az image builder customizer

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

Commandes

Nom	Description	Type	État
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 customizer add

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

Doit être utilisé avec --defer.

az image builder customizer add --customizer-name
                                --type {file, powershell, shell, windows-restart, windows-update}
                                [--defer]
                                [--dest-path]
                                [--exit-codes]
                                [--file-source]
                                [--filters]
                                [--ids]
                                [--inline-script]
                                [--name]
                                [--resource-group]
                                [--restart-check-command]
                                [--restart-command]
                                [--restart-timeout]
                                [--script-url]
                                [--search-criteria]
                                [--subscription]
                                [--update-limit]

Exemples

Ajouter un personnalisateur d’interpréteur de commandes inline à un modèle d’image dans le cache d’objets cli

az image builder customizer add -n myTemplate -g myGroup \
    --inline-script "sudo mkdir /buildArtifacts" \
                    "sudo cp /tmp/index.html /buildArtifacts/index.html" \
    --customizer-name shellScriptInline --type shell --defer

Ajouter un personnalisateur de fichier à un modèle d’image dans le cache d’objets cli

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFile --type file \
    --file-source "https://my-remote-file.html" --dest-path "/tmp/index.html" --defer

Ajouter un personnalisateur de redémarrage Windows à un modèle d’image dans le cache d’objets cli

az image builder customizer add -n myTemplate -g myGroup \
--customizer-name shellScriptUrl \
--restart-check-command "echo Azure-Image-Builder-Restarted-the-VM  > \
                        c:\buildArtifacts\restart.txt" \
    --type windows-restart --restart-timeout 10m --defer

Ajoutez un personnalisateur windows update à un modèle d’image dans le cache d’objets cli.

az image builder customizer add -n myTemplate -g myGroup --customizer-name winUpdate --type windows-update --search-criteria IsInstalled=0 --filters "exclude:\$_.Title -like \'*Preview*\'" "include:\$true" --update-limit 20 --defer

Paramètres obligatoires

--customizer-name

Nom du personnalisateur.

--type -t

Type de personnalisateur à ajouter au modèle d’image.

Propriété	Valeur
Valeurs acceptées:	file, powershell, shell, windows-restart, windows-update

Paramètres facultatifs

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

--defer

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

--dest-path

Chemin d’accès de destination absolu dans lequel le fichier spécifié dans --file-source sera téléchargé dans l’image.

Propriété	Valeur
Parameter group:	File Arguments

--exit-codes -e

Liste séparée par l’espace des codes de sortie valides, sous forme d’entiers.

Propriété	Valeur
Parameter group:	Powershell Arguments

--file-source

URI du fichier à télécharger dans l’image. Il peut s’agir d’un lien github, d’UN URI SAP pour stockage Azure, etc.

Propriété	Valeur
Parameter group:	File Arguments

--filters

Filtres délimités d’espace pour sélectionner les mises à jour à appliquer. Omettez ou spécifiez un tableau vide pour utiliser la valeur par défaut (aucun filtre).

Propriété	Valeur
Parameter group:	Windows Update Arguments

--ids

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--inline-script

Liste séparée par l’espace des lignes de script inline avec laquelle personnaliser l’image.

Propriété	Valeur
Parameter group:	Shell and Powershell Arguments

--name -n

Nom du modèle d’image.

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-group -g

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--restart-check-command

Commande pour vérifier que le redémarrage a réussi.

Propriété	Valeur
Parameter group:	Windows Restart Arguments

--restart-command

Commande pour exécuter l’opération de redémarrage.

Propriété	Valeur
Parameter group:	Windows Restart Arguments

--restart-timeout

Délai d’expiration du redémarrage spécifié sous la forme d’une chaîne composée d’une magnitude et d’une unité, par exemple « 5m » (5 minutes) ou « 2h » (2 heures).

Propriété	Valeur
Parameter group:	Windows Restart Arguments
Valeur par défaut:	5m

--script-url

URL du script avec laquelle personnaliser l’image. L’URL doit être accessible publiquement.

Propriété	Valeur
Parameter group:	Shell and Powershell Arguments

--search-criteria

Critères de recherche des mises à jour. Omettez ou spécifiez une chaîne vide pour utiliser la valeur par défaut (recherche tout). Reportez-vous au lien ci-dessus pour obtenir des exemples et une description détaillée de ce champ.

Propriété	Valeur
Parameter group:	Windows Update Arguments

--subscription

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--update-limit

Nombre maximal de mises à jour à appliquer à la fois. Omettez ou spécifiez 0 pour utiliser la valeur par défaut (1000).

Propriété	Valeur
Parameter group:	Windows Update Arguments

Paramètres globaux

--debug

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

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

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

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

--output -o

Output format.

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

--query

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

--verbose

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

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