Freigeben über

az image builder

Verwalten und Erstellen von Image Builder-Vorlagen

Befehle

Name Beschreibung Typ Status
az image builder cancel

Abbrechen des Builds für lang ausgeführtes Image basierend auf der Bildvorlage.

 Core GA
az image builder create

Erstellen Sie eine Image Builder-Vorlage.

 Core GA
az image builder customizer

Verwalten von Image Builder-Vorlagenanpassungen.

 Core GA
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 delete

Löschen Sie die Bild-Generator-Vorlage.

 Core GA
az image builder error-handler

Fehlerhandler für Die Image Builder-Vorlage verwalten.

 Core GA
az image builder error-handler add

Fügen Sie einer vorhandenen Image Builder-Vorlage Einen Fehlerhandler hinzu.

 Core GA
az image builder error-handler remove

Entfernen Sie den Fehlerhandler aus einer vorhandenen Image Builder-Vorlage.

 Core GA
az image builder error-handler show

Fehlerhandler einer vorhandenen Image Builder-Vorlage anzeigen.

 Core GA
az image builder identity

Verwalten von Identitäten einer Image Builder-Vorlage.

 Core GA
az image builder identity assign

Fügen Sie einer vorhandenen Image Builder-Vorlage verwaltete Identitäten hinzu. Derzeit wird nur eine Benutzeridentität unterstützt.

 Core GA
az image builder identity remove

Entfernen sie verwaltete Identitäten aus einer vorhandenen Image Builder-Vorlage.

 Core GA
az image builder identity show

Anzeigen verwalteter Identitäten einer Image Builder-Vorlage.

 Core GA
az image builder list

Bild-Generator-Vorlagen auflisten.

 Core GA
az image builder optimizer

Verwalten sie den Optimierer für Image Builder-Vorlagen.

 Core GA
az image builder optimizer add

Fügen Sie einer vorhandenen Image Builder-Vorlage Optimierer hinzu.

 Core GA
az image builder optimizer remove

Entfernen Sie den Optimierer aus einer vorhandenen Image Builder-Vorlage.

 Core GA
az image builder optimizer show

Optimierer einer vorhandenen Image Builder-Vorlage anzeigen.

 Core GA
az image builder optimizer update

Aktualisieren Sie einen Optimierer aus einer vorhandenen Image Builder-Vorlage.

 Core GA
az image builder output

Verwalten sie die Ausgabeverteiler von Image Builder-Vorlagen.

 Core GA
az image builder output add

Fügen Sie einer Image Builder-Vorlage einen Ausgabeverteiler für den Image Builder hinzu.

 Core GA
az image builder output clear

Entfernen Sie alle Bild-Generator-Ausgabeverteiler aus einer Image Builder-Vorlage.

 Core GA
az image builder output remove

Entfernen Sie einen Bild-Generator-Ausgabeverteiler aus einer Image Builder-Vorlage.

 Core GA
az image builder output versioning

Verwalten sie die Ausgabeversionsverwaltung für Bild-Generator-Vorlagen.

 Core GA
az image builder output versioning remove

Entfernen Sie alle Versionsverwaltungsoptionen für angegebene Ausgaben.

 Core GA
az image builder output versioning set

Legen Sie die Ausgabeversionsverwaltung für den Image Builder einer Image Builder-Vorlage fest.

 Core GA
az image builder output versioning show

Versionsverwaltungsoptionen für angegebene Ausgaben anzeigen.

 Core GA
az image builder run

Erstellen Sie eine Image Builder-Vorlage.

 Core GA
az image builder show

Zeigen Sie eine Bild-Generator-Vorlage an.

 Core GA
az image builder show-runs

Zeigen Sie die Ausführungsausgabe einer Bild-Generator-Vorlage an.

 Core GA
az image builder trigger

Verwalten des Bild-Generator-Vorlagentriggers.

 Core GA
az image builder trigger create

Erstellen Sie einen Trigger für die angegebene Imagevorlage für virtuelle Computer.

 Core GA
az image builder trigger delete

Löschen eines Triggers für die angegebene Imagevorlage für virtuelle Computer.

 Core GA
az image builder trigger list

Listet alle Trigger für die angegebene Bildvorlagenressource auf.

 Core GA
az image builder trigger show

Rufen Sie den angegebenen Trigger für die angegebene Bildvorlagenressource ab.

 Core GA
az image builder trigger wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist.

 Core GA
az image builder update

Aktualisieren sie eine Image Builder-Vorlage.

 Core GA
az image builder validator

Verwalten sie die Überprüfung der Image Builder-Vorlage.

 Core GA
az image builder validator add

Fügen Sie einer vorhandenen Image Builder-Vorlage Eine Überprüfung hinzu.

 Core GA
az image builder validator remove

Entfernen Sie die Überprüfung aus einer vorhandenen Image Builder-Vorlage.

 Core GA
az image builder validator show

Zeigen Sie die Überprüfung einer vorhandenen Image Builder-Vorlage an.

 Core GA
az image builder wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Vorlage erfüllt ist.

 Core GA

az image builder cancel

Abbrechen des Builds für lang ausgeführtes Image basierend auf der Bildvorlage.

az image builder cancel [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Beispiele

Abbrechen eines Imagebuilds.

az image builder cancel -n mytemplate -g my-group

Optionale Parameter

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

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

az image builder create

Erstellen Sie eine Image Builder-Vorlage.

az image builder create --name
                        --resource-group
                        [--build-timeout]
                        [--build-vm-identities]
                        [--checksum]
                        [--defer]
                        [--identity]
                        [--image-source]
                        [--image-template]
                        [--location]
                        [--managed-image-destinations]
                        [--no-wait]
                        [--os-disk-size]
                        [--proxy-vm-size]
                        [--scripts]
                        [--shared-image-destinations]
                        [--staging-resource-group]
                        [--subnet]
                        [--tags]
                        [--validator]
                        [--vm-size]
                        [--vnet]

Beispiele

Erstellen Sie eine Image Builder-Vorlage aus einem Ubuntu2204-Image. Verteilen Sie es als verwaltetes Bild und als freigegebene Bildgaleriebildversion. Geben Sie die Stagingressourcengruppen-ID als Bildvorlage an, die zum Erstellen des Images verwendet wird.

scripts="https://my-script-url.net/customize_script.sh"
imagesource="Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest"

az image builder create --image-source $imagesource -n myTemplate -g myGroup \
    --scripts $scripts --managed-image-destinations image_1=westus \
    --shared-image-destinations my_shared_gallery/linux_image_def=westus,brazilsouth \
    --identity myIdentity --staging-resource-group myStagingResourceGroup

Erstellen Sie eine Bild-Generator-Vorlage mithilfe einer Bildvorlagendatei.

az image builder create -g my-group -n myTemplate --image-template filename

[Erweitert] Erstellen Sie eine Bildvorlage mit mehreren Customizern und Distributoren mithilfe des Objektcaches der CLI über --defer. Unterstützt Features wie: Customizer- und Ausgabenamen, PowerShell-Exitcodes, Inlineskripts, Windows-Neustart, Dateianpasser, Artefakttags und vhd-Ausgabeverteiler.

script="https://my-script-url.com/customize_script.ps1"
imagesource="MicrosoftWindowsServer:WindowsServer:2019-Datacenter:2019.0.20190214"

# create and update template object in local cli cache. Defers put request to ARM
# Cache object ttl set via az configure.
az image builder create --image-source $imagesource -n myTemplate \
    -g myGroup --scripts $script --identity myIdentity --defer

# add customizers
az image builder customizer add -n myTemplate -g myGroup  \
    --customizer-name myPwshScript --exit-codes 0 1 --inline-script \
    "mkdir c:\buildActions" "echo Azure-Image-Builder-Was-Here \
     > c:\buildActions\Output.txt" --type powershell --defer

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFileCustomizer --type file \
    --file-source "https://my-file-source.net/file.txt"  \
    --dest-path "c:\buildArtifacts\file.txt" --defer

# add distributors
az image builder output add -n myTemplate -g myGroup --is-vhd \
    --output-name myWinImageVhd --artifact-tags "is_vhd=True" --defer

az image builder output add -n myTemplate -g myGroup \
    --output-name myWinImageManaged --managed-image winImage \
    --managed-image-location eastus \
    --artifact-tags "is_vhd=False" --defer

# Stop deferring put request to ARM. Create the template from the object cache.
# Cache object will be deleted.
az image builder update -n myTemplate -g myGroup

Erforderliche Parameter

--name -n

Der Name der Bildvorlage.

--resource-group -g

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

Optionale Parameter

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

--build-timeout

Die maximale Wartezeit beim Erstellen der Bildvorlage in Minuten. Der Standardwert ist 60.

--build-vm-identities

Optionale Konfiguration des virtuellen Netzwerks, das zum Bereitstellen des virtuellen Buildcomputers verwendet werden soll. Lassen Sie aus, wenn kein bestimmtes virtuelles Netzwerk verwendet werden muss.

--checksum

Die SHA256-Prüfsumme des Red Hat ISO-Images.

Eigenschaft Wert
Parameter group: Image Source Arguments
--defer

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

--identity

Liste der vom Benutzer zugewiesenen Identitäten (Name oder ID, durch Leerzeichen getrennt) der Bildvorlage.

--image-source -i

Das anzupassende Basisbild. Muss ein gültiger Plattformimage-URN, Plattformimagealias, Red Hat ISO-Image-URI, verwalteter Imagename/-ID oder versions-ID für freigegebene Bilder sein.

Eigenschaft Wert
Parameter group: Image Source Arguments
Wert aus: az vm image list, az vm image show
--image-template

Lokaler Pfad oder url zu einer Bildvorlagendatei. Bei Verwendung von --image-template werden alle anderen Parameter außer -g und -n ignoriert. Referenz: https://learn.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Location. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>konfigurieren.

--managed-image-destinations

Informationen zu verwalteten Bildausgabeverteiler. Durch Leerzeichen getrennte Liste von Schlüssel-Wert-Paaren. Z.B. "image_1=westus2 image_2=westus". Jeder Schlüssel ist der Name oder die Ressourcen-ID des zu erstellenden verwalteten Images. Jeder Wert ist die Position des Bilds.

Eigenschaft Wert
Parameter group: Output Arguments
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--os-disk-size

Größe des Betriebssystemdatenträgers in GB. Geben Sie "0" aus, um die Standardgröße des Betriebssystemdatenträgers von Azure zu verwenden.

--proxy-vm-size

Größe des virtuellen Computers, der zum Erstellen, Anpassen und Erfassen von Images verwendet wird (Standard_D1_v2 für Gen1-Images und Standard_D2ds_v4 für Gen2-Images).

--scripts

Durch Leerzeichen getrennte Liste von Shell- oder PowerShell-Skripts, um das Bild anzupassen. Jedes Skript muss eine öffentlich zugängliche URL sein. Leitet den Typ des Skripts aus der Dateierweiterung ('.sh' oder'.ps1') oder vom Quelltyp ab. Weitere Anpassungsoptionen und Flexibilität finden Sie unter :"az image template customizer add".

Eigenschaft Wert
Parameter group: Customizer Arguments
--shared-image-destinations

Freigegebene Bildkataloginformationen (sig) Ausgabeverteilerinformationen. Durch Leerzeichen getrennte Liste von Schlüssel-Wert-Paaren. Z. B. "my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth." Jeder Schlüssel ist die SIG-Bilddefinitions-ID oder der Sig-Katalogname und sig-Bilddefinition, die durch ein "/" getrennt ist. Jeder Wert ist eine durch Trennzeichen getrennte Liste von Replikatspeicherorten.

Eigenschaft Wert
Parameter group: Output Arguments
--staging-resource-group

Die Stagingressourcengruppen-ID im selben Abonnement wie die Bildvorlage, die zum Erstellen des Images verwendet wird.

--subnet

Name oder ID des Subnetzs, um den virtuellen Buildcomputer bereitzustellen.

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--validator

Der Typ der Überprüfung, die Sie für das Bild verwenden möchten. Beispielsweise kann "Shell" die Shellüberprüfung sein.

--vm-size

Größe des virtuellen Computers, der zum Erstellen, Anpassen und Erfassen von Images verwendet wird. Lassen Oder geben Sie leere Zeichenfolge an, um die Standardeinstellung zu verwenden (Standard_D1_v2).

--vnet

Der Name von VNET zum Bereitstellen des virtuellen Buildcomputers. Sie sollten sie nur angeben, wenn Subnetz ein Name ist.

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

--subscription

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

--verbose

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

Eigenschaft Wert
Standardwert: False

az image builder delete

Löschen Sie die Bild-Generator-Vorlage.

az image builder delete [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Beispiele

Löschen Sie die Bild-Generator-Vorlage. (autogenerated)

az image builder delete --name MyImageTemplate --resource-group MyResourceGroup

Optionale Parameter

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

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

az image builder list

Bild-Generator-Vorlagen auflisten.

az image builder list [--resource-group]

Optionale Parameter

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

--resource-group -g

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

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

--subscription

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

--verbose

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

Eigenschaft Wert
Standardwert: False

az image builder run

Erstellen Sie eine Image Builder-Vorlage.

az image builder run [--ids]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--subscription]

Beispiele

Starten Sie eine Vorlagenbuildausführung, und warten Sie dann, bis sie abgeschlossen ist.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

Optionale Parameter

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

--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
--name -n

Der Name der Bildvorlage.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--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
--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
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

az image builder show

Zeigen Sie eine Bild-Generator-Vorlage an.

az image builder show [--ids]
                      [--name]
                      [--resource-group]
                      [--subscription]

Beispiele

Anzeigen einer Bild-Generator-Vorlage (automatisch generiert)

az image builder show --name mytemplate  --resource-group my-group

Optionale Parameter

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

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

az image builder show-runs

Zeigen Sie die Ausführungsausgabe einer Bild-Generator-Vorlage an.

az image builder show-runs [--ids]
                           [--name]
                           [--output-name]
                           [--resource-group]
                           [--subscription]

Beispiele

Führen Sie einen Vorlagenbuild aus, und zeigen Sie dann die zugehörigen Ausführungsausgaben an.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show-runs -n mytemplate -g my-group

Optionale Parameter

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

--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
--name -n

Der Name der Bildvorlage.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--output-name

Name der Ausgabe des Image-Generators.

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

az image builder update

Aktualisieren sie eine Image Builder-Vorlage.

Das Aktualisieren einer Image Builder-Vorlagen wird derzeit nicht unterstützt. Dieser Befehl kann zusammen mit --defer verwendet werden, um ein Bildvorlagenobjekt im CLI-Cache zu aktualisieren. Ohne --defer ruft sie die angegebene Bildvorlage aus dem Cache ab und sendet eine Anforderung an Azure, um die Bildvorlage zu erstellen.

az image builder update [--add]
                        [--defer]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]
                        [--subscription]

Beispiele

Erstellen Sie eine Vorlagenressource aus einem Vorlagenobjekt im Cli-Cache. Weitere Informationen finden Sie unter "az image builder create / output add / customizer add --help" und "az cache -h"

# create and write template object to local cli cache
az image builder create --image-source {image_source} -n mytemplate -g my-group \
    --scripts {script} --managed-image-destinations image_1=westus --identity myidentity --defer

# add customizers and outputs to local cache template object via az image template output / customizer add
# one can also update cache object properties through generic update options, such as: --set
az image builder output add -n mytemplate -g my-group --output-name my-win-image-managed \
    --artifact-tags "is_vhd=False"  --managed-image winImage --managed-image-location eastus --defer

# send template create request to azure to create template resource
az image builder update -n mytemplate -g my-group

Optionale Parameter

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

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Eigenschaft Wert
Parameter group: Generic Update Arguments
Standardwert: []
--defer

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

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Eigenschaft Wert
Parameter group: Generic Update Arguments
Standardwert: False
--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
--name -n

Der Name der Bildvorlage.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Eigenschaft Wert
Parameter group: Generic Update Arguments
Standardwert: []
--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
--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Eigenschaft Wert
Parameter group: Generic Update Arguments
Standardwert: []
--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
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

az image builder wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Vorlage erfüllt ist.

az image builder wait [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--ids]
                      [--interval]
                      [--name]
                      [--resource-group]
                      [--subscription]
                      [--timeout]
                      [--updated]

Beispiele

Starten Sie eine Vorlagenbuildausführung, und warten Sie dann, bis sie abgeschlossen ist.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

Optionale Parameter

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

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Eigenschaft Wert
Parameter group: Wait Condition Arguments
--deleted

Warten Sie, bis sie gelöscht wurde.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: False
--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
--interval

Abrufintervall in Sekunden.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: 30
--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
--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
--timeout

Maximale Wartezeit in Sekunden.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Eigenschaft Wert
Parameter group: Wait Condition Arguments
Standardwert: False
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