az image

  • Référence

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.

Pour gérer les 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.

 Core GA
az image builder cancel

Annulez la build d’image longue en fonction du modèle d’image.

 Core GA
az image builder create

Créez un modèle de générateur d’images.

 Core GA
az image builder customizer

Pour gérer les personnalisateurs de générateur d’images.

 Core GA
az image builder customizer add

Ajoutez un personnalisateur de générateur d’images à un modèle de générateur d’images.

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

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

 Core GA
az image builder delete

Supprimez le modèle de générateur d’images.

 Core GA
az image builder error-handler

Gérer le gestionnaire d’erreurs de modèle de générateur d’images.

 Core GA
az image builder error-handler add

Ajoutez un gestionnaire d’erreurs à un modèle de générateur d’images existant.

 Core GA
az image builder error-handler remove

Supprimez le gestionnaire d’erreurs d’un modèle de générateur d’images existant.

 Core GA
az image builder error-handler show

Afficher le gestionnaire d’erreurs d’un modèle de générateur d’images existant.

 Core GA
az image builder identity

Gérer les identités d’un modèle de générateur d’images.

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

 Core GA
az image builder identity remove

Supprimez les identités managées d’un modèle de générateur d’images existant.

 Core GA
az image builder identity show

Afficher les identités managées d’un modèle de générateur d’images.

 Core GA
az image builder list

Répertorier les modèles de générateur d’images.

 Core GA
az image builder optimizer

Gérer l’optimiseur de modèle du générateur d’images.

 Core GA
az image builder optimizer add

Ajoutez l’optimiseur à un modèle de générateur d’images existant.

 Core GA
az image builder optimizer remove

Supprimez l’optimiseur d’un modèle de générateur d’images existant.

 Core GA
az image builder optimizer show

Afficher l’optimiseur d’un modèle de générateur d’images existant.

 Core GA
az image builder optimizer update

Mettez à jour un optimiseur à partir d’un modèle de générateur d’images existant.

 Core GA
az image builder output

Pour gérer les distributeurs de sortie des modèles de générateur d’images.

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

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

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

 Core GA
az image builder output versioning

Gérer l’éditeur de version de sortie de modèle de générateur d’images.

 Core GA
az image builder output versioning remove

Supprimez toutes les options de contrôle de version sur les sorties spécifiées.

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

 Core GA
az image builder output versioning show

Afficher les options de contrôle de version sur les sorties spécifiées.

 Core GA
az image builder run

Créez un modèle de générateur d’images.

 Core GA
az image builder show

Afficher un modèle de générateur d’images.

 Core GA
az image builder show-runs

Afficher les sorties d’exécution d’un modèle de générateur d’images.

 Core GA
az image builder trigger

Gérer le déclencheur de modèle de générateur d’images.

 Core GA
az image builder trigger create

Créez un déclencheur pour le modèle d’image de machine virtuelle spécifié.

 Core GA
az image builder trigger delete

Supprimez un déclencheur pour le modèle d’image de machine virtuelle spécifié.

 Core GA
az image builder trigger list

Répertoriez tous les déclencheurs pour la ressource de modèle d’image spécifiée.

 Core GA
az image builder trigger show

Obtenez le déclencheur spécifié pour la ressource de modèle d’image spécifiée.

 Core GA
az image builder trigger wait

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

 Core GA
az image builder update

Mettez à jour un modèle de générateur d’images.

 Core GA
az image builder validator

Gérer la validation du modèle de générateur d’images.

 Core GA
az image builder validator add

Ajoutez la validation à un modèle de générateur d’images existant.

 Core GA
az image builder validator remove

Supprimez la validation d’un modèle de générateur d’images existant.

 Core GA
az image builder validator show

Afficher la validation d’un modèle de générateur d’images existant.

 Core GA
az image builder wait

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

 Core 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 de instantané s.

 Core GA
az image delete

Supprimez une image.

 Core GA
az image list

Lister la liste des images sous un groupe de ressources.

 Core GA
az image show

Obtenir une image.

 Core GA
az image update

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

 Core GA
az image wait

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

 Core 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 propre up à 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 que 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher 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êtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az image create

Créez une image de machine virtuelle personnalisée à partir de disques managés ou de 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 en utilisant az configure --defaults group=<name>.

--source

Source de disque du système d’exploitation 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 instantané de système d’exploitation.

Paramètres facultatifs

--data-disk-caching

Stockage type de mise en cache 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 instantané ID ou nom.

--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 provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--os-disk-caching

Stockage type de mise en cache 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 des Stockage redondantes interzone.

Valeurs acceptées: false, true
Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher 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êtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des 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 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 ».

--image-name --name -n

Nom de l'image.

--no-wait

Ne pas attendre 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 en utilisant az configure --defaults group=<name>.

--subscription

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

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

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher 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êtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des 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 l’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 en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher 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êtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des 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 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 ».

--image-name --name -n

Nom de l'image.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

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

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

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher 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êtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az image update

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

az image update [--add]
                [--force-string]
                [--ids]
                [--name]
                [--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>.

Valeur par défaut: []
--force-string

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

Valeur par défaut: False
--ids

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

--name -n

Nom de l'image. Obligatoire.

--remove

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

Valeur par défaut: []
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant 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>.

Valeur par défaut: []
--subscription

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

--tags

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

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher 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êtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des 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 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 ».

--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 en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher 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êtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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