使用代理程式檢查來尋找及修正 IoT 中樞裝置更新中遺失的裝置

了解如何使用代理程式檢查功能來尋找、診斷及修正 IoT 中樞裝置更新執行個體中遺失的裝置。

必要條件

注意

代理程式檢查功能只能在已安裝裝置更新代理程式，且會報告與 IoT 中樞裝置更新相容之 PnP 模型識別碼的裝置上執行驗證檢查。

支援的瀏覽器：

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 以確定您使用的是最新版本的延伸模組。

代理程式檢查功能目前會在符合上述先決條件的所有裝置上執行下列驗證檢查。

驗證檢查	準則
PnP 模型識別碼	PnP 模型識別碼是裝置更新代理程式向裝置對應項報告的字串，其描述裝置/雲端通訊時應該使用的 PnP 模型。此字串必須是支援裝置更新介面的有效數位對應項模型識別碼 (DTMI)。
介面識別碼	介面識別碼是裝置更新代理程式向裝置對應項回報的字串，其描述裝置/雲端通訊時應該使用的裝置更新介面識別碼版本。此字串必須是支援裝置更新介面的有效 DTMI。
相容性屬性名稱	`CompatPropertyNames` 是裝置更新代理程式向裝置對應項回報的欄位，其描述應該使用哪些 `deviceProperties` 欄位來判斷裝置與指定部署的相容性。此欄位的值必須是以逗號分隔名稱的字串。此字串至少必須包含一個名稱，但不得超過五個。每個名稱都必須 < 32 個字元。
相容性屬性值	相容性屬性值是由 `compatPropertyNames` 欄位指定的 field:value 組，且裝置更新代理程式會向裝置對應項回報為 `deviceProperties`。相容性屬性名稱中定義的每個名稱都必須具有回報的對應 field:value 組。每組的值限制為 64 個字元。
ADU 群組	ADU 群組標籤是在裝置的裝置對應項中定義的選擇性標籤，可決定裝置所屬的裝置群組。如果指定，則標籤字串限制為 255 個字元，且只能包含英數字元和下列特殊字元："." "-" "_" "~"

如果無法滿足所有準則，可能不會正確顯示在裝置更新中。更正無效值以符合指定的準則，應可讓裝置正確出現在裝置更新中。如果裝置未出現在裝置更新中，也未出現在代理程式檢查中，您可能需要執行裝置同步以解決此問題。

您可以在裝置更新的 [診斷] 索引標籤中找到代理程式檢查的結果。

使用 az iot du device health list 檢視裝置的健康情況。

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

--account：裝置更新帳戶的名稱。
--instance：裝置更新執行個體的名稱。
--filter：裝置健康情況篩選，可依裝置狀態或裝置識別碼篩選。例如：
- 若要列出所有狀況良好的裝置，請依 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 中樞註冊，但未顯示在裝置更新中，也未顯示在代理程式檢查結果中，則應該會觸發裝置同步。

每個裝置更新執行個體一次只會啟動一個裝置同步作業。

使用 az iot du device import 從連結的 IoT 中樞將裝置和模組匯入裝置更新執行個體。

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

若要深入了解裝置更新的診斷功能，請參閱裝置更新診斷功能概觀