Merge pull request #297819 from SoniaLopezBravo/enable-instance-feature

Adding how to enable preview connector

Author: prmerger-automator[bot]

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

@@ -7,7 +7,6 @@ ms.topic: how-to
 ms.custom: ignite-2023, devx-track-azurecli
 ms.date: 04/08/2025
 
-
 #CustomerIntent: As an OT professional, I want to deploy Azure IoT Operations to a Kubernetes cluster.
 ---
 
@@ -128,10 +127,9 @@ Use these steps if you chose the **Test settings** option on the **Dependency ma
       az login
       ```
 
-   1. Install the latest Azure IoT Operations CLI extension.
+   1. Install the latest Azure IoT Operations CLI extension if you haven't already.
 
       ```azurecli
-      az upgrade
       az extension add --upgrade --name azure-iot-ops
       ```
 
@@ -142,13 +140,19 @@ Use these steps if you chose the **Test settings** option on the **Dependency ma
    1. Prepare the cluster for Azure IoT Operations deployment. Copy and run the provided [az iot ops init](/cli/azure/iot/ops#az-iot-ops-init) command.
 
       >[!TIP]
-      >The `init` command only needs to be run once per cluster. If you're reusing a cluster that already had Azure IoT Operations version 0.8.0 deployed on it, you can skip this step.
+      >The `init` command only needs to be run once per cluster. If you're reusing a cluster that already has the latest version of Azure IoT Operations deployed on it, you can skip this step.
 
       If you followed the optional prerequisite to set up your own certificate authority issuer, add the `--user-trust` flag to the `init` command.
 
       This command might take several minutes to complete. You can watch the progress in the deployment progress display in the terminal.
 
    1. Deploy Azure IoT Operations. Copy and run the provided [az iot ops create](/cli/azure/iot/ops#az-iot-ops-create) command.
+   
+      * If you want to use the preview connector configuration, add the following parameter to the `create` command:
+
+        ```bash
+        --feature connectors.settings.preview=Enabled
+        ```
 
       * If you followed the optional prerequisites to prepare your cluster for observability, add the following parameters to the `create` command:
 
@@ -220,8 +224,14 @@ Use these steps if you chose the **Secure settings** option on the **Dependency
       This command might take several minutes to complete. You can watch the progress in the deployment progress display in the terminal.
 
    1. Deploy Azure IoT Operations. Copy and run the provided [az iot ops create](/cli/azure/iot/ops#az-iot-ops-create) command.
+   
+      * If you want to use the preview connector configuration, add the following parameter to the `create` command:
+
+        ```bash
+        --feature connectors.settings.preview=Enabled
+        ```
 
-      If you followed the optional prerequisites to prepare your cluster for observability, add the following optional parameters to the `create` command:
+      * If you followed the optional prerequisites to prepare your cluster for observability, add the following optional parameters to the `create` command:
 
       | Optional parameter | Value | Description |
       | --------- | ----- | ----------- |

articles/iot-operations/deploy-iot-ops/howto-manage-update-uninstall.md

@@ -107,19 +107,21 @@ You can run `az iot ops check` on your cluster to assess health and configuratio
 
 ---
 
-### Update instance tags and description
+### Update instances and configuration
 
-#### [Azure portal](#tab/portal)
+#### [Azure portal](#tab/portal2)
 
 1. In the [Azure portal](https://portal.azure.com), go to the resource group that contains your Azure IoT Operations instance, or search for and select **Azure IoT Operations**.
 
 1. Select the name of your Azure IoT Operations instance.
 
 1. On the **Overview** page of your instance, select **Add tags** or **edit** to modify tags on your instance.
 
-#### [Azure CLI](#tab/cli)
+#### [Azure CLI](#tab/cli2)
+
+Use the `az iot ops update` command to edit the features of your Azure IoT Operations instance.
 
-Use the `az iot ops update` command to edit the tags and description parameters of your Azure IoT Operations instance. The values provided in the `update` command replace any existing tags or description
+To update tags and description parameters of an instance, run:
 
 ```azurecli
 az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --desc "<INSTANCE_DESCRIPTION>" --tags <TAG_NAME>=<TAG-VALUE> <TAG_NAME>=<TAG-VALUE>
@@ -131,6 +133,18 @@ To delete all tags on an instance, set the tags parameter to a null value. For e
 az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""
 ```
 
+To enable the preview connector configuration, run: 
+
+```azurecli
+az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --feature connectors.settings.preview=Enabled 
+```
+
+To disable the preview connector configuration, run: 
+
+```azurecli
+az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --feature connectors.settings.preview=Disabled  
+```
+
 ---
 
 ### Manage components