Freigeben über

az image builder customizer

  • Referenz

Image Builder-Vorlagenanpassung verwalten.

Befehle

Name Beschreibung Typ Status
az image builder customizer add

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

 Kernspeicher Allgemein verfügbar
az image builder customizer clear

Entfernen Sie alle Image Builder Customizer aus einer Image Builder-Vorlage.

 Kernspeicher Allgemein verfügbar
az image builder customizer remove

Entfernen Sie einen Image Builder Customizer aus einer Image Builder-Vorlage.

 Kernspeicher Allgemein verfügbar

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.

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

Optionale Parameter

--defer

Speichert das Objekt temporär im lokalen Cache, anstatt es 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.

--exit-codes -e

Leerzeichentrennte Liste gültiger Ausgangscodes als ganze Zahlen.

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

--filters

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

--ids

Eine oder mehrere 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.

--inline-script

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

--name -n

Der Name der Bildvorlage.

--resource-group -g

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

--restart-check-command

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

--restart-command

Befehl zum Ausführen des Neustartvorgangs.

--restart-timeout

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

Standardwert: 5m
--script-url

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az image builder customizer clear

Entfernen Sie alle Image Builder Customizer aus einer Image Builder-Vorlage.

Muss mit --defer verwendet werden.

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

Optionale Parameter

--defer

Speichert das Objekt temporär im lokalen Cache, anstatt es an Azure zu senden. Verwenden Sie az cache Befehle zum Anzeigen/Löschen.

--ids

Eine oder mehrere 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.

--name -n

Der Name der Bildvorlage.

--resource-group -g

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az image builder customizer remove

Entfernen Sie einen Image Builder Customizer aus einer Image Builder-Vorlage.

Muss mit --defer verwendet werden.

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

Erforderliche Parameter

--customizer-name

Name des Customizers.

Optionale Parameter

--defer

Speichert das Objekt temporär im lokalen Cache, anstatt es an Azure zu senden. Verwenden Sie az cache Befehle zum Anzeigen/Löschen.

--ids

Eine oder mehrere 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.

--name -n

Der Name der Bildvorlage.

--resource-group -g

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.