你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
使用内置直接方法来与 edgeAgent 通信
适用于：
IoT Edge 1.5 IoT Edge 1.4
重要
IoT Edge 1.5 LTS 和 IoT Edge 1.4 LTS 是受支持的版本。 IoT Edge 1.4 LTS 的生命周期结束日期为 2024 年 11 月 12 日。 如果你使用的是较低的版本，请参阅更新 IoT Edge。
使用 IoT Edge 代理模块中包含的直接方法监视和管理 IoT Edge 部署。 直接方法在设备上实现，然后可从云中调用。 IoT Edge 代理包含一些可以帮助你远程监视和管理 IoT Edge 设备的直接方法。
有关直接方法及其用法，以及如何在自己的模块中实现这些方法的详细信息，请参阅了解直接方法以及从 IoT 中心调用直接方法。
处理这些直接方法时，其名称不区分大小写。
Ping
ping 方法可用于检查 IoT Edge 是否在设备上运行，或者设备是否与 IoT 中心建立了连接。 使用此直接方法可以 ping IoT Edge 代理并获取其状态。 成功的 ping 将返回空有效负载和“状态”： 200。
例如：
az iot hub invoke-module-method --method-name 'ping' -n <hub name> -d <device name> -m '$edgeAgent'
在 Azure 门户中，调用名为 ping、包含空 JSON 有效负载 {} 的方法。
重启模块
使用 RestartModule 方法可以远程管理 IoT Edge 设备上运行的模块。 如果某个模块报告故障状态或其他不正常行为，你可以触发 IoT Edge 代理来重启该模块。 成功的 restart 命令将返回空有效负载和“状态”： 200。
RestartModule 方法可在 IoT Edge 1.0.9 和更高版本中使用。
提示
Azure 门户中的 IoT Edge 故障排除页提供了重启模块的简化体验。 有关详细信息，请参阅在 Azure 门户中对 IoT Edge 设备进行监视和故障排除。
可对 IoT Edge 设备上运行的任何模块（包括 edgeAgent 模块本身）使用 RestartModule 直接方法。 但是，如果使用此直接方法来关闭 edgeAgent，将不会收到成功结果，因为在模块重启时会中断连接。
例如：
az iot hub invoke-module-method --method-name 'RestartModule' -n <hub name> -d <device name> -m '$edgeAgent' --method-payload \
'
{
"schemaVersion": "1.0",
"id": "<module name>"
}
'
在 Azure 门户中，调用名为 RestartModule、包含以下 JSON 有效负载的方法：
{
"schemaVersion": "1.0",
"id": "<module name>"
}
诊断直接方法
- GetModuleLogs：检索直接方法的响应中内联的模块日志。
- UploadModuleLogs：检索模块日志，并将其上传到 Azure Blob 存储。
- UploadSupportBundle：使用支持捆绑检索模块日志，并将 zip 文件上传到 Azure Blob 存储。
- GetTaskStatus：检查上传日志请求或支持捆绑请求的状态。
从 1.0.10 版本起提供这些诊断直接方法。