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

az image builder customizer

  • Ссылка

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

Команды

Имя Описание Тип Состояние
az image builder customizer add

Добавьте настройщик построителя изображений в шаблон построителя образов.

 Ядро ГА
az image builder customizer clear

Удалите всех настройщиков построителя образов из шаблона построителя образов.

 Ядро ГА
az image builder customizer remove

Удалите настройщик построителя образов из шаблона построителя образов.

 Ядро ГА

az image builder customizer add

Добавьте настройщик построителя изображений в шаблон построителя образов.

Необходимо использовать с --defer.

az image builder customizer add --customizer-name
                                --type {file, powershell, shell, windows-restart, windows-update}
                                [--defer]
                                [--dest-path]
                                [--exit-codes]
                                [--file-source]
                                [--filters]
                                [--ids]
                                [--inline-script]
                                [--name]
                                [--resource-group]
                                [--restart-check-command]
                                [--restart-command]
                                [--restart-timeout]
                                [--script-url]
                                [--search-criteria]
                                [--subscription]
                                [--update-limit]

Примеры

Добавление встроенного настройщика оболочки в шаблон изображения в кэше объектов cli

az image builder customizer add -n myTemplate -g myGroup \
    --inline-script "sudo mkdir /buildArtifacts" \
                    "sudo cp /tmp/index.html /buildArtifacts/index.html" \
    --customizer-name shellScriptInline --type shell --defer

Добавление настройщика файлов в шаблон изображения в кэше объектов cli

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFile --type file \
    --file-source "https://my-remote-file.html" --dest-path "/tmp/index.html" --defer

Добавление настройщика перезапуска Windows в шаблон изображения в кэше объектов cli

az image builder customizer add -n myTemplate -g myGroup \
--customizer-name shellScriptUrl \
--restart-check-command "echo Azure-Image-Builder-Restarted-the-VM  > \
                        c:\buildArtifacts\restart.txt" \
    --type windows-restart --restart-timeout 10m --defer

Добавьте настройщик обновления Windows в шаблон изображения в кэше объектов cli.

az image builder customizer add -n myTemplate -g myGroup --customizer-name winUpdate --type windows-update --search-criteria IsInstalled=0 --filters "exclude:\$_.Title -like \'*Preview*\'" "include:\$true" --update-limit 20 --defer

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

--customizer-name

Имя настройщика.

--type -t

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

Допустимые значения: file, powershell, shell, windows-restart, windows-update

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

--defer

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

--dest-path

Абсолютный путь назначения, в котором файл, указанный в --file-source, будет скачан в изображение.

--exit-codes -e

Разделенный пробелами список допустимых кодов выхода в виде целых чисел.

--file-source

Универсальный код ресурса (URI) файла, который нужно скачать в образ. Это может быть ссылка на github, URI SAS для службы хранилища Azure и т. д.

--filters

Фильтры с разделителями пространства для выбора обновлений для применения. Опустите или укажите пустой массив для использования по умолчанию (без фильтра).

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

--inline-script

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

--name -n

Имя шаблона изображения.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--restart-check-command

Команда, чтобы убедиться, что перезапуск выполнен успешно.

--restart-command

Команда для выполнения операции перезапуска.

--restart-timeout

Время ожидания перезапуска, указанное как строка, состоящая из величины и единицы, например "5 млн" (5 минут) или "2h" (2 часа).

Default value: 5m
--script-url

URL-адрес скрипта для настройки изображения. URL-адрес должен быть общедоступным.

--search-criteria

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

--subscription

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

--update-limit

Максимальное количество обновлений, применяемых за раз. Опустить или указать 0, чтобы использовать значение по умолчанию (1000).

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

az image builder customizer clear

Удалите всех настройщиков построителя образов из шаблона построителя образов.

Необходимо использовать с --defer.

az image builder customizer clear [--defer]
                                  [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

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

--defer

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

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

--name -n

Имя шаблона изображения.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--subscription

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

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

az image builder customizer remove

Удалите настройщик построителя образов из шаблона построителя образов.

Необходимо использовать с --defer.

az image builder customizer remove --customizer-name
                                   [--defer]
                                   [--ids]
                                   [--name]
                                   [--resource-group]
                                   [--subscription]

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

--customizer-name

Имя настройщика.

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

--defer

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

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

--name -n

Имя шаблона изображения.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--subscription

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

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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