az iot du device class

  • Ссылка

Примечание.

Эта ссылка является частью расширения Azure-iot для Azure CLI (версия 2.37.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az iot du device class . Подробнее о расширениях.

Управление подгруппами класса устройств и класса устройств.

Класс устройства описывает набор устройств, которые совместно используют общий набор атрибутов между группами, а подгруппа класса устройства — это подмножество устройств в группе, которая использует один и тот же идентификатор класса устройства. Классы устройств создаются автоматически при подключении устройств с поддержкой обновления устройств к центру.

Команды

Имя Описание Тип Состояние
az iot du device class delete

Удалите подгруппу класса устройства или класса устройства.

 Расширение Общедоступная версия
az iot du device class list

Вывод списка классов устройств или подгрупп классов устройств.

 Расширение Общедоступная версия
az iot du device class show

Отображение сведений о подгруппе класса устройства или класса устройства, включая устанавливаемые обновления, оптимальное соответствие обновлений и обновлений.

 Расширение Общедоступная версия
az iot du device class update

Обновление класса устройства.

 Расширение Общедоступная версия

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

Имя учетной записи обновления устройства. Вы можете настроить имя учетной записи по умолчанию с помощью az config set defaults.adu_account=<name>.

--cid --class-id

Идентификатор класса устройства. Это создается из идентификатора модели и свойств compat, сообщаемых агентом обновления устройства в интерфейсе PnP обновления устройства в Центр Интернета вещей. Это хэш, закодированный в шестнадцатеричном формате SHA1.

--instance -i

Имя экземпляра обновления устройства. Можно настроить имя экземпляра по умолчанию с помощью az config set defaults.adu_instance=<name>.

Необязательные параметры

--gid --group-id

Идентификатор группы устройств. Это создается из значения тега 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Имя учетной записи обновления устройства. Вы можете настроить имя учетной записи по умолчанию с помощью 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

Идентификатор группы устройств. Это создается из значения тега 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Имя учетной записи обновления устройства. Вы можете настроить имя учетной записи по умолчанию с помощью az config set defaults.adu_account=<name>.

--cid --class-id

Идентификатор класса устройства. Это создается из идентификатора модели и свойств compat, сообщаемых агентом обновления устройства в интерфейсе PnP обновления устройства в Центр Интернета вещей. Это хэш, закодированный в шестнадцатеричном формате SHA1.

--instance -i

Имя экземпляра обновления устройства. Можно настроить имя экземпляра по умолчанию с помощью az config set defaults.adu_instance=<name>.

Необязательные параметры

--best-update

Флаг, указывающий, что команда должна получить наилучшее доступное обновление для подгруппы класса устройства, включая количество устройств, требующих обновления. Идентификатор группы необходим для этого флага. Лучшее обновление — это последнее обновление, соответствующее всем спецификациям совместимости класса устройства.

допустимые значения: false, true
--gid --group-id

Идентификатор группы устройств. Это создается из значения тега ADUGroup в двойнике устройства или модуля подключенного Центр Интернета вещей или $default для устройств без тега.

--installable-updates

Флаг, указывающий, что команда должна получать устанавливаемые обновления для класса устройства.

допустимые значения: false, true
--resource-group -g

Имя группы ресурсов учетной записи обновления устройства. Вы можете настроить расположение по умолчанию с помощью az config set defaults.adu_group=<name>.

--update-compliance

Флаг, указывающий, что команда должна получить сведения о соответствии подгруппы класса устройств, например количество устройств в последнем обновлении, количество необходимых обновлений и количество выполняемых обновлений при получении нового обновления. Идентификатор группы необходим для этого флага.

допустимые значения: false, true
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью 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

Имя учетной записи обновления устройства. Вы можете настроить имя учетной записи по умолчанию с помощью az config set defaults.adu_account=<name>.

--cid --class-id

Идентификатор класса устройства. Это создается из идентификатора модели и свойств compat, сообщаемых агентом обновления устройства в интерфейсе PnP обновления устройства в Центр Интернета вещей. Это хэш, закодированный в шестнадцатеричном формате 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

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.