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
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.
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.
Almacene temporalmente el objeto en la memoria caché local en lugar de enviarlo a Azure. Use comandos az cache para ver o borrar.
Nombre o identificador de la definición de imagen SIG existente con la que crear la versión de imagen personalizada.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Shared Image Gallery Arguments |
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 |
|---|---|
| Grupo de parámetros: | Shared Image Gallery Arguments |
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 |
|---|---|
| Grupo de parámetros: | Shared Image Gallery Arguments |
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 |
La salida es un distribuidor de VHD.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | VHD Arguments |
Nombre o identificador de la imagen administrada personalizada que se va a crear.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Managed Image Arguments |
Ubicación donde se creará la imagen personalizada. El valor predeterminado es la ubicación del grupo de recursos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Managed Image Arguments |
Nombre de la plantilla de imagen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
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.
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 |
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 |
Describir cómo generar un nuevo número de versión x.y.z para la distribución.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | Latest, Source |
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 |
|---|---|
| Grupo de parámetros: | VHD Arguments |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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
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.
Almacene temporalmente el objeto en la memoria caché local en lugar de enviarlo a Azure. Use comandos az cache para ver o borrar.
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 |
Nombre de la plantilla de imagen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
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 |
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 |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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
Nombre de la salida de ejecución del generador de imágenes.
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.
Almacene temporalmente el objeto en la memoria caché local en lugar de enviarlo a Azure. Use comandos az cache para ver o borrar.
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 |
Nombre de la plantilla de imagen.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
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 |
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 |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |