az iot hub
Note
Эта группа команд содержит команды, определенные как в Azure CLI, так и в одном расширении. Установите каждое расширение, чтобы воспользоваться расширенными возможностями. Learn more about extensions.
Управление центрами Интернета вещей Azure.
Команды
Имя | Описание | Тип | Состояние |
---|---|---|---|
az iot hub certificate |
Управление сертификатами Центра Интернета вещей. |
Core | GA |
az iot hub certificate create |
Создание или отправка сертификата Центр Интернета вещей Azure. |
Core | GA |
az iot hub certificate delete |
Удаляет сертификат Центра Интернета вещей Azure. |
Core | GA |
az iot hub certificate generate-verification-code |
Создает код проверки для сертификата Центра Интернета вещей Azure. |
Core | GA |
az iot hub certificate list |
Выводит список всех сертификатов, содержащихся в Центр Интернета вещей Azure. |
Core | GA |
az iot hub certificate show |
Отображает сведения о конкретном сертификате Центр Интернета вещей Azure. |
Core | GA |
az iot hub certificate update |
Обновите сертификат Центр Интернета вещей Azure. |
Core | GA |
az iot hub certificate verify |
Проверяет сертификат Центра Интернета вещей Azure. |
Core | GA |
az iot hub configuration |
Реализовано управление конфигурацией автоматического управления устройствами в центре Интернета вещей в большом масштабе. |
Extension | GA |
az iot hub configuration create |
Создайте конфигурацию автоматического управления устройствами Интернета вещей в целевой Центр Интернета вещей. |
Extension | GA |
az iot hub configuration delete |
Удаление конфигурации устройства Интернета вещей. |
Extension | GA |
az iot hub configuration list |
Вывод списка конфигураций автоматического управления устройствами Интернета вещей в Центре Интернета вещей. |
Extension | GA |
az iot hub configuration show |
Получите сведения о конфигурации автоматического управления устройствами Интернета вещей. |
Extension | GA |
az iot hub configuration show-metric |
Оцените целевой пользователь или системную метрику, определенную в конфигурации устройства Интернета вещей. |
Extension | GA |
az iot hub configuration update |
Обновите указанные свойства конфигурации автоматического управления устройствами Интернета вещей. |
Extension | GA |
az iot hub connection-string |
Управление Центр Интернета вещей строка подключения. |
Extension | GA |
az iot hub connection-string show |
Отображение строка подключения для указанных Центр Интернета вещей с помощью заданного имени политики и ключа. |
Extension | GA |
az iot hub consumer-group |
Управление группами потребителей концентратора событий Центра Интернета вещей. |
Core | GA |
az iot hub consumer-group create |
Создайте группу потребителей концентратора событий. |
Core | GA |
az iot hub consumer-group delete |
Удаление группы потребителей концентратора событий. |
Core | GA |
az iot hub consumer-group list |
Вывод списка групп потребителей концентратора событий. |
Core | GA |
az iot hub consumer-group show |
Получение сведений о группе потребителей концентратора событий. |
Core | GA |
az iot hub create |
Создайте Центр Интернета вещей Azure. |
Core | GA |
az iot hub delete |
Удаление центра Интернета вещей. |
Core | GA |
az iot hub device-identity |
Управление устройствами Интернета вещей. |
Extension | GA |
az iot hub device-identity children |
Управление связями дочерних устройств для устройств IoT edge. |
Extension | GA |
az iot hub device-identity children add |
Добавьте устройства в качестве дочерних устройств в целевое пограничное устройство. |
Extension | GA |
az iot hub device-identity children list |
Выводит коллекцию назначенных дочерних устройств. |
Extension | GA |
az iot hub device-identity children remove |
Удалите дочерние устройства с целевого пограничного устройства. |
Extension | GA |
az iot hub device-identity connection-string |
Управление строка подключения устройства Интернета вещей. |
Extension | GA |
az iot hub device-identity connection-string show |
Отображение заданного Центр Интернета вещей устройства строка подключения. |
Extension | GA |
az iot hub device-identity create |
Создайте устройство в Центре Интернета вещей. |
Extension | GA |
az iot hub device-identity delete |
Удаление устройства Центра Интернета вещей. |
Extension | GA |
az iot hub device-identity export |
Экспортируйте все удостоверения устройств из Центр Интернета вещей в контейнер больших двоичных объектов служба хранилища Azure. |
Extension | GA |
az iot hub device-identity import |
Импорт удостоверений устройства в Центр Интернета вещей из большого двоичного объекта контейнера хранилища. |
Extension | GA |
az iot hub device-identity list |
Вывод списка устройств в Центр Интернета вещей. |
Extension | GA |
az iot hub device-identity parent |
Управление отношениями родительского устройства для устройств Интернета вещей. |
Extension | GA |
az iot hub device-identity parent set |
Задайте родительское устройство целевого устройства. |
Extension | GA |
az iot hub device-identity parent show |
Получите родительское устройство целевого устройства. |
Extension | GA |
az iot hub device-identity renew-key |
Продление целевых ключей устройств Центр Интернета вещей с проверкой подлинности SAS. |
Extension | GA |
az iot hub device-identity show |
Получение сведений об устройстве Центра Интернета вещей. |
Extension | GA |
az iot hub device-identity update |
Обновите устройство Центра Интернета вещей. |
Extension | GA |
az iot hub device-twin |
Управление конфигурацией двойника устройств Интернета вещей. |
Extension | GA |
az iot hub device-twin list |
Вывод списка двойников устройств в Центр Интернета вещей. |
Extension | GA |
az iot hub device-twin replace |
Замените определение двойника устройства целевым json. |
Extension | GA |
az iot hub device-twin show |
Получение определения двойника устройства. |
Extension | GA |
az iot hub device-twin update |
Обновите нужные свойства и теги двойника устройства. |
Extension | GA |
az iot hub devicestream |
Управление потоками устройств Центра Интернета вещей. |
Core | Preview |
az iot hub devicestream show |
Получение конечных точек потоков устройств Центр Интернета вещей. |
Core | Preview |
az iot hub digital-twin |
Управляйте цифровым двойником Центр Интернета вещей устройства и взаимодействуйте с ним. |
Extension | GA |
az iot hub digital-twin invoke-command |
Вызов команды корневого или компонента устройства цифрового двойника. |
Extension | GA |
az iot hub digital-twin show |
Отображение цифрового двойника устройства Центр Интернета вещей. |
Extension | GA |
az iot hub digital-twin update |
Обновите свойства устройства цифрового двойника с помощью спецификации исправления JSON. |
Extension | GA |
az iot hub distributed-tracing |
Управление распределенными параметрами для каждого устройства. |
Extension | Preview |
az iot hub distributed-tracing show |
Получите параметры распределенной трассировки для устройства. |
Extension | Preview |
az iot hub distributed-tracing update |
Обновите параметры распределенной трассировки для устройства. |
Extension | Preview |
az iot hub generate-sas-token |
Создайте маркер SAS для целевого Центра Интернета вещей, устройства или модуля. |
Extension | GA |
az iot hub identity |
Управление удостоверениями Центра Интернета вещей Azure. |
Core | GA |
az iot hub identity assign |
Назначьте управляемые удостоверения Центр Интернета вещей. |
Core | GA |
az iot hub identity remove |
Удалите управляемые удостоверения из Центр Интернета вещей. |
Core | GA |
az iot hub identity show |
Отображение свойств удостоверения Центр Интернета вещей. |
Core | GA |
az iot hub invoke-device-method |
Вызов метода устройства. |
Extension | GA |
az iot hub invoke-module-method |
Вызов метода модуля. |
Extension | GA |
az iot hub job |
Управление заданиями Центр Интернета вещей (версия 2). |
Extension | GA |
az iot hub job cancel |
Отмена задания Центр Интернета вещей. |
Extension | GA |
az iot hub job create |
Создание и планирование задания Центр Интернета вещей для выполнения. |
Extension | GA |
az iot hub job list |
Перечислить исторические задания Центр Интернета вещей. |
Extension | GA |
az iot hub job show |
Отображение сведений о существующем задании Центр Интернета вещей. |
Extension | GA |
az iot hub list |
Вывод списка центров Интернета вещей. |
Core | GA |
az iot hub list-skus |
Перечисление доступных ценовых категорий. |
Core | GA |
az iot hub manual-failover |
Инициация перехода на другой ресурс вручную для Центра Интернета вещей в связанный географический регион аварийного восстановления. |
Core | GA |
az iot hub message-endpoint |
Управление пользовательскими конечными точками Центра Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint create |
Добавьте конечную точку в Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint create cosmosdb-container |
Добавьте конечную точку контейнера Cosmos DB для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint create eventhub |
Добавьте конечную точку Концентратора событий для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint create servicebus-queue |
Добавьте конечную точку очереди служебная шина для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint create servicebus-topic |
Добавьте конечную точку раздела служебная шина для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint create storage-container |
Добавьте конечную точку контейнера хранилища для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint delete |
Удалите все или определенную конечную точку для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint list |
Получите сведения обо всех конечных точках для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint show |
Получите сведения о указанной конечной точке для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint update |
Обновите свойства существующей конечной точки для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint update cosmosdb-container |
Обновите свойства существующей конечной точки контейнера Cosmos DB для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint update eventhub |
Обновите свойства существующей конечной точки Концентратора событий для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint update servicebus-queue |
Обновите свойства существующей конечной точки очереди служебная шина для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint update servicebus-topic |
Обновите свойства существующей конечной точки раздела служебная шина для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-endpoint update storage-container |
Обновите свойства существующей конечной точки контейнера хранилища для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-enrichment |
Управление обогащением сообщений для конечных точек Центра Интернета вещей. |
Core | GA |
az iot hub message-enrichment create |
Создайте обогащение сообщений для выбранных конечных точек в Центр Интернета вещей. |
Core | GA |
az iot hub message-enrichment delete |
Удаление обогащения сообщений в Центре Интернета вещей (по ключу). |
Core | GA |
az iot hub message-enrichment list |
Получите сведения обо всех обогащениях сообщений для Центр Интернета вещей. |
Core | GA |
az iot hub message-enrichment update |
Обновите обогащение сообщений в Центре Интернета вещей (по ключу). |
Core | GA |
az iot hub message-route |
Управление маршрутами Центра Интернета вещей. |
Extension | Preview |
az iot hub message-route create |
Добавьте маршрут для Центр Интернета вещей. |
Extension | Preview |
az iot hub message-route delete |
Удалите все маршруты или упомянутый маршрут в Центр Интернета вещей. |
Extension | Preview |
az iot hub message-route fallback |
Управление резервным маршрутом Центра Интернета вещей. |
Extension | Preview |
az iot hub message-route fallback set |
Включите или отключите резервный маршрут в Центр Интернета вещей. |
Extension | Preview |
az iot hub message-route fallback show |
Отображение резервного маршрута Центр Интернета вещей. |
Extension | Preview |
az iot hub message-route list |
Получите все маршруты в Центр Интернета вещей. |
Extension | Preview |
az iot hub message-route show |
Получение сведений о маршруте в Центр Интернета вещей. |
Extension | Preview |
az iot hub message-route test |
Проверьте все маршруты или упомянутый маршрут в Центр Интернета вещей. |
Extension | Preview |
az iot hub message-route update |
Обновите маршрут для Центр Интернета вещей. |
Extension | Preview |
az iot hub module-identity |
Управление модулями устройств Интернета вещей. |
Extension | GA |
az iot hub module-identity connection-string |
Управление строка подключения модуля устройства Интернета вещей. |
Extension | GA |
az iot hub module-identity connection-string show |
Отображение целевого модуля устройства Интернета вещей строка подключения. |
Extension | GA |
az iot hub module-identity create |
Создайте модуль на целевом устройстве Интернета вещей в Центре Интернета вещей. |
Extension | GA |
az iot hub module-identity delete |
Удалите устройство в Центр Интернета вещей. |
Extension | GA |
az iot hub module-identity list |
Вывод списка модулей, расположенных на устройстве Интернета вещей в Центр Интернета вещей. |
Extension | GA |
az iot hub module-identity renew-key |
Продление целевых ключей модулей устройств Центр Интернета вещей с проверкой подлинности SAS. |
Extension | GA |
az iot hub module-identity show |
Получение сведений о модуле устройства Интернета вещей в Центре Интернета вещей. |
Extension | GA |
az iot hub module-identity update |
Обновите модуль устройства Центр Интернета вещей. |
Extension | GA |
az iot hub module-twin |
Управление конфигурацией двойников устройств Интернета вещей. |
Extension | GA |
az iot hub module-twin replace |
Замените определение двойника модуля целевым json. |
Extension | GA |
az iot hub module-twin show |
Отображение определения двойника модуля. |
Extension | GA |
az iot hub module-twin update |
Обновление нужных свойств и тегов двойника модуля. |
Extension | GA |
az iot hub monitor-events |
Отслеживайте данные телеметрии устройства и сообщения, отправленные в Центр Интернета вещей. |
Extension | GA |
az iot hub monitor-feedback |
Мониторинг ответов, отправляемых устройствами для подтверждения обмена сообщениями, передаваемых из облака на устройство (C2D). |
Extension | GA |
az iot hub policy |
Управление политиками общего доступа Центра Интернета вещей. |
Core | GA |
az iot hub policy create |
Создайте новую политику общего доступа в Центре Интернета вещей. |
Core | GA |
az iot hub policy delete |
Удалите политику общего доступа из Центра Интернета вещей. |
Core | GA |
az iot hub policy list |
Список политик общего доступа центра Интернета вещей. |
Core | GA |
az iot hub policy renew-key |
Повторно создайте ключи политики общего доступа центра Интернета вещей. |
Core | GA |
az iot hub policy show |
Получение сведений о политике общего доступа центра Интернета вещей. |
Core | GA |
az iot hub query |
Запрос к Центру Интернета вещей с помощью мощного языка SQL. |
Extension | GA |
az iot hub show |
Получение сведений о Центре Интернета вещей. |
Core | GA |
az iot hub show-quota-metrics |
Получение метрик квоты для Центра Интернета вещей. |
Core | GA |
az iot hub show-stats |
Получение статистики для Центра Интернета вещей. |
Core | GA |
az iot hub state |
Управление состоянием Центр Интернета вещей. |
Extension | Experimental |
az iot hub state export |
Экспорт состояния Центр Интернета вещей в файл. |
Extension | Experimental |
az iot hub state import |
Импорт состояния концентратора из файла в Центр Интернета вещей. |
Extension | Experimental |
az iot hub state migrate |
Перенос состояния одного концентратора в другой, не сохраняя его в файл. |
Extension | Experimental |
az iot hub update |
Обновление метаданных для Центра Интернета вещей. |
Core | GA |
az iot hub wait |
Дождитесь завершения операции в экземпляре Центр Интернета вещей. |
Core | GA |
az iot hub create
Создайте Центр Интернета вещей Azure.
Общие сведения о Центр Интернета вещей Azure см. в статье https://learn.microsoft.com/azure/iot-hub/.
az iot hub create --name
--resource-group
[--c2d-max-delivery-count --cdd]
[--c2d-ttl --ct]
[--dds --disable-device-sas {false, true}]
[--disable-local-auth --dla {false, true}]
[--disable-module-sas --dms {false, true}]
[--edr --enforce-data-residency {false, true}]
[--fc --fileupload-storage-container-name]
[--fcs --fileupload-storage-connectionstring]
[--fd --feedback-max-delivery-count]
[--feedback-lock-duration --fld]
[--feedback-ttl --ft]
[--fileupload-notification-lock-duration --fnld]
[--fileupload-notification-max-delivery-count --fnd]
[--fileupload-notification-ttl --fnt]
[--fileupload-notifications --fn {false, true}]
[--fileupload-sas-ttl --fst]
[--fileupload-storage-auth-type --fsa {identityBased, keyBased}]
[--fileupload-storage-identity --fsi]
[--location]
[--mi-system-assigned {false, true}]
[--mi-user-assigned]
[--min-tls-version --mintls]
[--no-wait]
[--partition-count]
[--rd --retention-day]
[--role]
[--scopes]
[--sku {B1, B2, B3, F1, S1, S2, S3}]
[--tags]
[--unit]
Примеры
Создайте Центр Интернета вещей с бесплатной ценовой категорией F1 в регионе группы ресурсов.
az iot hub create --resource-group MyResourceGroup --name MyIotHub --sku F1 --partition-count 2
Создайте Центр Интернета вещей со стандартной ценовой категорией S1 и 4 в регионе "westus" с тегами.
az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --tags a=b c=d
Создайте Центр Интернета вещей с управляемым удостоверением, назначаемое системой, и назначьте роль и область учетной записи хранения для созданного удостоверения.
az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --mi-system-assigned --role "Storage Blob Data Contributor" --scopes {resourceId}
Создание Центра Интернета вещей с локальной проверкой подлинности, ключами SAS устройства и ключами SAS модуля все отключены
az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --disable-local-auth --disable-device-sas --disable-module-sas
Создайте Центр Интернета вещей с применением расположения данных. Это приведет к отключению аварийного восстановления между регионами.
az iot hub create --resource-group MyResourceGroup --name MyIoTHub --edr
Обязательные параметры
Имя Центра Интернета вещей.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Количество попыток доставки сообщения из облака в устройство в Центр Интернета вещей от 1 до 100.
Свойство | Значение |
---|---|
Default value: | 10 |
Время, когда устройство будет использовать сообщение до истечения срока действия Центра Интернета вещей, от 1 до 48 часов.
Свойство | Значение |
---|---|
Default value: | 1 |
Логическое значение, указывающее, следует ли отключать все устройства (включая пограничные устройства, кроме модулей), ограниченные ключами SAS для проверки подлинности.
Свойство | Значение |
---|---|
Допустимые значения: | false, true |
Логическое значение, указывающее, следует ли отключить ключи SAS центра Интернета вещей для проверки подлинности.
Свойство | Значение |
---|---|
Допустимые значения: | false, true |
Логическое значение, указывающее, следует ли отключить ключи SAS с областью действия модуля для проверки подлинности.
Свойство | Значение |
---|---|
Допустимые значения: | false, true |
Принудительное размещение данных для этого Центра Интернета вещей путем отключения аварийного восстановления между регионами. Это свойство неизменяемо после установки ресурса. Доступно только в выборе регионов. Узнайте больше на сайте https://aka.ms/iothubdisabledr.
Свойство | Значение |
---|---|
Допустимые значения: | false, true |
Имя корневого контейнера, в котором вы отправляете файлы. Контейнер не должен существовать, но должен быть настраиваемым с помощью указанного connectionString.
Строка подключения для учетной записи хранения Azure, в которую отправляются файлы.
Количество попыток доставки сообщения в очереди отзывов центра Интернета вещей в диапазоне от 1 до 100.
Свойство | Значение |
---|---|
Default value: | 10 |
Длительность блокировки для очереди отзывов составляет от 5 до 300 секунд.
Свойство | Значение |
---|---|
Default value: | 5 |
Период времени, для которого Центр Интернета вещей будет поддерживать отзывы о истечении срока действия или доставке сообщений из облака на устройство в период от 1 до 48 часов.
Свойство | Значение |
---|---|
Default value: | 1 |
Длительность блокировки очереди уведомлений о отправке файла составляет от 5 до 300 секунд.
Свойство | Значение |
---|---|
Default value: | 5 |
Количество попыток доставки сообщения уведомления о файле в центре Интернета вещей в диапазоне от 1 до 100.
Свойство | Значение |
---|---|
Default value: | 10 |
Время отправки файла доступно для службы до истечения срока действия Центра Интернета вещей в период от 1 до 48 часов.
Свойство | Значение |
---|---|
Default value: | 1 |
Логическое значение, указывающее, следует ли регистрировать сведения о отправленных файлах в конечную точку Центра Интернета вещей.
Свойство | Значение |
---|---|
Default value: | False |
Допустимые значения: | false, true |
Срок действия URI SAS, созданного Центром Интернета вещей, действителен до истечения срока его действия в диапазоне от 1 до 24 часов.
Свойство | Значение |
---|---|
Default value: | 1 |
Тип проверки подлинности для учетной записи хранения Azure, в которую отправляются файлы.
Свойство | Значение |
---|---|
Допустимые значения: | identityBased, keyBased |
Управляемое удостоверение, используемое для проверки подлинности отправки файлов. Используйте параметр [system], чтобы ссылаться на управляемое удостоверение, назначаемое системой, или идентификатор ресурса, чтобы ссылаться на управляемое удостоверение, назначаемое пользователем.
Расположение Центра Интернета вещей. По умолчанию — расположение целевой группы ресурсов.
Включите управляемое удостоверение, назначаемое системой, для этого концентратора.
Свойство | Значение |
---|---|
Допустимые значения: | false, true |
Включите управляемые удостоверения, назначаемые пользователем, для этого концентратора. Примите идентификаторы ресурсов удостоверений, разделенные пробелами.
Укажите минимальную версию TLS для поддержки этого концентратора. Можно задать значение "1.0" или "1.2". Например, минимальная версия TLS с значением "1.2" приводит к отклонению клиентов, использующих версию TLS ниже 1.2.
Не ожидать завершения длительной операции.
Свойство | Значение |
---|---|
Default value: | False |
Количество секций резервного концентратора событий для сообщений с устройством в облако.
Свойство | Значение |
---|---|
Default value: | 4 |
Указывает, как долго этот центр Интернета вещей будет поддерживать события устройства в облако в диапазоне от 1 до 7 дней.
Свойство | Значение |
---|---|
Default value: | 1 |
Роль для назначения управляемому удостоверению, назначаемого системой центра.
Разделенный пробелами список областей для назначения роли (--role) для управляемого удостоверения, назначаемого системой.
Ценовая категория для Центра Интернета вещей Azure. Обратите внимание, что в каждой подписке разрешено только один бесплатный экземпляр Центра Интернета вещей (F1). Исключение будет возникать, если бесплатные экземпляры превышают один.
Свойство | Значение |
---|---|
Default value: | S1 |
Допустимые значения: | B1, B2, B3, F1, S1, S2, S3 |
Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.
Единицы в Центре Интернета вещей.
Свойство | Значение |
---|---|
Default value: | 1 |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub delete
Удаление центра Интернета вещей.
az iot hub delete [--ids]
[--name]
[--no-wait]
[--resource-group]
[--subscription]
Примеры
Удаление центра Интернета вещей. (autogenerated)
az iot hub delete --name MyIoTHub --resource-group MyResourceGroup
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя Центра Интернета вещей.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Не ожидать завершения длительной операции.
Свойство | Значение |
---|---|
Default value: | False |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub generate-sas-token
Создайте маркер SAS для целевого Центра Интернета вещей, устройства или модуля.
Для маркеров SAS устройства параметр политики используется только для доступа к реестру устройств. Поэтому политика должна иметь доступ на чтение к реестру. Для маркеров Центра Интернета вещей политика является частью SAS.
az iot hub generate-sas-token [--auth-type {key, login}]
[--connection-string --cs]
[--device-id]
[--du --duration]
[--hub-name]
[--key-type --kt {primary, secondary}]
[--login]
[--module-id]
[--pn --policy-name]
[--resource-group]
Примеры
Создайте маркер SAS Центра Интернета вещей с помощью политики iothubowner и первичного ключа.
az iot hub generate-sas-token -n {iothub_name}
Создайте маркер SAS Центра Интернета вещей с помощью политики реестраRead и дополнительного ключа.
az iot hub generate-sas-token -n {iothub_name} --policy registryRead --key-type secondary
Создайте маркер SAS устройства с помощью политики iothubowner для доступа к реестру устройств {iothub_name}.
az iot hub generate-sas-token -d {device_id} -n {iothub_name}
Создание маркера SAS устройства с помощью строки подключения Центра Интернета вещей (с доступом к реестру)
az iot hub generate-sas-token -d {device_id} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'
Создание маркера SAS Центра Интернета вещей с помощью строки подключения Центра Интернета вещей
az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'
Создание маркера SAS устройства с помощью строки подключения устройства
az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;DeviceId=mydevice;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'
Создание маркера SAS модуля с помощью строки подключения модуля
az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;DeviceId=mydevice;ModuleId=mymodule;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Можно настроить значение по умолчанию с помощью az configure --defaults iothub-data-auth-type={auth-type-value}
.
Свойство | Значение |
---|---|
Parameter group: | Access Control Arguments |
Default value: | key |
Допустимые значения: | key, login |
Целевая строка подключения. Это проходит реестр Центра Интернета вещей и создает маркер SAS непосредственно из предоставленного симметричного ключа без дополнительной проверки. Все остальные параметры команды, кроме длительности, будут игнорироваться. Поддерживаемые типы строк подключения: Iot Hub, Device, Module.
Идентификатор целевого устройства.
Допустимая длительность маркера в секундах.
Свойство | Значение |
---|---|
Default value: | 3600 |
Имя центра Интернета вещей или имя узла. Требуется, если --login не указан.
Свойство | Значение |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
Тип ключа политики общего доступа для проверки подлинности.
Свойство | Значение |
---|---|
Default value: | primary |
Допустимые значения: | primary, secondary |
Эта команда поддерживает строку подключения сущности с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если указана строка подключения к сущности и имя, то строка подключения имеет приоритет. Требуется, если имя --hub-name не указано.
Свойство | Значение |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
Идентификатор целевого модуля.
Политика общего доступа с разрешениями операции для целевой сущности Центра Интернета вещей.
Свойство | Значение |
---|---|
Default value: | iothubowner |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub invoke-device-method
Вызов метода устройства.
az iot hub invoke-device-method --device-id
--method-name --mn
[--auth-type {key, login}]
[--hub-name]
[--login]
[--method-payload --mp]
[--resource-group]
[--timeout --to]
Примеры
Вызов прямого метода на устройстве.
az iot hub invoke-device-method --hub-name {iothub_name} --device-id {device_id} --method-name Reboot --method-payload '{"version":"1.0"}'
Обязательные параметры
Идентификатор целевого устройства.
Целевой метод для вызова.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Можно настроить значение по умолчанию с помощью az configure --defaults iothub-data-auth-type={auth-type-value}
.
Свойство | Значение |
---|---|
Parameter group: | Access Control Arguments |
Default value: | key |
Допустимые значения: | key, login |
Имя центра Интернета вещей или имя узла. Требуется, если --login не указан.
Свойство | Значение |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
Эта команда поддерживает строку подключения сущности с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если указана строка подключения к сущности и имя, то строка подключения имеет приоритет. Требуется, если имя --hub-name не указано.
Свойство | Значение |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
Полезные данные Json, передаваемые в метод. Должен быть путь к файлу или необработанный json.
Свойство | Значение |
---|---|
Default value: | {} |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Максимальное количество секунд, ожидающее результата метода устройства.
Свойство | Значение |
---|---|
Default value: | 30 |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub invoke-module-method
Вызов метода модуля.
Эта команда поддерживает как пограничные, так и неграничные модули устройств.
az iot hub invoke-module-method --device-id
--method-name --mn
--module-id
[--auth-type {key, login}]
[--hub-name]
[--login]
[--method-payload --mp]
[--resource-group]
[--timeout --to]
Примеры
Вызов прямого метода на пограничном модуле устройства.
az iot hub invoke-module-method -n {iothub_name} -d {device_id} -m '$edgeAgent' --method-name 'RestartModule' --method-payload '{"schemaVersion": "1.0"}'
Обязательные параметры
Идентификатор целевого устройства.
Целевой метод для вызова.
Идентификатор целевого модуля.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Можно настроить значение по умолчанию с помощью az configure --defaults iothub-data-auth-type={auth-type-value}
.
Свойство | Значение |
---|---|
Parameter group: | Access Control Arguments |
Default value: | key |
Допустимые значения: | key, login |
Имя центра Интернета вещей или имя узла. Требуется, если --login не указан.
Свойство | Значение |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
Эта команда поддерживает строку подключения сущности с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если указана строка подключения к сущности и имя, то строка подключения имеет приоритет. Требуется, если имя --hub-name не указано.
Свойство | Значение |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
Полезные данные Json, передаваемые в метод. Должен быть путь к файлу или необработанный json.
Свойство | Значение |
---|---|
Default value: | {} |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Максимальное количество секунд для ожидания результата метода модуля.
Свойство | Значение |
---|---|
Default value: | 30 |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub list
Вывод списка центров Интернета вещей.
az iot hub list [--resource-group]
Примеры
Вывод списка всех центров Интернета вещей в подписке.
az iot hub list
Список всех центров Интернета вещей в группе ресурсов "MyGroup"
az iot hub list --resource-group MyGroup
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub list-skus
Перечисление доступных ценовых категорий.
az iot hub list-skus [--ids]
[--name]
[--resource-group]
[--subscription]
Примеры
Перечисление доступных ценовых категорий. (autogenerated)
az iot hub list-skus --name MyIoTHub
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя Центра Интернета вещей.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub manual-failover
Инициация перехода на другой ресурс вручную для Центра Интернета вещей в связанный географический регион аварийного восстановления.
az iot hub manual-failover [--ids]
[--name]
[--no-wait]
[--resource-group]
[--subscription]
Примеры
Инициируйте отработку отказа "myhub" из первичного в дополнительный регион.
az iot hub manual-failover -n myhub
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя Центра Интернета вещей.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Не ожидать завершения длительной операции.
Свойство | Значение |
---|---|
Default value: | False |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub monitor-events
Отслеживайте данные телеметрии устройства и сообщения, отправленные в Центр Интернета вещей.
Эта команда используется и может устанавливать зависимый пакет Cython (uamqp) при первом выполнении. https://github.com/Azure/azure-uamqp-python
Примечание. Событие будет отображаться даже в том случае, если текст сообщения не является декодируемым, в этом случае часть полезных данных события будет отображаться как {{не декодируемые полезные данные}} с остальными доступными свойствами события.
az iot hub monitor-events [--cg --consumer-group]
[--content-type --ct]
[--device-id]
[--device-query]
[--enqueued-time --et]
[--hub-name]
[--interface]
[--login]
[--mc --message-count]
[--module-id]
[--properties --props {all, anno, app, sys}]
[--repair {false, true}]
[--resource-group]
[--timeout --to]
[--yes {false, true}]
Примеры
Basic usage
az iot hub monitor-events -n {iothub_name}
Базовое использование со строкой подключения Центра Интернета вещей
az iot hub monitor-events -n {iothub_name} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'
Базовое использование при фильтрации на целевом устройстве
az iot hub monitor-events -n {iothub_name} -d {device_id}
Базовое использование при фильтрации целевых устройств с подстановочным знаком в идентификаторе
az iot hub monitor-events -n {iothub_name} -d Device*
Фильтрация устройств с помощью языка запросов Центра Интернета вещей
az iot hub monitor-events -n {iothub_name} -q "select * from devices where tags.location.region = 'US'"
Отфильтруйте устройство и укажите группу потребителей Концентратора событий для привязки.
az iot hub monitor-events -n {iothub_name} -d {device_id} --cg {consumer_group_name}
Получение заметок сообщения (заголовки сообщений)
az iot hub monitor-events -n {iothub_name} -d {device_id} --properties anno
Получение заметок сообщения + системных свойств. Никогда не истекает время ожидания.
az iot hub monitor-events -n {iothub_name} -d {device_id} --properties anno sys --timeout 0
Получение всех атрибутов сообщения из всех сообщений устройства
az iot hub monitor-events -n {iothub_name} --props all
Получение всех сообщений и полезных данных для анализа сообщений в формате JSON
az iot hub monitor-events -n {iothub_name} --content-type application/json
Получите указанное количество сообщений из концентратора, а затем завершите работу.
az iot hub monitor-events -n {iothub_name} --message-count {message_count}
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Укажите группу потребителей, используемую при подключении к конечной точке концентратора событий.
Свойство | Значение |
---|---|
Default value: | $Default |
Укажите тип контента полезных данных сообщения, чтобы автоматически отформатировать выходные данные для этого типа.
Идентификатор целевого устройства.
Укажите пользовательский запрос для фильтрации устройств.
Указывает время, которое следует использовать в качестве отправной точки для чтения сообщений из секций. Единицы являются миллисекундами с эпохи UNIX. Если время не указано "сейчас", используется.
Имя центра Интернета вещей или имя узла. Требуется, если --login не указан.
Свойство | Значение |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
Идентификатор целевого интерфейса для фильтрации. Например: dtmi:com:example:TemperatureController;1.
Эта команда поддерживает строку подключения сущности с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если указана строка подключения к сущности и имя, то строка подключения имеет приоритет. Требуется, если имя --hub-name не указано.
Свойство | Значение |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
Число сообщений телеметрии для записи до завершения монитора. Если это не указано, монитор продолжает работать до тех пор, пока не будет достигнуто пороговое время ожидания, не получающее сообщения из концентратора.
Идентификатор целевого модуля.
Укажите ключевые свойства сообщения для вывода. sys = системные свойства, приложение = свойства приложения, anno = заметки.
Свойство | Значение |
---|---|
Допустимые значения: | all, anno, app, sys |
Переустановите зависимость uamqp, совместимую с версией расширения. Default: false.
Свойство | Значение |
---|---|
Default value: | False |
Допустимые значения: | false, true |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Максимальное количество секунд для поддержания подключения без получения сообщения. Используйте 0 для бесконечности.
Свойство | Значение |
---|---|
Default value: | 300 |
Пропустить запросы пользователей. Указывает на принятие действия. Используется в основном для сценариев автоматизации. Default: false.
Свойство | Значение |
---|---|
Default value: | False |
Допустимые значения: | false, true |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub monitor-feedback
Мониторинг ответов, отправляемых устройствами для подтверждения обмена сообщениями, передаваемых из облака на устройство (C2D).
Эта команда используется и может устанавливать зависимый пакет Cython (uamqp) при первом выполнении. https://github.com/Azure/azure-uamqp-python.
az iot hub monitor-feedback [--auth-type {key, login}]
[--device-id]
[--hub-name]
[--login]
[--repair {false, true}]
[--resource-group]
[--wait-on-msg]
[--yes {false, true}]
Примеры
Basic usage
az iot hub monitor-feedback -n {iothub_name}
Базовое использование со строкой подключения Центра Интернета вещей
az iot hub monitor-feedback -n {iothub_name} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'
Базовое использование при фильтрации на целевом устройстве
az iot hub monitor-feedback -n {iothub_name} -d {device_id}
Выход из монитора обратной связи при получении сообщения с определенным идентификатором (uuid)
az iot hub monitor-feedback -n {iothub_name} -d {device_id} -w {message_id}
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Можно настроить значение по умолчанию с помощью az configure --defaults iothub-data-auth-type={auth-type-value}
.
Свойство | Значение |
---|---|
Parameter group: | Access Control Arguments |
Default value: | key |
Допустимые значения: | key, login |
Идентификатор целевого устройства.
Имя центра Интернета вещей или имя узла. Требуется, если --login не указан.
Свойство | Значение |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
Эта команда поддерживает строку подключения сущности с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если указана строка подключения к сущности и имя, то строка подключения имеет приоритет. Требуется, если имя --hub-name не указано.
Свойство | Значение |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
Переустановите зависимость uamqp, совместимую с версией расширения. Default: false.
Свойство | Значение |
---|---|
Default value: | False |
Допустимые значения: | false, true |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Монитор отзывов блокируется до получения сообщения с определенным идентификатором (uuid).
Пропустить запросы пользователей. Указывает на принятие действия. Используется в основном для сценариев автоматизации. Default: false.
Свойство | Значение |
---|---|
Default value: | False |
Допустимые значения: | false, true |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub query
Запрос к Центру Интернета вещей с помощью мощного языка SQL.
Получение сведений о двойниках устройств и модулях, заданиях и маршрутизации сообщений. См. https://learn.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language для получения дополнительной информации.
az iot hub query --query-command
[--auth-type {key, login}]
[--hub-name]
[--login]
[--resource-group]
[--top]
Примеры
Запрос всех данных двойника устройства в Центре Интернета вещей Azure.
az iot hub query -n {iothub_name} -q "select * from devices"
Запрос всех данных двойника модуля на целевом устройстве.
az iot hub query -n {iothub_name} -q "select * from devices.modules where devices.deviceId = '{device_id}'"
Обязательные параметры
Выполнение пользовательского запроса.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Указывает, должна ли операция автоматически наследовать ключ политики или использовать текущий сеанс Azure AD. Если тип проверки подлинности является именем входа, а имя узла ресурса указано, поиск ресурсов будет пропущен, если это не требуется. Можно настроить значение по умолчанию с помощью az configure --defaults iothub-data-auth-type={auth-type-value}
.
Свойство | Значение |
---|---|
Parameter group: | Access Control Arguments |
Default value: | key |
Допустимые значения: | key, login |
Имя центра Интернета вещей или имя узла. Требуется, если --login не указан.
Свойство | Значение |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
Эта команда поддерживает строку подключения сущности с правами на выполнение действия. Используйте для предотвращения входа сеанса с помощью az login. Если указана строка подключения к сущности и имя, то строка подключения имеет приоритет. Требуется, если имя --hub-name не указано.
Свойство | Значение |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Максимальное количество возвращаемых элементов. По умолчанию запрос не имеет ограничения.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub show
Получение сведений о Центре Интернета вещей.
az iot hub show [--ids]
[--name]
[--resource-group]
[--subscription]
Примеры
Получение сведений о Центре Интернета вещей. (autogenerated)
az iot hub show --name MyIoTHub
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя Центра Интернета вещей.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub show-quota-metrics
Получение метрик квоты для Центра Интернета вещей.
az iot hub show-quota-metrics [--ids]
[--name]
[--resource-group]
[--subscription]
Примеры
Получение метрик квоты для Центра Интернета вещей. (autogenerated)
az iot hub show-quota-metrics --ids {ids}
Получение метрик квоты для Центра Интернета вещей. (autogenerated)
az iot hub show-quota-metrics --name MyIoTHub
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя Центра Интернета вещей.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub show-stats
Получение статистики для Центра Интернета вещей.
az iot hub show-stats [--ids]
[--name]
[--resource-group]
[--subscription]
Примеры
Получение статистики для Центра Интернета вещей. (autogenerated)
az iot hub show-stats --name MyIoTHub
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя Центра Интернета вещей.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub update
Обновление метаданных для Центра Интернета вещей.
az iot hub update [--add]
[--c2d-max-delivery-count --cdd]
[--c2d-ttl --ct]
[--dds --disable-device-sas {false, true}]
[--disable-local-auth --dla {false, true}]
[--disable-module-sas --dms {false, true}]
[--fc --fileupload-storage-container-name]
[--fcs --fileupload-storage-connectionstring]
[--fd --feedback-max-delivery-count]
[--feedback-lock-duration --fld]
[--feedback-ttl --ft]
[--fileupload-notification-lock-duration --fnld]
[--fileupload-notification-max-delivery-count --fnd]
[--fileupload-notification-ttl --fnt]
[--fileupload-notifications --fn {false, true}]
[--fileupload-sas-ttl --fst]
[--fileupload-storage-auth-type --fsa {identityBased, keyBased}]
[--fileupload-storage-identity --fsi]
[--force-string]
[--ids]
[--min-tls-version --mintls]
[--name]
[--rd --retention-day]
[--remove]
[--resource-group]
[--set]
[--sku {B1, B2, B3, F1, S1, S2, S3}]
[--subscription]
[--tags]
[--unit]
Примеры
Добавление параметров контейнера хранилища для отправки файла
az iot hub update --name MyIotHub --fileupload-storage-connectionstring "connection-string" \ --fileupload-storage-container-name "container_name"
Добавьте правило фильтра брандмауэра для приема трафика из маски IP 127.0.0.0/31.
az iot hub update --name MyIotHub --add properties.ipFilterRules filter_name=test-rule action=Accept ip_mask=127.0.0.0/31
Обновление метаданных для Центра Интернета вещей. (autogenerated)
az iot hub update --name MyIotHub --set properties.allocationPolicy="GeoLatency"
Обновление единиц Центра Интернета вещей до 2 и добавление тегов
az iot hub update -n MyIotHub --unit 2 --tags a=b c=d
Обновление ценовой категории центра Интернета вещей как S2
az iot hub update -n MyIotHub --sku S2
Обновление дней хранения событий Центра Интернета вещей в облако за 3 дня
az iot hub update -n MyIotHub --retention-day 3
Обновление параметров обмена сообщениями между облаком и устройствами Центра Интернета вещей
az iot hub update --name MyIotHub --c2d-max-delivery-count 30 --c2d-ttl 5
Обновление параметров очереди отзывов Центра Интернета вещей
az iot hub update --name MyIoTHub --feedback-max-delivery-count 20 --feedback-lock-duration 100 --feedback-ttl 4
Обновите параметры отправки файлов Центра Интернета вещей и назначьте управляемое удостоверение пользователю для отправки файлов.
az iot hub update -n MyIoTHub --fileupload-sas-ttl 5 --fileupload-storage-auth-type identityBased --fileupload-storage-identity [system]
Обновление параметров уведомления о отправке файлов Центра Интернета вещей и длительности блокировки очереди
az iot hub update -n MyIoTHub --fileupload-notification-max-delivery-count 50 --fileupload-notification-ttl 48 --fileupload-notifications --fileupload-notification-lock-duration 10
Обновление параметров SAS локальной проверки подлинности Центра Интернета вещей, SAS устройства и модуля SAS
az iot hub update -n MyIoTHub --disable-local-auth --disable-device-sas false --disable-module-sas true
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>
.
Свойство | Значение |
---|---|
Parameter group: | Generic Update Arguments |
Default value: | [] |
Количество попыток доставки сообщения из облака в устройство в Центр Интернета вещей от 1 до 100.
Время, когда устройство будет использовать сообщение до истечения срока действия Центра Интернета вещей, от 1 до 48 часов.
Логическое значение, указывающее, следует ли отключать все устройства (включая пограничные устройства, кроме модулей), ограниченные ключами SAS для проверки подлинности.
Свойство | Значение |
---|---|
Допустимые значения: | false, true |
Логическое значение, указывающее, следует ли отключить ключи SAS центра Интернета вещей для проверки подлинности.
Свойство | Значение |
---|---|
Допустимые значения: | false, true |
Логическое значение, указывающее, следует ли отключить ключи SAS с областью действия модуля для проверки подлинности.
Свойство | Значение |
---|---|
Допустимые значения: | false, true |
Имя корневого контейнера, в котором вы отправляете файлы. Контейнер не должен существовать, но должен быть настраиваемым с помощью указанного connectionString.
Строка подключения для учетной записи хранения Azure, в которую отправляются файлы.
Количество попыток доставки сообщения в очереди отзывов центра Интернета вещей в диапазоне от 1 до 100.
Длительность блокировки для очереди отзывов составляет от 5 до 300 секунд.
Период времени, для которого Центр Интернета вещей будет поддерживать отзывы о истечении срока действия или доставке сообщений из облака на устройство в период от 1 до 48 часов.
Длительность блокировки очереди уведомлений о отправке файла составляет от 5 до 300 секунд.
Количество попыток доставки сообщения уведомления о файле в центре Интернета вещей в диапазоне от 1 до 100.
Время отправки файла доступно для службы до истечения срока действия Центра Интернета вещей в период от 1 до 48 часов.
Логическое значение, указывающее, следует ли регистрировать сведения о отправленных файлах в конечную точку Центра Интернета вещей.
Свойство | Значение |
---|---|
Допустимые значения: | false, true |
Срок действия URI SAS, созданного Центром Интернета вещей, действителен до истечения срока его действия в диапазоне от 1 до 24 часов.
Тип проверки подлинности для учетной записи хранения Azure, в которую отправляются файлы.
Свойство | Значение |
---|---|
Допустимые значения: | identityBased, keyBased |
Управляемое удостоверение, используемое для проверки подлинности отправки файлов. Используйте параметр [system], чтобы ссылаться на управляемое удостоверение, назначаемое системой, или идентификатор ресурса, чтобы ссылаться на управляемое удостоверение, назначаемое пользователем.
При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.
Свойство | Значение |
---|---|
Parameter group: | Generic Update Arguments |
Default value: | False |
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Укажите минимальную версию TLS для поддержки этого концентратора. Можно задать значение "1.0" или "1.2". Например, минимальная версия TLS с значением "1.2" приводит к отклонению клиентов, использующих версию TLS ниже 1.2.
Имя Центра Интернета вещей.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Указывает, как долго этот центр Интернета вещей будет поддерживать события устройства в облако в диапазоне от 1 до 7 дней.
Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Свойство | Значение |
---|---|
Parameter group: | Generic Update Arguments |
Default value: | [] |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>
.
Свойство | Значение |
---|---|
Parameter group: | Generic Update Arguments |
Default value: | [] |
Ценовая категория для Центра Интернета вещей Azure. Обратите внимание, что в каждой подписке разрешено только один бесплатный экземпляр Центра Интернета вещей (F1). Исключение будет возникать, если бесплатные экземпляры превышают один.
Свойство | Значение |
---|---|
Допустимые значения: | B1, B2, B3, F1, S1, S2, S3 |
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.
Единицы в Центре Интернета вещей.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az iot hub wait
Дождитесь завершения операции в экземпляре Центр Интернета вещей.
az iot hub wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Примеры
Дождитесь создания существующего экземпляра Центра Интернета вещей
az iot hub wait -n MyIoTHub --created
Дождитесь удаления экземпляра Центра Интернета вещей
az iot hub wait -n MyIoTHub --deleted
Дождитесь, пока существующий экземпляр Центра Интернета вещей имеет активное состояние
az iot hub wait -n MyIoTHub --custom "properties.state=='Active'"
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code='PowerState/running'].
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Дождитесь удаления.
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Подождите, пока ресурс не существует.
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Интервал опроса в секундах.
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | 30 |
Имя Центра Интернета вещей.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Свойство | Значение |
---|---|
Parameter group: | Resource Id Arguments |
Максимальное ожидание в секундах.
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | 3600 |
Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |