Compartir a través de

az image builder customizer

  • Referencia

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.

 Núcleo GA
az image builder customizer clear

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

 Núcleo GA
az image builder customizer remove

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

 Núcleo 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

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.

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

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

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

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

--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 del registro. Usa --debug para ver 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

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

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

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

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

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

--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 del registro. Usa --debug para ver 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

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

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

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

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

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

--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 del registro. Usa --debug para ver registros de depuración completos.