共用方式為


在裝置更新中管理 IoT 中樞的裝置群組

IoT 中樞的裝置更新允許將更新部署到一組IoT裝置。 將更新部署至受控裝置時,這個步驟是選擇性的。 您可以使用為您建立的預設群組,將更新部署到您的裝置。 或者,您可以將使用者定義的標籤指派給您的裝置,而且這些標記會根據標記和裝置相容性屬性自動分組。

注意

如果您想要部署至預設群組,而不是使用者建立的群組,請繼續進行 如何部署更新

必要條件

支援的瀏覽器:

將標籤新增至您的裝置

若要建立裝置群組,第一個步驟是將標籤新增至 IoT 中樞 中的裝置目標集。 只有在標籤已連線到裝置更新之後,才能成功新增至您的裝置。

裝置更新標籤使用下列範例中的格式:

"etag": "",
"deviceId": "",
"deviceEtag": "",
"version": <version>,
"tags": {
   "ADUGroup": "<CustomTagValue>"
}

如需對應項 JSON 語法的詳細資訊和範例,請參閱 瞭解和使用裝置 對應項或 瞭解和使用模塊對應項

下列各節說明新增和更新標記的不同方式。

使用 SDK 新增標籤

使用 Device Update 註冊裝置之後,您可以使用 RegistryManager,以適當的標籤來更新裝置或模組對應項。 如需詳細資訊,請參閱下列文章:

如果您的裝置更新代理程式是以裝置身分識別布建,或以模組身分識別布建裝置更新代理程式,請將標籤新增至裝置對應項。

使用作業新增標籤

您可以在多個裝置上排程作業,以新增或更新裝置更新標籤。 如需作業作業的範例,請參閱 排程多個裝置上的作業。 您可以使用作業來更新裝置對應項或模組對應項,視裝置更新代理程式是使用裝置或模組身分識別布建而定。

如需詳細資訊,請參閱 排程和廣播作業

注意

此動作會根據您的 IoT 中樞 訊息配額計算。 我們建議您一次最多變更 50,000 個裝置或模組對應項標籤,否則如果您超過每日 IoT 中樞 訊息配額,您可能需要購買更多 IoT 中樞 單位。 如需詳細資訊,請參閱 配額和節流

藉由更新對應項來新增標籤

標籤也可以直接在裝置或模組對應項中新增或更新。

  1. Azure 入口網站中,瀏覽至您的 IoT 中樞。

  2. 左側瀏覽窗格上的 [裝置 ] 或 [IoT Edge ],尋找您的 IoT 裝置。 請流覽至裝置對應項或裝置更新模組,然後流覽至其模組對應項,視裝置更新代理程式是使用裝置或模組身分識別布建而定。

  3. 在對應項詳細數據中,將現有裝置更新標籤設定為 Null,以刪除任何現有的裝置更新標籤值。

  4. 新增裝置更新標籤值,如下所示。

        "tags": {
                "ADUGroup": "<CustomTagValue>"
                }
    

限制

  • 除了 和 $default之外,您可以將任何值新增至您的標記Uncategorized,這些值都是保留值。
  • 標記值不能超過 200 個字元。
  • 標記值可以包含英數位元和下列特殊字元: . - _ ~
  • 標籤和組名會區分大小寫。
  • 裝置只能有一個名稱為ADUGroup的標籤。 具有該名稱之標籤的任何新增都會覆寫標籤名稱 ADUGroup 的現有值。
  • 一個裝置只能屬於一個群組。

檢視裝置群組

群組會根據指派的標記以及裝置的相容性屬性自動建立。 一個群組可以有多個具有不同裝置類別的子群組。

  1. Azure 入口網站 中,流覽至您先前連線到裝置更新實例的IoT中樞。

  2. 從左側導覽列選取 [裝置管理] 底下的 [更新] 選項。

  3. 選取 [ 群組和部署] 索引標籤

    Screenshot of ungrouped devices.

  4. 建立群組之後,您會看到合規性圖表和群組清單已更新。 [裝置更新合規性] 圖表會顯示各種合規性狀態中的裝置計數:最新更新、可用的新更新,以及進行中 更新。 如需詳細資訊,請參閱 裝置更新合規性。

    Screenshot of update compliance view.

  5. 您應該會在群組清單中看到現有群組和這些群組中裝置的任何可用更新。 如果有不符合群組裝置類別需求的裝置,它們會顯示在對應的無效群組中。 您可以選取群組旁的 [部署] 按鈕,從這個檢視將最佳的可用更新部署至群組。

檢視群組的裝置詳細數據

  1. 從 [ 群組和部署] 索引 標籤中,選取您要檢視的組名。

  2. 在 [群組詳細數據] 頁面上,您可以看到屬於群組一部分的裝置清單,以及其裝置更新屬性。 在此檢視中,您也可以查看群組成員之所有裝置的更新合規性資訊。 合規性圖表會顯示各種合規性狀態中的裝置計數。

    Screenshot of device group details view.

  3. 您也可以選取群組內的個別裝置,以重新導向至 IoT 中樞 中的裝置詳細數據頁面。

    Screenshot of device details view.

    Screenshot of device details view in IoT hub.

從裝置群組移除裝置

若要從裝置群組中移除裝置,ADUGroup 標籤必須變更為 「null」。。

    "tags": {
            "ADUGroup": "null"
            }

這會從裝置對應項中刪除ADUGroup標籤,並從其裝置群組中移除裝置。

刪除裝置群組

自動建立裝置群組時,不會自動清除群組、裝置類別和部署,以便保留記錄檔或其他使用者需求。 您可以透過個別選取和刪除所需的群組,或在群組上呼叫 DELETE API,以透過 Azure 入口網站 刪除裝置群組。 深入了解

如果刪除群組之後,此群組再次連線裝置,而群組會自動重新建立,則不會有相關聯的裝置或部署歷程記錄。

若要刪除,群組必須符合下列需求:

  • 群組必須有 NO 成員裝置。 這表示裝置更新實例中未布建任何裝置,其 ADUGroup 標籤的值應符合所選組名。
  • 群組不得為預設群組。
  • 群組必須沒有與其相關聯的作用中或已取消部署。

注意

如果您仍無法在符合上述需求之後刪除群組,請驗證您是否有任何標記為群組一部分的狀況不良裝置。 狀況不良的裝置是無法接收部署的裝置,因此不會直接顯示在群組內的成員裝置清單中。 您可以在 [裝置更新入口網站] 體驗的 [診斷] 索引標籤內,移至 [尋找遺失的裝置] 來驗證您是否有任何狀況不良的裝置。 如果您有標記為群組一部分的狀況不良裝置,您必須先修改標籤或刪除裝置,再嘗試刪除群組。

後續步驟