使用 agent check 查找並修正 IoT 中樞裝置更新中缺少的裝置

學習如何使用代理檢查功能來尋找、診斷並修正 IoT 中樞裝置更新實例中缺少的裝置。

先決條件

Note

代理檢查功能只能對已安裝裝置更新代理且回報與 IoT 中樞裝置更新相容的 PnP 型號 ID 的裝置進行驗證檢查。

支援的瀏覽器：

Azure CLI 環境：

在 Azure Cloud Shell 中使用 Bash 環境。
或者，如果你想在本地執行 CLI 參考指令，可以安裝 Azure CLI
1. 使用 az login 命令來登入 Azure CLI。
2. 執行 az version 以尋找已安裝的版本和相依程式庫。若要升級至最新版本，請執行 az upgrade。
3. 出現提示時，請在第一次使用時安裝 Azure CLI 擴充功能。本文中的指令使用 azure-iot 擴充功能。執行 az extension update --name azure-iot，確認你使用的是最新版本的擴充功能。

代理檢查功能目前對所有符合上述先決條件的裝置執行以下驗證檢查。

驗證檢查	Criteria
PnP模型ID	PnP 模型 ID 是由裝置更新代理回報給裝置雙胞胎的字串，描述裝置與雲端通訊應該使用哪種 PnP 模型。此字串必須是有效的數位孿生型號識別碼（DTMI），並支援裝置更新介面。
介面識別碼	介面 ID 是一個由裝置更新代理程式回報至裝置對應項的字串，用來描述裝置與雲端通訊時應使用哪個裝置更新介面版本。此字串必須是有效的 DTMI，且支援裝置更新介面。
相容性屬性名稱	`CompatPropertyNames` 是裝置更新代理向裝置雙胞胎回報的欄位。它描述了用哪些 `deviceProperties` 欄位來判斷裝置與特定部署的相容性。此欄位的值必須是一串逗號分隔的名稱。字串必須包含至少一個且不超過五個名稱。每個名字必須少於32個字元。
相容性屬性值	相容性屬性值是由 `compatPropertyNames` 欄位指定的欄位:值配對，並由裝置更新代理程式以 `deviceProperties` 的形式回報到裝置對應項。在相容性屬性名稱中定義的每個名稱，都必須回報對應的欄位:值配對。每對字元的值限制為64個字元。
ADU 集團	ADU 群組標籤是您可在裝置的裝置對應項中定義的選用標籤。它決定該裝置屬於哪個裝置群組。若另有指定，標籤字串限制為 255 個字元，且只能包含字母數字及以下特殊字元：「。」"-" "_" "~"

如果裝置未達上述任何一項標準，可能無法在裝置更新中正確顯示。將無效值修正為符合指定條件後，裝置應該會正確出現在裝置更新中。如果裝置在裝置更新或代理檢查中都沒有顯示，你可能需要執行裝置同步來解決這個問題。

代理檢查的結果可在裝置更新的診斷標籤中取得。

使用 az iot du 裝置健康清單來查看裝置的健康狀況。

device health list 命令採用下列引數：

--account：裝置更新帳號名稱。
--instance：裝置更新實例的名稱。
--filter：一個裝置健康過濾器，可以根據裝置狀態或裝置ID進行過濾。例如：
- 要列出所有健康裝置，請篩選 state eq 'Healthy'
- 要列出所有不健康的裝置，請篩選 state eq 'Unhealthy'
- 若要顯示目標裝置的健康狀態，可依 deviceId eq '<device_name>' 或 deviceId eq '<device_name>' and moduleId eq '<module_name>' 篩選

az iot du device health list --account <Device Update account name> --instance <Device Update instance name> --filter "<filter query>"

如果裝置已在 IoT Hub 註冊，但未出現在裝置更新或代理檢查結果中，應該會觸發裝置同步。

每個裝置更新實例同時只能啟用一個裝置同步操作。

使用 az iot du device import 從連結的物聯網中樞匯入裝置和模組到 Device Update 實例。

az iot du device import --account <Device Update account name> --instance <Device Update instance name>

欲了解更多 Device Update 的診斷功能，請參閱 Device Update 診斷功能總覽

此頁面對您有幫助嗎？