az image

Nota:

Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Administrar imágenes de máquinas virtuales personalizadas.

Comandos

Nombre	Description	Tipo	Estado
az image builder	Administrar y compilar plantillas de generador de imágenes.	Principal	GA
az image builder cancel	Cancele la compilación de imágenes de larga duración en función de la plantilla de imagen.	Principal	GA
az image builder create	Cree una plantilla de Generador de imágenes.	Principal	GA
az image builder customizer	Administrar personalizadores de plantillas del generador de imágenes.	Principal	GA
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 delete	Elimine la plantilla del generador de imágenes.	Principal	GA
az image builder error-handler	Administrar el controlador de errores de plantilla del generador de imágenes.	Principal	GA
az image builder error-handler add	Agregue el controlador de errores a una plantilla de Generador de imágenes existente.	Principal	GA
az image builder error-handler remove	Quite el controlador de errores de una plantilla de Generador de imágenes existente.	Principal	GA
az image builder error-handler show	Mostrar el controlador de errores de una plantilla existente de Image Builder.	Principal	GA
az image builder identity	Administrar identidades de una plantilla de Image Builder.	Principal	GA
az image builder identity assign	Agregue identidades administradas a una plantilla existente de Image Builder. Actualmente, solo se admite una identidad de usuario.	Principal	GA
az image builder identity remove	Quite las identidades administradas de una plantilla existente de Image Builder.	Principal	GA
az image builder identity show	Mostrar identidades administradas de una plantilla de Image Builder.	Principal	GA
az image builder list	Enumerar plantillas del generador de imágenes.	Principal	GA
az image builder optimizer	Administrar el optimizador de plantillas de Image Builder.	Principal	GA
az image builder optimizer add	Agregue el optimizador a una plantilla existente de Image Builder.	Principal	GA
az image builder optimizer remove	Quite el optimizador de una plantilla existente de Image Builder.	Principal	GA
az image builder optimizer show	Mostrar optimizador de una plantilla existente de Image Builder.	Principal	GA
az image builder optimizer update	Actualice un optimizador a partir de una plantilla existente de Image Builder.	Principal	GA
az image builder output	Administrar distribuidores de salida de plantillas del generador de imágenes.	Principal	GA
az image builder output add	Agregue un distribuidor de salida del generador de imágenes a una plantilla de Image Builder.	Principal	GA
az image builder output clear	Quite todos los distribuidores de salida del generador de imágenes de una plantilla de Image Builder.	Principal	GA
az image builder output remove	Quite un distribuidor de salida de Image Builder de una plantilla de Image Builder.	Principal	GA
az image builder output versioning	Administrar el versionador de salida de la plantilla del generador de imágenes.	Principal	GA
az image builder output versioning remove	Quite todas las opciones de control de versiones en las salidas especificadas.	Principal	GA
az image builder output versioning set	Establezca el versionador de salida del generador de imágenes de una plantilla de Image Builder.	Principal	GA
az image builder output versioning show	Mostrar las opciones de control de versiones en las salidas especificadas.	Principal	GA
az image builder run	Cree una plantilla de generador de imágenes.	Principal	GA
az image builder show	Mostrar una plantilla del generador de imágenes.	Principal	GA
az image builder show-runs	Mostrar las salidas de ejecución de una plantilla de Image Builder.	Principal	GA
az image builder trigger	Administrar el desencadenador de plantilla del generador de imágenes.	Principal	GA
az image builder trigger create	Cree un desencadenador para la plantilla de imagen de máquina virtual especificada.	Principal	GA
az image builder trigger delete	Elimine un desencadenador para la plantilla de imagen de máquina virtual especificada.	Principal	GA
az image builder trigger list	Enumere todos los desencadenadores para el recurso plantilla de imagen especificado.	Principal	GA
az image builder trigger show	Obtenga el desencadenador especificado para el recurso de plantilla de imagen especificado.	Principal	GA
az image builder trigger wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición.	Principal	GA
az image builder update	Actualice una plantilla de Image Builder.	Principal	GA
az image builder validator	Administre la validación de la plantilla del generador de imágenes.	Principal	GA
az image builder validator add	Agregue validate a una plantilla existente de Image Builder.	Principal	GA
az image builder validator remove	Quite validate de una plantilla existente de Image Builder.	Principal	GA
az image builder validator show	Mostrar la validación de una plantilla de Generador de imágenes existente.	Principal	GA
az image builder wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición de la plantilla.	Principal	GA
az image copy	Copie una imagen administrada (o vm) en otras regiones. Requiere que el disco de origen esté disponible.	Extensión	GA
az image create	Cree una imagen de máquina virtual personalizada a partir de discos administrados o instantáneas.	Principal	GA
az image delete	Eliminar una imagen.	Principal	GA
az image list	Enumerar la lista de imágenes en un grupo de recursos.	Principal	GA
az image show	Obtener una imagen.	Principal	GA
az image update	Actualice las imágenes de máquina virtual personalizadas.	Principal	GA
az image wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición.	Principal	GA

az image copy

Copie una imagen administrada (o vm) en otras regiones. Requiere que el disco de origen esté disponible.

az image copy --source-object-name
              --source-resource-group
              --target-location
              --target-resource-group
              [--cleanup]
              [--export-as-snapshot]
              [--parallel-degree]
              [--source-type {image, vm}]
              [--tags]
              [--target-name]
              [--target-subscription]
              [--temporary-resource-group-name]
              [--timeout]

Ejemplos

Copie una imagen en varias regiones y limpie al final.

az image copy --source-resource-group mySources-rg --source-object-name myImage \
    --target-location uksouth northeurope --target-resource-group "images-repo-rg" --cleanup

Use una máquina virtual ya generalizada para crear imágenes en otras regiones.

az image copy --source-resource-group mySources-rg --source-object-name myVm \
    --source-type vm --target-location uksouth northeurope --target-resource-group "images-repo-rg"

Parámetros requeridos

--source-object-name

Nombre de la imagen o recurso de máquina virtual.

--source-resource-group

Nombre del grupo de recursos del recurso de origen.

--target-location

Lista de ubicaciones separadas por espacios para crear la imagen en (por ejemplo, westeurope, etc.).

--target-resource-group

Nombre del grupo de recursos en el que se van a crear imágenes.

Parámetros opcionales

--cleanup

Incluya este modificador para eliminar recursos temporales tras la finalización.

Valor predeterminado: False

--export-as-snapshot

Incluya este modificador para exportar las copias como instantáneas en lugar de imágenes.

Valor predeterminado: False

--parallel-degree

Número de operaciones de copia en paralelo.

Valor predeterminado: -1

--source-type

Imagen o máquina virtual.

Valores aceptados: image, vm

Valor predeterminado: image

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--target-name

Nombre de la imagen final que se creará.

--target-subscription

Nombre o identificador de la suscripción donde se debe crear la imagen final.

--temporary-resource-group-name

Nombre del grupo de recursos donde se creará una cuenta de almacenamiento temporal.

Valor predeterminado: image-copy-rg

--timeout

Tiempo en segundos para que finalice la operación de copia. Aumente este tiempo si va a copiar imágenes grandes (discos) como 512 GB o más.

Valor predeterminado: 3600

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 create

Cree una imagen de máquina virtual personalizada a partir de discos administrados o instantáneas.

az image create --name
                --resource-group
                --source
                [--data-disk-caching {None, ReadOnly, ReadWrite}]
                [--data-disk-sources]
                [--edge-zone]
                [--hyper-v-generation {V1, V2}]
                [--location]
                [--os-disk-caching {None, ReadOnly, ReadWrite}]
                [--os-type {Linux, Windows}]
                [--storage-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
                [--tags]
                [--zone-resilient {false, true}]

Ejemplos

Cree una imagen a partir de un disco existente.

az image create -g MyResourceGroup -n image1 --os-type Linux \
    --source /subscriptions/db5eb68e-73e2-4fa8-b18a-0123456789999/resourceGroups/rg1/providers/Microsoft.Compute/snapshots/s1

Cree una imagen capturando una máquina virtual generalizada existente en el mismo grupo de recursos.

az image create -g MyResourceGroup -n image1 --source MyVm1

Parámetros requeridos

--name -n

Nuevo nombre de imagen.

--resource-group -g

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

--source

Origen del disco del sistema operativo de la misma región, incluido un identificador o un nombre de máquina virtual, un URI de blob de disco del sistema operativo, un identificador o un nombre de disco del sistema operativo administrado, o un identificador o nombre de instantánea del sistema operativo.

Parámetros opcionales

--data-disk-caching

Tipo de almacenamiento en caché para el disco de datos de la imagen.

Valores aceptados: None, ReadOnly, ReadWrite

--data-disk-sources

Lista separada por espacios de orígenes de disco de datos, incluido el URI de blob no administrado, el identificador de disco administrado o el nombre o el nombre de instantánea.

--edge-zone

Nombre de la zona perimetral.

--hyper-v-generation

Generación del hipervisor de la máquina virtual creada a partir de la imagen.

Valores aceptados: V1, V2

Valor predeterminado: V1

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--os-disk-caching

Tipo de almacenamiento en caché para el disco del sistema operativo de la imagen.

Valores aceptados: None, ReadOnly, ReadWrite

--os-type

Valores aceptados: Linux, Windows

--storage-sku

SKU de la cuenta de almacenamiento con la que se va a crear la imagen de máquina virtual. No se usa si se especifica la máquina virtual de origen.

Valores aceptados: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--zone-resilient

Especifica si una imagen es resistente a la zona o no. El valor predeterminado es False. Las imágenes resistentes a zonas solo se pueden crear en regiones que proporcionan almacenamiento con redundancia de zona.

Valores aceptados: false, true

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 delete

Eliminar una imagen.

az image delete [--ids]
                [--image-name]
                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                [--resource-group]
                [--subscription]

Parámetros opcionales

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

--image-name --name -n

Nombre de la imagen.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes

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

Enumerar la lista de imágenes en un grupo de recursos.

az image list [--max-items]
              [--next-token]
              [--resource-group]

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token el argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

--resource-group -g

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

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 show

Obtener una imagen.

az image show [--expand]
              [--ids]
              [--image-name]
              [--resource-group]
              [--subscription]

Parámetros opcionales

--expand

Expresión expand que se va a aplicar en la operación.

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

--image-name --name -n

Nombre de la 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 update

Actualice las imágenes de máquina virtual personalizadas.

az image update [--add]
                [--force-string]
                [--ids]
                [--name]
                [--remove]
                [--resource-group]
                [--set]
                [--subscription]
                [--tags]

Ejemplos

Agregar o actualizar etiquetas.

az image update -n ImageName -g ResourceGroup --tags tag1=val1 tag2=val2

Quite todas las etiquetas.

az image update -n ImageName -g resourceGroup --tags

Parámetros opcionales

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Valor predeterminado: []

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Valor predeterminado: False

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

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Valor predeterminado: []

--resource-group -g

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

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Valor predeterminado: []

--subscription

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

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

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 wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

az image wait [--created]
              [--custom]
              [--deleted]
              [--exists]
              [--expand]
              [--ids]
              [--image-name]
              [--interval]
              [--resource-group]
              [--subscription]
              [--timeout]
              [--updated]

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False

--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False

--exists

Espere hasta que exista el recurso.

Valor predeterminado: False

--expand

Expresión expand que se va a aplicar en la operación.

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

--image-name --name -n

Nombre de la imagen.

--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30

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

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600

--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Valor predeterminado: False

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.