如何根據裝置對應項屬性來檢視和更新裝置

使用 Azure 入口網站和 Azure CLI 透過裝置對應項和模組對應項來管理裝置。 本文著重於裝置對應項,為了簡單起見,但所有概念和程序的運作方式都與模塊對應項類似。

本文說明 Azure 入口網站 或 Azure CLI 中可用的裝置對應項管理工作,以遠端管理裝置對應項。 如需開發裝置應用程式以處理裝置對應項變更的相關信息,請參閱 開始使用裝置對應項

在 IoT 中樞 中,裝置對應項是儲存狀態資訊的 JSON 檔。 建立裝置時,每個 裝置身 分識別都會自動與裝置對應項相關聯。 後端應用程式或使用者可以更新裝置對應項的兩個專案:

  • Desired 屬性:D esired 屬性是一組鏈接狀態資訊的一半。 後端應用程式或使用者可以更新對應項上所需的屬性,以傳達所需的狀態變更,而裝置可以更新 報告的屬性 以傳達其目前狀態。
  • 標籤:您可以使用裝置對應項標籤來組織和管理IoT解決方案中的裝置。 您可以設定任何有意義的類別標籤,例如裝置類型、位置或函式。

如需詳細資訊,請參閱瞭解和使用 IoT 中樞 中的裝置對應項或瞭解和使用 IoT 中樞 中的模組對應項。

注意

本文中所述的功能僅適用於 IoT 中樞的標準層。 如需有關基本和標準/免費 Azure IoT 中樞階層的詳細資訊,請參閱為您的解決方案選擇適合的 Azure IoT 中樞階層

必要條件

開始之前,請先準備下列必要條件。

  • Azure 訂用帳戶中的 IoT 中樞。 如果您還沒有中樞,請遵循建立IoT中樞中的步驟。

  • 在 IoT 中樞內註冊的裝置。 如果 IoT 中樞中沒有裝置,請遵循註冊裝置中的步驟。

了解裝置組織的標籤

裝置對應項標記可以用作功能強大的工具,協助您組織裝置。 當您在IoT解決方案中有多個裝置類型時,您可以使用標籤來設定類型、位置等。例如:

{
  "deviceId": "mydevice1",
  "status": "enabled",
  "connectionState": "Connected",
  "cloudToDeviceMessageCount": 0,
  "authenticationType": "sas",
  "tags": {
    "deploymentLocation": {
      "building": "43",
      "floor": "1"
    },
    "deviceType":"HDCamera"
  },
  "properties": {
    ...
  }
}

檢視和更新裝置對應項

建立裝置身分識別之後,系統會在 IoT 中樞中隱含建立裝置對應項。 您可以使用 Azure 入口網站 或 Azure CLI 來擷取指定裝置的裝置對應項。 您也可以新增、編輯或移除標籤和所需的屬性。

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

  2. 在 IoT 中樞中,從導覽功能表的 [裝置管理] 區段中選取 [裝置]。

    在 [ 裝置] 頁面上,您會看到已在IoT中樞註冊的所有裝置清單。 如果任何裝置在其裝置對應項中已經有標籤,這些標籤會顯示在 [卷標] 資料行中

  3. 選取您想要管理的裝置名稱。

    提示

    如果您要更新標籤,您可以選取多個裝置,然後選取 [ 指派標籤 以將其管理為群組]。

    顯示選取 Azure 入口網站 中多個裝置以將標籤指派為群組的螢幕快照。

  4. [裝置詳細數據] 頁面會顯示所選裝置的任何目前標籤。 選取 Tags 參數旁的 [編輯],以新增、更新或移除標籤。

    顯示開啟 Azure 入口網站 中標記編輯選項的螢幕快照。

    提示

    若要新增或更新巢狀標記,請選取 [ 進階 ] 索引標籤並提供 JSON。

    顯示使用進階標籤編輯器提供 JSON 文字的螢幕快照。

  5. 選取 [ 裝置對應項 ] 以檢視及更新裝置對應項 JSON。

    您可以直接在文字框中輸入 ,以更新標籤或所需的屬性。 若要移除標記或所需的屬性,請將專案的值設定為 null

  6. 選取儲存以儲存變更。

  7. 回到裝置詳細數據頁面,選取 [重新 整理] 以更新頁面以反映您的變更。

如果您的裝置有任何與其相關聯的模組身分識別,這些模組也會顯示在裝置詳細數據頁面上。 選取模組名稱,然後選取 [模組身分識別對應項 ] 以檢視和更新模塊對應項 JSON。

查詢裝置對應項

IoT 中樞可以將 IoT 中樞的裝置對應項公開為稱為裝置的文件集合。 您可以根據裝置對應項值來查詢裝置。

本節說明如何在 Azure 入口網站 和 Azure CLI 中執行對應項查詢。 若要瞭解如何撰寫對應項查詢,請參閱 IoT 中樞 裝置和模塊對應項的查詢。

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

  2. 在 IoT 中樞中,從導覽功能表的 [裝置管理] 區段中選取 [裝置]。

  3. 您可以使用篩選條件或查詢,根據裝置對應項詳細資料來尋找裝置:

    • 使用篩選來尋找裝置:

      1. 使用篩選尋找裝置是 Azure 入口網站的預設檢視。 如果您沒有看到這些欄位,請選取 [使用篩選尋找裝置]。

      2. 選取 [ 新增篩選],然後從下拉功能表中選取 [裝置卷標 ] 作為篩選類型。

      3. 輸入所需的標籤名稱和值,選取 [ 套用 ] 以擷取符合準則的裝置清單。

        螢幕擷取畫面:使用標籤篩選裝置。

    • 使用查詢尋找裝置:

      1. 選取 [使用查詢尋找裝置]。

      2. 在文字框中輸入您的查詢,然後選取 [ 執行查詢]。

        顯示使用 Azure 入口網站 中裝置查詢篩選條件的螢幕快照。

使用作業更新裝置對應項

作業功能可以在排程時間對一組裝置執行裝置對應項更新。 如需詳細資訊,請參閱 排程多個裝置上的作業。

Azure 入口網站 不支持作業。 請改用 Azure CLI。