az image builder customizer

Administrar personalizadores de plantillas del generador de imágenes.

Comandos

Nombre	Description	Tipo	Estado
az image builder customizer add	Agregue un personalizador de Image Builder a una plantilla de Image Builder.	Core	GA
az image builder customizer clear	Quite todos los personalizadores de image builder de una plantilla de Image Builder.	Core	GA
az image builder customizer remove	Quite un personalizador de Image Builder de una plantilla de Image Builder.	Core	GA

az image builder customizer add

Agregue un personalizador de Image Builder a una plantilla de Image Builder.

Debe usarse con --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]

Ejemplos

Adición de un personalizador de shell insertado a una plantilla de imagen en la caché de objetos de la 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

Adición de un personalizador de archivos a una plantilla de imagen en la caché de objetos de la 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

Agregar un personalizador de reinicio de Windows a una plantilla de imagen en la caché de objetos de la 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

Agregue un personalizador de Windows Update a una plantilla de imagen en la caché de objetos de la 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

Parámetros requeridos

--customizer-name

Nombre del personalizador.

--type -t

Tipo de personalizador que se va a agregar a la plantilla de imagen.

Propiedad	Valor
Valores aceptados:	file, powershell, shell, windows-restart, windows-update

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--defer

Almacene temporalmente el objeto en la memoria caché local en lugar de enviarlo a Azure. Use comandos az cache para ver o borrar.

--dest-path

Ruta de acceso de destino absoluta en la que se descargará el archivo especificado en --file-source en la imagen.

Propiedad	Valor
Grupo de parámetros:	File Arguments

--exit-codes -e

Lista separada por espacios de códigos de salida válidos, como enteros.

Propiedad	Valor
Grupo de parámetros:	Powershell Arguments

--file-source

Identificador URI del archivo que se va a descargar en la imagen. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc.

Propiedad	Valor
Grupo de parámetros:	File Arguments

--filters

Filtros delimitados por espacios para seleccionar las actualizaciones que se van a aplicar. Omita o especifique una matriz vacía para usar el valor predeterminado (sin filtro).

Propiedad	Valor
Grupo de parámetros:	Windows Update Arguments

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--inline-script

Lista separada por espacios de líneas de script insertadas con la que personalizar la imagen.

Propiedad	Valor
Grupo de parámetros:	Shell and Powershell Arguments

--name -n

Nombre de la plantilla de imagen.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--restart-check-command

Comando para comprobar que el reinicio se ha realizado correctamente.

Propiedad	Valor
Grupo de parámetros:	Windows Restart Arguments

--restart-command

Comando para ejecutar la operación de reinicio.

Propiedad	Valor
Grupo de parámetros:	Windows Restart Arguments

--restart-timeout

Tiempo de espera de reinicio especificado como una cadena que consta de una magnitud y unidad, por ejemplo, "5m" (5 minutos) o "2h" (2 horas).

Propiedad	Valor
Grupo de parámetros:	Windows Restart Arguments
Valor predeterminado:	5m

--script-url

Dirección URL del script con el que personalizar la imagen. La dirección URL debe ser accesible públicamente.

Propiedad	Valor
Grupo de parámetros:	Shell and Powershell Arguments

--search-criteria

Criterios para buscar actualizaciones. Omita o especifique una cadena vacía para usar el valor predeterminado (buscar todo). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo.

Propiedad	Valor
Grupo de parámetros:	Windows Update Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--update-limit

Número máximo de actualizaciones que se aplicarán a la vez. Omita o especifique 0 para usar el valor predeterminado (1000).

Propiedad	Valor
Grupo de parámetros:	Windows Update Arguments

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False