Freigeben über


az image builder output

Verwalten sie die Ausgabeverteiler von Image Builder-Vorlagen.

Ein angepasstes Bild kann als verwaltetes Bild, ein freigegebenes Bild in einer freigegebenen Bildergalerie (SIG) oder als VHD-Blob verteilt werden.

Befehle

Name Beschreibung Typ Status
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 output add

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

Muss mit --defer verwendet werden. Der Ausgabeverteiler kann ein verwaltetes Bild, ein Katalogbild oder ein VHD-Blob sein.

az image builder output add [--artifact-tags]
                            [--defer]
                            [--gallery-image-definition]
                            [--gallery-name]
                            [--gallery-replication-regions]
                            [--ids]
                            [--is-vhd]
                            [--managed-image]
                            [--managed-image-location]
                            [--name]
                            [--output-name]
                            [--resource-group]
                            [--subscription]
                            [--versioning {Latest, Source}]
                            [--vhd-uri]

Beispiele

Fügen Sie einer Bildvorlage im Cli-Objektcache einen verwalteten Bildverteiler hinzu. Geben Sie einen Ausführungsausgabenamen an.

az image builder output add -n mytemplate -g my-group \
    --managed-image my_desired_image_name --output-name managed_image_run_01 --defer

Fügen Sie eine freigegebene Bildgalerieverteiler zu einer Bildvorlage im Cli-Objektcache hinzu. Geben Sie die Replikationsregionen an.

az image builder output add -n mytemplate -g my-group --gallery-name my_shared_gallery \
    --gallery-replication-regions westus brazilsouth \
    --gallery-image-definition linux_image_def --defer

Fügen Sie einen VHD-Verteiler zu einer Bildvorlage im Cli-Objektcache hinzu.

az image builder output add -n mytemplate -g my-group \
    --output-name my_vhd_image --is-vhd  --defer

Fügen Sie einen VHD-Verteiler hinzu, bei dem Speicher-URI einer Bildvorlage im Cli-Objektcache angegeben wird.

az image builder output add -n mytemplate -g my-group \
    --output-name my_vhd_image --is-vhd --vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file --defer

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--artifact-tags

Tags, die auf das Ausgabeartefakt angewendet werden, sobald sie vom Verteiler erstellt wurden. durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--defer

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

--gallery-image-definition

Name oder ID der vorhandenen SIG-Bilddefinition zum Erstellen der angepassten Bildversion mit.

Eigenschaft Wert
Parametergruppe: Shared Image Gallery Arguments
--gallery-name

Name des freigegebenen Bildkatalogs, wenn der Name der Bilddefinition und keine ID angegeben wurde.

Eigenschaft Wert
Parametergruppe: Shared Image Gallery Arguments
--gallery-replication-regions

Durch Leerzeichen getrennte Liste der Regionen, in die die Bildversion repliziert werden soll. Standardmäßig wird der Speicherort der Ressourcengruppe verwendet.

Eigenschaft Wert
Parametergruppe: Shared Image Gallery Arguments
--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
Parametergruppe: Resource Id Arguments
--is-vhd

Die Ausgabe ist ein VHD-Verteiler.

Eigenschaft Wert
Parametergruppe: VHD Arguments
--managed-image

Name oder ID des benutzerdefinierten verwalteten Images, das erstellt werden soll.

Eigenschaft Wert
Parametergruppe: Managed Image Arguments
--managed-image-location

Speicherort, an dem das angepasste Bild erstellt wird. Standardmäßig wird der Speicherort der Ressourcengruppe verwendet.

Eigenschaft Wert
Parametergruppe: Managed Image Arguments
--name -n

Der Name der Bildvorlage.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--output-name

Name der Ausgabe des Image-Generators. Standardmäßig wird der Name des verwalteten Bilds oder der Sig-Bilddefinition verwendet.

--resource-group -g

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

Eigenschaft Wert
Parametergruppe: 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
Parametergruppe: Resource Id Arguments
--versioning

Beschreiben, wie sie neue x.y.z-Versionsnummer für die Verteilung generieren.

Eigenschaft Wert
Zulässige Werte: Latest, Source
--vhd-uri

Optionaler Azure Storage-URI für das verteilte VHD-Blob. Lassen Sie die Standardeinstellung (leere Zeichenfolge) aus, in diesem Fall würde VHD in dem Speicherkonto in der Stagingressourcengruppe veröffentlicht.

Eigenschaft Wert
Parametergruppe: VHD 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

Ausgabeformat.

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

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

Muss mit --defer verwendet werden.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--defer

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

--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
Parametergruppe: Resource Id Arguments
--name -n

Der Name der Bildvorlage.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--resource-group -g

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

Eigenschaft Wert
Parametergruppe: 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
Parametergruppe: 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

Ausgabeformat.

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

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

Muss mit --defer verwendet werden.

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

Erforderliche Parameter

--output-name

Name der Ausgabe des Image-Generators.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--defer

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

--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
Parametergruppe: Resource Id Arguments
--name -n

Der Name der Bildvorlage.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--resource-group -g

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

Eigenschaft Wert
Parametergruppe: 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
Parametergruppe: 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

Ausgabeformat.

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