az sig image-definition

Note

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.

Administre la imagen de la galería compartida con la máquina virtual.

Comandos

Nombre	Description	Tipo	Estado
az sig image-definition create	Cree una definición de imagen de la galería.	Core	GA
az sig image-definition delete	Elimine una imagen de la galería.	Core	GA
az sig image-definition list	Enumerar las definiciones de imágenes de la galería en una galería.	Core	GA
az sig image-definition list-community	Enumerar las definiciones de imágenes de máquina virtual en una comunidad de la galería.	Core	GA
az sig image-definition list-community (image-gallery extensión)	Enumerar las definiciones de imágenes de máquina virtual en una comunidad de la galería (versión preliminar).	Extension	Experimental
az sig image-definition list-shared	Enumere las definiciones de imagen de máquina virtual en una galería compartida directamente en su suscripción o inquilino.	Core	GA
az sig image-definition show	Obtenga información sobre una definición de imagen de la galería.	Core	GA
az sig image-definition show-community	Obtenga una imagen de la galería de la comunidad.	Core	GA
az sig image-definition show-community (image-gallery extensión)	Obtener una imagen en una comunidad de galerías (versión preliminar).	Extension	Experimental
az sig image-definition show-shared	Obtenga una imagen de galería compartida.	Core	GA
az sig image-definition update	Actualice una definición de imagen de máquina virtual.	Core	GA
az sig image-definition wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición.	Core	GA

az sig image-definition create

Cree una definición de imagen de la galería.

az sig image-definition create --gallery-image-definition
                               --gallery-name
                               --offer
                               --os-type {Linux, Windows}
                               --publisher
                               --resource-group
                               --sku
                               [--architecture {Arm64, x64}]
                               [--description]
                               [--disallowed-disk-types]
                               [--end-of-life-date]
                               [--eula]
                               [--features]
                               [--hyper-v-generation {V1, V2}]
                               [--location]
                               [--maximum-cpu-core]
                               [--maximum-memory]
                               [--minimum-cpu-core]
                               [--minimum-memory]
                               [--os-state {Generalized, Specialized}]
                               [--plan-name]
                               [--plan-product]
                               [--plan-publisher]
                               [--privacy-statement-uri]
                               [--release-note-uri]
                               [--tags]

Ejemplos

Creación de una definición de imagen para imágenes de Linux especializadas

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized

Creación de una definición de imagen para imágenes de Linux generalizadas

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Generalized

Creación de una definición de imagen para imágenes de Windows especializadas

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type windows --os-state Specialized

Creación de una definición de imagen para imágenes de Windows generalizadas

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type windows --os-state Generalized

Creación de una definición de imagen con información de plan

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized --plan-name PlanName \
--plan-product PlanProduct --plan-publisher PlanPublisher

Creación de una definición de imagen para imágenes que admiten la característica de hibernación

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features IsHibernateSupported=true

Creación de una definición de imagen para imágenes que admiten redes aceleradas

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features IsAcceleratedNetworkSupported=true

Cree una definición de imagen para las imágenes que solo se pueden usar para crear máquinas virtuales de confianza. Solo se pueden crear máquinas virtuales de confianza a partir de esta imagen.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=TrustedLaunch

Cree una definición de imagen para las imágenes que se pueden usar para crear máquinas virtuales confidenciales.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=ConfidentialVmSupported

Cree una definición de imagen para las imágenes que solo se pueden usar para crear máquinas virtuales confidenciales. Solo se pueden crear máquinas virtuales confidenciales a partir de esta imagen.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=ConfidentialVM

Cree una definición de imagen para las imágenes que se pueden usar para crear máquinas virtuales Gen2 o TrustedLaunchSupported.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=TrustedLaunchSupported

Cree una definición de imagen para las imágenes que se pueden usar para crear máquinas virtuales Gen2, TrustedLaunch o Confidencial.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=TrustedLaunchAndConfidentialVmSupported

Crear una definición de imagen e indicar la fecha de finalización del ciclo de vida

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--end-of-life-date YYYY-MM-DDTHH:MM:SS+00:00

Cree una definición de imagen y recomiende cpu y memoria mínimas y máximas (GB)

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--minimum-cpu-core myMinCPU --maximum-cpu-core myMaxCPU \
--minimum-memory myMinMemory --maximum-memory myMaxMemory

Cree una definición de imagen e indique qué tipos de disco del sistema operativo no se recomiendan para la imagen.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--disallowed-disk-types Standard_LRS

Cree una definición de imagen y proporcione el CLUF, el URI de declaración de privacidad y el URI de notas de la versión.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--eula path_to_eula --privacy-statement-uri path_to_statement \
--release-note-uri path_to_release_notes

Parámetros requeridos

--gallery-image-definition -i

Definición de imagen de la galería.

--gallery-name -r

Nombre de la galería.

--offer -f

Oferta de imagen.

--os-type

Tipo del sistema operativo que se incluye en el disco si crea una máquina virtual a partir de una imagen de usuario o un VHD especializado.

Propiedad	Valor
Valores aceptados:	Linux, Windows

--publisher -p

Editor de imágenes.

--resource-group -g

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

--sku -s

SKU de imagen.

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.

--architecture

Arquitectura de CPU.

Propiedad	Valor
Valores aceptados:	Arm64, x64

--description

Descripción de la definición de la imagen de la galería.

--disallowed-disk-types

Tipos de disco que no funcionarían con la imagen, por ejemplo, Standard_LRS.

--end-of-life-date

Fecha de finalización de la vida, por ejemplo, "2020-12-31".

--eula

Acuerdo de Eula para la imagen de la galería.

--features

Lista de características de imagen de la galería. Por ejemplo, "IsSecureBootSupported=true IsMeasuredBootSupported=false".

--hyper-v-generation

Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.

Propiedad	Valor
Valor predeterminado:	V2
Valores aceptados:	V1, V2

--location -l

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

--maximum-cpu-core

Número máximo de núcleos de CPU.

Propiedad	Valor
Grupo de parámetros:	Recommendation Arguments

--maximum-memory

Memoria máxima en MB.

Propiedad	Valor
Grupo de parámetros:	Recommendation Arguments

--minimum-cpu-core

Núcleos de CPU mínimos.

Propiedad	Valor
Grupo de parámetros:	Recommendation Arguments

--minimum-memory

Memoria mínima en MB.

Propiedad	Valor
Grupo de parámetros:	Recommendation Arguments

--os-state

Esta propiedad permite al usuario especificar si las máquinas virtuales creadas en esta imagen son "Generalizadas" o "Especializadas".

Propiedad	Valor
Valor predeterminado:	Generalized
Valores aceptados:	Generalized, Specialized

--plan-name

Nombre del plan.

Propiedad	Valor
Grupo de parámetros:	Purchase plan Arguments

--plan-product

Planear el producto.

Propiedad	Valor
Grupo de parámetros:	Purchase plan Arguments

--plan-publisher

Publicador del plan.

Propiedad	Valor
Grupo de parámetros:	Purchase plan Arguments

--privacy-statement-uri

URI de la declaración de privacidad.

--release-note-uri

El URI de la nota de la versión.

--tags

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

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

Formato de salida.

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.

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

Propiedad	Valor
Valor predeterminado:	False

az sig image-definition delete

Elimine una imagen de la galería.

az sig image-definition delete [--gallery-image-definition --gallery-image-name]
                               [--gallery-name]
                               [--ids]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--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.

--gallery-image-definition --gallery-image-name -i

Nombre de la definición de imagen de la galería que se va a eliminar.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--gallery-name -r

Nombre de Shared Image Gallery en el que se va a eliminar la definición de imagen.

Propiedad	Valor
Grupo de parámetros:	Resource Id 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
Grupo de parámetros:	Resource Id Arguments

--no-wait

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

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

Propiedad	Valor
Grupo de parámetros:	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
Grupo de parámetros:	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

Formato de salida.

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 sig image-definition list

Enumerar las definiciones de imágenes de la galería en una galería.

az sig image-definition list --gallery-name
                             --resource-group
                             [--max-items]
                             [--next-token]

Parámetros requeridos

--gallery-name -r

Nombre de Shared Image Gallery desde el que se van a enumerar las definiciones de imagen.

--resource-group -g

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

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.

--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 argumento de un comando posterior.

Propiedad	Valor
Grupo de parámetros:	Pagination Arguments

--next-token

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

Propiedad	Valor
Grupo de parámetros:	Pagination 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

Formato de salida.

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.

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

Propiedad	Valor
Valor predeterminado:	False

az sig image-definition list-community

Enumerar las definiciones de imágenes de máquina virtual en una comunidad de la galería.

az sig image-definition list-community --location
                                       --public-gallery-name
                                       [--max-items]
                                       [--next-token]

Ejemplos

Enumerar las versiones de una imagen en una comunidad de la galería.

az sig image-version list-community --public-gallery-name publicGalleryName --gallery-image-definition MyImage --location myLocation

Parámetros requeridos

--location -l

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

--public-gallery-name

Nombre público de la galería de la comunidad.

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.

--max-items

Propiedad	Valor
Grupo de parámetros:	Pagination Arguments

--next-token

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

Propiedad	Valor
Grupo de parámetros:	Pagination 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

Formato de salida.

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.

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

Propiedad	Valor
Valor predeterminado:	False

az sig image-definition list-community (image-gallery extensión)

Habilitación de características

Este comando es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumerar las definiciones de imágenes de máquina virtual en una comunidad de la galería (versión preliminar).

Enumere las definiciones de imágenes de máquina virtual en una comunidad de la galería (característica de versión preliminar privada, póngase en contacto con el equipo de la galería de imágenes de la comunidad por correo electrónico sigpmdev@microsoft.com para registrarse para obtener una versión preliminar si está interesado en usar esta característica).

az sig image-definition list-community [--ids]
                                       [--location]
                                       [--marker]
                                       [--public-gallery-name]
                                       [--show-next-marker]
                                       [--subscription]

Ejemplos

Enumere una definición de imagen en una comunidad de la galería.

az sig image-definition list-community --public-gallery-name publicGalleryName \
--location myLocation

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.

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--location -l

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--marker

Valor de cadena que identifica la parte de la lista de contenedores que se va a devolver con la siguiente operación de lista. La operación devuelve el valor NextMarker dentro del cuerpo de la respuesta si la operación de lista no devolvió todos los contenedores restantes para que se muestren con la página actual. Si se especifica, este generador comenzará a devolver resultados desde el punto en el que se detuvo el generador anterior.

--public-gallery-name

Nombre público de la galería de la comunidad.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--show-next-marker

Muestra nextMarker en el resultado cuando se especifica.

--subscription

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

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

Formato de salida.

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 sig image-definition list-shared

Enumere las definiciones de imagen de máquina virtual en una galería compartida directamente en su suscripción o inquilino.

az sig image-definition list-shared --gallery-unique-name
                                    --location
                                    [--max-items]
                                    [--next-token]
                                    [--shared-to {tenant}]

Ejemplos

Enumere una definición de imagen en una galería compartida directamente a la suscripción en la ubicación especificada.

az sig image-definition list-shared --gallery-unique-name galleryUniqueName --location myLocation

Enumere una definición de imagen en una galería compartida directamente al inquilino en la ubicación especificada.

az sig image-definition list-shared --gallery-unique-name galleryUniqueName --location myLocation --shared-to tenant

Parámetros requeridos

--gallery-unique-name

Nombre único de la Galería compartida.

--location -l

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

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.

--max-items

Propiedad	Valor
Grupo de parámetros:	Pagination Arguments

--next-token

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

Propiedad	Valor
Grupo de parámetros:	Pagination Arguments

--shared-to

Parámetro de consulta para decidir qué galerías compartidas se van a capturar al realizar operaciones de enumeración. Si no se especifica, enumere por identificador de suscripción.

Propiedad	Valor
Valores aceptados:	tenant

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

Formato de salida.

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.

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

Propiedad	Valor
Valor predeterminado:	False

az sig image-definition show

Obtenga información sobre una definición de imagen de la galería.

az sig image-definition show [--gallery-image-definition --gallery-image-name]
                             [--gallery-name]
                             [--ids]
                             [--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.

--gallery-image-definition --gallery-image-name -i

Nombre de la definición de imagen de la galería que se va a recuperar.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--gallery-name -r

Nombre de shared Image Gallery desde el que se van a recuperar las definiciones de imagen.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

--subscription

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

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

Formato de salida.

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 sig image-definition show-community

Obtenga una imagen de la galería de la comunidad.

az sig image-definition show-community [--gallery-image-definition]
                                       [--ids]
                                       [--location]
                                       [--public-gallery-name]
                                       [--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.

--gallery-image-definition -i

Nombre de la definición de imagen de la galería de la comunidad a partir de la cual se mostrarán las versiones de la imagen.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--location -l

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--public-gallery-name

Nombre público de la galería de la comunidad.

Propiedad	Valor
Grupo de parámetros:	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
Grupo de parámetros:	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

Formato de salida.

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 sig image-definition show-community (image-gallery extensión)

Habilitación de características

Este comando es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Obtener una imagen en una comunidad de galerías (versión preliminar).

Obtenga una imagen en una comunidad de la galería (característica de versión preliminar privada, póngase en contacto con el equipo de la galería de imágenes de la comunidad por correo electrónico sigpmdev@microsoft.com para registrarse para obtener una vista previa si está interesado en usar esta característica).

az sig image-definition show-community [--gallery-image-definition]
                                       [--ids]
                                       [--location]
                                       [--public-gallery-name]
                                       [--subscription]

Ejemplos

Obtenga una definición de imagen en una comunidad de galerías en la ubicación especificada.

az sig image-definition show-community --public-gallery-name publicGalleryName \
--gallery-image-definition myGalleryImageName --location myLocation

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.

--gallery-image-definition -i

Nombre de la definición de imagen de la galería de la comunidad a partir de la cual se mostrarán las versiones de la imagen.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--location -l

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--public-gallery-name

Nombre público de la galería de la comunidad.

Propiedad	Valor
Grupo de parámetros:	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
Grupo de parámetros:	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

Formato de salida.

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 sig image-definition show-shared

Obtenga una imagen de galería compartida.

Obtenga una imagen de galería compartida que se haya compartido directamente en su suscripción o inquilino.

az sig image-definition show-shared [--gallery-image-definition --gallery-image-name]
                                    [--gallery-unique-name]
                                    [--ids]
                                    [--location]
                                    [--subscription]

Ejemplos

Obtenga una definición de imagen en una galería compartida directamente en su suscripción o inquilino en la ubicación especificada.

az sig image-definition show-shared --gallery-unique-name galleryUniqueName --gallery-image-definition myGalleryImageName --location myLocation

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.

--gallery-image-definition --gallery-image-name -i

Nombre de la definición de imagen de la galería compartida de la que se van a enumerar las versiones de la imagen.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--gallery-unique-name

Nombre único de la Galería compartida.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--location -l

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

Propiedad	Valor
Grupo de parámetros:	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
Grupo de parámetros:	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

Formato de salida.

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 sig image-definition update

Actualice una definición de imagen de máquina virtual.

az sig image-definition update [--add]
                               [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                               [--gallery-image-definition]
                               [--gallery-name]
                               [--ids]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--remove]
                               [--resource-group]
                               [--set]
                               [--subscription]

Ejemplos

Cambiar la configuración recomendada de la definición de imagen compartida

az sig image-definition update --resource-group MyResourceGroup --gallery-name MyGallery --gallery-image-definition MyImage --resource-group MyResourceGroup --set recommended.vCpUs.min=myNewvCpUsMin recommended.vCpUs.max=myNewvCpUsMax recommended.memory.min=myNewMemoryMin recommended.memory.max=myNewMemoryMax description="newDescription"

Quitar la propiedad de configuración de una definición de imagen compartida

az sig image-definition update --resource-group MyResourceGroup --gallery-name MyGallery --gallery-image-definition MyImage --resource-group MyResourceGroup --remove recommended.vCpUs.min

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.

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

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments

--force-string

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

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valores aceptados:	0, 1, f, false, n, no, t, true, y, yes

--gallery-image-definition -i

Nombre de la definición de imagen de la galería que se va a recuperar.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--gallery-name -r

Nombre de Shared Image Gallery en el que reside la definición de imagen.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--no-wait

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

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

--remove

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

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments

--resource-group -g

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

--set

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

Propiedad	Valor
Grupo de parámetros:	Generic Update 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
Grupo de parámetros:	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

Formato de salida.

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 sig image-definition wait

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

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

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.

--created

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

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	False

--custom

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

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments

--deleted

Espere hasta que se elimine.

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	False

--exists

Espere hasta que exista el recurso.

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	False

--gallery-image-definition --gallery-image-name -i

Nombre de la definición de imagen de la galería que se va a recuperar.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--gallery-name -r

Nombre de shared Image Gallery desde el que se van a recuperar las definiciones de imagen.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--ids

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--interval

Intervalo de sondeo en segundos.

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	30

--resource-group -g

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

--subscription

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

--timeout

Espera máxima en segundos.

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	3600

--updated

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

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	False

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

Formato de salida.

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

Comentarios

¿Le ha resultado útil esta página?

Compartir a través de

az sig image-definition

Comandos

az sig image-definition create

Ejemplos

Parámetros requeridos

Parámetros opcionales

az sig image-definition delete

Parámetros opcionales

az sig image-definition list

Parámetros requeridos

Parámetros opcionales

az sig image-definition list-community

Ejemplos

Parámetros requeridos

Parámetros opcionales

az sig image-definition list-community (image-gallery extensión)

Ejemplos

Parámetros opcionales

az sig image-definition list-shared

Ejemplos

Parámetros requeridos

Parámetros opcionales

az sig image-definition show

Parámetros opcionales

az sig image-definition show-community

Parámetros opcionales

az sig image-definition show-community (image-gallery extensión)

Ejemplos

Parámetros opcionales

az sig image-definition show-shared

Ejemplos

Parámetros opcionales

az sig image-definition update

Ejemplos

Parámetros opcionales

az sig image-definition wait

Parámetros opcionales

Comentarios