Partager via

az image builder customizer

  • Référence

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

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

Paramètres facultatifs

--defer

Stocker temporairement l’objet dans le cache local au lieu de l’envoyer à Azure. Utilisez az cache des 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.

--exit-codes -e

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

--file-source

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

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

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

--inline-script

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

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

--restart-check-command

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

--restart-command

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

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

Valeur par défaut: 5m
--script-url

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

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

--subscription

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

--update-limit

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

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 customizer clear

Supprimez tous les personnalisateurs de générateur d’images d’un modèle de générateur d’images.

Doit être utilisé avec --defer.

az image builder customizer clear [--defer]
                                  [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

Paramètres facultatifs

--defer

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

--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 customizer remove

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

Doit être utilisé avec --defer.

az image builder customizer remove --customizer-name
                                   [--defer]
                                   [--ids]
                                   [--name]
                                   [--resource-group]
                                   [--subscription]

Paramètres obligatoires

--customizer-name

Nom du personnalisateur.

Paramètres facultatifs

--defer

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

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