使用 Azure CLI 和 Azure 门户管理、卸载或更新 Azure IoT 操作实例。
先决条件
部署到群集的 Azure IoT 操作实例。 有关详细信息，请参阅部署 Azure IoT 运营。
已在开发计算机上安装的 Azure CLI。 此场景需要 Azure CLI 2.53.0 或更高版本。 如有必要，请使用az --version检查版本，使用az upgrade进行更新。 有关详细信息，请参阅 如何安装 Azure CLI。
适用于 Azure CLI 的 Azure IoT 操作扩展。 使用以下命令添加扩展或将其更新到最新版本：
az extension add --upgrade --name azure-iot-ops
管理
部署后，可以使用 Azure CLI 和 Azure 门户查看和管理 Azure IoT 操作实例。
列出实例
- 在 Azure 门户 中，搜索并选择 Azure IoT 运营。
- 使用筛选器根据订阅、资源组等查看 Azure IoT 操作实例。
使用 az iot ops list 命令查看订阅或资源组中的所有 Azure IoT 操作实例。
基本命令将返回订阅中的所有实例。
az iot ops list
若要按资源组筛选结果，请添加 --resource-group 参数。
az iot ops list --resource-group <RESOURCE_GROUP>
查看实例
可以在 Azure 门户中查看 Azure IoT 操作实例。
在 Azure 门户中，转到包含您的 Azure IoT 操作实例的资源组，或搜索并选择 Azure IoT 操作。
选择 Azure IoT 操作实例的名称。
在实例的 “概述 ”页上，可以看到实例的属性。 例如，可以看到 预览连接器的状态，这些连接器可以启用或禁用。 若要更改预览连接器的状态，请单击“ 编辑”。
此作将打开一个配置面板，可在其中启用或禁用 ONVIF 预览连接器。
“ 资源摘要 ”选项卡显示已部署到群集的资源。
使用 az iot ops show 命令查看实例的属性。
az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>
还可以使用 az iot ops show 命令在 Azure CLI 中查看 Azure IoT 操作部署中的资源。 添加 --tree 标志以显示包含指定 Azure IoT 操作实例的部署的树状视图。
az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --tree
部署的树状视图如以下示例所示：
MyCluster
├── extensions
│ ├── akvsecretsprovider
│ ├── azure-iot-operations-ltwgs
│ └── azure-iot-operations-platform-ltwgs
└── customLocations
└── MyCluster-cl
├── resourceSyncRules
└── resources
├── MyCluster-ops-init-instance
└── MyCluster-observability
可以在群集上运行 az iot ops check 来评估各个 Azure IoT 操作组件的运行状况和配置。 默认情况下，该命令会检查 MQ，但可以使用 参数--ops-service。
（预览版）克隆实例
目前，Azure 门户不支持克隆 Azure IoT 操作实例。 可以使用 Azure CLI 克隆实例。
使用az iot ops clone命令基于现有实例创建新的 Azure IoT 操作实例。 可以将克隆的输出应用到另一个连接的群集，这称为复制。 还可以将克隆保存到本地目录供以后使用，并在将克隆应用到群集之前执行一些配置更改。
有关详细信息，请参阅 克隆命令 Wiki 页。
若要将实例克隆到另一个群集，请运行：
az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID>
若要自定义复制到另一个群集，请使用 --param 并指定要更改的格式 key=value的参数。 例如，若要更改克隆实例的位置，请运行：
az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --param ___location=eastus
若要将实例克隆到本地目录，请运行：
az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-dir <DIRECTORY>
小窍门
若要将实例克隆到当前目录，请运行 --to-dir .
若要将实例克隆到群集，但拆分并串行应用与资产相关的子部署，请运行：
az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --mode linked
更新实例和配置
在 Azure 门户中，转到包含您的 Azure IoT 操作实例的资源组，或搜索并选择 Azure IoT 操作。
选择 Azure IoT 操作实例的名称。
在实例的“概述”页上，选择“添加标记”或“编辑”以修改实例上的标记。
使用 az iot ops update 命令编辑 Azure IoT Operations 实例的功能。
若要更新实例的标记和说明参数，请运行：
az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --desc "<INSTANCE_DESCRIPTION>" --tags <TAG_NAME>=<TAG-VALUE> <TAG_NAME>=<TAG-VALUE>
若要删除实例上的所有标记，请将标记参数设置为 null 值。 例如：
az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""
若要启用预览连接器配置，请运行：
az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --feature connectors.settings.preview=Enabled
若要禁用预览连接器配置，请运行：
az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --feature connectors.settings.preview=Disabled
管理组件
每个 Azure IoT 操作实例都包含多个组件，例如 MQTT 代理、OPC UA 连接器和数据流。 若要详细了解如何管理这些组件，请参阅各自的文章。 例如，若要管理 MQTT 代理，请从 Broker 概述开始。
（预览版）使用 Kubernetes 部署清单管理组件
通常，Azure IoT 操作使用 Azure Arc 平台提供混合云体验，可在其中通过 Azure 资源管理器 (ARM) 和前端工具（如 Azure 门户、Bicep 和 Azure CLI）管理配置。
但是，还可以使用 YAML Kubernetes 部署清单管理 Azure IoT 操作的组件。 这意味着可以使用 kubectl 等工具来管理 Azure IoT 操作的某些组件。 此功能以预览版提供，存在一些限制：
- 只有某些组件支持使用 Kubernetes 部署清单。 这些组件是 MQTT 中转站 和 数据流。 其他组件（如 OPC UA 和 Akri 服务的连接器）不支持此功能。
- 除非使用启用了资源同步功能的来部署 Azure IoT运营，否则通过 Kubernetes 部署清单对资源进行的更改不会同步到 Azure。 若要了解有关资源同步的详细信息，请参阅 资源同步。
- 即使启用了资源同步，使用 Kubernetes 部署清单创建的全新资源也不会同步到 Azure。 仅同步对现有资源的更改。
卸载
Azure IoT Operations CLI 和 Azure 门户提供了用于卸载 Azure IoT作的不同选项。
重要
若要清理群集和资源组，建议首先使用接下来部分中的 Azure IoT Operations CLI 命令，从群集中删除 Azure IoT 运营。 然后，可以删除资源组。 如果直接删除资源组，孤立的资源会保留在群集上。
在 Azure 门户中，转到包含您的 Azure IoT 操作实例的资源组，或搜索并选择 Azure IoT 操作。
选择 Azure IoT 操作实例的名称。
在实例的“概述”页上，选择“删除”。
查看此操作中已删除和未删除的资源列表，然后键入实例的名称并选择“删除”进行确认。
注释
在 Azure 门户中删除 Azure IoT作实例不会删除部署 Azure IoT作时创建的依赖项。 若要删除这些依赖项，请使用 az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps Azure CLI 过程中所述的命令。
使用 az iot ops delete 命令从群集中删除整个 Azure IoT 操作部署。 delete 命令会评估群集上的 Azure IoT 操作相关的资源，并显示要删除的资源的树视图。 运行此命令时，群集应为联机状态。
delete 命令简化了将 Azure IoT 操作重新部署到同一群集的过程。 它会撤消 create 命令，以便可以再次运行 create、delete、create 等，而无需重新运行 init。
delete 命令会删除：
- Azure IoT 操作实例
- Arc 扩展
- 自定义位置
- 资源同步规则
- 可以在 Azure IoT 操作解决方案中配置的资源，例如资产、MQTT 代理和数据流。
az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>
若要删除实例并删除 Azure IoT 操作依赖项（init 的输出），请添加标志 --include-deps。
az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps
