Adding get-versions command

Author: SoniaLopezBravo

articles/iot-operations/deploy-iot-ops/howto-deploy-iot-operations.md

@@ -214,8 +214,15 @@ The `check` command displays a warning about missing data flows, which is normal
 
 You can check the configurations of topic maps, QoS, and message routes by adding the `--detail-level 2` parameter to the `check` command for a verbose view.
 
+You can view all versions of the Azure IoT Operations CLI extension that are available by running the following command:
+
+```azurecli
+az iot ops get-versions
+```
+
 ## Next steps
 
-If your components need to connect to Azure endpoints like SQL or Fabric, learn how to [Manage secrets for your Azure IoT Operations deployment](../deploy-iot-ops/howto-manage-secrets.md).
+- If your components need to connect to Azure endpoints like SQL or Fabric, learn how to [Manage secrets for your Azure IoT Operations deployment](../deploy-iot-ops/howto-manage-secrets.md).
+- To upgrade your Azure IoT Operations deployment to a newer version, see [Upgrade Azure IoT Operations](./howto-upgrade.md).
 
 

articles/iot-operations/deploy-iot-ops/howto-deploy-iot-test-operations.md

@@ -174,6 +174,12 @@ The `check` command displays a warning about missing data flows, which is normal
 
 You can check the configurations of topic maps, QoS, and message routes by adding the `--detail-level 2` parameter to the `check` command for a verbose view.
 
+You can view all versions of the Azure IoT Operations CLI extension that are available by running the following command:
+
+```azurecli
+az iot ops get-versions
+```
+
 ## Next steps
 
 The Azure IoT Operations instance you deployed is configured for testing scenarios. If you want to enable secure setting and prepare the instance for production scenarios, follow the steps in [Enable secure settings on an existing Azure IoT Operations instance](./howto-enable-secure-settings.md).

articles/iot-operations/deploy-iot-ops/howto-upgrade.md

@@ -89,21 +89,21 @@ Use the following steps to upgrade your deployment to the latest version:
    az iot ops upgrade --resource-group <RESOURCE_GROUP_NAME> --name <INSTANCE_NAME>
    ```
 
-1. The CLI outputs a table of the components that have available upgrades. Enter `Y` to continue with the upgrade.
+1. The CLI outputs a table of the components that have available upgrades. Enter `Y` to continue with the upgrade. 
 
-1. If you want to upgrade to a specific version of Azure IoT Operations that isn't the latest, use the related CLI extension version. Refer to [IoT Operations versions](https://aka.ms/aio-versions) to find the CLI extension version associated with the Azure IoT Operations version that you want and run the following command: 
+If you want to upgrade to a specific version of Azure IoT Operations that isn't the latest, you can run `az iot ops get-versions` or refer to [IoT Operations versions](https://aka.ms/aio-versions) to find the CLI extension version associated with the Azure IoT Operations version that you want. Get the version number and run the following command to upgrade to that version:
 
-   ```azurecli
-   az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>
-   ```
+```azurecli
+az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>
+```
 
 ---
 
 ## Upgrade to preview version
 
 Sometimes the latest version of Azure IoT Operations is in preview. Check the [Azure IoT Operations versions](https://aka.ms/aio-versions) to see the latest version. During preview releases, version upgrade is blocked, and you need to uninstall Azure IoT Operations and reinstall the preview version. 
 
-You can only install a preview version using the Azure CLI. Follow these steps to upgrade to a preview version of Azure IoT Operations:
+You can only install a preview version using the Azure CLI.
 
 1. If you have an existing Azure IoT Operations instance, you need to [Uninstall Azure IoT Operations](howto-manage-update-uninstall.md#uninstall) to do a new deployment. 
 1. Add the latest version of the Azure IoT Operations CLI extension with the `--allow-preview` flag.
@@ -112,11 +112,11 @@ You can only install a preview version using the Azure CLI. Follow these steps t
    az extension add --upgrade --name azure-iot-ops --allow-preview
    ```
 
-1. During preview releases, you can upgrade your deployment to a specific version of Azure IoT Operations by specifying the related CLI extension version. Refer to [IoT Operations versions](https://aka.ms/aio-versions) to find the CLI extension version associated with the Azure IoT Operations version that you want and run the following command:
+If you want to upgrade to a specific version of Azure IoT Operations that isn't the latest, you can run `az iot ops get-versions` or refer to [IoT Operations versions](https://aka.ms/aio-versions) to find the CLI extension version associated with the Azure IoT Operations version that you want. Get the version number and run the following command to upgrade to that version:
 
-    ```azurecli
-    az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>
-   ```
+   ```azurecli
+   az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>
+```
 
 > [!NOTE]
 > In preview releases, the `az iot ops upgrade` command doesn't work for upgrading to a preview version, but it works for configuring the Azure IoT Operations for observability. Add the following parameters to the `upgrade` command: