在裝置更新中管理 IoT 中樞的裝置群組
IoT 中樞的裝置更新允許將更新部署到一組IoT裝置。 將更新部署至受控裝置時,這個步驟是選擇性的。 您可以使用為您建立的預設群組,將更新部署到您的裝置。 或者,您可以將使用者定義的標籤指派給您的裝置,而且這些標記會根據標記和裝置相容性屬性自動分組。
注意
如果您想要部署至預設群組,而不是使用者建立的群組,請繼續進行 如何部署更新。
必要條件
- 存取已啟用 IoT 中樞裝置更新的 IoT 中樞。 建議您針對 IoT 中樞 使用 S1(標準)層或更新版本。
- 在 IoT 中樞 內針對裝置更新布建的 IoT 裝置(或模擬器)。
- 在您的IoT裝置上安裝並啟動 裝置更新代理程式 ,做為模組或裝置層級身分識別。
- 已布建裝置的匯入更新。
支援的瀏覽器:
- Microsoft Edge
- Google Chrome
將標籤新增至您的裝置
若要建立裝置群組,第一個步驟是將標籤新增至 IoT 中樞 中的裝置目標集。 只有在標籤已連線到裝置更新之後,才能成功新增至您的裝置。
裝置更新標籤使用下列範例中的格式:
"etag": "",
"deviceId": "",
"deviceEtag": "",
"version": <version>,
"tags": {
"ADUGroup": "<CustomTagValue>"
}
如需對應項 JSON 語法的詳細資訊和範例,請參閱 瞭解和使用裝置 對應項或 瞭解和使用模塊對應項。
下列各節說明新增和更新標記的不同方式。
使用 SDK 新增標籤
使用 Device Update 註冊裝置之後,您可以使用 RegistryManager,以適當的標籤來更新裝置或模組對應項。 如需詳細資訊,請參閱下列文章:
如果您的裝置更新代理程式是以裝置身分識別布建,或以模組身分識別布建裝置更新代理程式,請將標籤新增至裝置對應項。
使用作業新增標籤
您可以在多個裝置上排程作業,以新增或更新裝置更新標籤。 如需作業作業的範例,請參閱 排程多個裝置上的作業。 您可以使用作業來更新裝置對應項或模組對應項,視裝置更新代理程式是使用裝置或模組身分識別布建而定。
如需詳細資訊,請參閱 排程和廣播作業。
注意
此動作會根據您的 IoT 中樞 訊息配額計算。 我們建議您一次最多變更 50,000 個裝置或模組對應項標籤,否則如果您超過每日 IoT 中樞 訊息配額,您可能需要購買更多 IoT 中樞 單位。 如需詳細資訊,請參閱 配額和節流。
藉由更新對應項來新增標籤
標籤也可以直接在裝置或模組對應項中新增或更新。
在 Azure 入口網站中,瀏覽至您的 IoT 中樞。
從 左側瀏覽窗格上的 [裝置 ] 或 [IoT Edge ],尋找您的 IoT 裝置。 請流覽至裝置對應項或裝置更新模組,然後流覽至其模組對應項,視裝置更新代理程式是使用裝置或模組身分識別布建而定。
在對應項詳細數據中,將現有裝置更新標籤設定為 Null,以刪除任何現有的裝置更新標籤值。
新增裝置更新標籤值,如下所示。
"tags": { "ADUGroup": "<CustomTagValue>" }
限制
- 除了 和
$default
之外,您可以將任何值新增至您的標記Uncategorized
,這些值都是保留值。 - 標記值不能超過 200 個字元。
- 標記值可以包含英數位元和下列特殊字元:
. - _ ~
。 - 標籤和組名會區分大小寫。
- 裝置只能有一個名稱為ADUGroup的標籤。 具有該名稱之標籤的任何新增都會覆寫標籤名稱 ADUGroup 的現有值。
- 一個裝置只能屬於一個群組。
檢視裝置群組
群組會根據指派的標記以及裝置的相容性屬性自動建立。 一個群組可以有多個具有不同裝置類別的子群組。
在 Azure 入口網站 中,流覽至您先前連線到裝置更新實例的IoT中樞。
從左側導覽列選取 [裝置管理] 底下的 [更新] 選項。
選取 [ 群組和部署] 索引標籤 。
建立群組之後,您會看到合規性圖表和群組清單已更新。 [裝置更新合規性] 圖表會顯示各種合規性狀態中的裝置計數:最新更新、可用的新更新,以及進行中 更新。 如需詳細資訊,請參閱 裝置更新合規性。
您應該會在群組清單中看到現有群組和這些群組中裝置的任何可用更新。 如果有不符合群組裝置類別需求的裝置,它們會顯示在對應的無效群組中。 您可以選取群組旁的 [部署] 按鈕,從這個檢視將最佳的可用更新部署至群組。
檢視群組的裝置詳細數據
從裝置群組移除裝置
若要從裝置群組中移除裝置,ADUGroup 標籤必須變更為 「null」。。
"tags": {
"ADUGroup": "null"
}
這會從裝置對應項中刪除ADUGroup標籤,並從其裝置群組中移除裝置。
刪除裝置群組
自動建立裝置群組時,不會自動清除群組、裝置類別和部署,以便保留記錄檔或其他使用者需求。 您可以透過個別選取和刪除所需的群組,或在群組上呼叫 DELETE API,以透過 Azure 入口網站 刪除裝置群組。 深入了解
如果刪除群組之後,此群組再次連線裝置,而群組會自動重新建立,則不會有相關聯的裝置或部署歷程記錄。
若要刪除,群組必須符合下列需求:
- 群組必須有 NO 成員裝置。 這表示裝置更新實例中未布建任何裝置,其 ADUGroup 標籤的值應符合所選組名。
- 群組不得為預設群組。
- 群組必須沒有與其相關聯的作用中或已取消部署。
注意
如果您仍無法在符合上述需求之後刪除群組,請驗證您是否有任何標記為群組一部分的狀況不良裝置。 狀況不良的裝置是無法接收部署的裝置,因此不會直接顯示在群組內的成員裝置清單中。 您可以在 [裝置更新入口網站] 體驗的 [診斷] 索引標籤內,移至 [尋找遺失的裝置] 來驗證您是否有任何狀況不良的裝置。 如果您有標記為群組一部分的狀況不良裝置,您必須先修改標籤或刪除裝置,再嘗試刪除群組。