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

az iot du device class

  • 参考

注意

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

设备类和设备类子组管理。

设备类描述一组设备，这些设备在设备类子组中共享一组通用属性，而设备类子组是共享同一设备类 ID 的组中的设备子集。设备类在设备更新启用的设备连接到中心时自动创建。

命令

名称 说明 类型 状态
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 class delete

删除设备类或设备类子组。

当启用了设备更新的设备连接到中心但不会自动清理设备类时，设备类会自动创建，因为它们由设备类子组引用。 如果删除目标设备类的所有设备类子组，也可以删除设备类本身以从系统中删除记录，并停止检查设备类与新更新的兼容性。 如果设备曾经重新连接，则如果设备不存在，则会重新创建其设备类。

az iot du device class delete --account
                              --cid
                              --instance
                              [--gid]
                              [--resource-group]
                              [--yes {false, true}]

示例

删除设备类。

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id}

删除设备类并跳过确认提示。

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} -y

删除设备类子组。

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id}

必需参数

--account -n

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

--cid --class-id

设备类 ID。这是从IoT 中心设备更新 PnP 接口中的设备更新代理报告的模型 ID 和兼容性属性生成的。 它是十六进制编码的 SHA1 哈希。

--instance -i

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

可选参数

--gid --group-id

设备组 ID。这是从连接的 IoT 中心 设备/模块孪生中的 ADUGroup 标记的值创建的，或者为没有标记的设备创建$default。

--resource-group -g

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

--yes -y

跳过用户提示。 指示接受操作。 主要用于自动化方案。 默认值：false。

接受的值: false, true
全局参数
--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 class list

列出设备类或设备类子组。

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

示例

列出实例中的设备类。

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

列出按友好名称筛选的实例设备类。

az iot du device class list -n {account_name} -i {instance_name} --filter "friendlyName eq 'my-favorite-class'"

列出组的设备类子组。

az iot du device class list -n {account_name} -i {instance_name} --group-id {device_group_id}

列出组的设备类子组，按 compatProperties/manufacturer 进行筛选。

az iot du device class list -n {account_name} -i {instance_name} --group-id {device_group_id} --filter "compatProperties/manufacturer eq 'Contoso'"

必需参数

--account -n

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

--instance -i

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

可选参数

--filter

如果使用 --group-id 提供，则支持基于设备类组合属性名称和值进行筛选。 例如“compatProperties/manufacturer eq 'Contoso'”。 否则，支持按类友好名称进行筛选。

--gid --group-id

设备组 ID。这是从连接的 IoT 中心 设备/模块孪生中的 ADUGroup 标记的值创建的，或者为没有标记的设备创建$default。

--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 class show

显示有关设备类或设备类子组的详细信息，包括可安装更新、最佳更新和更新符合性。

az iot du device class show --account
                            --cid
                            --instance
                            [--best-update {false, true}]
                            [--gid]
                            [--installable-updates {false, true}]
                            [--resource-group]
                            [--update-compliance {false, true}]

示例

显示设备类。

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id}

显示设备类的可安装更新。 此标志修改命令以返回列表。

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --installable-updates

显示设备类子组。

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id}

显示设备类子组可用的最佳更新。

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id} --best-update

显示设备类子组的更新符合性。

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id} --update-compliance

必需参数

--account -n

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

--cid --class-id

设备类 ID。这是从IoT 中心设备更新 PnP 接口中的设备更新代理报告的模型 ID 和兼容性属性生成的。 它是十六进制编码的 SHA1 哈希。

--instance -i

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

可选参数

--best-update

指示命令应提取设备类子组的最佳可用更新的标志，包括需要更新的设备数的计数。 此标志需要组 ID。 最佳更新是符合设备类的所有兼容性规范的最新更新。

接受的值: false, true
--gid --group-id

设备组 ID。这是从连接的 IoT 中心 设备/模块孪生中的 ADUGroup 标记的值创建的，或者为没有标记的设备创建$default。

--installable-updates

指示命令应提取设备类的可安装更新的标志。

接受的值: false, true
--resource-group -g

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

--update-compliance

指示命令应提取设备类子组更新符合性信息的标志，例如最新更新中的设备数、需要多少新更新以及接收新更新时正在进行多少个设备。 此标志需要组 ID。

接受的值: false, true
全局参数
--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 class update

更新设备类。

az iot du device class update --account
                              --cid
                              --instance
                              [--friendly-name]
                              [--resource-group]

示例

更新设备类友好名称。

az iot du device class update -n {account_name} -i {instance_name} --class-id {device_class_id} --friendly-name "EU-region"

必需参数

--account -n

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

--cid --class-id

设备类 ID。这是从IoT 中心设备更新 PnP 接口中的设备更新代理报告的模型 ID 和兼容性属性生成的。 它是十六进制编码的 SHA1 哈希。

--instance -i

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

可选参数

--friendly-name

设备类友好名称。 友好名称必须为 1 - 100 个字符，并支持字母数字、点和短划线值。

--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 获取完整的调试日志。