Partager via

az sig image-version

Note

Ce groupe de commandes a des commandes définies dans Azure CLI et au moins une extension. Installez chaque extension pour bénéficier de ses fonctionnalités étendues. Learn more about extensions.

Gérer la version d’image de galerie partagée avec une machine virtuelle.

Commandes

Nom Description Type État
az sig image-version create

Créez une nouvelle version d’image.

 Core GA
az sig image-version delete

Supprimez une version d’image de galerie.

 Core GA
az sig image-version list

Répertorier les versions d’images de la galerie dans une définition d’image de galerie.

 Core GA
az sig image-version list-community

Répertoriez les versions d’images de machine virtuelle dans une communauté de galerie.

 Core GA
az sig image-version list-community (image-gallery extension)

Répertorier les versions d’images de machine virtuelle dans une communauté de galerie (préversion).

 Extension Experimental
az sig image-version list-shared

Répertoriez les versions d’images de machine virtuelle dans une galerie partagée directement avec votre abonnement ou locataire.

 Core GA
az sig image-version show

Obtenez des informations sur une version d’image de la galerie.

 Core GA
az sig image-version show-community

Obtenir une version d’image de la galerie de communautés.

 Core GA
az sig image-version show-community (image-gallery extension)

Obtenir une version d’image dans une communauté de galerie (préversion).

 Extension Experimental
az sig image-version show-shared

Obtenez une version d’image dans une galerie partagée directement avec votre abonnement ou locataire.

 Core GA
az sig image-version undelete

Restaurer la version d’image supprimée de manière réversible.

 Core Preview
az sig image-version update

Mettez à jour une version d’image de partage.

 Core GA
az sig image-version wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.

 Core GA

az sig image-version create

Créez une nouvelle version d’image.

Cette opération peut prendre beaucoup de temps en fonction du numéro de région de réplication. Utilisez « --no-wait » est conseillé.

az sig image-version create --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group
                            [--allow-replicated-location-deletion {false, true}]
                            [--block-delete-before-eol --block-deletion-before-end-of-life {false, true}]
                            [--data-snapshot-luns]
                            [--data-snapshots]
                            [--data-vhds-luns]
                            [--data-vhds-sa --data-vhds-storage-accounts]
                            [--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]
                            [--storage-account-type {Premium_LRS, Standard_LRS, Standard_ZRS}]
                            [--tags]
                            [--target-edge-zone-encryption --zone-encryption]
                            [--target-edge-zones]
                            [--target-region-cvm-encryption]
                            [--target-region-encryption]
                            [--target-regions]
                            [--virtual-machine]

Exemples

Ajouter une nouvelle version d’image à partir d’une machine virtuelle

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

Ajouter une nouvelle version d’image à partir d’une image managée

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

Ajouter une nouvelle version d’image à partir d’une autre version d’image

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

Ajouter une nouvelle version d’image à partir d’un disque managé

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

Ajouter une nouvelle version d’image à partir d’un disque managé et ajouter des disques de données supplémentaires

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 0

Ajoutez une nouvelle version d’image à partir d’un instantané d’un disque de système d’exploitation.

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

Ajouter une nouvelle version d’image à partir d’un instantané d’un disque de système d’exploitation et ajouter des instantanés supplémentaires en tant que disques de données

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 0

Ajoutez une nouvelle version d’image à partir d’un disque dur virtuel d’un disque de système d’exploitation.

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

Ajouter une nouvelle version d’image à partir d’un disque dur virtuel d’un disque de système d’exploitation et ajouter des disques durs virtuels supplémentaires en tant que disques de données

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 0

Vous pouvez combiner des instantanés, des disques managés et des disques durs virtuels pour créer une nouvelle version d’image. Ajoutez une nouvelle version d’image à l’aide d’un disque dur virtuel en tant que disque de système d’exploitation et d’un disque managé et d’un instantané en tant que disques de données.

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 1

Ajoutez une nouvelle version d’image et copiez-la dans des régions supplémentaires. L’emplacement d’accueil de la source de la version de l’image doit être inclus dans la liste des régions cibles. Pour chaque région supplémentaire, vous pouvez spécifier un nombre de réplicas et un type de compte de stockage différents. Sinon, la région héritera du global. Le nombre de réplicas par défaut est 1 et le type de compte de stockage par défaut est Standard LRS. Dans cet exemple, eastus2 aura un réplica stocké sur le stockage ZRS Standard, ukwest aura 3 réplicas stockés sur le stockage ZRS Standard, southindia aura un réplica stocké sur le stockage LRS Standard, et brésilsouth aura 2 réplicas stockés sur le stockage LRS Standard.

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_lrs

Ajoutez une nouvelle version d’image avec chiffrement à l’aide d’un jeu de chiffrement de disque. Le chiffrement est appliqué à chaque disque qui fait partie de la version de l’image.

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

Ajoutez une nouvelle version d’image et copiez-la dans des emplacements étendus.

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_lrs

Ajoutez une nouvelle version d’image et copiez-la dans des emplacements étendus avec chiffrement à l’aide d’un jeu de chiffrement de disque.

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

Ajoutez une nouvelle version d’image et n’attendez pas dessus. Plus tard, vous pouvez appeler la commande « az sig image-version wait » quand vous êtes prêt à créer une machine virtuelle à partir de la version d’image de la galerie

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

Ajoutez une nouvelle version d’image, mais supprimez-la de la considération en tant que dernière version dans sa définition d’image

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 true

Ajoutez une nouvelle version d’image et définissez sa date de fin de vie. La version de l’image peut toujours être utilisée pour créer une machine virtuelle après sa date de fin de vie.

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

Ajoutez une nouvelle version d’image et bloquez la suppression de cette version d’image si sa fin de vie n’a pas expiré

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:00 \
--block-deletion-before-end-of-life true

Paramètres obligatoires

--gallery-image-definition -i

Définition d’image de la galerie.

--gallery-image-version -e

Version d’image de la galerie dans le modèle de version sémantique. Les caractères autorisés sont des chiffres et des points. Les chiffres doivent se trouver dans la plage d’un entier 32 bits, par exemple <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Gallery name.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--allow-replicated-location-deletion

Indiquez si la suppression ou non de cette version d’image de galerie des régions répliquées est autorisée.

Propriété Valeur
Valeurs acceptées: false, true
--block-delete-before-eol --block-deletion-before-end-of-life

Indiquez si la suppression est bloquée ou non pour cette version d’image de la galerie si sa fin de vie n’a pas expiré.

Propriété Valeur
Valeurs acceptées: false, true
--data-snapshot-luns

Nombres d’unités logiques (délimités par l’espace) des instantanés de disque de données.

--data-snapshots

Noms ou ID (délimités par l’espace) des instantanés de disque de données.

--data-vhds-luns

Nombres d’unités logiques (délimités par l’espace) des URI de disque dur virtuel source des disques de données.

--data-vhds-sa --data-vhds-storage-accounts

Noms ou ID (délimités par l’espace) des comptes de stockage des URI de disque dur virtuel source des disques de données.

--data-vhds-uris

URI de disque dur virtuel source (délimité par l’espace) des disques de données.

--end-of-life-date

Date de fin de vie, par exemple « 2020-12-31 ».

--exclude-from-latest

L’indicateur signifie que s’il est défini sur true, les personnes qui déploient des machines virtuelles avec la version omise n’utilisent pas cette version.

Propriété Valeur
Valeurs acceptées: false, true
--image-version

ID de ressource de la source de version d’image de la galerie.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--managed-image

Nom de l’image (si dans le même groupe de ressources) ou ID de ressource.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--os-snapshot

Nom ou ID de l’instantané de disque du système d’exploitation.

--os-vhd-storage-account

Nom ou ID du compte de stockage de l’URI de disque dur virtuel source du disque du système d’exploitation.

--os-vhd-uri

URI de disque dur virtuel source du disque du système d’exploitation.

--replica-count

Nombre par défaut de réplicas à créer par région. Pour définir les nombres de réplication régionales, utilisez --target-regions.

--replication-mode

Paramètre facultatif qui spécifie le mode à utiliser pour la réplication. Cette propriété n’est pas modifiable.

--storage-account-type

Type de compte de stockage par défaut à utiliser par région. Pour définir les types de comptes de stockage régionaux, utilisez --target-regions.

Propriété Valeur
Valeurs acceptées: Premium_LRS, Standard_LRS, Standard_ZRS
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--target-edge-zone-encryption --zone-encryption

Liste séparée par l’espace des clés gérées par le client pour chiffrer le système d’exploitation et les disques de données dans l’artefact de la galerie pour chaque région. Format pour chaque zone de périmètre : <edge zone>,<os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>.

--target-edge-zones

Liste séparée par l’espace des régions, zones de périphérie, nombres de réplicas et types de stockage. Utilisez <region>=<edge zone>[=<replica count>][=<storage account type>] pour définir éventuellement le nombre de réplicas et/ou le type de compte de stockage pour chaque région. Si aucun nombre de réplicas n’est spécifié, le nombre de réplicas par défaut est utilisé. Si aucun type de compte de stockage n’est spécifié, le type de compte de stockage par défaut est utilisé. Si « --target-edge-zones None » est spécifié, les emplacements étendus cibles sont effacés.

--target-region-cvm-encryption

Liste séparée par l’espace de la clé gérée par le client pour la machine virtuelle confidentielle qui chiffre le disque du système d’exploitation dans l’artefact de la galerie pour chaque région. Format pour chaque région : <os_cvm_encryption_type>,<os_cvm_des>. Les valeurs valides pour os_cvm_encryption_type sont EncryptedVMGuestStateOnlyWithPmk, EncryptedWithPmk, EncryptedWithCmk.

--target-region-encryption

Liste séparée par l’espace des clés gérées par le client pour chiffrer le système d’exploitation et les disques de données dans l’artefact de la galerie pour chaque région. Format pour chaque région : <os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>. Utilisez « null » comme espace réservé.

--target-regions

Liste séparée par l’espace des régions et leur nombre de réplicas. Utilisez <region>[=<replica count>][=<storage account type>] pour définir éventuellement le nombre de réplicas et/ou le type de compte de stockage pour chaque région. Si aucun nombre de réplicas n’est spécifié, le nombre de réplicas par défaut est utilisé. Si aucun type de compte de stockage n’est spécifié, le type de compte de stockage par défaut est utilisé.

--virtual-machine

ID de ressource de la source de machine virtuelle.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sig image-version delete

Supprimez une version d’image de galerie.

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

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Nom de la définition d’image de la galerie dans laquelle réside la version de l’image.

Propriété Valeur
Parameter group: Resource Id Arguments
--gallery-image-version --gallery-image-version-name -e

Nom de la version de l’image de la galerie à supprimer.

Propriété Valeur
Parameter group: Resource Id Arguments
--gallery-name -r

Nom de la galerie d’images partagées dans laquelle réside la définition d’image.

Propriété Valeur
Parameter group: Resource Id Arguments
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Parameter group: Resource Id Arguments
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Parameter group: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Parameter group: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sig image-version list

Répertorier les versions d’images de la galerie dans une définition d’image de galerie.

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

Paramètres obligatoires

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

Définition d’image de la galerie.

--gallery-name -r

Gallery name.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--max-items

Nombre total d’éléments à retourner dans la sortie de la commande. Si le nombre total d’éléments disponibles est supérieur à la valeur spécifiée, un jeton est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur du jeton dans --next-token argument d’une commande suivante.

Propriété Valeur
Parameter group: Pagination Arguments
--next-token

Jeton pour spécifier où commencer la pagination. Il s’agit de la valeur du jeton d’une réponse tronquée précédemment.

Propriété Valeur
Parameter group: Pagination Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sig image-version list-community

Répertoriez les versions d’images de machine virtuelle dans une communauté de galerie.

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

Exemples

Répertorier les versions d’une image dans une communauté de galerie.

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

Paramètres obligatoires

--gallery-image-definition -i

Nom de la définition d’image de la galerie de communautés à partir de laquelle les versions d’image doivent être répertoriées.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--public-gallery-name

Nom public de la galerie de la communauté.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--max-items

Nombre total d’éléments à retourner dans la sortie de la commande. Si le nombre total d’éléments disponibles est supérieur à la valeur spécifiée, un jeton est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur du jeton dans --next-token argument d’une commande suivante.

Propriété Valeur
Parameter group: Pagination Arguments
--next-token

Jeton pour spécifier où commencer la pagination. Il s’agit de la valeur du jeton d’une réponse tronquée précédemment.

Propriété Valeur
Parameter group: Pagination Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sig image-version list-community (image-gallery extension)

Expérimental

Cette commande est expérimentale et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Répertorier les versions d’images de machine virtuelle dans une communauté de galerie (préversion).

Répertoriez les versions d’images de machine virtuelle dans une communauté de galerie (fonctionnalité de préversion privée, contactez l’équipe de la galerie d’images de la communauté par e-mail sigpmdev@microsoft.com pour vous inscrire à la préversion si vous souhaitez utiliser cette fonctionnalité).

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

Exemples

Répertorier les versions d’une image dans une communauté de galerie.

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

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--gallery-image-definition -i

Nom de la définition d’image de la galerie de communautés à partir de laquelle les versions d’image doivent être répertoriées.

Propriété Valeur
Parameter group: Resource Id Arguments
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Parameter group: Resource Id Arguments
--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

Propriété Valeur
Parameter group: Resource Id Arguments
--marker

Valeur de chaîne qui identifie la partie de la liste des conteneurs à retourner avec l’opération de référencement suivante. L’opération retourne la valeur NextMarker dans le corps de la réponse si l’opération de référencement n’a pas renvoyé tous les conteneurs restants à répertorier avec la page active. Si spécifié, ce générateur commence à retourner les résultats à partir du point où le générateur précédent s’est arrêté.

--public-gallery-name

Nom public de la galerie de communautés.

Propriété Valeur
Parameter group: Resource Id Arguments
--show-next-marker

Affichez nextMarker dans le résultat lorsqu’il est spécifié.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Parameter group: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sig image-version list-shared

Répertoriez les versions d’images de machine virtuelle dans une galerie partagée directement avec votre abonnement ou locataire.

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

Exemples

Répertoriez les versions d’image d’une galerie partagée directement avec votre abonnement à l’emplacement et à la définition d’image donnés.

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

Répertoriez les versions d’image d’une galerie partagée directement avec votre locataire à l’emplacement et à la définition d’image donnés.

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

Paramètres obligatoires

--gallery-image-definition -i

Nom de la définition d’image de la galerie partagée à partir de laquelle les versions d’image doivent être répertoriées.

--gallery-unique-name

Nom unique de la galerie partagée.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--max-items

Nombre total d’éléments à retourner dans la sortie de la commande. Si le nombre total d’éléments disponibles est supérieur à la valeur spécifiée, un jeton est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur du jeton dans --next-token argument d’une commande suivante.

Propriété Valeur
Parameter group: Pagination Arguments
--next-token

Jeton pour spécifier où commencer la pagination. Il s’agit de la valeur du jeton d’une réponse tronquée précédemment.

Propriété Valeur
Parameter group: Pagination Arguments
--shared-to

Paramètre de requête pour déterminer les galeries partagées à extraire lors de la liste des opérations. Si ce n’est pas spécifié, listez par ID d’abonnement.

Propriété Valeur
Valeurs acceptées: tenant
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sig image-version show

Obtenez des informations sur une version d’image de la galerie.

az sig image-version show [--expand {ReplicationStatus, UefiSettings}]
                          [--gallery-image-definition]
                          [--gallery-image-version --gallery-image-version-name]
                          [--gallery-name]
                          [--ids]
                          [--resource-group]
                          [--subscription]

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--expand

Expression de développement à appliquer à l’opération.

Propriété Valeur
Valeurs acceptées: ReplicationStatus, UefiSettings
--gallery-image-definition -i

Nom de la définition d’image de la galerie dans laquelle réside la version de l’image.

Propriété Valeur
Parameter group: Resource Id Arguments
--gallery-image-version --gallery-image-version-name -e

Nom de la version de l’image de la galerie à supprimer.

Propriété Valeur
Parameter group: Resource Id Arguments
--gallery-name -r

Nom de la galerie d’images partagées dans laquelle réside la définition d’image.

Propriété Valeur
Parameter group: Resource Id Arguments
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Parameter group: Resource Id Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Parameter group: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Parameter group: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sig image-version show-community

Obtenir une version d’image de la galerie de communautés.

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

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Nom de la définition d’image de la galerie de communautés à partir de laquelle les versions d’image doivent être répertoriées.

Propriété Valeur
Parameter group: Resource Id Arguments
--gallery-image-version --gallery-image-version-name -e

Version d’image de la galerie dans le modèle de version sémantique. Les caractères autorisés sont des chiffres et des points. Les chiffres doivent se trouver dans la plage d’un entier 32 bits, par exemple <MajorVersion>.<MinorVersion>.<Patch>.

Propriété Valeur
Parameter group: Resource Id Arguments
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Parameter group: Resource Id Arguments
--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

Propriété Valeur
Parameter group: Resource Id Arguments
--public-gallery-name

Nom public de la galerie de la communauté.

Propriété Valeur
Parameter group: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Parameter group: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sig image-version show-community (image-gallery extension)

Expérimental

Cette commande est expérimentale et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Obtenir une version d’image dans une communauté de galerie (préversion).

Obtenez une version d’image dans une communauté de galerie (fonctionnalité de préversion privée, contactez l’équipe de la galerie d’images de la communauté par e-mail sigpmdev@microsoft.com pour vous inscrire à la préversion si vous souhaitez utiliser cette fonctionnalité).

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

Exemples

Obtenez une version d’image dans une communauté de galerie à l’emplacement donné.

az sig image-version show-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocation

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--gallery-image-definition -i

Nom de la définition d’image de la galerie de communautés à partir de laquelle les versions d’image doivent être répertoriées.

Propriété Valeur
Parameter group: Resource Id Arguments
--gallery-image-version -e

Nom de la version de l’image de la galerie à créer. Doit suivre le modèle de nom de version sémantique : les caractères autorisés sont des chiffres et des points. Les chiffres doivent se trouver dans la plage d’un entier 32 bits. Format : <MajorVersion>.<MinorVersion>.<Patch>.

Propriété Valeur
Parameter group: Resource Id Arguments
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Parameter group: Resource Id Arguments
--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

Propriété Valeur
Parameter group: Resource Id Arguments
--public-gallery-name

Nom public de la galerie de communautés.

Propriété Valeur
Parameter group: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Parameter group: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sig image-version show-shared

Obtenez une version d’image dans une galerie partagée directement avec votre abonnement ou locataire.

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

Exemples

Obtenez une version d’image dans une galerie partagée directement avec votre abonnement ou locataire à l’emplacement donné.

az sig image-version show-shared --gallery-unique-name galleryUniqueName --gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocation

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Nom de la définition d’image de la galerie partagée à partir de laquelle les versions d’image doivent être répertoriées.

Propriété Valeur
Parameter group: Resource Id Arguments
--gallery-image-version --gallery-image-version-name -e

Nom de la version de l’image de la galerie à créer. Doit suivre le modèle de nom de version sémantique : les caractères autorisés sont des chiffres et des points. Les chiffres doivent se trouver dans la plage d’un entier 32 bits. Format : <MajorVersion>.<MinorVersion>.<Patch>.

Propriété Valeur
Parameter group: Resource Id Arguments
--gallery-unique-name

Nom unique de la galerie partagée.

Propriété Valeur
Parameter group: Resource Id Arguments
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Parameter group: Resource Id Arguments
--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

Propriété Valeur
Parameter group: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Parameter group: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sig image-version undelete

Préversion

Cette commande est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Restaurer la version d’image supprimée de manière réversible.

L’opération réussit uniquement si elle est utilisée dans une galerie avec suppression réversible activée.

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]

Exemples

Restaurer une version d’image supprimée de manière réversible

az sig image-version undelete --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.1.1

Paramètres obligatoires

--gallery-image-definition -i

Définition d’image de la galerie.

--gallery-image-version -e

Version d’image de la galerie dans le modèle de version sémantique. Les caractères autorisés sont des chiffres et des points. Les chiffres doivent se trouver dans la plage d’un entier 32 bits, par exemple <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Gallery name.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--allow-replicated-location-deletion

Indiquez si la suppression ou non de cette version d’image de galerie des régions répliquées est autorisée.

Propriété Valeur
Valeurs acceptées: false, true
--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sig image-version update

Mettez à jour une version d’image de partage.

az sig image-version update --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group
                            [--add]
                            [--allow-replicated-location-deletion {false, true}]
                            [--block-delete-before-eol --block-deletion-before-end-of-life {false, true}]
                            [--force-string]
                            [--no-wait]
                            [--remove]
                            [--replica-count]
                            [--set]
                            [--target-edge-zones]
                            [--target-regions]

Exemples

Modifier les régions de réplication et le nombre 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 eastus2

Modifier les emplacements étendus de réplication

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

Effacer les emplacements étendus de réplication

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones None

Répliquer vers une région supplémentaire. Facultatif, vous pouvez définir le nombre de réplicas pour la région et exclure cette image lors de l’utilisation de la dernière version de la définition d’image.

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

Modifiez si une image doit être incluse en considération pour la dernière version de la définition d’image. La définition de cette valeur sur true exclut l’image de la considération et la définition de cette valeur sur false inclut l’image à prendre en compte.

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.excludeFromLatest=true

Modifiez la date de fin de vie d’une version d’image. L’image peut toujours être utilisée pour créer des machines virtuelles après la date de fin de vie.

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

Autorisez la suppression de la version de l’image de la galerie des régions répliquées.

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set safetyProfile.allowDeletionOfReplicatedLocations=true

Bloquer la suppression de cette version de l’image de la galerie si sa fin de vie n’est pas expirée.

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--block-deletion-before-end-of-life true

Paramètres obligatoires

--gallery-image-definition -i

Définition d’image de la galerie.

--gallery-image-version -e

Version d’image de la galerie dans le modèle de version sémantique. Les caractères autorisés sont des chiffres et des points. Les chiffres doivent se trouver dans la plage d’un entier 32 bits, par exemple <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Gallery name.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

Propriété Valeur
Parameter group: Generic Update Arguments
Valeur par défaut: []
--allow-replicated-location-deletion

Indiquez si la suppression ou non de cette version d’image de galerie des régions répliquées est autorisée.

Propriété Valeur
Valeurs acceptées: false, true
--block-delete-before-eol --block-deletion-before-end-of-life

Indiquez si la suppression est bloquée ou non pour cette version d’image de la galerie si sa fin de vie n’a pas expiré.

Propriété Valeur
Valeurs acceptées: false, true
--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

Propriété Valeur
Parameter group: Generic Update Arguments
Valeur par défaut: False
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriété Valeur
Parameter group: Generic Update Arguments
Valeur par défaut: []
--replica-count

Nombre par défaut de réplicas à créer par région. Pour définir les nombres de réplication régionales, utilisez --target-regions.

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

Propriété Valeur
Parameter group: Generic Update Arguments
Valeur par défaut: []
--target-edge-zones

Liste séparée par l’espace des régions, zones de périphérie, nombres de réplicas et types de stockage. Utilisez <region>=<edge zone>[=<replica count>][=<storage account type>] pour définir éventuellement le nombre de réplicas et/ou le type de compte de stockage pour chaque région. Si aucun nombre de réplicas n’est spécifié, le nombre de réplicas par défaut est utilisé. Si aucun type de compte de stockage n’est spécifié, le type de compte de stockage par défaut est utilisé. Si « --target-edge-zones None » est spécifié, les emplacements étendus cibles sont effacés.

--target-regions

Liste séparée par l’espace des régions et leur nombre de réplicas. Utilisez <region>[=<replica count>][=<storage account type>] pour définir éventuellement le nombre de réplicas et/ou le type de compte de stockage pour chaque région. Si aucun nombre de réplicas n’est spécifié, le nombre de réplicas par défaut est utilisé. Si aucun type de compte de stockage n’est spécifié, le type de compte de stockage par défaut est utilisé.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az sig image-version wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.

az sig image-version wait [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--expand {ReplicationStatus, UefiSettings}]
                          [--gallery-image-definition]
                          [--gallery-image-version --gallery-image-version-name]
                          [--gallery-name]
                          [--ids]
                          [--interval]
                          [--resource-group]
                          [--subscription]
                          [--timeout]
                          [--updated]

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

Propriété Valeur
Parameter group: Wait Condition Arguments
Valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

Propriété Valeur
Parameter group: Wait Condition Arguments
--deleted

Attendez la suppression.

Propriété Valeur
Parameter group: Wait Condition Arguments
Valeur par défaut: False
--exists

Attendez que la ressource existe.

Propriété Valeur
Parameter group: Wait Condition Arguments
Valeur par défaut: False
--expand

Expression de développement à appliquer à l’opération.

Propriété Valeur
Valeurs acceptées: ReplicationStatus, UefiSettings
--gallery-image-definition -i

Nom de la définition d’image de la galerie dans laquelle réside la version de l’image.

Propriété Valeur
Parameter group: Resource Id Arguments
--gallery-image-version --gallery-image-version-name -e

Nom de la version de l’image de la galerie à supprimer.

Propriété Valeur
Parameter group: Resource Id Arguments
--gallery-name -r

Nom de la galerie d’images partagées dans laquelle réside la définition d’image.

Propriété Valeur
Parameter group: Resource Id Arguments
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Parameter group: Resource Id Arguments
--interval

Intervalle d’interrogation en secondes.

Propriété Valeur
Parameter group: Wait Condition Arguments
Valeur par défaut: 30
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Parameter group: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Parameter group: Resource Id Arguments
--timeout

Délai maximal d’attente en secondes.

Propriété Valeur
Parameter group: Wait Condition Arguments
Valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

Propriété Valeur
Parameter group: Wait Condition Arguments
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False