az iot device registration

  • Предварительный просмотр
  • Ссылка

Примечание.

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

Эта группа команд находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Управление регистрацией устройств Интернета вещей для службы подготовки устройств Интернета вещей.

Использование az iot dps enrollment registration или az iot dps enrollment-group registration просмотр и удаление регистраций.

Команды

Имя Описание Тип Состояние
az iot device registration create

Зарегистрируйте устройство Интернета вещей в службе подготовки устройств Интернета вещей.

 Расширение Предварительная версия

az iot device registration create

Предварительный просмотр

Группа команд "Регистрация устройств iot" находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Зарегистрируйте устройство Интернета вещей в службе подготовки устройств Интернета вещей.

Поддерживаются следующие механизмы аттестации:

  • Симметричный ключ
  • Сертификат x509 При использовании методов проверки подлинности x509 необходимо предоставить файлы сертификатов и ключей (и парольную фразу при необходимости).
az iot device registration create --registration-id
                                  [--auth-type {key, login}]
                                  [--certificate-file-path]
                                  [--ck]
                                  [--dps-name]
                                  [--enrollment-group-id]
                                  [--host]
                                  [--id-scope]
                                  [--key]
                                  [--key-file-path]
                                  [--login]
                                  [--pass]
                                  [--payload]
                                  [--resource-group]

Примеры

Зарегистрируйте устройство Интернета вещей с помощью отдельной регистрации.

az iot device registration create -n {dps_name} --rid {registration_id}

Зарегистрируйте устройство Интернета вещей с помощью групповой регистрации.

az iot device registration create -n {dps_name} --rid {registration_id} --gid {group_enrollment_id}

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

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

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

az iot device registration create --id-scope {id_scope} --rid {registration_id} --gid {group_enrollment_id} --key {symmetric_key} --ck

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

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

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

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

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

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file} --pass {passphrase}

Зарегистрируйте устройство Интернета вещей с помощью групповой регистрации, области идентификатора службы подготовки устройств и заданных файлов сертификатов и ключей. Это приведет к обходу извлечения области идентификатора. Обратите внимание, что идентификатор регистрации группы не нужен для аттестаций x509, а субъект файла сертификата — идентификатор регистрации.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

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

--registration-id --rid

Идентификатор регистрации устройства или отдельный идентификатор регистрации.

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

--auth-type

Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Вы можете настроить значение по умолчанию с помощью az configure --defaults iothub-data-auth-type=<auth-type-value>.

допустимые значения: key, login
значение по умолчанию: key
--certificate-file-path --cp

Путь к PEM-файлу сертификата. Требуется для регистрации x509.

--ck --compute-key

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

значение по умолчанию: False
--dps-name -n

Имя службы подготовки устройств Центр Интернета вещей Azure. Требуется, если --login не предоставляется или аргументы authenticaton и --id-область не предоставляются.

--enrollment-group-id --gid --group-id

Идентификатор группы регистрации. Требуется только для получения аргументов проверки подлинности.

--host --provisioning-host

Конечная точка, указывающая на узел подготовки для использования.

значение по умолчанию: global.azure-devices-provisioning.net
--id-scope --scope

Область идентификатора службы подготовки устройств Центр Интернета вещей Azure. Если заданы аргументы проверки подлинности, избежать входа в сеанс.

--key --symmetric-key

Симметричный общий ключ доступа для регистрации устройства.

--key-file-path --kp

Путь к файлу PEM ключа. Требуется для регистрации x509.

--login -l

Эта команда поддерживает сущность строка подключения с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если строка подключения сущности и имя указаны, строка подключения имеет приоритет. Требуется, если аргументы --dps-name не предоставляются или аргументы authenticaton и --id-область не предоставляются.

--pass --passphrase

Парольная фраза для сертификата.

--payload

Полезные данные пользовательского выделения в формате JSON. Специально для использования с настраиваемыми политиками выделения с помощью Функции Azure.

--resource-group -g

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