az image

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. En savoir plus sur les extensions.

Gérer des images de machine virtuelle personnalisées.

Commandes

Nom	Description	Type	État
az image builder	Gérer et générer des modèles de générateur d’images.	Noyau	GA
az image builder cancel	Annulez la build d’image longue en fonction du modèle d’image.	Noyau	GA
az image builder create	Créez un modèle de générateur d’images.	Noyau	GA
az image builder customizer	Gérer les personnalisateurs de modèles de générateur d’images.	Noyau	GA
az image builder customizer add	Ajoutez un personnalisateur de générateur d’images à un modèle de générateur d’images.	Noyau	GA
az image builder customizer clear	Supprimez tous les personnalisateurs de générateur d’images d’un modèle de générateur d’images.	Noyau	GA
az image builder customizer remove	Supprimez un personnalisateur de générateur d’images d’un modèle de générateur d’images.	Noyau	GA
az image builder delete	Supprimez le modèle de générateur d’images.	Noyau	GA
az image builder error-handler	Gérer le gestionnaire d’erreurs de modèle de générateur d’images.	Noyau	GA
az image builder error-handler add	Ajoutez un gestionnaire d’erreurs à un modèle de générateur d’images existant.	Noyau	GA
az image builder error-handler remove	Supprimez le gestionnaire d’erreurs d’un modèle de générateur d’images existant.	Noyau	GA
az image builder error-handler show	Afficher le gestionnaire d’erreurs d’un modèle de générateur d’images existant.	Noyau	GA
az image builder identity	Gérer les identités d’un modèle de générateur d’images.	Noyau	GA
az image builder identity assign	Ajoutez des identités managées à un modèle de générateur d’images existant. Actuellement, une seule identité d’utilisateur est prise en charge.	Noyau	GA
az image builder identity remove	Supprimez les identités managées d’un modèle de générateur d’images existant.	Noyau	GA
az image builder identity show	Afficher les identités managées d’un modèle de générateur d’images.	Noyau	GA
az image builder list	Répertorier les modèles de générateur d’images.	Noyau	GA
az image builder optimizer	Gérer l’optimiseur de modèle du générateur d’images.	Noyau	GA
az image builder optimizer add	Ajoutez l’optimiseur à un modèle de générateur d’images existant.	Noyau	GA
az image builder optimizer remove	Supprimez l’optimiseur d’un modèle de générateur d’images existant.	Noyau	GA
az image builder optimizer show	Afficher l’optimiseur d’un modèle de générateur d’images existant.	Noyau	GA
az image builder optimizer update	Mettez à jour un optimiseur à partir d’un modèle de générateur d’images existant.	Noyau	GA
az image builder output	Gérer les distributeurs de sortie de modèle de générateur d’images.	Noyau	GA
az image builder output add	Ajoutez un serveur de distribution de sortie du générateur d’images à un modèle de générateur d’images.	Noyau	GA
az image builder output clear	Supprimez tous les distributeurs de sortie du générateur d’images d’un modèle de générateur d’images.	Noyau	GA
az image builder output remove	Supprimez un serveur de distribution de sortie du générateur d’images d’un modèle de générateur d’images.	Noyau	GA
az image builder output versioning	Gérer l’éditeur de version de sortie de modèle de générateur d’images.	Noyau	GA
az image builder output versioning remove	Supprimez toutes les options de contrôle de version sur les sorties spécifiées.	Noyau	GA
az image builder output versioning set	Définissez le versioner de sortie du générateur d’images d’un modèle de générateur d’images.	Noyau	GA
az image builder output versioning show	Afficher les options de contrôle de version sur les sorties spécifiées.	Noyau	GA
az image builder run	Créez un modèle de générateur d’images.	Noyau	GA
az image builder show	Afficher un modèle de générateur d’images.	Noyau	GA
az image builder show-runs	Afficher les sorties d’exécution d’un modèle de générateur d’images.	Noyau	GA
az image builder trigger	Gérer le déclencheur de modèle de générateur d’images.	Noyau	GA
az image builder trigger create	Créez un déclencheur pour le modèle d’image de machine virtuelle spécifié.	Noyau	GA
az image builder trigger delete	Supprimez un déclencheur pour le modèle d’image de machine virtuelle spécifié.	Noyau	GA
az image builder trigger list	Répertoriez tous les déclencheurs pour la ressource de modèle d’image spécifiée.	Noyau	GA
az image builder trigger show	Obtenez le déclencheur spécifié pour la ressource de modèle d’image spécifiée.	Noyau	GA
az image builder trigger wait	Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.	Noyau	GA
az image builder update	Mettez à jour un modèle de générateur d’images.	Noyau	GA
az image builder validator	Gérer la validation du modèle de générateur d’images.	Noyau	GA
az image builder validator add	Ajoutez la validation à un modèle de générateur d’images existant.	Noyau	GA
az image builder validator remove	Supprimez la validation d’un modèle de générateur d’images existant.	Noyau	GA
az image builder validator show	Afficher la validation d’un modèle de générateur d’images existant.	Noyau	GA
az image builder wait	Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition du modèle soit remplie.	Noyau	GA
az image copy	Copiez une image managée (ou une machine virtuelle) dans d’autres régions. Le disque source doit être disponible.	Extension	GA
az image create	Créez une image de machine virtuelle personnalisée à partir de disques managés ou d’instantanés.	Noyau	GA
az image delete	Supprimez une image.	Noyau	GA
az image list	Lister la liste des images sous un groupe de ressources.	Noyau	GA
az image show	Obtenir une image.	Noyau	GA
az image update	Mettez à jour des images de machine virtuelle personnalisées.	Noyau	GA
az image wait	Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.	Noyau	GA

az image copy

Copiez une image managée (ou une machine virtuelle) dans d’autres régions. Le disque source doit être disponible.

az image copy --source-object-name
              --source-resource-group
              --target-location
              --target-resource-group
              [--cleanup]
              [--export-as-snapshot]
              [--parallel-degree]
              [--source-type {image, vm}]
              [--tags]
              [--target-name]
              [--target-subscription]
              [--temporary-resource-group-name]
              [--timeout]

Exemples

Copiez une image dans plusieurs régions et nettoyez à la fin.

az image copy --source-resource-group mySources-rg --source-object-name myImage \
    --target-location uksouth northeurope --target-resource-group "images-repo-rg" --cleanup

Utilisez une machine virtuelle déjà généralisée pour créer des images dans d’autres régions.

az image copy --source-resource-group mySources-rg --source-object-name myVm \
    --source-type vm --target-location uksouth northeurope --target-resource-group "images-repo-rg"

Paramètres obligatoires

--source-object-name

Nom de l’image ou de la ressource de machine virtuelle.

--source-resource-group

Nom du groupe de ressources de la ressource source.

--target-location

Liste d’emplacements séparés par l’espace pour créer l’image (par exemple, westeurope, etc.).

--target-resource-group

Nom du groupe de ressources dans lequel créer des images.

Paramètres facultatifs

--cleanup

Incluez ce commutateur pour supprimer des ressources temporaires une fois l’opération terminée.

Valeur par défaut: False

--export-as-snapshot

Incluez ce commutateur pour exporter les copies en tant qu’instantanés au lieu d’images.

Valeur par défaut: False

--parallel-degree

Nombre d’opérations de copie parallèle.

Valeur par défaut: -1

--source-type

Image ou machine virtuelle.

Valeurs acceptées: image, vm

Valeur par défaut: image

--tags

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

--target-name

Nom de l’image finale qui sera créée.

--target-subscription

Nom ou ID de l’abonnement dans lequel l’image finale doit être créée.

--temporary-resource-group-name

Nom du groupe de ressources où le compte de stockage temporaire sera créé.

Valeur par défaut: image-copy-rg

--timeout

Temps en secondes pour que l’opération de copie se termine. Augmentez cette durée si vous allez copier des images volumineuses (disques) comme 512 Go ou plus.

Valeur par défaut: 3600

Paramètres globaux

--debug

Augmentez la détail de journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az image create

Créez une image de machine virtuelle personnalisée à partir de disques managés ou d’instantanés.

az image create --name
                --resource-group
                --source
                [--data-disk-caching {None, ReadOnly, ReadWrite}]
                [--data-disk-sources]
                [--edge-zone]
                [--hyper-v-generation {V1, V2}]
                [--location]
                [--os-disk-caching {None, ReadOnly, ReadWrite}]
                [--os-type {Linux, Windows}]
                [--storage-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
                [--tags]
                [--zone-resilient {false, true}]

Exemples

Créez une image à partir d’un disque existant.

az image create -g MyResourceGroup -n image1 --os-type Linux \
    --source /subscriptions/db5eb68e-73e2-4fa8-b18a-0123456789999/resourceGroups/rg1/providers/Microsoft.Compute/snapshots/s1

Créez une image en capturant une machine virtuelle généralisée existante dans le même groupe de ressources.

az image create -g MyResourceGroup -n image1 --source MyVm1

Paramètres obligatoires

--name -n

Nouveau nom d’image.

--resource-group -g

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

--source

Source de disque du système d’exploitation à partir de la même région, y compris un ID ou un nom de machine virtuelle, un URI d’objet blob de disque de système d’exploitation, un ID ou un nom de disque de système d’exploitation managé, ou un ID ou un nom d’instantané du système d’exploitation.

Paramètres facultatifs

--data-disk-caching

Type de mise en cache du stockage pour le disque de données de l’image.

Valeurs acceptées: None, ReadOnly, ReadWrite

--data-disk-sources

Liste séparée par l’espace des sources de disque de données, y compris l’URI d’objet blob non managé, l’ID de disque managé ou le nom, ou l’ID ou le nom d’instantané.

--edge-zone

Nom de la zone de périphérie.

--hyper-v-generation

Génération d’hyperviseur de la machine virtuelle créée à partir de l’image.

Valeurs acceptées: V1, V2

Valeur par défaut: V1

--location -l

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

--os-disk-caching

Type de mise en cache du stockage pour le disque du système d’exploitation de l’image.

Valeurs acceptées: None, ReadOnly, ReadWrite

--os-type

Valeurs acceptées: Linux, Windows

--storage-sku

Référence SKU du compte de stockage avec lequel créer l’image de machine virtuelle. Inutilisé si la machine virtuelle source est spécifiée.

Valeurs acceptées: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

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

--zone-resilient

Spécifie si une image est résiliente ou non à une zone. La valeur par défaut est false. Les images résilientes aux zones peuvent être créées uniquement dans les régions qui fournissent un stockage redondant interzone.

Valeurs acceptées: false, true

Paramètres globaux

--debug

Augmentez la détail de journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az image delete

Supprimez une image.

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

Paramètres facultatifs

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

--image-name --name -n

Nom de l’image.

--no-wait

N’attendez pas la fin de l’opération de longue durée.

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

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

Paramètres globaux

--debug

Augmentez la détail de journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az image list

Lister la liste des images sous un groupe de ressources.

az image list [--max-items]
              [--next-token]
              [--resource-group]

Paramètres facultatifs

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

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

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

--debug

Augmentez la détail de journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az image show

Obtenir une image.

az image show [--expand]
              [--ids]
              [--image-name]
              [--resource-group]
              [--subscription]

Paramètres facultatifs

--expand

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

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

--image-name --name -n

Nom de l’image.

--resource-group -g

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

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

Paramètres globaux

--debug

Augmentez la détail de journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az image update

Mettez à jour des images de machine virtuelle personnalisées.

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

Exemples

Ajoutez ou mettez à jour des balises.

az image update -n ImageName -g ResourceGroup --tags tag1=val1 tag2=val2

Supprimez toutes les balises.

az image update -n ImageName -g resourceGroup --tags

Paramètres facultatifs

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

--force-string

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

Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes

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

--image-name --name -n

Nom de l’image.

--no-wait

N’attendez pas la fin de l’opération de longue durée.

Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes

--remove

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

--resource-group -g

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

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

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

--tags

Les balises de ressource prennent en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Paramètres globaux

--debug

Augmentez la détail de journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az image wait

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

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

Paramètres facultatifs

--created

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

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

--deleted

Attendez la suppression.

Valeur par défaut: False

--exists

Attendez que la ressource existe.

Valeur par défaut: False

--expand

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

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

--image-name --name -n

Nom de l’image.

--interval

Intervalle d’interrogation en secondes.

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

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

--timeout

Délai maximal d’attente en secondes.

Valeur par défaut: 3600

--updated

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

Valeur par défaut: False

Paramètres globaux

--debug

Augmentez la détail de journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.