Поделиться через

az iot du update init

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

Примечание.

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

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

Программа для инициализации манифеста импорта.

Команды

Имя Описание Тип Состояние
az iot du update init v5

Инициализация манифеста импорта версии 5 с требуемым состоянием.

 Расширение Предварительная версия

az iot du update init v5

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

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

Инициализация манифеста импорта версии 5 с требуемым состоянием.

Эта команда поддерживает все атрибуты манифеста импорта версии 5. Обратите внимание, что между и --file, а также --related-file--file и с позиционной чувствительностью--step. Ознакомьтесь с примерами и описаниями параметров, чтобы узнать, как полностью использовать операцию.

Дополнительные сведения об использовании кавычки и escape-символов в разных оболочках см. здесь: https://aka.ms/aziotcli-json

az iot du update init v5 --compat
                         --step
                         --update-name
                         --update-provider
                         --update-version
                         [--description]
                         [--file]
                         [--is-deployable {false, true}]
                         [--no-validation {false, true}]
                         [--related-file]

Примеры

Инициализация минимального манифеста импорта содержимого. Встроенный json, оптимизированный для bash.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{"installedCriteria": "1.0"}' --file path=/my/apt/manifest/file

Инициализация минимального манифеста импорта содержимого. Встроенный json, оптимизированный для powershell.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{\"installedCriteria\": \"1.0\"}' --file path=/my/apt/manifest/file

Инициализация минимального манифеста импорта содержимого. Встроенный json, оптимизированный для cmd.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="{\"installedCriteria\": \"1.0\"}" --file path=/my/apt/manifest/file

Инициализация минимального манифеста импорта содержимого. Используйте входные данные файла для json.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="@/path/to/file" --file path=/my/apt/manifest/file

Инициализировать неразверяемое конечное обновление для ссылки на пакетное обновление. Встроенный json, оптимизированный для bash.

az iot du update init v5 --update-provider Microsoft --update-name mySwUpdate --update-version 1.1.0 --compat manufacturer=Contoso model=Microphone --step handler=microsoft/swupdate:1 description="Deploy Update" properties='{"installedCriteria": "1.0"}' --file path=/my/update/image/file1 --file path=/my/update/image/file2 --is-deployable false

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

az iot du update init v5 \
--update-provider Microsoft --update-name myBundled --update-version 2.0 \
--compat manufacturer=Contoso model=SpaceStation \
--step handler=microsoft/script:1 properties='{"arguments": "--pre"}' description="Pre-install script" \
--file path=/my/update/scripts/preinstall.sh downloadHandler=microsoft/delta:1 \
--related-file path=/my/update/scripts/related_preinstall.json properties='{"microsoft.sourceFileHashAlgorithm": "sha256"}' \
--step updateId.provider=Microsoft updateId.name=SwUpdate updateId.version=1.1 \
--step handler=microsoft/script:1 properties='{"arguments": "--post"}' description="Post-install script" \
--file path=/my/update/scripts/postinstall.sh

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

--compat

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

--step

Пары key=value, разделенные пробелами, соответствующие свойствам элемента "instructions.steps". Клиент определяет, является ли шаг встроенным или ссылочным на основе указанных пар значений ключа. Если можно выполнить встроенный или ссылочный шаг, то на шаге ссылки будет задан приоритет. Использование файла --file будет связано с ближайшей встроенной записью --step, производным от значения "files". Поддерживаются следующие ключи ссылочного шага: updateId.provider, updateId.versionupdateId.nameи description. Поддерживаются следующие встроенные ключи шагов: handler (например, microsoft/script:1 или Microsoft/swupdate:1" или "microsoft/apt:1"), (объект json в строке, properties который агент передает обработчику) и description. --step можно использовать 1 или более раз.

--update-name

Имя обновления в качестве компонента updateId.

--update-provider

Поставщик обновлений в качестве компонента updateId.

--update-version

Версия обновления в качестве компонента updateId.

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

--description

Описание манифеста импорта.

--file

Пары key=value, разделенные пробелами, соответствующие свойствам элемента "files". Запись --file может включать ближайшие записи, связанные с файлами, если они указаны. Поддерживаются следующие ключи: path [обязательный] локальный путь к файлу обновления (например, downloadHandler обработчик microsoft/delta:1) для использования связанных файлов для скачивания properties полезных данных (объект in-line json агент передает обработчику). --file можно использовать 1 или более раз.

--is-deployable

Указывает, является ли обновление независимо развертываемым.

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

Отключает проверку схемы json на стороне клиента содержимого манифеста импорта.

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

Пары key=value, разделенные пробелами, соответствующие свойствам элемента files[*].relatedFiles. Запись, связанная с файлом, будет связана с ближайшей записью --file, если она существует. Поддерживаются следующие ключи: path [обязательный] локальный путь к связанному файлу обновления (объект json в строке, properties переданный обработчику загрузки). --related-file можно использовать 1 или более раз.

Глобальные параметры
--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.