az iot dps enrollment-group
Примечание.
Эта ссылка является частью расширения Azure-iot для Azure CLI (версия 2.46.0 или более поздней). Расширение автоматически установит команду az iot dps enrollment-group при первом запуске. Подробнее о расширениях.
Управление группами регистрации в службе подготовки устройств Центр Интернета вещей Azure.
Команды
Имя | Описание | Тип | Состояние |
---|---|---|---|
az iot dps enrollment-group compute-device-key |
Создайте производный ключ SAS устройства для группы регистрации в службе подготовки устройств Центр Интернета вещей Azure. |
Расширение | Общедоступная версия |
az iot dps enrollment-group create |
Создайте группу регистрации в службе подготовки устройств Центр Интернета вещей Azure. |
Расширение | Общедоступная версия |
az iot dps enrollment-group delete |
Удалите группу регистрации в службе подготовки устройств Центр Интернета вещей Azure. |
Расширение | Общедоступная версия |
az iot dps enrollment-group list |
Список групп регистрации в службе подготовки устройств Центр Интернета вещей Azure. |
Расширение | Общедоступная версия |
az iot dps enrollment-group registration |
Управление регистрацией устройств на стороне службы для группы регистрации в службе подготовки устройств Центр Интернета вещей Azure. |
Расширение | Общедоступная версия |
az iot dps enrollment-group registration delete |
Удалите регистрацию устройства для группы регистрации в службе подготовки устройств Центр Интернета вещей Azure. |
Расширение | Общедоступная версия |
az iot dps enrollment-group registration list |
Вывод списка регистраций устройств для группы регистрации в службе подготовки устройств Центр Интернета вещей Azure. |
Расширение | Общедоступная версия |
az iot dps enrollment-group registration show |
Получите регистрацию устройства для группы регистрации в службе подготовки устройств Центр Интернета вещей Azure. |
Расширение | Общедоступная версия |
az iot dps enrollment-group show |
Получение сведений о группе регистрации в службе подготовки устройств Центр Интернета вещей Azure. |
Расширение | Общедоступная версия |
az iot dps enrollment-group update |
Обновите группу регистрации в службе подготовки устройств Центр Интернета вещей Azure. |
Расширение | Общедоступная версия |
az iot dps enrollment-group compute-device-key
Создайте производный ключ SAS устройства для группы регистрации в службе подготовки устройств Центр Интернета вещей Azure.
az iot dps enrollment-group compute-device-key --registration-id
[--auth-type {key, login}]
[--dps-name]
[--eid]
[--key]
[--login]
[--resource-group]
Примеры
Вычислите ключ устройства с заданным симметричным ключом.
az iot dps enrollment-group compute-device-key --key {enrollement_group_symmetric_key} --registration-id {registration_id}
Вычислить ключ устройства с заданной группой регистрации.
az iot dps enrollment-group compute-device-key -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --registration-id {registration_id}
Обязательные параметры
Идентификатор регистрации устройства.
Необязательные параметры
Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Вы можете настроить значение по умолчанию с помощью az configure --defaults iotdps-data-auth-type=<auth-type-value>
.
Имя или имя узла службы подготовки устройств Центр Интернета вещей Azure. Требуется, если --login не указан.
Идентификатор группы регистрации.
Симметричный общий ключ доступа для группы регистрации. Это проходит реестр службы подготовки устройств и создает маркер SAS непосредственно из предоставленного симметричного ключа без дополнительной проверки. Все остальные параметры команды, кроме идентификатора регистрации, будут игнорироваться.
Эта команда поддерживает сущность строка подключения с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если строка подключения сущности и имя указаны, строка подключения имеет приоритет. Обязательный параметр , если --dps-name не указан.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az iot dps enrollment-group create
Создайте группу регистрации в службе подготовки устройств Центр Интернета вещей Azure.
Укажите формат сертификата, используя кодировку Base64 ASCII, и сертификат должен иметь соответствующие сегменты BEGIN и END, например, начать с "-----BEGIN CERTIFICATE-----" и завершиться "-----END CERTIFICATE-----".
az iot dps enrollment-group create --eid
[--allocation-policy {custom, geoLatency, hashed, static}]
[--api-version]
[--auth-type {key, login}]
[--ca-name]
[--certificate-path]
[--dps-name]
[--edge-enabled {false, true}]
[--ih]
[--initial-twin-properties]
[--initial-twin-tags]
[--login]
[--pk]
[--provisioning-status {disabled, enabled}]
[--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scn]
[--scp]
[--secondary-key]
[--webhook-url]
Примеры
Создайте группу регистрации "{enrollment_id}" в службе подготовки Интернета вещей Azure "{dps_name}" в группе ресурсов "{resource_group_name} с использованием промежуточного сертификата в качестве первичного сертификата".
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem
Создайте группу регистрации "{enrollment_id}" в службе подготовки Интернета вещей Azure "{dps_name}" в группе ресурсов "{resource_group_name} с помощью сертификата ЦС {certificate_name} в качестве дополнительного сертификата.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name}
Создайте группу регистрации "{enrollment_id}" в службе подготовки Интернета вещей Azure "MyDps" в группе ресурсов "{resource_group_name}" с состоянием подготовки "включено", начальными свойствами двойников "{"location":{"region":"US"}" и начальными тегами двойников "{"version_dps":"1"}" с использованием промежуточного сертификата в качестве первичного сертификата.
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem --provisioning-status enabled --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version_dps':'1'}"
Создайте группу регистрации "{enrollment_id}" в службе подготовки Интернета вещей Azure "{dps_name}" в группе ресурсов "{resource_group_name} с типом аттестации "симметричный ключ".
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {primary_key} --secondary-key {secondary_key}
Создайте группу регистрации "{enrollment_id}" с настраиваемой политикой выделения,
az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy custom --webhook-url {webhook_url} --api-version {api_version}
Обязательные параметры
Идентификатор группы регистрации.
Необязательные параметры
Тип политики выделения, чтобы определить, как устройство назначается Центр Интернета вещей. Если это не указано, политика выделения будет текущей политикой выделения по умолчанию для экземпляра службы подготовки устройств.
Версия API типов служб подготовки, отправленных в пользовательском запросе на выделение. Минимальная поддерживаемая версия: 2018-09-01-preview.
Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Вы можете настроить значение по умолчанию с помощью az configure --defaults iotdps-data-auth-type=<auth-type-value>
.
Имя первичного корневого сертификата ЦС. Если требуется аттестация с сертификатом корневого ЦС, необходимо указать имя корневого ЦС.
Путь к файлу, содержаму первичный сертификат. Если требуется аттестация с промежуточным сертификатом, необходимо указать путь к сертификату.
Имя или имя узла службы подготовки устройств Центр Интернета вещей Azure. Требуется, если --login не указан.
Флаг, указывающий включение ребра.
Имя узла целевой Центр Интернета вещей, связанной с политикой выделения. Используйте разделенный пробелами список для нескольких Центр Интернета вещей.
Начальные свойства двойника устройства.
Начальные теги двойника устройства.
Эта команда поддерживает сущность строка подключения с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если строка подключения сущности и имя указаны, строка подключения имеет приоритет. Обязательный параметр , если --dps-name не указан.
Первичный симметричный общий ключ доступа, хранящийся в формате Base64.
Включение или отключение записи регистрации.
Политика, чтобы определить, как следует обрабатывать данные устройства при повторной подготовке в другой Центр Интернета вещей.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Имя вторичного корневого сертификата ЦС. Если требуется аттестация с сертификатом корневого ЦС, необходимо указать имя корневого ЦС.
Путь к файлу, содержаму вторичный сертификат. Если требуется аттестация с промежуточным сертификатом, необходимо указать путь к сертификату.
Вторичный симметричный общий ключ доступа, хранящийся в формате Base64.
URL-адрес веб-перехватчика функции Azure, используемый для пользовательских запросов на выделение.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az iot dps enrollment-group delete
Удалите группу регистрации в службе подготовки устройств Центр Интернета вещей Azure.
az iot dps enrollment-group delete --eid
[--auth-type {key, login}]
[--dps-name]
[--etag]
[--login]
[--resource-group]
Обязательные параметры
Идентификатор группы регистрации.
Необязательные параметры
Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Вы можете настроить значение по умолчанию с помощью az configure --defaults iotdps-data-auth-type=<auth-type-value>
.
Имя или имя узла службы подготовки устройств Центр Интернета вещей Azure. Требуется, если --login не указан.
Тег Etag или сущности, соответствующий последнему состоянию ресурса. Если etag не указан, используется значение "*".
Эта команда поддерживает сущность строка подключения с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если строка подключения сущности и имя указаны, строка подключения имеет приоритет. Обязательный параметр , если --dps-name не указан.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az iot dps enrollment-group list
Список групп регистрации в службе подготовки устройств Центр Интернета вещей Azure.
az iot dps enrollment-group list [--auth-type {key, login}]
[--dps-name]
[--login]
[--resource-group]
[--top]
Необязательные параметры
Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Вы можете настроить значение по умолчанию с помощью az configure --defaults iotdps-data-auth-type=<auth-type-value>
.
Имя или имя узла службы подготовки устройств Центр Интернета вещей Azure. Требуется, если --login не указан.
Эта команда поддерживает сущность строка подключения с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если строка подключения сущности и имя указаны, строка подключения имеет приоритет. Обязательный параметр , если --dps-name не указан.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Максимальное количество возвращаемых элементов. Используйте -1 для неограниченного количества.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az iot dps enrollment-group show
Получение сведений о группе регистрации в службе подготовки устройств Центр Интернета вещей Azure.
az iot dps enrollment-group show --eid
[--auth-type {key, login}]
[--dps-name]
[--keys {false, true}]
[--login]
[--resource-group]
Примеры
Базовое использование
az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {enrollment_id}
Включение полных сведений аттестации в результаты для группы регистрации симметричного ключа
az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {symmetric_key_enrollment_id} --show-keys
Обязательные параметры
Идентификатор группы регистрации.
Необязательные параметры
Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Вы можете настроить значение по умолчанию с помощью az configure --defaults iotdps-data-auth-type=<auth-type-value>
.
Имя или имя узла службы подготовки устройств Центр Интернета вещей Azure. Требуется, если --login не указан.
Включите ключи аттестации и сведения в результаты группы регистрации.
Эта команда поддерживает сущность строка подключения с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если строка подключения сущности и имя указаны, строка подключения имеет приоритет. Обязательный параметр , если --dps-name не указан.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az iot dps enrollment-group update
Обновите группу регистрации в службе подготовки устройств Центр Интернета вещей Azure.
Укажите формат сертификата, используя кодировку Base64 ASCII, и сертификат должен иметь соответствующие сегменты BEGIN и END, например, начать с "-----BEGIN CERTIFICATE-----" и завершиться "-----END CERTIFICATE-----".
az iot dps enrollment-group update --eid
[--allocation-policy {custom, geoLatency, hashed, static}]
[--api-version]
[--auth-type {key, login}]
[--ca-name]
[--certificate-path]
[--dps-name]
[--edge-enabled {false, true}]
[--etag]
[--ih]
[--initial-twin-properties]
[--initial-twin-tags]
[--login]
[--pk]
[--provisioning-status {disabled, enabled}]
[--rc {false, true}]
[--remove-secondary-certificate {false, true}]
[--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scn]
[--scp]
[--secondary-key]
[--webhook-url]
Примеры
Обновите группу регистрации "{enrollment_id}" в службе подготовки Интернета вещей Azure "{dps_name}" в группе ресурсов "{resource_group_name}" с начальными свойствами двойников и тегами исходных двойников.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --initial-twin-properties "{'location':{'region':'USA'}}" --initial-twin-tags "{'version_dps':'2'}" --etag AAAAAAAAAAA=
Обновите группу регистрации "{enrollment_id}" в службе подготовки Интернета вещей Azure "{dps_name}" в группе ресурсов "{resource_group_name}" с новым первичным промежуточным сертификатом и удалите существующий вторичный промежуточный сертификат.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/NewCertificate.pem --remove-secondary-certificate --etag AAAAAAAAAAA=
Обновите группу регистрации "{enrollment_id}" в службе подготовки Интернета вещей Azure "{dps_name}" в группе ресурсов "{resource_group_name}" с новым вторичным сертификатом ЦС "{certificate_name}" и удалите существующий первичный сертификат ЦС.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name} --remove-certificate --etag AAAAAAAAAAA=
Обновите группу регистрации "{enrollment_id}" в службе подготовки Интернета вещей Azure "{dps_name}" в группе ресурсов "{resource_group_name}" с новым первичным ключом.
az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {new_primary_key} --etag AAAAAAAAAAA=
Обязательные параметры
Идентификатор группы регистрации.
Необязательные параметры
Тип политики выделения, чтобы определить, как устройство назначается Центр Интернета вещей. Если это не указано, политика выделения будет текущей политикой выделения по умолчанию для экземпляра службы подготовки устройств.
Версия API типов служб подготовки, отправленных в пользовательском запросе на выделение. Минимальная поддерживаемая версия: 2018-09-01-preview.
Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Вы можете настроить значение по умолчанию с помощью az configure --defaults iotdps-data-auth-type=<auth-type-value>
.
Имя первичного корневого сертификата ЦС. Если требуется аттестация с сертификатом корневого ЦС, необходимо указать имя корневого ЦС.
Путь к файлу, содержаму первичный сертификат. Если требуется аттестация с промежуточным сертификатом, необходимо указать путь к сертификату.
Имя или имя узла службы подготовки устройств Центр Интернета вещей Azure. Требуется, если --login не указан.
Флаг, указывающий включение ребра.
Тег Etag или сущности, соответствующий последнему состоянию ресурса. Если etag не указан, используется значение "*".
Имя узла целевой Центр Интернета вещей, связанной с политикой выделения. Используйте разделенный пробелами список для нескольких Центр Интернета вещей.
Начальные свойства двойника устройства.
Начальные теги двойника устройства.
Эта команда поддерживает сущность строка подключения с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если строка подключения сущности и имя указаны, строка подключения имеет приоритет. Обязательный параметр , если --dps-name не указан.
Первичный симметричный общий ключ доступа, хранящийся в формате Base64.
Включение или отключение записи регистрации.
Пометка для удаления текущего первичного сертификата.
Пометка для удаления текущего вторичного сертификата.
Политика, чтобы определить, как следует обрабатывать данные устройства при повторной подготовке в другой Центр Интернета вещей.
Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>
.
Имя вторичного корневого сертификата ЦС. Если требуется аттестация с сертификатом корневого ЦС, необходимо указать имя корневого ЦС.
Путь к файлу, содержаму вторичный сертификат. Если требуется аттестация с промежуточным сертификатом, необходимо указать путь к сертификату.
Вторичный симметричный общий ключ доступа, хранящийся в формате Base64.
URL-адрес веб-перехватчика функции Azure, используемый для пользовательских запросов на выделение.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.