管理 Azure IoT 作業實例的生命週期
重要
已啟用 Azure Arc 的 Azure IoT 操作預覽版目前為預覽狀態。 請勿在生產環境使用此預覽版軟體。
當正式推出的版本可使用時，您必須部署新的 Azure IoT 操作安裝。 您將無法升級預覽安裝。
請參閱 Microsoft Azure 預覽版增補使用規定，以了解適用於 Azure 功能 (搶鮮版 (Beta)、預覽版，或尚未正式發行的版本) 的法律條款。
使用 Azure CLI 和 Azure 入口網站 來管理、卸載或更新 Azure IoT 作業實例。
必要條件
部署至叢集的 Azure IoT 作業實例。 如需詳細資訊，請參閱部署 Azure IoT Orchestrator。
在您的開發電腦上安裝 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>
若要刪除執行個體上的所有標籤，請將 tags 參數設定為 null 值。 例如：
az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""
解除安裝
Azure CLI 和 Azure 入口網站會提供不同選項供您解除安裝 Azure IoT 操作。
Azure 入口網站 步驟可以刪除 Azure IoT Operations 實例，但不會影響部署中的相關資源。 如果您想要刪除整個部署，請使用 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 Operations 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>
