az iot adr ns device

Замечание

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

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

Команды

Имя Описание Тип Состояние
az iot adr ns device list

Вывод списка устройств в пространстве имен реестра устройств.

 Расширение GA
az iot adr ns device revoke

Отмена учетных данных для устройства в пространстве имен реестра устройств.

 Расширение GA
az iot adr ns device show

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

 Расширение GA
az iot adr ns device update

Обновите устройство в пространстве имен реестра устройств.

 Расширение GA

az iot adr ns device list

Вывод списка устройств в пространстве имен реестра устройств.

az iot adr ns device list --namespace --ns
                          --resource-group

Примеры

Вывод списка всех устройств в пространстве имен

az iot adr ns device list --ns myNamespace -g myResourceGroup

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

--namespace --ns

Имя пространства имен реестра устройств.

--resource-group -g

Имя группы ресурсов. Вы можете настроить группу по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

az iot adr ns device revoke

Отмена учетных данных для устройства в пространстве имен реестра устройств.

Эта команда отменяет все активные учетные данные для указанного устройства. Устройство потребуется повторно пройти проверку подлинности и получить новые учетные данные.

Используйте --disable, чтобы также запретить устройству получать новые учетные данные.

az iot adr ns device revoke --device-name --dn --name
                            --namespace --ns
                            --resource-group
                            [--acquire-policy-token]
                            [--change-reference]
                            [--disable]
                            [--yes {false, true}]

Примеры

Отзыв учетных данных устройства

az iot adr ns device revoke -n myDevice --ns myNamespace -g myResourceGroup

Отмена учетных данных и отключение устройства

az iot adr ns device revoke -n myDevice --ns myNamespace -g myResourceGroup --disable

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

--device-name --dn --name -n

Имя устройства.

--namespace --ns

Имя пространства имен реестра устройств.

--resource-group -g

Имя группы ресурсов. Вы можете настроить группу по умолчанию с помощью az configure --defaults group=<name>.

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

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

--acquire-policy-token

Автоматическое получение маркера Azure Policy для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--disable

Отключите устройство после отзыва учетных данных. Запрещает выдачу новых учетных данных.

Свойство Значение
Default value: False
--yes -y

Пропустить запросы пользователей. Указывает на принятие действия. Используется в основном для сценариев автоматизации. По умолчанию: false.

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

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

az iot adr ns device show

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

az iot adr ns device show --device-name --dn --name
                          --namespace --ns
                          --resource-group

Примеры

Отображение сведений об устройстве

az iot adr ns device show -n myDevice --ns myNamespace -g myResourceGroup

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

--device-name --dn --name -n

Имя устройства.

--namespace --ns

Имя пространства имен реестра устройств.

--resource-group -g

Имя группы ресурсов. Вы можете настроить группу по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

az iot adr ns device update

Обновите устройство в пространстве имен реестра устройств.

az iot adr ns device update --device-name --dn --name
                            --namespace --ns
                            --resource-group
                            [--acquire-policy-token]
                            [--attributes]
                            [--change-reference]
                            [--enabled {false, true}]
                            [--os-version]
                            [--policy-resource-id]
                            [--tags]

Примеры

Отключение устройства

az iot adr ns device update -n myDevice --ns myNamespace -g myResourceGroup --enabled false

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

az iot adr ns device update -n myDevice --ns myNamespace -g myResourceGroup --os-version "2.0.1"

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

--device-name --dn --name -n

Имя устройства.

--namespace --ns

Имя пространства имен реестра устройств.

--resource-group -g

Имя группы ресурсов. Вы можете настроить группу по умолчанию с помощью az configure --defaults group=<name>.

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

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

--acquire-policy-token

Автоматическое получение маркера Azure Policy для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--attributes

Атрибуты устройства в формате JSON.

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--enabled

Включите или отключите устройство. Отключенное устройство не может пройти проверку подлинности с помощью Microsoft Entra ID.

Свойство Значение
Допустимые значения: false, true
--os-version

Версия операционной системы устройства.

--policy-resource-id

Идентификатор ресурса политики учетных данных для связывания с устройством.

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False