Поделиться через

az iot du device group

  • Ссылка

Примечание.

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

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

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

Команды

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

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

 Расширение ГА
az iot du device group list

Вывод списка групп устройств в экземпляре.

 Расширение ГА
az iot du device group show

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

 Расширение ГА

az iot du device group delete

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

Группы устройств не удаляются автоматически, но сохраняются в целях журнала. Эту операцию можно использовать, если для группы не требуется или для нее не требуется хранить журнал. Если устройство снова подключено для группы после удаления группы, она будет автоматически создана автоматически без журнала.

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

Примеры

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

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

Удалите группу устройств, пропуская запрос на подтверждение.

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

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

--account -n

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

--gid --group-id

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

--instance -i

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

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

--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
Default value: json
--query

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

--subscription

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

--verbose

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

az iot du device group list

Вывод списка групп устройств в экземпляре.

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

Примеры

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

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

Перечисление групп устройств в нужном порядке в данном случае с помощью deviceCount.

az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCount

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

--account -n

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

--instance -i

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

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

--order-by

Упорядочивает возвращаемый набор групп. Вы можете заказать по groupId, deviceCount, createdDateTime, подгруппамWithNewUpdatesAvailableCount, подгруппамWithUpdatesInProgressCount или подгруппамWithOnLatestUpdateCount.

--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
Default value: json
--query

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

--subscription

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

--verbose

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

az iot du device group show

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

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

Примеры

Отображение группы устройств.

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

Отображение лучших обновлений, доступных для группы устройств. Этот флаг изменяет команду для возврата списка.

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

Отображение соответствия обновлений для группы устройств.

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

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

--account -n

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

--gid --group-id

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

--instance -i

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

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

--best-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
Default value: json
--query

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

--subscription

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

--verbose

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