Merge pull request #234559 from Blackmist/update-sdk

Update sdk

Author: v-dirichards

articles/machine-learning/how-to-manage-registries.md

@@ -32,6 +32,8 @@ Azure Machine Learning registries (preview) enable you to create and use those a
 
 [!INCLUDE [CLI v2 preres](../../includes/machine-learning-cli-prereqs.md)]
 
+[!INCLUDE [CLI v2 update](./includes/new-feature-cli.md)]
+
 ## Prepare to create registry
 
 You need to decide the following information carefully before proceeding to create a registry:
@@ -94,7 +96,7 @@ You can create registries in Azure Machine Learning studio using the following s
     > If you are in a workspace, navigate to the global UI by clicking your organization or tenant name in the navigation pane to find the __Registries__ entry.  You can also go directly there by navigating to [https://ml.azure.com/registries](https://ml.azure.com/registries).
 
     :::image type="content" source="./media/how-to-manage-registries/studio-create-registry-button.png" lightbox="./media/how-to-manage-registries/studio-create-registry-button.png" alt-text="Screenshot of the create registry screen.":::
-	
+    
 1. Enter the registry name, select the subscription and resource group and then select __Next__.
 
     :::image type="content" source="./media/how-to-manage-registries/studio-create-registry-basics.png" alt-text="Screenshot of the registry creation basics tab.":::
@@ -111,7 +113,7 @@ You can create registries in Azure Machine Learning studio using the following s
 1. From the [Azure portal](https://portal.azure.com), navigate to the Azure Machine Learning service. You can get there by searching for __Azure Machine Learning__ in the search bar at the top of the page or going to __All Services__ looking for __Azure Machine Learning__ under the __AI + machine learning__ category. 
 
 1. Select __Create__, and then select __Azure Machine Learning registry__. Enter the registry name, select the subscription, resource group and primary region, then select __Next__.
-	
+    
 1. Select the additional regions the registry must support, then select __Next__ until you arrive at the __Review + Create__ tab.
 
     :::image type="content" source="./media/how-to-manage-registries/create-registry-review.png" alt-text="Screenshot of the review + create tab.":::

articles/machine-learning/how-to-share-data-across-workspaces-with-registries.md

@@ -102,7 +102,7 @@ Before following the steps in this article, make sure you have the following pre
     To install the Python SDK v2, use the following command:
 
     ```bash
-    pip install --pre azure-ai-ml
+    pip install --pre --upgrade azure-ai-ml azure-identity
     ```
 
     ---

articles/machine-learning/how-to-share-models-pipelines-across-workspaces-with-registries.md

@@ -70,7 +70,7 @@ Before following the steps in this article, make sure you have the following pre
     To install the Python SDK v2, use the following command:
 
     ```bash
-    pip install --pre azure-ai-ml
+    pip install --pre --upgrade azure-ai-ml azure-identity
     ```
 
     ---

articles/machine-learning/includes/new-feature-cli.md

@@ -0,0 +1,14 @@
+---
+author: blackmist
+ms.service: machine-learning
+ms.topic: include
+ms.date: 04/14/2023
+ms.author: larryfr
+---
+
+> [!TIP]
+> If you are using an older version of the `ml` extension for CLI, you may need to update it to the latest version before working with this feature. To update the latest version, use the following command:
+>
+> :::code language="azurecli" source="~/azureml-examples-main/cli/misc.sh" id="az_ml_update":::
+>
+> For more information, see [Install, set up, and use the CLI (v2)](../how-to-configure-cli.md).

articles/machine-learning/includes/new-feature-sdk.md

@@ -0,0 +1,16 @@
+---
+author: blackmist
+ms.service: machine-learning
+ms.topic: include
+ms.date: 04/14/2023
+ms.author: larryfr
+---
+
+> [!TIP]
+> If you are using an older version of the Azure Machine Learning SDK, you may need to update it to the latest version before working with this feature. To update the latest version, use the following command:
+>
+> ```bash
+> pip install --upgrade azure-ai-ml azure-identity
+> ```
+>
+> For more information, see [Install the Python SDK v2 for Azure Machine Learning](https://aka.ms/sdk-v2-install).

includes/machine-learning-cli-prereqs.md

@@ -8,8 +8,6 @@ ms.author: larryfr
 
 Before following the steps in this article, make sure you have the following prerequisites:
 
-* An Azure subscription. If you don't have an Azure subscription, create a free account before you begin. Try the [free or paid version of Azure Machine Learning](https://azure.microsoft.com/free/).
-
 * The [Azure CLI](/cli/azure/) and the `ml` extension to the Azure CLI. For more information, see [Install, set up, and use the CLI (v2)](../articles/machine-learning/how-to-configure-cli.md).
 
     > [!IMPORTANT]

includes/machine-learning-cli-sdk-v2-prereqs.md

@@ -8,8 +8,6 @@ ms.author: larryfr
 
 Before following the steps in this article, make sure you have the following prerequisites:
 
-* An Azure subscription. If you don't have an Azure subscription, create a free account before you begin. Try the [free or paid version of Azure Machine Learning](https://azure.microsoft.com/free/).
-
 * An Azure Machine Learning workspace. If you don't have one, use the steps in the [Quickstart: Create workspace resources](../articles/machine-learning/quickstart-create-resources.md) article to create one.
 
 * The Azure CLI and the `ml` extension __or__ the Azure Machine Learning Python SDK v2:
@@ -25,4 +23,10 @@ Before following the steps in this article, make sure you have the following pre
         pip install azure-ai-ml azure-identity
         ```
 
+        To update an existing installation of the SDK to the latest version, use the following command:
+
+        ```bash
+        pip install --upgrade azure-ai-ml azure-identity
+        ```
+
         For more information, see [Install the Python SDK v2 for Azure Machine Learning](https://aka.ms/sdk-v2-install).

includes/machine-learning-sdk-v2-prereqs.md

@@ -8,8 +8,6 @@ ms.author: larryfr
 
 Before following the steps in this article, make sure you have the following prerequisites:
 
-* An Azure subscription. If you don't have an Azure subscription, create a free account before you begin. Try the [free or paid version of Azure Machine Learning](https://azure.microsoft.com/free/).
-
 * An Azure Machine Learning workspace. If you don't have one, use the steps in the [Quickstart: Create workspace resources](../articles/machine-learning/quickstart-create-resources.md) article to create one.
 
 * To install the Python SDK v2, use the following command:
@@ -18,4 +16,10 @@ Before following the steps in this article, make sure you have the following pre
     pip install azure-ai-ml azure-identity
     ```
 
+    To update an existing installation of the SDK to the latest version, use the following command:
+
+    ```bash
+    pip install --upgrade azure-ai-ml azure-identity
+    ```
+
     For more information, see [Install the Python SDK v2 for Azure Machine Learning](/python/api/overview/azure/ai-ml-readme).