az iot du update

Note

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

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

Команды

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

az iot du update calculate-hash

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

az iot du update calculate-hash --file-path
                                [--acquire-policy-token]
                                [--change-reference]
                                [--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 или более раз.

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

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

--acquire-policy-token

Автоматическое получение маркера Azure Policy для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--change-reference

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

Свойство	Значение
Группа параметров:	Global Policy Arguments

--hash-algo

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

Свойство	Значение
Default value:	sha256
Допустимые значения:	sha256

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False

az iot du update delete

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

az iot du update delete --account
                        --instance
                        --un --update-name
                        --up --update-provider
                        --update-version --uv
                        [--acquire-policy-token]
                        [--change-reference]
                        [--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}.

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--instance -i

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

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--un --update-name

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

--up --update-provider

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

--update-version --uv

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

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

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

--acquire-policy-token

Автоматическое получение маркера Azure Policy для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--change-reference

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

Свойство	Значение
Группа параметров:	Global Policy Arguments

--no-wait

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

Свойство	Значение
Default value:	False

--resource-group -g

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

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--yes -y

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

Свойство	Значение
Допустимые значения:	false, true

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False

az iot du update import

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

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

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

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

az iot du update import --account
                        --instance
                        --url
                        [--acquire-policy-token]
                        [--change-reference]
                        [--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}.

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--instance -i

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

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--url

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

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

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

--acquire-policy-token

Автоматическое получение маркера Azure Policy для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--change-reference

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

Свойство	Значение
Группа параметров:	Global Policy Arguments

--defer

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

--file

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

--friendly-name

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

--hashes

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

--no-wait

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

Свойство	Значение
Default value:	False

--resource-group -g

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

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--size

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

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False

az iot du update list

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

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

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

Примеры

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

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}.

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--instance -i

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

Свойство	Значение
Группа параметров:	Account Identifier Arguments

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

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

--by-provider

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

Свойство	Значение
Допустимые значения:	false, true

--filter

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

Свойство	Значение
Группа параметров:	Filter Arguments

--resource-group -g

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

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--search

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

Свойство	Значение
Группа параметров:	Filter Arguments

--un --update-name

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

--up --update-provider

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

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False

az iot du update show

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

az iot du update show --account
                      --instance
                      --un --update-name
                      --up --update-provider
                      --update-version --uv
                      [--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}.

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--instance -i

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

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--un --update-name

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

--up --update-provider

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

--update-version --uv

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

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

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

--resource-group -g

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

Свойство	Значение
Группа параметров:	Account Identifier Arguments

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False

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
                       [--acquire-policy-token]
                       [--change-reference]
                       [--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}.

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--instance -i

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

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--manifest-path

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

--storage-account

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

Свойство	Значение
Группа параметров:	Storage Arguments

--storage-container

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

Свойство	Значение
Группа параметров:	Storage Arguments

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

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

--acquire-policy-token

Автоматическое получение маркера Azure Policy для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--change-reference

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

Свойство	Значение
Группа параметров:	Global Policy Arguments

--friendly-name

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

--overwrite

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

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--resource-group -g

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

Свойство	Значение
Группа параметров:	Account Identifier Arguments

--storage-subscription

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

Свойство	Значение
Группа параметров:	Storage Arguments

--then-import

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

Свойство	Значение
Допустимые значения:	false, true

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False