az sig image-version
Remarque
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. En savoir plus sur les 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 de l’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 | Expérimental |
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 |
Récupère 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 | Expérimental |
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 | Aperçu |
az sig image-version update |
Mettez à jour une version d’image de partage. |
Core | GA |
az sig image-version wait |
Attendez l’opération liée à la version de l’image. |
Core | GA |
az sig image-version create
Créez une nouvelle version de l’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}]
[--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]
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é 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é, 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
Paramètres obligatoires
Définition d’image de la galerie.
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>
.
Nom de la galerie.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Indiquez si la suppression ou non de cette version d’image de galerie des régions répliquées est autorisée.
Nombres d’unités logiques (délimités par l’espace) des instantané de disque de données.
Noms ou ID (délimités par l’espace) des instantané de disque de données.
Nombres d’unités logiques (délimités par l’espace) des URI de disque dur virtuel source des disques de données.
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.
URI de disque dur virtuel source (délimité par l’espace) des disques de données.
Date de fin de vie, par exemple « 2020-12-31 ».
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.
ID de ressource de la source de version d’image de la galerie.
Emplacement. Valeurs provenant de : az account list-locations
. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>
.
Nom de l’image (si dans le même groupe de ressources) ou ID de ressource.
Ne pas attendre la fin de l’opération de longue durée.
Nom ou ID du disque du système d’exploitation instantané.
Nom ou ID du compte de stockage de l’URI de disque dur virtuel source du disque du système d’exploitation.
URI de disque dur virtuel source du disque du système d’exploitation.
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.
Paramètre facultatif qui spécifie le mode à utiliser pour la réplication. Cette propriété n’est pas modifiable.
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.
Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.
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ériphérie : ,<os_des,lun1_des,lun2_des<><>>.
Liste séparée par l’espace des régions, zones de périphérie, nombres de réplicas et types de stockage. Utilisez =[=][=] 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.
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.
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é.
Liste séparée par l’espace des régions et leur nombre de réplicas. Permet <region>[=<replica count>][=<storage account type>]
de 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é.
ID de ressource de la source de machine virtuelle.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az sig image-version delete
Supprimez une version d’image de galerie.
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]
Paramètres facultatifs
Nom de la définition d’image de la galerie dans laquelle réside la version de l’image.
Nom de la version de l’image de la galerie à supprimer.
Nom de la galerie d’images partagées dans laquelle réside la définition d’image.
Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».
Ne pas attendre la fin de l’opération de longue durée.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
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-name
--resource-group
[--max-items]
[--next-token]
Paramètres obligatoires
Définition d’image de la galerie.
Nom de la galerie.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
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
l’argument d’une commande suivante.
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.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
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]
[--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
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.
Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».
Emplacement. Valeurs provenant de : az account list-locations
. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>
.
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é.
Nom public de la galerie de communautés.
Affichez nextMarker dans le résultat lorsqu’il est spécifié.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az sig image-version list-community (image-gallery extension)
Cette commande est expérimentale et en cours de développement. Référence et niveaux 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
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.
Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».
Emplacement. Valeurs provenant de : az account list-locations
. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>
.
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é.
Nom public de la galerie de communautés.
Affichez nextMarker dans le résultat lorsqu’il est spécifié.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
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]
[--ids]
[--location]
[--marker]
[--shared-to {tenant}]
[--show-next-marker]
[--subscription]
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 facultatifs
Nom de la définition d’image de la galerie partagée à partir de laquelle les versions d’image doivent être répertoriées.
Nom unique de la galerie partagée.
Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».
Emplacement. Valeurs provenant de : az account list-locations
. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>
.
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é.
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.
Affichez nextMarker dans le résultat lorsqu’il est spécifié.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az sig image-version show
Récupère des informations sur une version d’image de la galerie.
az sig image-version show --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--expand]
Paramètres obligatoires
Définition d’image de la galerie.
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>
.
Nom de la galerie.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Expression de développement à appliquer sur l’opération, par exemple « ReplicationStatus ».
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
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-version]
[--ids]
[--location]
[--public-gallery-name]
[--subscription]
Paramètres facultatifs
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.
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>
.
Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».
Emplacement. Valeurs provenant de : az account list-locations
. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>
.
Nom public de la galerie de la communauté.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az sig image-version show-community (image-gallery extension)
Cette commande est expérimentale et en cours de développement. Référence et niveaux 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
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.
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:...
Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».
Emplacement. Valeurs provenant de : az account list-locations
. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>
.
Nom public de la galerie de communautés.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
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-version]
[--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
Nom de la définition d’image de la galerie partagée à partir de laquelle les versions d’image doivent être répertoriées.
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:...
Nom unique de la galerie partagée.
Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».
Emplacement. Valeurs provenant de : az account list-locations
. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>
.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az sig image-version undelete
Cette commande est en préversion et en cours de développement. Référence et niveaux 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
Définition d’image de la galerie.
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>
.
Nom de la galerie.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Indiquez si la suppression ou non de cette version d’image de galerie des régions répliquées est autorisée.
Emplacement. Valeurs provenant de : az account list-locations
. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>
.
Ne pas attendre la fin de l’opération de longue durée.
Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
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}]
[--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
Paramètres obligatoires
Définition d’image de la galerie.
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>
.
Nom de la galerie.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
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>
.
Indiquez si la suppression ou non de cette version d’image de galerie des régions répliquées est autorisée.
Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.
Ne pas attendre la fin de l’opération de longue durée.
Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
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.
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>
.
Liste séparée par l’espace des régions, zones de périphérie, nombres de réplicas et types de stockage. Utilisez =[=][=] 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.
Liste séparée par l’espace des régions et leur nombre de réplicas. Permet <region>[=<replica count>][=<storage account type>]
de 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
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.
az sig image-version wait
Attendez l’opération liée à la version de l’image.
az sig image-version wait --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--interval]
[--timeout]
[--updated]
Exemples
attendre qu’une version d’image soit mise à jour
az sig image-version wait --updated --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0
attendez l’opération liée à la version de l’image. (généré automatiquement)
az sig image-version wait --created --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0
Paramètres obligatoires
Définition d’image de la galerie.
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>
.
Nom de la galerie.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Attendez la création avec « provisioningState » sur « Succeeded ».
Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].
Attendez la suppression.
Attendez que la ressource existe.
Expression de développement à appliquer à l’opération. La valeur par défaut « ReplicationStatus » est None.
Intervalle d’interrogation en secondes.
Délai maximal d’attente en secondes.
Attendez la mise à jour avec provisioningState sur « Réussi ».
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.