你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用代理检查从 Device Update for IoT Hub 中查找和修复缺失的设备

了解如何使用代理检查功能来查找、诊断和修复 Device Update for IoT Hub 实例中缺失的设备。

先决条件

注意

代理检查功能只能在安装了 Device Update 代理并报告 PnP 模型 ID（与那些兼容 Device Update for IoT Hub 的设备匹配）的设备上执行验证检查。

支持的浏览器：

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 模型 ID	PnP 模型 ID 是由 Device Update 代理向设备孪生报告的字符串，用于描述应该用于设备/云通信的 PnP 模型。此字符串必须是支持 Device Update 接口的有效数字孪生模型标识符 (DTMI)。
接口 ID	接口 ID 是由 Device Update 代理向设备孪生报告的字符串，用于描述应该用于设备/云通信的 Device Update 接口版本。此字符串必须是支持 Device Update 接口的有效 DTMI。
兼容性属性名称	`CompatPropertyNames` 是 Device Update 代理向设备孪生报告的字段，用于描述应使用哪些 `deviceProperties` 字段来确定设备与给定部署的兼容性。此字段的值必须是一个包含逗号分隔名称的字符串。此字符串必须包含至少一个名称，但不超过五个名称。每个名称必须 <32 个字符。
兼容性属性值	兼容性属性值是由 `compatPropertyNames` 字段指定的 field:value 对，作为 `deviceProperties` 由 Device Update 代理报告给设备孪生。兼容性属性名称中定义的每个名称都必须报告相应的 field:value 对。每个对的值限制为 64 个字符。
ADU 组	ADU 组标记是在设备的设备孪生中定义的可选标记，用于确定设备所属的设备组。如果指定了它，则标记字符串限制为 255 个字符，只能包含字母数字字符和以下特殊字符：“.”、“-”、“_”、“~”

如果设备不符合上述任何条件，则可能不会在 Device Update 中正确显示。更正无效值以满足指定条件，设备应该就会正确显示在 Device Update 中。如果设备既未显示在 Device Update 中，也未显示在代理检查中，则可能需要运行设备同步来解决此问题。

可以在 Device Update 的“诊断”选项卡中找到代理检查的结果。

使用 az iot du device health list 查看设备的运行状况。

device health list 命令使用以下自变量：

--account：Device Update 帐户的名称。
--instance：Device Update 实例的名称。
--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 中心注册，但未显示在 Device Update 或代理检查结果中，则应触发设备同步。

每个 Device Update 实例一次只能有一个设备同步操作处于活动状态。

使用 az iot du device import 从链接的 IoT 中心将设备和模块导入 Device Update 实例。

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