az image builder
Verwalten und Erstellen von Bild-Generatorvorlagen.
Befehle
| az image builder cancel |
Abbrechen des langfristig ausgeführten Bildbuilds basierend auf der Bildvorlage. |
| az image builder create |
Erstellen Sie eine Bild-Generatorvorlage. |
| az image builder customizer |
Image Builder-Vorlagenanpassung verwalten. |
| 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 delete |
Bild-Generatorvorlage löschen. |
| az image builder list |
Listenbild-Generatorvorlagen. |
| az image builder output |
Image Builder-Vorlagenausgabeverteiler verwalten. |
| az image builder output add |
Fügen Sie einen Ausgabeverteiler eines Bild-Generators zu einer Bild-Generator-Vorlage hinzu. |
| az image builder output clear |
Entfernen Sie alle Ausgabeverteiler des Bild-Generators aus einer Bild-Generator-Vorlage. |
| az image builder output remove |
Entfernen Sie einen Ausgabeverteiler eines Bild-Generators aus einer Bild-Generatorvorlage. |
| az image builder run |
Erstellen Sie eine Bild-Generatorvorlage. |
| az image builder show |
Zeigen Sie eine Bild-Generatorvorlage an. |
| az image builder show-runs |
Zeigen Sie die Ausführungsausgabe einer Bild-Generatorvorlage an. |
| az image builder update |
Aktualisieren einer Bild-Generatorvorlage. |
| az image builder validator |
Verwalten der Vorlagenvorlage für den Bild-Generator. |
| az image builder validator add |
Fügen Sie eine vorhandene Bild-Generatorvorlage hinzu. |
| az image builder validator remove |
Entfernen Sie die Überprüfung aus einer vorhandenen Bild-Generatorvorlage. |
| az image builder validator show |
Zeigen Sie die Überprüfung einer vorhandenen Bild-Generatorvorlage an. |
| az image builder wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Vorlage erfüllt ist. |
az image builder cancel
Abbrechen des langfristig ausgeführten Bildbuilds basierend auf der Bildvorlage.
az image builder cancel [--ids]
[--name]
[--resource-group]
Beispiele
Abbrechen eines Bildbuilds.
az image builder cancel -n mytemplate -g my-group
Optionale Parameter
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.
Der Name der Bildvorlage.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
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 Bild-Generatorvorlage.
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]
[--vm-size]
[--vnet]
Beispiele
Erstellen Sie eine Image-Generatorvorlage aus einem UbuntuLTS 18.04-Bild. Verteilen Sie es als verwaltetes Bild und eine freigegebene Bildkatalogversion. Geben Sie die Id der Bereitstellungsressourcengruppe als Bildvorlage an, die zum Erstellen des Bilds verwendet wird.
scripts="https://my-script-url.net/customize_script.sh"
imagesource="Canonical:UbuntuServer:18.04-LTS:18.04.201903060"
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-Generatorvorlage mithilfe einer Bildvorlagendatei.
az image builder create -g my-group -n myTemplate --image-template filename
[Erweitert] Erstellen Sie eine Bildvorlage mit mehreren Anpassbaren und Vertriebspartnern mithilfe des CLI-Objektcaches über --defer. Unterstützt Features wie: Anpassungs- und Ausgabenamen, PowerShell-Exitcodes, Inlineskripts, Windows Neustart, Dateianpassungen, Artefaktetags 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
Der Name der Bildvorlage.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Optionale Parameter
Die maximale Dauer zum Warten beim Erstellen der Bildvorlage in Minuten. Der Standardwert ist 60.
Optionale Konfiguration des virtuellen Netzwerks, mit dem der Build-virtuelle Computer bereitgestellt werden soll. Lassen Sie diese Angabe aus, wenn kein bestimmtes virtuelles Netzwerk verwendet werden muss.
Die SHA256-Prüfsumme des Red Hat ISO-Bilds.
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, Leerzeichen getrennt) der Bildvorlage.
Das Basisbild, das angepasst werden soll. Muss ein gültiges Plattformimage-URN, Plattformimage-Alias, Red Hat ISO-Image-URI, verwalteter Bildname/ID oder freigegebene Imageversions-ID sein.
Lokaler Pfad oder URL zu einer Bildvorlagendatei. Wenn Sie --image-vorlage verwenden, werden alle anderen Parameter außer -g und -n ignoriert. Referenz: https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.
Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.
Informationen zur verwalteten Bildausgabe. Leerzeichentrennte Liste der Schlüsselwertpaare. Z. B. "image_1=westus2 image_2=westus". Jeder Schlüssel ist der Name oder die Ressourcen-ID des verwalteten Bilds, das erstellt werden soll. Jeder Wert ist die Position des Bilds.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Größe des Betriebssystemdatenträgers in GB. Lassen Sie die Standarddatenträgergröße von Azure aus oder geben Sie 0 an, um die Standarddatenträgergröße von Azure zu verwenden.
Größe des virtuellen Computers, der zum Erstellen, Anpassen und Erfassen von Bildern verwendet wird (Standard_D1_v2 für Gen1-Bilder und Standard_D2ds_v4 für Gen2-Bilder).
Leergetrennte Liste der Shell- oder PowerShell-Skripts zum Anpassen des Bilds mit. Jedes Skript muss eine öffentlich zugängliche URL sein. Leitet den Skripttyp aus der Dateierweiterung (.sh' oder '.ps1') oder vom Quelltyp aus. Weitere Anpassungsoptionen und Flexibilität finden Sie unter "az image template customizer add".
Informationen zu freigegebenen Bildkatalogen (sig) ausgabeverteilerinformationen. Leerzeichentrennte Liste der Schlüsselwertpaare. 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 die Sig-Bilddefinition, die durch ein "/" getrennt ist. Jeder Wert ist eine durch Komma getrennte Liste der Replikatspeicherorte.
Die Gruppen-ID der Stagingressourcen in demselben Abonnement wie die Bildvorlage, die zum Erstellen des Bilds verwendet wird.
Name oder ID des Subnetzs, um den virtuellen Buildcomputer bereitzustellen.
Leergetrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Größe des virtuellen Computers, der zum Erstellen, Anpassen und Erfassen von Bildern verwendet wird. Geben Sie leere Zeichenfolge aus, um die Standardeinstellung (Standard_D1_v2) zu verwenden.
Name des VNET zum Bereitstellen des virtuellen Buildcomputers. Sie sollten ihn nur angeben, wenn Subnetz ein Name ist.
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
Bild-Generatorvorlage löschen.
az image builder delete [--ids]
[--name]
[--resource-group]
Beispiele
Bild-Generatorvorlage löschen. (automatisch generiert)
az image builder delete --name MyImageTemplate --resource-group MyResourceGroup
Optionale Parameter
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.
Der Name der Bildvorlage.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
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
Listenbild-Generatorvorlagen.
az image builder list [--resource-group]
Optionale Parameter
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
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 Bild-Generatorvorlage.
az image builder run [--ids]
[--name]
[--no-wait]
[--resource-group]
Beispiele
Starten Sie einen Vorlagenbuild, 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
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.
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.
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-Generatorvorlage an.
az image builder show [--ids]
[--name]
[--resource-group]
Beispiele
Anzeigen einer Bild-Generatorvorlage (automatisch generiert)
az image builder show --name mytemplate --resource-group my-group
Optionale Parameter
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.
Der Name der Bildvorlage.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
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-Generatorvorlage an.
az image builder show-runs [--ids]
[--name]
[--output-name]
[--resource-group]
Beispiele
Führen Sie eine Vorlagenerstellung aus, und zeigen Sie dann die Ausführungsausgabe 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
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.
Der Name der Bildvorlage.
Name der Ausgabe des Bild-Generators.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
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 einer Bild-Generatorvorlage.
Das Aktualisieren einer Bild-Generatorvorlagen wird derzeit nicht unterstützt. Dieser Befehl kann in Verbindung 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]
Beispiele
Erstellen Sie eine Vorlagenressource aus einem Vorlagenobjekt im Cli-Cache.
# 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
Fügen Sie einem Objekt eine Liste von Objekten 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 Zeichenfolgen literale beibehalten, anstatt zu versuchen, in JSON zu konvertieren.
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.
Der Name der Bildvorlage.
Entfernen Sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftenpfad und einen wert angeben, der festgelegt werden soll. Beispiel: --set-property1.property2=.
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]
[--timeout]
[--updated]
Beispiele
Starten Sie einen Vorlagenbuild, 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
Warten Sie, bis Sie mit "provisioningState" unter "Erfolgreich" erstellt wurden.
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). 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.
Abfrageintervall in Sekunden.
Der Name der Bildvorlage.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Maximale Wartezeit in Sekunden.
Warten Sie, bis sie mit provisioningState unter "Erfolgreich" aktualisiert wurde.
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
Feedback senden und anzeigen für