az image builder customizer

Verwalten von Image Builder-Vorlagenanpassungen.

Befehle

Name	Beschreibung	Typ	Status
az image builder customizer add	Fügen Sie einer Image Builder-Vorlage einen Image Builder Customizer hinzu.	Core	GA
az image builder customizer clear	Entfernen Sie alle Image Builder Customizer aus einer Image Builder-Vorlage.	Core	GA
az image builder customizer remove	Entfernen Sie einen Image Builder Customizer aus einer Image Builder-Vorlage.	Core	GA

az image builder customizer add

Fügen Sie einer Image Builder-Vorlage einen Image Builder Customizer hinzu.

Muss mit --defer verwendet werden.

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]

Beispiele

Hinzufügen eines Inlineshell-Customizers zu einer Bildvorlage im Cli-Objektcache

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

Hinzufügen eines File Customizers zu einer Bildvorlage im Cli-Objektcache

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

Hinzufügen eines Windows-Neustartanpassers zu einer Bildvorlage im Cli-Objektcache

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

Fügen Sie einen Windows Update Customizer zu einer Bildvorlage im Cli-Objektcache hinzu.

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

Erforderliche Parameter

--customizer-name

Name des Customizers.

--type -t

Typ des Customizers, der der Bildvorlage hinzugefügt werden soll.

Eigenschaft	Wert
Zulässige Werte:	file, powershell, shell, windows-restart, windows-update

Optionale Parameter

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

--defer

Speichern Sie das Objekt vorübergehend im lokalen Cache, anstatt an Azure zu senden. Verwenden Sie az cache Befehle zum Anzeigen/Löschen.

--dest-path

Der absolute Zielpfad, in dem die in "-file-source" angegebene Datei in das Bild heruntergeladen wird.

Eigenschaft	Wert
Parameter group:	File Arguments

--exit-codes -e

Leerzeichentrennte Liste gültiger Ausgangscodes als ganze Zahlen.

Eigenschaft	Wert
Parameter group:	Powershell Arguments

--file-source

Der URI der Datei, die in das Bild heruntergeladen werden soll. Es kann sich um einen GitHub-Link, SAS-URI für Azure Storage usw. handeln.

Eigenschaft	Wert
Parameter group:	File Arguments

--filters

Durch Leerzeichen getrennte Filter, um anzuwendende Updates auszuwählen. Lassen Sie das leere Array aus, um den Standardwert zu verwenden (kein Filter).

Eigenschaft	Wert
Parameter group:	Windows Update Arguments

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft	Wert
Parameter group:	Resource Id Arguments

--inline-script

Durch Leerzeichen getrennte Liste der Inlineskriptzeilen, um das Bild anzupassen.

Eigenschaft	Wert
Parameter group:	Shell and Powershell Arguments

--name -n

Der Name der Bildvorlage.

Eigenschaft	Wert
Parameter group:	Resource Id Arguments

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft	Wert
Parameter group:	Resource Id Arguments

--restart-check-command

Befehl, um zu überprüfen, ob der Neustart erfolgreich war.

Eigenschaft	Wert
Parameter group:	Windows Restart Arguments

--restart-command

Befehl zum Ausführen des Neustartvorgangs.

Eigenschaft	Wert
Parameter group:	Windows Restart Arguments

--restart-timeout

Neustarttimeout, das als Zeichenfolge angegeben ist, bestehend aus einer Größe und Einheit, z. B. "5m" (5 Minuten) oder "2h" (2 Stunden).

Eigenschaft	Wert
Parameter group:	Windows Restart Arguments
Standardwert:	5m

--script-url

URL des Skripts zum Anpassen des Bilds mit. Die URL muss öffentlich zugänglich sein.

Eigenschaft	Wert
Parameter group:	Shell and Powershell Arguments

--search-criteria

Kriterien für die Suche nach Aktualisierungen. Lassen Oder geben Sie leere Zeichenfolge an, um die Standardeinstellung zu verwenden (alle durchsuchen). Im obigen Link finden Sie Beispiele und eine ausführliche Beschreibung dieses Felds.

Eigenschaft	Wert
Parameter group:	Windows Update Arguments

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft	Wert
Parameter group:	Resource Id Arguments

--update-limit

Maximale Anzahl von Updates, die gleichzeitig angewendet werden sollen. Lassen Sie "0" aus, oder geben Sie "0" an, um den Standardwert zu verwenden (1000).

Eigenschaft	Wert
Parameter group:	Windows Update Arguments

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False