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.	Principal	GA
az image builder customizer clear	Quite todos los personalizadores de image builder de una plantilla de Image Builder.	Principal	GA
az image builder customizer remove	Quite un personalizador de Image Builder de una plantilla de Image Builder.	Principal	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.

valores aceptados: file, powershell, shell, windows-restart, windows-update

Parámetros opcionales

--defer

Almacena temporalmente el objeto en la memoria caché local en lugar de enviarlo a Azure. Use az cache comandos 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.

--exit-codes -e

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

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

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

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--inline-script

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

--name -n

Nombre de la plantilla de imagen.

--resource-group -g

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

--restart-check-command

Comando para comprobar que el reinicio se ha realizado correctamente.

--restart-command

Comando para ejecutar la operación de reinicio.

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

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.

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

--subscription

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

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

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az image builder customizer clear

Quite todos los personalizadores de image builder de una plantilla de Image Builder.

Debe usarse con --defer.

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

Parámetros opcionales

--defer

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

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--name -n

Nombre de la plantilla de imagen.

--resource-group -g

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

--subscription

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

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az image builder customizer remove

Quite un personalizador de Image Builder de una plantilla de Image Builder.

Debe usarse con --defer.

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

Parámetros requeridos

--customizer-name

Nombre del personalizador.

Parámetros opcionales

--defer

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

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--name -n

Nombre de la plantilla de imagen.

--resource-group -g

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

--subscription

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

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.