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 | Allgemein verfügbar |
| az image builder create |
Erstellen Sie eine Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder customizer |
Image Builder-Vorlagenanpassung verwalten. |
Core | Allgemein verfügbar |
| az image builder customizer add |
Fügen Sie einer Image Builder-Vorlage einen Image Builder Customizer hinzu. |
Core | Allgemein verfügbar |
| az image builder customizer clear |
Entfernen Sie alle Image Builder Customizer aus einer Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder customizer remove |
Entfernen Sie einen Image Builder Customizer aus einer Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder delete |
Löschen Sie die Bild-Generator-Vorlage. |
Core | Allgemein verfügbar |
| az image builder error-handler |
Fehlerhandler für Die Image Builder-Vorlage verwalten. |
Core | Allgemein verfügbar |
| az image builder error-handler add |
Fügen Sie einer vorhandenen Image Builder-Vorlage Einen Fehlerhandler hinzu. |
Core | Allgemein verfügbar |
| az image builder error-handler remove |
Entfernen Sie den Fehlerhandler aus einer vorhandenen Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder error-handler show |
Fehlerhandler einer vorhandenen Image Builder-Vorlage anzeigen. |
Core | Allgemein verfügbar |
| az image builder identity |
Verwalten von Identitäten einer Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| 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 | Allgemein verfügbar |
| az image builder identity remove |
Entfernen sie verwaltete Identitäten aus einer vorhandenen Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder identity show |
Anzeigen verwalteter Identitäten einer Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder list |
Bild-Generator-Vorlagen auflisten. |
Core | Allgemein verfügbar |
| az image builder optimizer |
Verwalten sie den Optimierer für Image Builder-Vorlagen. |
Core | Allgemein verfügbar |
| az image builder optimizer add |
Fügen Sie einer vorhandenen Image Builder-Vorlage Optimierer hinzu. |
Core | Allgemein verfügbar |
| az image builder optimizer remove |
Entfernen Sie den Optimierer aus einer vorhandenen Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder optimizer show |
Optimierer einer vorhandenen Image Builder-Vorlage anzeigen. |
Core | Allgemein verfügbar |
| az image builder optimizer update |
Aktualisieren Sie einen Optimierer aus einer vorhandenen Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder output |
Image Builder-Vorlagenausgabeverteiler verwalten. |
Core | Allgemein verfügbar |
| az image builder output add |
Fügen Sie einer Image Builder-Vorlage einen Ausgabeverteiler für den Image Builder hinzu. |
Core | Allgemein verfügbar |
| az image builder output clear |
Entfernen Sie alle Bild-Generator-Ausgabeverteiler aus einer Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder output remove |
Entfernen Sie einen Bild-Generator-Ausgabeverteiler aus einer Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder output versioning |
Verwalten sie die Ausgabeversionsverwaltung für Bild-Generator-Vorlagen. |
Core | Allgemein verfügbar |
| az image builder output versioning remove |
Entfernen Sie alle Versionsverwaltungsoptionen für angegebene Ausgaben. |
Core | Allgemein verfügbar |
| az image builder output versioning set |
Legen Sie die Ausgabeversionsverwaltung für den Image Builder einer Image Builder-Vorlage fest. |
Core | Allgemein verfügbar |
| az image builder output versioning show |
Versionsverwaltungsoptionen für angegebene Ausgaben anzeigen. |
Core | Allgemein verfügbar |
| az image builder run |
Erstellen Sie eine Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder show |
Zeigen Sie eine Bild-Generator-Vorlage an. |
Core | Allgemein verfügbar |
| az image builder show-runs |
Zeigen Sie die Ausführungsausgabe einer Bild-Generator-Vorlage an. |
Core | Allgemein verfügbar |
| az image builder trigger |
Verwalten des Bild-Generator-Vorlagentriggers. |
Core | Allgemein verfügbar |
| az image builder trigger create |
Erstellen Sie einen Trigger für die angegebene Imagevorlage für virtuelle Computer. |
Core | Allgemein verfügbar |
| az image builder trigger delete |
Löschen eines Triggers für die angegebene Imagevorlage für virtuelle Computer. |
Core | Allgemein verfügbar |
| az image builder trigger list |
Listet alle Trigger für die angegebene Bildvorlagenressource auf. |
Core | Allgemein verfügbar |
| az image builder trigger show |
Rufen Sie den angegebenen Trigger für die angegebene Bildvorlagenressource ab. |
Core | Allgemein verfügbar |
| az image builder trigger wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist. |
Core | Allgemein verfügbar |
| az image builder update |
Aktualisieren sie eine Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder validator |
Verwalten sie die Überprüfung der Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder validator add |
Fügen Sie einer vorhandenen Image Builder-Vorlage Eine Überprüfung hinzu. |
Core | Allgemein verfügbar |
| az image builder validator remove |
Entfernen Sie die Überprüfung aus einer vorhandenen Image Builder-Vorlage. |
Core | Allgemein verfügbar |
| az image builder validator show |
Zeigen Sie die Überprüfung einer vorhandenen Image Builder-Vorlage an. |
Core | Allgemein verfügbar |
| az image builder wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Vorlage erfüllt ist. |
Core | Allgemein verfügbar |
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-groupOptionale Parameter
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.
Der Name der Bildvorlage.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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 myStagingResourceGroupErstellen 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 myGroupErforderliche Parameter
Der Name der Bildvorlage.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Optionale Parameter
Die maximale Wartezeit beim Erstellen der Bildvorlage in Minuten. Der Standardwert ist 60.
Optionale Konfiguration des virtuellen Netzwerks, das zum Bereitstellen des virtuellen Buildcomputers verwendet werden soll. Lassen Sie diese Angabe aus, wenn kein bestimmtes virtuelles Netzwerk verwendet werden muss.
Die SHA256-Prüfsumme des Red Hat ISO-Images.
Speichert das Objekt temporär im lokalen Cache, anstatt es an Azure zu senden. Verwenden Sie az cache Befehle zum Anzeigen/Löschen.
Liste der vom Benutzer zugewiesenen Identitäten (Name oder ID, durch Leerzeichen getrennt) der Bildvorlage.
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.
Lokaler Pfad oder url zu einer Bildvorlagendatei. Bei Verwendung von --image-template werden alle anderen Parameter außer -g und -n ignoriert. Referenz: https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.
Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.
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.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Größe des Betriebssystemdatenträgers in GB. Geben Sie "0" aus, um die Standardgröße des Betriebssystemdatenträgers von Azure zu verwenden.
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).
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".
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.
Die Stagingressourcengruppen-ID im selben Abonnement wie die Bildvorlage, die zum Erstellen des Images verwendet wird.
Name oder ID des Subnetzs, um den virtuellen Buildcomputer bereitzustellen.
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Der Typ der Überprüfung, die Sie für das Bild verwenden möchten. Beispielsweise kann "Shell" die Shellüberprüfung sein.
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).
Der Name von VNET zum Bereitstellen des virtuellen Buildcomputers. Sie sollten sie nur angeben, wenn Subnetz ein Name ist.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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. (automatisch generiert)
az image builder delete --name MyImageTemplate --resource-group MyResourceGroupOptionale Parameter
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.
Der Name der Bildvorlage.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az image builder list
Bild-Generator-Vorlagen auflisten.
az image builder list [--resource-group]Optionale Parameter
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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-groupOptionale Parameter
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.
Der Name der Bildvorlage.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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-groupOptionale Parameter
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.
Der Name der Bildvorlage.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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-groupOptionale Parameter
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.
Der Name der Bildvorlage.
Name der Ausgabe des Image-Generators.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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-groupOptionale Parameter
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>.
Speichert das Objekt temporär im lokalen Cache, anstatt es an Azure zu senden. Verwenden Sie az cache Befehle zum Anzeigen/Löschen.
Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.
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.
Der Name der Bildvorlage.
Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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-groupOptionale Parameter
Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.
Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Warten Sie, bis sie gelöscht wurde.
Warten Sie, bis die Ressource vorhanden ist.
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.
Abrufintervall in Sekunden.
Der Name der Bildvorlage.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Maximale Wartezeit in Sekunden.
Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für