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

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.