az iot du instance

  • Ссылка

Примечание.

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

Управление экземплярами обновления устройств.

Команды

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

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

 Расширение Общедоступная версия
az iot du instance delete

Удаление экземпляра обновления устройства.

 Расширение Общедоступная версия
az iot du instance list

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

 Расширение Общедоступная версия
az iot du instance show

Отображение экземпляра обновления устройства.

 Расширение Общедоступная версия
az iot du instance update

Обновление экземпляра обновления устройства.

 Расширение Общедоступная версия
az iot du instance wait

Блокировать до тех пор, пока не будет выполнено требуемое состояние ресурса экземпляра.

 Расширение Общедоступная версия

az iot du instance create

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

Эта команда также может использоваться для обновления состояния существующего экземпляра.

az iot du instance create --account
                          --instance
                          --iothub-ids
                          [--diagnostics-storage-id]
                          [--enable-diagnostics {false, true}]
                          [--no-wait]
                          [--resource-group]
                          [--tags]

Примеры

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

az iot du instance create -n {account_name} -i {instance_name} --iothub-ids {iothub_resource_id}

Создайте экземпляр с включенным диагностика, в паре с предоставленной пользователем учетной записью хранения. Включите теги.

az iot du instance create -n {account_name} -i {instance_name} --iothub-ids {iothub_resource_id} --enable-diagnostics --diagnostics-storage-id {storage_account_resource_id} --tags a=b

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

--account -n

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

--instance -i

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

--iothub-ids

Идентификаторы ресурсов, разделенные пробелами, Центр Интернета вещей.

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

--diagnostics-storage-id

Пользователь предоставил идентификатор ресурса учетной записи хранения для использования в коллекции журналов диагностики.

--enable-diagnostics

Включает коллекцию журналов диагностики.

допустимые значения: false, true
--no-wait

Не ожидать завершения длительной операции.

значение по умолчанию: False
--resource-group -g

Имя группы ресурсов учетной записи обновления устройства. Вы можете настроить расположение по умолчанию с помощью az config set defaults.adu_group=<name>.

--tags

Теги ресурсов. Контейнер свойств в парах "ключ-значение" со следующим форматом: a=b=b=d.

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az iot du instance delete

Удаление экземпляра обновления устройства.

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

Примеры

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

az iot du instance delete -n {account_name} -i {instance_name}

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

az iot du instance delete -n {account_name} -i {instance_name} -y

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

--account -n

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

--instance -i

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

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

--no-wait

Не ожидать завершения длительной операции.

значение по умолчанию: False
--resource-group -g

Имя группы ресурсов учетной записи обновления устройства. Вы можете настроить расположение по умолчанию с помощью az config set defaults.adu_group=<name>.

--yes -y

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az iot du instance list

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

az iot du instance list --account
                        [--resource-group]

Примеры

Вывод списка экземпляров, связанных с целевой учетной записью.

az iot du instance list -n {account_name}

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

--account -n

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

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

--resource-group -g

Имя группы ресурсов учетной записи обновления устройства. Вы можете настроить расположение по умолчанию с помощью az config set defaults.adu_group=<name>.

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az iot du instance show

Отображение экземпляра обновления устройства.

az iot du instance show --account
                        --instance
                        [--resource-group]

Примеры

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

az iot du instance show -n {account_name} -i {instance_name}

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

--account -n

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

--instance -i

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

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

--resource-group -g

Имя группы ресурсов учетной записи обновления устройства. Вы можете настроить расположение по умолчанию с помощью az config set defaults.adu_group=<name>.

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az iot du instance update

Обновление экземпляра обновления устройства.

В настоящее время можно обновить следующие свойства экземпляра — iotHubs, enableDiagnostics, diagnostics служба хранилища Properties и теги.

az iot du instance update --account
                          --instance
                          [--add]
                          [--force-string]
                          [--no-wait]
                          [--remove]
                          [--resource-group]
                          [--set]

Примеры

Задайте определенный атрибут тега экземпляра.

az iot du instance update -n {account_name} -i {instance_name} --set tags.env='test'

Включите диагностика и настройте учетную запись хранения для сбора журналов.

az iot du instance update -n {account_name} -i {instance_name} --set enableDiagnostics=true diagnosticStorageProperties.resourceId={storage_account_resource_id}

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

--account -n

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

--instance -i

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

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

--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

значение по умолчанию: []
--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

значение по умолчанию: False
--no-wait

Не ожидать завершения длительной операции.

значение по умолчанию: False
--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.

значение по умолчанию: []
--resource-group -g

Имя группы ресурсов учетной записи обновления устройства. Вы можете настроить расположение по умолчанию с помощью az config set defaults.adu_group=<name>.

--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

значение по умолчанию: []
Глобальные параметры
--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az iot du instance wait

Блокировать до тех пор, пока не будет выполнено требуемое состояние ресурса экземпляра.

az iot du instance wait --account
                        --instance
                        [--created]
                        [--custom]
                        [--deleted]
                        [--exists]
                        [--interval]
                        [--resource-group]
                        [--timeout]
                        [--updated]

Примеры

Блокировать до удаления целевого экземпляра.

az iot du instance wait -n {account_name} -i {instance_name} --deleted

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

--account -n

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

--instance -i

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

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

--created

Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".

значение по умолчанию: False
--custom

Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code='PowerState/running'].

--deleted

Дождитесь удаления.

значение по умолчанию: False
--exists

Подождите, пока ресурс не существует.

значение по умолчанию: False
--interval

Интервал опроса в секундах.

значение по умолчанию: 30
--resource-group -g

Имя группы ресурсов учетной записи обновления устройства. Вы можете настроить расположение по умолчанию с помощью az config set defaults.adu_group=<name>.

--timeout

Максимальное ожидание в секундах.

значение по умолчанию: 3600
--updated

Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".

значение по умолчанию: False
Глобальные параметры
--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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