你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
管理 Azure IoT 操作实例的生命周期
重要
Azure Arc 启用的 Azure IoT 操作预览版目前处于预览状态。 不应在生产环境中使用此预览版软件。
在正式版推出后，你需要部署新的 Azure IoT 操作安装。 无法升级预览版安装。
有关 beta 版本、预览版或尚未正式发布的版本的 Azure 功能所适用的法律条款，请参阅 Microsoft Azure 预览版的补充使用条款。
使用 Azure CLI 和 Azure 门户管理、卸载或更新 Azure IoT 操作实例。
先决条件
部署到群集的 Azure IoT 操作实例。 有关详细信息，请参阅部署 Azure IoT 操作。
已在开发计算机上安装的 Azure CLI。 此场景需要 Azure CLI 2.64.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 操作实例的名称。
在实例的“概述”页面上，“Arc 扩展”表会显示已部署到群集的资源。
使用 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 IoT 操作”。
选择 Azure IoT 操作实例的名称。
在实例的“概述”页上，选择“添加标记”或“编辑”以修改实例上的标记。
使用 az iot ops update 命令编辑 Azure IoT 操作实例的标记和说明参数。 update 命令中提供的值将替换任何现有标记或说明
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 ""
卸载
Azure CLI 和 Azure 门户提供了用于卸载 Azure IoT 操作的不同选项。
Azure 门户步骤可以删除 Azure IoT 操作实例，但无法影响部署中的相关资源。 如果要删除整个部署，请使用 Azure CLI。
在 Azure 门户中，转到包含 Azure IoT 操作实例的资源组，或搜索并选择“Azure IoT 操作”。
选择 Azure IoT 操作实例的名称。
在实例的“概述”页上，选择“删除”。
查看此操作中已删除和未删除的资源列表，然后键入实例的名称并选择“删除”进行确认。
使用 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
升级
在公共预览版中，Azure IoT 操作支持将实例从版本 0.7.x 升级到 0.8.x。
在正式版推出后，你需要部署新的 Azure IoT 操作安装。 无法从预览版安装升级。
在 Azure 门户中，转到包含 Azure IoT 操作实例的资源组，或搜索并选择“Azure IoT 操作”。
选择 Azure IoT 操作实例的名称。
在实例的“概述”页上，选择“升级”。
“升级 Azure IoT 操作”向导会提示你确保具有 Azure IoT 操作 CLI 扩展的最新版本。 复制并运行所提供的 az extension add 命令。
更新到最新版本的 Azure IoT 操作实例。 复制并运行所提供的 az iot ops upgrade 命令。
升级命令成功完成后，可以退出向导并刷新实例页。
使用 az iot ops upgrade 命令升级 Azure IoT 操作部署。 此命令：
- 升级群集上的 Azure Arc 扩展。
- 升级 Azure IoT 操作实例。
az iot ops upgrade --resource-group <RESOURCE_GROUP> --name <INSTANCE_NAME>
