az iot du update

Примечание.

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

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

Команды

Имя	Описание	Тип	Состояние
az iot du update calculate-hash	Вычисление хэшированного представления файла base64.	Расширение	Общедоступная версия
az iot du update delete	Удалите определенную версию обновления.	Расширение	Общедоступная версия
az iot du update file	Обновление операций с файлами.	Расширение	Общедоступная версия
az iot du update file list	Вывод списка идентификаторов файла обновления относительно поставщика обновлений, имени и версии.	Расширение	Общедоступная версия
az iot du update file show	Отображение сведений о конкретном файле обновления относительно поставщика обновлений, имени и версии.	Расширение	Общедоступная версия
az iot du update import	Импортируйте новую версию обновления в экземпляр обновления устройства.	Расширение	Общедоступная версия
az iot du update init	Программа для инициализации манифеста импорта.	Расширение	Предварительная версия
az iot du update init v5	Инициализация манифеста импорта версии 5 с требуемым состоянием.	Расширение	Предварительная версия
az iot du update list	Список обновлений, импортированных в экземпляр обновления устройств.	Расширение	Общедоступная версия
az iot du update show	Отображение определенной версии обновления.	Расширение	Общедоступная версия
az iot du update stage	Этап обновления для импорта в целевой экземпляр.	Расширение	Предварительная версия

az iot du update calculate-hash

Вычисление хэшированного представления файла base64.

az iot du update calculate-hash --file-path
                                [--hash-algo {sha256}]

Примеры

Вычислите представление дайджеста sha256 base64 для целевого файла обновления.

az iot du update calculate-hash --file-path /path/to/file

Вычислите представление дайджеста sha256 в base64 для нескольких целевых файлов обновления.

az iot du update calculate-hash --file-path /path/to/file1 --file-path /path/to/file2 --file-path /path/to/file3

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

--file-path -f

Локальный путь к целевому файлу для вычисления хэша. --file-path можно использовать 1 или более раз.

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

--hash-algo

Алгоритм шифрования, используемый для хэширования.

допустимые значения: sha256

значение по умолчанию: sha256

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

--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 update delete

Удалите определенную версию обновления.

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

Примеры

Удалите целевое обновление относительно поставщика обновлений, имени и версии.

az iot du update delete -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

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

--account -n

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

--instance -i

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

--un --update-name

Имя обновления.

--up --update-provider

Поставщик обновлений.

--update-version --uv

Версия обновления.

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

--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 update import

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

Эта команда поддерживает --defer возможность. При использовании команды будут храниться полезные данные объекта, предназначенные для отправки в Azure в локальном кэше. Следующее использование этой команды без --defer объединения полезных данных запроса с кэшируемыми объектами, отправляя их вместе.

После успешного удаления соответствующей записи локального кэша будет удалена. Если сбой возникает, кэшированное содержимое не будет удалено. Используйте az cache команды для управления записями локального кэша независимо.

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

az iot du update import --account
                        --instance
                        --url
                        [--defer]
                        [--file]
                        [--friendly-name]
                        [--hashes]
                        [--no-wait]
                        [--resource-group]
                        [--size]

Примеры

Импортируйте обновление с двумя связанными файлами и без ссылочных шагов, явно предоставляя хэш-значение манифеста и размер манифеста в байтах.

az iot du update import -n {account_name} -i {instance_name} --hashes sha256={hash_value} --size {size_in_bytes} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Импортируйте обновление с двумя связанными файлами и без ссылочных шагов, позволяя CLI вычислять хэш-значение манифеста импорта и размер в байтах.

az iot du update import -n {account_name} -i {instance_name} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

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

az iot du update import -n {account_name} -i {instance_name} --url {parent_manifest_location} --file filename={parent_file_name} url={parent_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child1_manifest_location} --file filename={child1_file_name} url={child1_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child2_manifest_location} --file filename={child2_file_name} url={child2_file_url}

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

--account -n

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

--instance -i

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

--url

Расположение, из которого манифест импорта можно скачать с помощью обновления устройства для Центр Интернета вещей. Обычно это URL-адрес большого двоичного объекта, защищенного только для чтения, с сроком действия не менее 3 часов.

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

--defer

Временно сохраните объект в локальном кэше вместо отправки в Azure. Используйте az cache команды для просмотра и очистки.

--file

Пары key=value, разделенные пробелами, соответствующие свойствам файла метаданных манифеста. Обязательные ключи включают имя файла и URL-адрес. --file можно использовать 1 или более раз.

--friendly-name

Понятное имя, связанное с определением обновления.

--hashes

Пары key=value, разделенные пробелами, где ключ является хэш-алгоритмом, а значением является хэш файла манифеста в кодировке Base64. Требуется по крайней мере запись sha256. Если он не указан, вычисляется по указанному URL-адресу.

--no-wait

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

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

--resource-group -g

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

--size

Размер файла в байтах. Если он не указан, вычисляется по указанному URL-адресу.

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

--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 update list

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

При перечислении поставщиков обновлений необходимо указать только флаг поставщика --by-provider в дополнение к аргументам общего экземпляра. При указании имен обновлений поставщику обновлений необходимо указать. При перечислении версий обновлений необходимо указать поставщика обновлений и имя обновления.

az iot du update list --account
                      --instance
                      [--by-provider {false, true}]
                      [--filter]
                      [--resource-group]
                      [--search]
                      [--un]
                      [--up]

Примеры

Список всех обновлений.

az iot du update list -n {account_name} -i {instance_name}

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

az iot du update list -n {account_name} -i {instance_name} --search 'Contoso'

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

az iot du update list -n {account_name} -i {instance_name} --filter 'isDeployable eq false'

Список всех поставщиков обновлений.

az iot du update list -n {account_name} -i {instance_name} --by-provider

Список всех имен обновлений по поставщику обновлений.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name}

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

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name}

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

--account -n

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

--instance -i

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

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

--by-provider

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

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

--filter

Ограничивает набор обновлений, возвращаемых значениями свойств. Поддерживается при перечислении обновлений без ограничений или при перечислении по версии.

--resource-group -g

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

--search

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

--un --update-name

Имя обновления.

--up --update-provider

Поставщик обновлений.

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

--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 update show

Отображение определенной версии обновления.

az iot du update show --account
                      --instance
                      --un
                      --up
                      --update-version
                      [--resource-group]

Примеры

Отображение определенного обновления относительно поставщика обновлений, имени и версии.

az iot du update show -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

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

--account -n

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

--instance -i

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

--un --update-name

Имя обновления.

--up --update-provider

Поставщик обновлений.

--update-version --uv

Версия обновления.

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

--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 update stage

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

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

Этап обновления для импорта в целевой экземпляр.

Промежуточное обновление относится к ускорению необходимых шагов импорта обновления в целевой экземпляр. Для данного манифеста импорта процесс определяет соответствующие файлы, отправляет их в нужный контейнер хранилища, создает URI SAS и охватывает другие шаги подготовки для успешного импорта.

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

Доступ на основе ключей используется для отправки артефактов BLOB-объектов и создания URI SAS продолжительности 3 часа с доступом на чтение.

Если --then-import флаг указан, команда импортирует поэтапное обновление. В противном случае результатом этой операции является команда импорта, выполняемая для достижения того же результата позже.

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

az iot du update stage --account
                       --instance
                       --manifest-path
                       --storage-account
                       --storage-container
                       [--friendly-name]
                       [--overwrite {false, true}]
                       [--resource-group]
                       [--storage-subscription]
                       [--then-import {false, true}]

Примеры

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

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json

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

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json --then-import --friendly-name myAptUpdate

Этап много ссылочного обновления. Файлы обновления будут отправлены в контейнер BLOB-объектов хранилища, который находится в другой подписке для учетной записи обновления.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --storage-subscription {storage_account_subscription} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json

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

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json --then-import --overwrite

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

--account -n

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

--instance -i

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

--manifest-path

Локальный путь к манифесту импорта, который должен быть поэтапно выполнен. Можно использовать 1 или более раз.

--storage-account

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

--storage-container

Требуемое имя контейнера хранилища для этапов импорта артефактов манифеста.

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

--friendly-name

Понятное имя, связанное с определением обновления.

--overwrite

Флаг, указывающий, следует ли перезаписывать существующие большие двоичные объекты, если конфликт существует.

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

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

--resource-group -g

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

--storage-subscription

Требуемая подписка учетной записи хранения для этапов импорта артефактов манифеста. Применимо, если учетные записи обновления хранилища и устройства находятся в разных подписках.

--then-import

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

допустимые значения: 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.