Compartir a través de

az image builder output

Administrar distribuidores de salida de plantillas de Image Builder.

Una imagen personalizada se puede distribuir como una imagen administrada, una imagen compartida en una galería de imágenes compartidas (SIG) o como un blob VHD.

Comandos

Nombre Description Tipo Estado
az image builder output add

Agregue un distribuidor de salida del generador de imágenes a una plantilla de Image Builder.

 Core GA
az image builder output clear

Quite todos los distribuidores de salida del generador de imágenes de una plantilla de Image Builder.

 Core GA
az image builder output remove

Quite un distribuidor de salida de Image Builder de una plantilla de Image Builder.

 Core GA
az image builder output versioning

Administrar el versionador de salida de la plantilla del generador de imágenes.

 Core GA
az image builder output versioning remove

Quite todas las opciones de control de versiones en las salidas especificadas.

 Core GA
az image builder output versioning set

Establezca el versionador de salida del generador de imágenes de una plantilla de Image Builder.

 Core GA
az image builder output versioning show

Mostrar las opciones de control de versiones en las salidas especificadas.

 Core GA

az image builder output add

Agregue un distribuidor de salida del generador de imágenes a una plantilla de Image Builder.

Debe usarse con --defer. El distribuidor de salida puede ser una imagen administrada, una imagen de galería o como un blob VHD.

az image builder output add [--artifact-tags]
                            [--defer]
                            [--gallery-image-definition]
                            [--gallery-name]
                            [--gallery-replication-regions]
                            [--ids]
                            [--is-vhd]
                            [--managed-image]
                            [--managed-image-location]
                            [--name]
                            [--output-name]
                            [--resource-group]
                            [--subscription]
                            [--versioning {Latest, Source}]
                            [--vhd-uri]

Ejemplos

Agregue un distribuidor de imágenes administradas a una plantilla de imagen en la caché de objetos de la CLI. Especifique un nombre de salida de ejecución.

az image builder output add -n mytemplate -g my-group \
    --managed-image my_desired_image_name --output-name managed_image_run_01 --defer

Agregue un distribuidor de la galería de imágenes compartida a una plantilla de imagen en la caché de objetos de la CLI. Especifique sus regiones de replicación.

az image builder output add -n mytemplate -g my-group --gallery-name my_shared_gallery \
    --gallery-replication-regions westus brazilsouth \
    --gallery-image-definition linux_image_def --defer

Agregue un distribuidor de VHD a una plantilla de imagen en la caché de objetos de la CLI.

az image builder output add -n mytemplate -g my-group \
    --output-name my_vhd_image --is-vhd  --defer

Agregue un distribuidor de VHD con la especificación del URI de almacenamiento en una plantilla de imagen en la caché de objetos de la CLI.

az image builder output add -n mytemplate -g my-group \
    --output-name my_vhd_image --is-vhd --vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file --defer

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--artifact-tags

Etiquetas que se aplicarán al artefacto de salida una vez creado por el distribuidor. etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--defer

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

--gallery-image-definition

Nombre o identificador de la definición de imagen SIG existente con la que crear la versión de imagen personalizada.

Propiedad Valor
Parameter group: Shared Image Gallery Arguments
--gallery-name

Nombre de la galería de imágenes compartidas, si se proporcionó el nombre de la definición de imagen y no el identificador.

Propiedad Valor
Parameter group: Shared Image Gallery Arguments
--gallery-replication-regions

Lista separada por espacios de regiones en las que se va a replicar la versión de la imagen. El valor predeterminado es la ubicación del grupo de recursos.

Propiedad Valor
Parameter group: Shared Image Gallery 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
Parameter group: Resource Id Arguments
--is-vhd

La salida es un distribuidor de VHD.

Propiedad Valor
Parameter group: VHD Arguments
--managed-image

Nombre o identificador de la imagen administrada personalizada que se va a crear.

Propiedad Valor
Parameter group: Managed Image Arguments
--managed-image-location

Ubicación donde se creará la imagen personalizada. El valor predeterminado es la ubicación del grupo de recursos.

Propiedad Valor
Parameter group: Managed Image Arguments
--name -n

Nombre de la plantilla de imagen.

Propiedad Valor
Parameter group: Resource Id Arguments
--output-name

Nombre de la salida de ejecución del generador de imágenes. El valor predeterminado es el nombre de la imagen administrada o la definición de imagen sig.

--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id 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
Parameter group: Resource Id Arguments
--versioning

Describir cómo generar un nuevo número de versión x.y.z para la distribución.

Propiedad Valor
Valores aceptados: Latest, Source
--vhd-uri

URI opcional de Azure Storage para el blob de disco duro virtual distribuido. Omita usar el valor predeterminado (cadena vacía) en cuyo caso el disco duro virtual se publicaría en la cuenta de almacenamiento del grupo de recursos de almacenamiento provisional.

Propiedad Valor
Parameter group: VHD 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

Output format.

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

az image builder output clear

Quite todos los distribuidores de salida del generador de imágenes de una plantilla de Image Builder.

Debe usarse con --defer.

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

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Propiedad Valor
Parameter group: Resource Id Arguments
--name -n

Nombre de la plantilla de imagen.

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id 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
Parameter group: Resource Id 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

Output format.

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

az image builder output remove

Quite un distribuidor de salida de Image Builder de una plantilla de Image Builder.

Debe usarse con --defer.

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

Parámetros requeridos

--output-name

Nombre de la salida de ejecución del generador de imágenes.

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Propiedad Valor
Parameter group: Resource Id Arguments
--name -n

Nombre de la plantilla de imagen.

Propiedad Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Parameter group: Resource Id 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
Parameter group: Resource Id 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

Output format.

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