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

az iot du device

注意

此参考是 Azure CLI（版本 2.37.0 或更高版本）的 azure-iot 扩展的一部分。 该扩展将在首次运行 az iot du device 命令时自动安装。 详细了解扩展。

设备更新设备管理。

命令

名称	说明	类型	状态
az iot du device class	设备类和设备类子组管理。	分机	GA
az iot du device class delete	删除设备类或设备类子组。	分机	GA
az iot du device class list	列出设备类或设备类子组。	分机	GA
az iot du device class show	显示有关设备类或设备类子组的详细信息，包括可安装更新、最佳更新和更新符合性。	分机	GA
az iot du device class update	更新设备类。	分机	GA
az iot du device compliance	实例视图设备符合性实用工具。	分机	GA
az iot du device compliance show	获取最新更新、有可用新更新或正在进行接收新更新的设备数的细分。	分机	GA
az iot du device deployment	设备部署管理。	分机	GA
az iot du device deployment cancel	取消设备类子组部署。	扩展	GA
az iot du device deployment create	为设备组创建部署。 部署将针对目标组中的每个设备类子组进行多转换。	扩展	GA
az iot du device deployment delete	按设备组或设备类子组删除部署。	分机	GA
az iot du device deployment list	列出设备组或设备类子组的部署。	分机	GA
az iot du device deployment list-devices	列出设备类子组部署中的设备及其状态。 可用于获取失败的设备列表。	分机	GA
az iot du device deployment retry	重试设备类子组部署。	分机	GA
az iot du device deployment show	显示设备组或设备类子组的部署，包括状态，其中详细说明了部署中有多少设备正在进行、已完成或失败。	扩展	GA
az iot du device group	设备组管理。	分机	GA
az iot du device group delete	删除设备组。	分机	GA
az iot du device group list	列出实例中的设备组。	分机	GA
az iot du device group show	显示有关设备组的详细信息，包括最佳更新和更新符合性。	扩展	GA
az iot du device health	设备运行状况检查实用工具。	扩展	GA
az iot du device health list	列出目标筛选器的设备运行状况。	分机	GA
az iot du device import	从链接IoT 中心将设备和模块导入设备更新实例。	分机	GA
az iot du device list	列出实例中包含的设备标识。	扩展	GA
az iot du device log	实例日志收集管理。	扩展	GA
az iot du device log collect	在指定设备上配置设备诊断日志收集操作。	分机	GA
az iot du device log list	列出实例诊断日志收集操作。	分机	GA
az iot du device log show	显示特定的实例诊断日志收集操作。	分机	GA
az iot du device module	设备模块管理。	分机	GA
az iot du device module show	显示导入到实例的设备模块标识。	分机	GA
az iot du device show	显示实例中包含的设备标识。	分机	GA

az iot du device import

从链接IoT 中心将设备和模块导入设备更新实例。

az iot du device import --account
                        --instance
                        [--import-type {All, Devices, Modules}]
                        [--resource-group]

示例

将设备和模块导入目标实例。

az iot du device import -n {account_name} -i {instance_name}

仅导入设备。

az iot du device import -n {account_name} -i {instance_name} --import-type Devices

仅导入模块。

az iot du device import -n {account_name} -i {instance_name} --import-type Modules

必需参数

--account -n

设备更新帐户名称。 可以使用 < a0/> 配置默认帐户名称 az config set defaults.adu_account=<name>。

--instance -i

设备更新实例名称。 可以使用 配置默认实例名称 az config set defaults.adu_instance=<name>。

可选参数

--import-type --it

要从IoT 中心导入的设备类型。

接受的值: All, Devices, Modules

默认值: All

--resource-group -g

设备更新帐户资源组名称。 可以使用 az config set defaults.adu_group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az iot du device list

列出实例中包含的设备标识。

az iot du device list --account
                      --instance
                      [--filter]
                      [--resource-group]

示例

列出目标实例中的设备标识。

az iot du device list -n {account_name} -i {instance_name}

列出按所需组 ID 筛选的目标实例中的设备标识。

az iot du device list -n {account_name} -i {instance_name} --filter "groupId eq 'myDeviceGroup'"

必需参数

--account -n

设备更新帐户名称。 可以使用 < a0/> 配置默认帐户名称 az config set defaults.adu_account=<name>。

--instance -i

设备更新实例名称。 可以使用 配置默认实例名称 az config set defaults.adu_instance=<name>。

可选参数

--filter

限制返回的设备集。 可以筛选 groupId、deviceClassId 或 groupId 和 deploymentStatus。

--resource-group -g

设备更新帐户资源组名称。 可以使用 az config set defaults.adu_group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az iot du device show

显示实例中包含的设备标识。

az iot du device show --account
                      --device-id
                      --instance
                      [--resource-group]

示例

在目标实例中显示设备标识。

az iot du device show -n {account_name} -i {instance_name} -d {device_id}

必需参数

--account -n

设备更新帐户名称。 可以使用 < a0/> 配置默认帐户名称 az config set defaults.adu_account=<name>。

--device-id -d

目标设备 ID。

--instance -i

设备更新实例名称。 可以使用 配置默认实例名称 az config set defaults.adu_instance=<name>。

可选参数

--resource-group -g

设备更新帐户资源组名称。 可以使用 az config set defaults.adu_group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。