az image builder

  • Référence

Gérer et générer des modèles de générateur d’images.

Commandes

Nom Description Type État
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 builder cancel

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

az image builder cancel [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Exemples

Annulez une build d’image.

az image builder cancel -n mytemplate -g my-group

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

--name -n

Nom du modèle 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>.

--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 builder create

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

az image builder create --name
                        --resource-group
                        [--build-timeout]
                        [--build-vm-identities]
                        [--checksum]
                        [--defer]
                        [--identity]
                        [--image-source]
                        [--image-template]
                        [--location]
                        [--managed-image-destinations]
                        [--no-wait]
                        [--os-disk-size]
                        [--proxy-vm-size]
                        [--scripts]
                        [--shared-image-destinations]
                        [--staging-resource-group]
                        [--subnet]
                        [--tags]
                        [--validator]
                        [--vm-size]
                        [--vnet]

Exemples

Créez un modèle de générateur d’images à partir d’une image Ubuntu2204. Distribuez-la en tant qu’image managée et une version d’image de galerie d’images partagées. Spécifiez l’ID de groupe de ressources intermédiaire comme modèle d’image qui sera utilisé pour générer l’image.

scripts="https://my-script-url.net/customize_script.sh"
imagesource="Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest"

az image builder create --image-source $imagesource -n myTemplate -g myGroup \
    --scripts $scripts --managed-image-destinations image_1=westus \
    --shared-image-destinations my_shared_gallery/linux_image_def=westus,brazilsouth \
    --identity myIdentity --staging-resource-group myStagingResourceGroup

Créez un modèle de générateur d’images à l’aide d’un fichier de modèle d’image.

az image builder create -g my-group -n myTemplate --image-template filename

[Avancé] Créez un modèle d’image avec plusieurs personnalisateurs et distributeurs à l’aide du cache d’objets de l’interface CLI via --defer. Prend en charge les fonctionnalités telles que : le personnalisateur et les noms de sortie, les codes de sortie PowerShell, les scripts inline, les redémarrages windows, les personnalisateurs de fichiers, les balises d’artefact et les distributeurs de sortie vhd.

script="https://my-script-url.com/customize_script.ps1"
imagesource="MicrosoftWindowsServer:WindowsServer:2019-Datacenter:2019.0.20190214"

# create and update template object in local cli cache. Defers put request to ARM
# Cache object ttl set via az configure.
az image builder create --image-source $imagesource -n myTemplate \
    -g myGroup --scripts $script --identity myIdentity --defer

# add customizers
az image builder customizer add -n myTemplate -g myGroup  \
    --customizer-name myPwshScript --exit-codes 0 1 --inline-script \
    "mkdir c:\buildActions" "echo Azure-Image-Builder-Was-Here \
     > c:\buildActions\Output.txt" --type powershell --defer

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFileCustomizer --type file \
    --file-source "https://my-file-source.net/file.txt"  \
    --dest-path "c:\buildArtifacts\file.txt" --defer

# add distributors
az image builder output add -n myTemplate -g myGroup --is-vhd \
    --output-name myWinImageVhd --artifact-tags "is_vhd=True" --defer

az image builder output add -n myTemplate -g myGroup \
    --output-name myWinImageManaged --managed-image winImage \
    --managed-image-location eastus \
    --artifact-tags "is_vhd=False" --defer

# Stop deferring put request to ARM. Create the template from the object cache.
# Cache object will be deleted.
az image builder update -n myTemplate -g myGroup

Paramètres obligatoires

--name -n

Nom du modèle 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>.

Paramètres facultatifs

--build-timeout

Durée maximale d’attente pendant la génération du modèle d’image, en minutes. La valeur par défaut est 60.

--build-vm-identities

Configuration facultative du réseau virtuel à utiliser pour déployer la machine virtuelle de génération. Omettez si aucun réseau virtuel spécifique ne doit être utilisé.

--checksum

Sha256 case activée um de l’image ISO Red Hat.

--defer

Stocker temporairement l’objet dans le cache local au lieu de l’envoyer à Azure. Utilisez az cache des commandes pour afficher/effacer.

--identity

Liste des identités affectées par l’utilisateur (nom ou ID, espace délimité) du modèle d’image.

--image-source -i

Image de base à personnaliser. Doit être un URN d’image de plateforme valide, un alias d’image de plateforme, un URI d’image ISO Red Hat, un nom/ID d’image managée ou un ID de version d’image partagée.

Valeur de: az vm image list, az vm image show
--image-template

Chemin d’accès local ou URL d’un fichier de modèle d’image. Lorsque vous utilisez --image-template, tous les autres paramètres sont ignorés à l’exception de -g et -n. Référence : https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.

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

--managed-image-destinations

Informations du serveur de distribution de sortie d’image managée. Liste séparée par l’espace des paires clé-valeur. Par exemple, « image_1=westus2 image_2=westus ». Chaque clé est le nom ou l’ID de ressource de l’image managée à créer. Chaque valeur est l’emplacement de l’image.

--no-wait

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

Valeur par défaut: False
--os-disk-size

Taille du disque du système d’exploitation en Go. Omettez ou spécifiez 0 pour utiliser la taille de disque du système d’exploitation par défaut d’Azure.

--proxy-vm-size

Taille de la machine virtuelle utilisée pour générer, personnaliser et capturer des images (Standard_D1_v2 pour les images Gen1 et Standard_D2ds_v4 pour les images Gen2).

--scripts

Liste séparée par l’espace des scripts Shell ou PowerShell avec personnalisation de l’image. Chaque script doit être une URL accessible publiquement. Déduit le type de script à partir de l’extension de fichier ('.sh' ou'.ps1') ou du type source. Plus d’options de personnalisateur et de flexibilité supplémentaires, consultez : « az image template customizer add ».

--shared-image-destinations

Informations de distribution de sortie de la galerie d’images partagées (sig). Liste séparée par l’espace des paires clé-valeur. Par exemple, « my_gallery_1/image_def_1=eastus, westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth ». Chaque clé est l’ID de définition d’image sig ou le nom de la galerie sig et la définition d’image sig délimitée par un « / ». Chaque valeur est une liste délimitée par des virgules d’emplacements de réplica.

--staging-resource-group

ID de groupe de ressources intermédiaires dans le même abonnement que le modèle d’image qui sera utilisé pour générer l’image.

--subnet

Nom ou ID du sous-réseau pour déployer la machine virtuelle de build.

--tags

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

--validator

Type de validation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être la validation de l’interpréteur de commandes.

--vm-size

Taille de la machine virtuelle utilisée pour générer, personnaliser et capturer des images. Omettez ou spécifiez une chaîne vide pour utiliser la valeur par défaut (Standard_D1_v2).

--vnet

Nom du réseau virtuel pour déployer la machine virtuelle de build. Vous ne devez le spécifier que lorsque le sous-réseau est un nom.

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 builder delete

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

az image builder delete [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Exemples

Supprimez le modèle de générateur d’images. (généré automatiquement)

az image builder delete --name MyImageTemplate --resource-group MyResourceGroup

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

--name -n

Nom du modèle 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>.

--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 builder list

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

az image builder list [--resource-group]

Paramètres facultatifs

--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 builder run

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

az image builder run [--ids]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--subscription]

Exemples

Démarrez une build de modèle, puis attendez qu’elle se termine.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

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

--name -n

Nom du modèle d’image.

--no-wait

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

Valeur par défaut: False
--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 builder show

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

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

Exemples

Afficher un modèle de générateur d’images (généré automatiquement)

az image builder show --name mytemplate  --resource-group my-group

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

--name -n

Nom du modèle 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>.

--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 builder show-runs

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

az image builder show-runs [--ids]
                           [--name]
                           [--output-name]
                           [--resource-group]
                           [--subscription]

Exemples

Exécutez une build de modèle, puis affichez ses sorties d’exécution.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show-runs -n mytemplate -g my-group

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

--name -n

Nom du modèle d’image.

--output-name

Nom de la sortie d’exécution du générateur d’images.

--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 builder update

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

La mise à jour d’un modèle de générateur d’images n’est actuellement pas prise en charge. Cette commande peut être utilisée conjointement avec --defer pour mettre à jour un objet de modèle d’image dans le cache CLI. Sans différer, il récupère le modèle d’image spécifié à partir du cache et envoie une demande à Azure pour créer le modèle d’image.

az image builder update [--add]
                        [--defer]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]
                        [--subscription]

Exemples

Créez une ressource de modèle à partir d’un objet de modèle dans le cache cli. Pour plus d’informations, consultez « az image builder create / output add / customizer add --help » et « az cache -h » pour plus d’informations

# create and write template object to local cli cache
az image builder create --image-source {image_source} -n mytemplate -g my-group \
    --scripts {script} --managed-image-destinations image_1=westus --identity myidentity --defer

# add customizers and outputs to local cache template object via az image template output / customizer add
# one can also update cache object properties through generic update options, such as: --set
az image builder output add -n mytemplate -g my-group --output-name my-win-image-managed \
    --artifact-tags "is_vhd=False"  --managed-image winImage --managed-image-location eastus --defer

# send template create request to azure to create template resource
az image builder update -n mytemplate -g my-group

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: []
--defer

Stocker temporairement l’objet dans le cache local au lieu de l’envoyer à Azure. Utilisez az cache des commandes pour afficher/effacer.

--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 du modèle d’image.

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

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

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

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

Exemples

Démarrez une build de modèle, puis attendez qu’elle se termine.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

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

--interval

Intervalle d’interrogation en secondes.

Valeur par défaut: 30
--name -n

Nom du modèle 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>.

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