az image

  • Referencia

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.