az sig image-version
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.
Administre la versión de la imagen de la galería compartida con la máquina virtual.
Comandos
| Nombre | Description | Tipo | Estado |
|---|---|---|---|
| az sig image-version create |
Crea una nueva versión de imagen. |
Principal | GA |
| az sig image-version delete |
Elimine una versión de imagen de la galería. |
Principal | GA |
| az sig image-version list |
Enumerar las versiones de imagen de la galería en una definición de imagen de la galería. |
Principal | GA |
| az sig image-version list-community |
Enumerar las versiones de imagen de máquina virtual en una comunidad de la galería. |
Principal | GA |
| az sig image-version list-community (image-gallery extensión) |
Enumerar las versiones de imágenes de máquina virtual en una comunidad de la galería (versión preliminar). |
Extensión | Habilitación de características |
| az sig image-version list-shared |
Enumere las versiones de imagen de máquina virtual en una galería compartida directamente a su suscripción o inquilino. |
Principal | GA |
| az sig image-version show |
Recupera información sobre una versión de imagen de la galería. |
Principal | GA |
| az sig image-version show-community |
Obtenga una versión de imagen de la galería de la comunidad. |
Principal | GA |
| az sig image-version show-community (image-gallery extensión) |
Obtenga una versión de imagen en una comunidad de galerías (versión preliminar). |
Extensión | Habilitación de características |
| az sig image-version show-shared |
Obtenga una versión de imagen en una galería compartida directamente en su suscripción o inquilino. |
Principal | GA |
| az sig image-version undelete |
Restaure la versión de imagen eliminada temporalmente. |
Principal | Vista previa |
| az sig image-version update |
Actualice una versión de imagen de recurso compartido. |
Principal | GA |
| az sig image-version wait |
Espere a la operación relacionada con la versión de la imagen. |
Principal | GA |
az sig image-version create
Crea una nueva versión de imagen.
Esta operación puede tardar mucho tiempo en función del número de región de replicación. Se recomienda usar "--no-wait".
az sig image-version create --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--allow-replicated-location-deletion {false, true}]
[--data-snapshot-luns]
[--data-snapshots]
[--data-vhds-luns]
[--data-vhds-sa]
[--data-vhds-uris]
[--end-of-life-date]
[--exclude-from-latest {false, true}]
[--image-version]
[--location]
[--managed-image]
[--no-wait]
[--os-snapshot]
[--os-vhd-storage-account]
[--os-vhd-uri]
[--replica-count]
[--replication-mode {Full, Shallow}]
[--storage-account-type {Premium_LRS, Standard_LRS, Standard_ZRS}]
[--tags]
[--target-edge-zone-encryption]
[--target-edge-zones]
[--target-region-cvm-encryption]
[--target-region-encryption]
[--target-regions]
[--virtual-machine]Ejemplos
Adición de una nueva versión de imagen desde una máquina virtual
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVMAdición de una nueva versión de imagen desde una imagen administrada
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--managed-image /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/images/MyManagedImageAdición de una nueva versión de imagen desde otra versión de imagen
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--image-version /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/galleries/MyGallery/images/MyImageDefinition/versions/1.0.0Adición de una nueva versión de imagen desde un disco administrado
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDiskAdición de una nueva versión de imagen desde un disco administrado y adición de discos de datos adicionales
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk \
--data-snapshot-luns 0Agregue una nueva versión de imagen a partir de una instantánea de un disco del sistema operativo.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshotAgregar una nueva versión de imagen a partir de una instantánea de un disco del sistema operativo y agregar instantáneas adicionales como discos de datos
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0Agregue una nueva versión de imagen desde un disco duro virtual de un disco del sistema operativo.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_fileAgregar una nueva versión de imagen desde un VHD de un disco del sistema operativo y agregar discos duros virtuales adicionales como discos de datos
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-sa /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/myotherstorageaccount \
--data-vhds-uris https://myotherstorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-luns 0Puede combinar instantáneas, discos administrados y discos duros virtuales para crear una nueva versión de imagen. Agregue una nueva versión de imagen mediante un disco duro virtual como disco del sistema operativo y un disco administrado y una instantánea como discos de datos.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0 1Agregue una nueva versión de imagen y cópiela en regiones adicionales. La ubicación principal del origen de la versión de la imagen debe incluirse en la lista de regiones de destino. Para cada región adicional, puede especificar un número de réplicas y un tipo de cuenta de almacenamiento diferentes. De lo contrario, la región heredará del global. El recuento de réplicas predeterminado es 1 y el tipo de cuenta de almacenamiento predeterminado es LRS estándar. En este ejemplo, eastus2 tendrá una réplica almacenada en el almacenamiento de ZRS estándar, ukwest tendrá 3 réplicas almacenadas en el almacenamiento de ZRS estándar, southindia tendrá una réplica almacenada en el almacenamiento LRS estándar y brazilsouth tendrá 2 réplicas almacenadas en el almacenamiento LRS estándar.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-regions eastus2 ukwest=3 southindia=standard_lrs \
brazilsouth=2=standard_lrsAgregue una nueva versión de imagen con cifrado mediante un conjunto de cifrado de disco. El cifrado se aplica a cada disco que forma parte de la versión de la imagen.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-regions westus=2=standard eastus \
--target-region-encryption WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2 \
EastUSDiskEncryptionSet1,0,EastUSDiskEncryptionSet2Agregue una nueva versión de imagen y cópiela en ubicaciones extendidas.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1 \
brazilsouth=2=standard_lrsAgregue una nueva versión de imagen y cópiela en ubicaciones extendidas con cifrado mediante un conjunto de cifrado de disco.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-edge-zones westus=microsoftlosangeles1 \
--target-edge-zone-encryption microsoftlosangeles1,WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2Agregue una nueva versión de imagen y no espere. Más adelante, puede invocar el comando "az sig image-version wait" cuando esté listo para crear una máquina virtual desde la versión de la imagen de la galería.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--no-waitAgregue una nueva versión de imagen, pero quítela de tener en cuenta como versión más reciente en su definición de imagen.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--exclude-from-latest trueAgregue una nueva versión de imagen y establezca su fecha de finalización de ciclo de vida. La versión de la imagen todavía se puede usar para crear una máquina virtual después de su fecha de finalización de ciclo de vida.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--end-of-life-date 2024-08-02T00:00:00+00:00Parámetros requeridos
Definición de imagen de la galería.
Versión de la imagen de la galería en el patrón de versión semántica. Los caracteres permitidos son dígitos y puntos. Los dígitos deben estar dentro del intervalo de un entero de 32 bits, por ejemplo, <MajorVersion>.<MinorVersion>.<Patch>.
Nombre de la galería.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros opcionales
Indica si se permite quitar o no esta versión de imagen de la galería de regiones replicadas.
Números de unidad lógica (delimitados por espacio) de instantáneas de disco de datos.
Nombres o identificadores (delimitados por espacio) de instantáneas de disco de datos.
Números de unidad lógica (delimitados por el espacio) de los URI de VHD de origen de los discos de datos.
Nombres o identificadores (delimitados por espacio) de cuentas de almacenamiento de URI de VHD de origen de discos de datos.
URI de VHD de origen (delimitados por espacio) de discos de datos.
Fecha de finalización de la vida, por ejemplo, "2020-12-31".
La marca significa que si se establece en true, las personas que implementan máquinas virtuales con la versión omitida no usarán esta versión.
Identificador de recurso del origen de la versión de la imagen de la galería.
Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Nombre de la imagen (si está en el mismo grupo de recursos) o identificador de recurso.
No espere hasta que finalice la operación de ejecución prolongada.
Nombre o identificador de la instantánea del disco del sistema operativo.
Nombre o identificador de la cuenta de almacenamiento del URI de VHD de origen del disco del sistema operativo.
URI de VHD de origen del disco del sistema operativo.
Número predeterminado de réplicas que se van a crear por región. Para establecer recuentos de replicación regionales, use --target-regions.
Parámetro opcional que especifica el modo que se va a usar para la replicación. Esta propiedad no es actualizable.
Tipo de cuenta de almacenamiento predeterminado que se va a usar por región. Para establecer los tipos de cuenta de almacenamiento regional, use --target-regions.
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Lista separada por espacios de claves administradas por el cliente para cifrar el sistema operativo y los discos de datos en el artefacto de la galería para cada región. Formato para cada zona perimetral: ,<os_des>,,<lun1_des>,,<lun2_des>.
Lista separada por espacios de regiones, zonas perimetrales, recuentos de réplicas y tipos de almacenamiento. Use =[=][=] para establecer opcionalmente el número de réplicas o el tipo de cuenta de almacenamiento para cada región. Si no se especifica un recuento de réplicas, se usará el recuento de réplicas predeterminado. Si no se especifica un tipo de cuenta de almacenamiento, se usará el tipo de cuenta de almacenamiento predeterminado. Si se especifica "--target-edge-zones None", se borrarán las ubicaciones extendidas de destino.
Lista separada por espacios de la clave administrada por el cliente para la máquina virtual confidencial que cifra el disco del sistema operativo en el artefacto de la galería para cada región. Formato para cada región: <os_cvm_encryption_type>,<os_cvm_des>. Los valores válidos para os_cvm_encryption_type son EncryptedVMGuestStateOnlyWithPmk, EncryptedWithPmk, EncryptedWithCmk.
Lista separada por espacios de claves administradas por el cliente para cifrar el sistema operativo y los discos de datos en el artefacto de la galería para cada región. Formato para cada región: <os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>. Use "null" como marcador de posición.
Lista separada por espacios de regiones y sus recuentos de réplicas. Use <region>[=<replica count>][=<storage account type>] para establecer opcionalmente el número de réplicas o el tipo de cuenta de almacenamiento para cada región. Si no se especifica un recuento de réplicas, se usará el recuento de réplicas predeterminado. Si no se especifica un tipo de cuenta de almacenamiento, se usará el tipo de cuenta de almacenamiento predeterminado.
Identificador de recurso del origen de la máquina virtual.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az sig image-version delete
Elimine una versión de imagen de la galería.
az sig image-version delete [--gallery-image-definition]
[--gallery-image-version]
[--gallery-name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]Parámetros opcionales
Nombre de la definición de imagen de la galería en la que reside la versión de la imagen.
Nombre de la versión de la imagen de la galería que se va a eliminar.
Nombre de Shared Image Gallery en el que reside la definición de imagen.
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".
No espere hasta que finalice la operación de ejecución prolongada.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az sig image-version list
Enumerar las versiones de imagen de la galería en una definición de imagen de la galería.
az sig image-version list --gallery-image-definition
--gallery-name
--resource-group
[--max-items]
[--next-token]Parámetros requeridos
Definición de imagen de la galería.
Nombre de la galería.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros opcionales
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.
Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az sig image-version list-community
Enumerar las versiones de imagen de máquina virtual en una comunidad de la galería.
az sig image-version list-community [--gallery-image-definition]
[--ids]
[--location]
[--marker]
[--public-gallery-name]
[--show-next-marker]
[--subscription]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 myLocationParámetros opcionales
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.
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".
Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
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.
Nombre público de la galería de la comunidad.
Muestra nextMarker en el resultado cuando se especifica.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az sig image-version list-community (image-gallery extensión)
Este comando es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Enumerar las versiones de imágenes de máquina virtual en una comunidad de la galería (versión preliminar).
Enumere las versiones de imagen 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-version list-community [--gallery-image-definition]
[--ids]
[--location]
[--marker]
[--public-gallery-name]
[--show-next-marker]
[--subscription]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 myLocationParámetros opcionales
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.
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".
Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
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.
Nombre público de la galería de la comunidad.
Muestra nextMarker en el resultado cuando se especifica.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az sig image-version list-shared
Enumere las versiones de imagen de máquina virtual en una galería compartida directamente a su suscripción o inquilino.
az sig image-version list-shared [--gallery-image-definition]
[--gallery-unique-name]
[--ids]
[--location]
[--marker]
[--shared-to {tenant}]
[--show-next-marker]
[--subscription]Ejemplos
Enumere las versiones de imagen de una galería compartida directamente a la suscripción en la ubicación y la definición de imagen especificadas.
az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocationEnumere las versiones de imagen de una galería compartida directamente al inquilino en la ubicación y la definición de imagen especificadas.
az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocation --shared-to tenantParámetros opcionales
Nombre de la definición de imagen de la galería compartida de la que se van a enumerar las versiones de la imagen.
Nombre único de la Galería compartida.
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".
Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
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.
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.
Muestra nextMarker en el resultado cuando se especifica.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az sig image-version show
Recupera información sobre una versión de imagen de la galería.
az sig image-version show --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--expand]Parámetros requeridos
Definición de imagen de la galería.
Versión de la imagen de la galería en el patrón de versión semántica. Los caracteres permitidos son dígitos y puntos. Los dígitos deben estar dentro del intervalo de un entero de 32 bits, por ejemplo, <MajorVersion>.<MinorVersion>.<Patch>.
Nombre de la galería.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros opcionales
Expresión expand que se va a aplicar en la operación, por ejemplo, "ReplicationStatus".
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az sig image-version show-community
Obtenga una versión de imagen de la galería de la comunidad.
az sig image-version show-community [--gallery-image-definition]
[--gallery-image-version]
[--ids]
[--location]
[--public-gallery-name]
[--subscription]Parámetros opcionales
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.
Versión de la imagen de la galería en el patrón de versión semántica. Los caracteres permitidos son dígitos y puntos. Los dígitos deben estar dentro del intervalo de un entero de 32 bits, por ejemplo, <MajorVersion>.<MinorVersion>.<Patch>.
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".
Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Nombre público de la galería de la comunidad.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az sig image-version show-community (image-gallery extensión)
Este comando es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Obtenga una versión de imagen en una comunidad de galerías (versión preliminar).
Obtenga una versión de 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 versión preliminar si está interesado en usar esta característica).
az sig image-version show-community [--gallery-image-definition]
[--gallery-image-version]
[--ids]
[--location]
[--public-gallery-name]
[--subscription]Ejemplos
Obtenga una versión de imagen en una comunidad de la galería en la ubicación especificada.
az sig image-version show-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocationParámetros opcionales
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.
Nombre de la versión de la imagen de la galería que se va a crear. Debe seguir el patrón de nombre de versión semántica: los caracteres permitidos son dígitos y puntos. Los dígitos deben estar dentro del intervalo de un entero de 32 bits. Formato:...
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".
Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Nombre público de la galería de la comunidad.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az sig image-version show-shared
Obtenga una versión de imagen en una galería compartida directamente en su suscripción o inquilino.
az sig image-version show-shared [--gallery-image-definition]
[--gallery-image-version]
[--gallery-unique-name]
[--ids]
[--location]
[--subscription]Ejemplos
Obtenga una versión de imagen en una galería compartida directamente en su suscripción o inquilino en la ubicación especificada.
az sig image-version show-shared --gallery-unique-name galleryUniqueName --gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocationParámetros opcionales
Nombre de la definición de imagen de la galería compartida de la que se van a enumerar las versiones de la imagen.
Nombre de la versión de la imagen de la galería que se va a crear. Debe seguir el patrón de nombre de versión semántica: los caracteres permitidos son dígitos y puntos. Los dígitos deben estar dentro del intervalo de un entero de 32 bits. Formato:...
Nombre único de la Galería compartida.
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".
Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az sig image-version undelete
Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Restaure la versión de imagen eliminada temporalmente.
La operación solo se realizará correctamente si se usa en una galería con eliminación temporal.
az sig image-version undelete --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--allow-replicated-location-deletion {false, true}]
[--location]
[--no-wait]
[--tags]Ejemplos
Restaurar una versión de imagen eliminada temporalmente
az sig image-version undelete --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.1.1Parámetros requeridos
Definición de imagen de la galería.
Versión de la imagen de la galería en el patrón de versión semántica. Los caracteres permitidos son dígitos y puntos. Los dígitos deben estar dentro del intervalo de un entero de 32 bits, por ejemplo, <MajorVersion>.<MinorVersion>.<Patch>.
Nombre de la galería.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros opcionales
Indica si se permite quitar o no esta versión de imagen de la galería de regiones replicadas.
Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
No espere hasta que finalice la operación de ejecución prolongada.
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az sig image-version update
Actualice una versión de imagen de recurso compartido.
az sig image-version update --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--add]
[--allow-replicated-location-deletion {false, true}]
[--force-string]
[--no-wait]
[--remove]
[--replica-count]
[--set]
[--target-edge-zones]
[--target-regions]Ejemplos
Cambiar las regiones de replicación y el recuento de réplicas
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-regions westcentralus=2 eastus2Cambiar las ubicaciones extendidas de replicación
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1Borrar las ubicaciones extendidas de replicación
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones NoneReplique en una región adicional. Opcional, puede establecer el recuento de réplicas para la región y excluir esta imagen al usar la versión más reciente de la definición de imagen.
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--add publishingProfile.targetRegions name=westcentralus \
regionalReplicaCount=3 excludeFromLatest=trueCambie si se debe incluir una imagen en consideración para la versión más reciente de la definición de la imagen. Establecer este valor en true excluye la imagen de consideración y establecer este valor en false incluye la imagen para su consideración.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.excludeFromLatest=trueCambie la fecha de finalización del ciclo de vida de una versión de imagen. La imagen todavía se puede usar para crear máquinas virtuales después de la fecha de finalización del ciclo de vida.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.endOfLifeDate=2024-08-02T00:00:00+00:00Permitir quitar la versión de la imagen de la galería de regiones replicadas.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set safetyProfile.allowDeletionOfReplicatedLocations=trueParámetros requeridos
Definición de imagen de la galería.
Versión de la imagen de la galería en el patrón de versión semántica. Los caracteres permitidos son dígitos y puntos. Los dígitos deben estar dentro del intervalo de un entero de 32 bits, por ejemplo, <MajorVersion>.<MinorVersion>.<Patch>.
Nombre de la galería.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros opcionales
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>.
Indica si se permite quitar o no esta versión de imagen de la galería de regiones replicadas.
Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.
No espere hasta que finalice la operación de ejecución prolongada.
Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.
Número predeterminado de réplicas que se van a crear por región. Para establecer recuentos de replicación regionales, use --target-regions.
Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.
Lista separada por espacios de regiones, zonas perimetrales, recuentos de réplicas y tipos de almacenamiento. Use =[=][=] para establecer opcionalmente el número de réplicas o el tipo de cuenta de almacenamiento para cada región. Si no se especifica un recuento de réplicas, se usará el recuento de réplicas predeterminado. Si no se especifica un tipo de cuenta de almacenamiento, se usará el tipo de cuenta de almacenamiento predeterminado. Si se especifica "--target-edge-zones None", se borrarán las ubicaciones extendidas de destino.
Lista separada por espacios de regiones y sus recuentos de réplicas. Use <region>[=<replica count>][=<storage account type>] para establecer opcionalmente el número de réplicas o el tipo de cuenta de almacenamiento para cada región. Si no se especifica un recuento de réplicas, se usará el recuento de réplicas predeterminado. Si no se especifica un tipo de cuenta de almacenamiento, se usará el tipo de cuenta de almacenamiento predeterminado.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az sig image-version wait
Espere a la operación relacionada con la versión de la imagen.
az sig image-version wait --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--interval]
[--timeout]
[--updated]Ejemplos
esperar a que se actualice una versión de imagen
az sig image-version wait --updated --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0espere a que la operación relacionada con la versión de la imagen. (generado automáticamente)
az sig image-version wait --created --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0Parámetros requeridos
Definición de imagen de la galería.
Versión de la imagen de la galería en el patrón de versión semántica. Los caracteres permitidos son dígitos y puntos. Los dígitos deben estar dentro del intervalo de un entero de 32 bits, por ejemplo, <MajorVersion>.<MinorVersion>.<Patch>.
Nombre de la galería.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros opcionales
Espere hasta que se cree con "provisioningState" en "Succeeded".
Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Espere hasta que se elimine.
Espere hasta que exista el recurso.
Expresión expand que se va a aplicar en la operación. El valor predeterminado "ReplicationStatus" es None.
Intervalo de sondeo en segundos.
Espera máxima en segundos.
Espere hasta que se actualice con provisioningState en "Succeeded".
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
