Feedback

az image builder customizer

  • Referenz

Image Builder-Vorlagenanpassung verwalten.

Befehle

az image builder customizer add

Fügen Sie einem Bild-Generator-Anpassungsgeber eine Bild-Generatorvorlage hinzu.
az image builder customizer clear

Entfernen Sie alle Bild-Generator-Anpassungen aus einer Bild-Generatorvorlage.
az image builder customizer remove

Entfernen Sie einen Bild-Generator-Customizer aus einer Bild-Generatorvorlage.

az image builder customizer add

Fügen Sie einem Bild-Generator-Anpassungsgeber eine Bild-Generatorvorlage 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]
                                [--update-limit]

Beispiele

Hinzufügen eines Inlineshell-Anpassungsgebers 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 Dateianpassers 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-Neustart-Customizers 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 dem Cli-Objektcache einen Windows Update-Anpassungsgeber zu einer Bildvorlage 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 Anpassungsgebers.

--type -t

Typ des Anpassens, der zur 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 datei angegebene Datei in der Dateiquelle im Bild heruntergeladen wird.

--exit-codes -e

Leerzeichentrennte Liste gültiger Exitcodes, als ganze Zahlen.

--file-source

Der URI der Datei, die in das Bild heruntergeladen werden soll. Es kann ein github-Link, SAS-URI für Azure Storage usw. sein.

--filters

Leerzeichenfilter, um updates auszuwählen, die angewendet werden sollen. Auslassen oder angeben, dass leeres Array verwendet werden soll (kein Filter).

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--inline-script

Leergetrennte Liste der Inlineskriptzeilen, um das Bild mit 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

Starten Sie timeout neu, das als Zeichenfolge angegeben ist, die aus einer Größe und Einheit besteht, 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 Updates. Geben Sie leere Zeichenfolge aus, um die Standardeinstellung zu verwenden (alle durchsuchen). Verweisen Sie auf den oben genannten Link für Beispiele und detaillierte Beschreibung dieses Felds.

--update-limit

Maximale Anzahl von Updates, die gleichzeitig angewendet werden sollen. Auslassen oder Angeben von 0, um den Standardwert (1000) zu verwenden.

az image builder customizer clear

Entfernen Sie alle Bild-Generator-Anpassungen aus einer Bild-Generatorvorlage.

Muss mit --defer verwendet werden.

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

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). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource 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.

az image builder customizer remove

Entfernen Sie einen Bild-Generator-Customizer aus einer Bild-Generatorvorlage.

Muss mit --defer verwendet werden.

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

Erforderliche Parameter

--customizer-name

Name des Anpassungsgebers.

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). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource 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.