Freigeben über

az sig image-definition

  • Referenz

Anmerkung

Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Erfahren Sie mehr über Erweiterungen.

Verwalten des freigegebenen Katalogimages mit vm.

Befehle

Name Beschreibung Typ Status
az sig image-definition create

Erstellen Sie eine Katalogbilddefinition.

 Kern GA
az sig image-definition delete

Löschen sie ein Katalogbild.

 Kern GA
az sig image-definition list

Listenkatalogbilddefinitionen in einem Katalog.

 Kern GA
az sig image-definition list-community

Auflisten von VM-Imagedefinitionen in einer Katalogcommunity.

 Kern GA
az sig image-definition list-community (image-gallery Erweiterung)

Auflisten von VM-Imagedefinitionen in einer Katalogcommunity (Vorschau).

 Erweiterung Experimentell
az sig image-definition list-shared

Auflisten von VM-Imagedefinitionen in einem Katalog, der direkt für Ihr Abonnement oder Ihren Mandanten freigegeben wurde.

 Kern GA
az sig image-definition show

Abrufen von Informationen zu einer Katalogbilddefinition.

 Kern GA
az sig image-definition show-community

Abrufen eines Communitykatalogbilds.

 Kern GA
az sig image-definition show-community (image-gallery Erweiterung)

Abrufen eines Bilds in einer Galeriecommunity (Vorschau).

 Erweiterung Experimentell
az sig image-definition show-shared

Abrufen eines freigegebenen Katalogbilds.

 Kern GA
az sig image-definition update

Aktualisieren sie eine VM-Imagedefinition.

 Kern GA
az sig image-definition wait

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

 Kern GA

az sig image-definition create

Erstellen Sie eine Katalogbilddefinition.

az sig image-definition create --gallery-image-definition
                               --gallery-name
                               --offer
                               --os-type {Linux, Windows}
                               --publisher
                               --resource-group
                               --sku
                               [--architecture {Arm64, x64}]
                               [--description]
                               [--disallowed-disk-types]
                               [--end-of-life-date]
                               [--eula]
                               [--features]
                               [--hyper-v-generation {V1, V2}]
                               [--location]
                               [--maximum-cpu-core]
                               [--maximum-memory]
                               [--minimum-cpu-core]
                               [--minimum-memory]
                               [--os-state {Generalized, Specialized}]
                               [--plan-name]
                               [--plan-product]
                               [--plan-publisher]
                               [--privacy-statement-uri]
                               [--release-note-uri]
                               [--tags]

Beispiele

Erstellen einer Imagedefinition für spezielle Linux-Images

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized

Erstellen einer Imagedefinition für generalisierte Linux-Images

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Generalized

Erstellen einer Bilddefinition für spezialisierte Windows-Images

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type windows --os-state Specialized

Erstellen einer Bilddefinition für generalisierte Windows-Images

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type windows --os-state Generalized

Erstellen einer Bilddefinition mit Planinformationen

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized --plan-name PlanName \
--plan-product PlanProduct --plan-publisher PlanPublisher

Erstellen einer Bilddefinition für Bilder, die das Ruhezustandsfeature unterstützen

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features IsHibernateSupported=true

Erstellen einer Imagedefinition für Bilder, die beschleunigte Netzwerke unterstützen

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features IsAcceleratedNetworkSupported=true

Erstellen Sie eine Bilddefinition für Bilder, die nur zum Erstellen vertrauenswürdiger VMs verwendet werden können. Aus diesem Image können nur vertrauenswürdige VMs erstellt werden.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=TrustedLaunch

Erstellen Sie eine Bilddefinition für Bilder, die zum Erstellen vertraulicher VMs verwendet werden können.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=ConfidentialVmSupported

Erstellen Sie eine Bilddefinition für Bilder, die nur zum Erstellen vertraulicher VMs verwendet werden können. Aus diesem Image können nur vertrauliche virtuelle Computer erstellt werden.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=ConfidentialVM

Erstellen Sie eine Bilddefinition für Bilder, die zum Erstellen von Gen2- oder TrustedLaunchSupported-VMs verwendet werden können.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=TrustedLaunchSupported

Erstellen Sie eine Bilddefinition für Bilder, die zum Erstellen von Gen2, TrustedLaunch oder vertraulichen VMs verwendet werden können.

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--features SecurityType=TrustedLaunchAndConfidentialVmSupported

Erstellen einer Bilddefinition und Angeben des Datums des Lebensendes

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--end-of-life-date YYYY-MM-DDTHH:MM:SS+00:00

Erstellen einer Bilddefinition und Empfehlen der minimalen und maximalen CPU und des maximalen Arbeitsspeichers (GB)

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--minimum-cpu-core myMinCPU --maximum-cpu-core myMaxCPU \
--minimum-memory myMinMemory --maximum-memory myMaxMemory

Erstellen einer Imagedefinition und Angeben, welche Betriebssystemdatenträgertypen für das Image nicht empfohlen werden

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--disallowed-disk-types Standard_LRS

Erstellen einer Bilddefinition und Bereitstellen des URI der EULA, Datenschutzbestimmungen und Versionshinweise-URI

az sig image-definition create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--publisher GreatPublisher --offer GreatOffer --sku GreatSku \
--os-type linux --os-state Specialized \
--eula path_to_eula --privacy-statement-uri path_to_statement \
--release-note-uri path_to_release_notes

Erforderliche Parameter

--gallery-image-definition -i

Katalogbilddefinition.

--gallery-name -r

Katalogname.

--offer -f

Bildangebot.

--os-type

Der Typ des Betriebssystems, das auf dem Datenträger enthalten ist, wenn ein virtueller Computer vom Benutzerimage oder einer speziellen VHD erstellt wird.

Zulässige Werte: Linux, Windows
--publisher -p

Bildherausgeber.

--resource-group -g

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

--sku -s

Bild-Sku.

Optionale Parameter

--architecture

CPU-Architektur.

Zulässige Werte: Arm64, x64
--description

Die Beschreibung der Katalogbilddefinition.

--disallowed-disk-types

Datenträgertypen, die nicht mit dem Image funktionieren würden, z. B. Standard_LRS.

--end-of-life-date

Das Ende des Lebenszyklus, z. B. "2020-12-31".

--eula

Der Eula-Vertrag für das Galeriebild.

--features

Eine Liste der Katalogbildfeatures. Beispiel: "IsSecureBootSupported=true IsMeasuredBootSupported=false".

--hyper-v-generation

Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.

Zulässige Werte: V1, V2
Standardwert: V2
--location -l

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

--maximum-cpu-core

Maximale CPU-Kerne.

--maximum-memory

Maximaler Arbeitsspeicher in MB.

--minimum-cpu-core

Minimale CPU-Kerne.

--minimum-memory

Minimaler Arbeitsspeicher in MB.

--os-state

Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalisiert" oder "Spezialisiert" sind.

Zulässige Werte: Generalized, Specialized
Standardwert: Generalized
--plan-name

Planname.

--plan-product

Produkt planen.

--plan-publisher

Plan publisher.

--privacy-statement-uri

Der Datenschutzbestimmungen-URI.

--release-note-uri

Der Versionshinweise-URI.

--tags

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.

az sig image-definition delete

Löschen sie ein Katalogbild.

az sig image-definition delete [--gallery-image-definition]
                               [--gallery-name]
                               [--ids]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--resource-group]
                               [--subscription]

Optionale Parameter

--gallery-image-definition --gallery-image-name -i

Der Name der zu löschenden Katalogbilddefinition.

--gallery-name -r

Der Name des freigegebenen Bildkatalogs, in dem die Bilddefinition gelöscht werden soll.

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

--no-wait

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

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.

az sig image-definition list

Listenkatalogbilddefinitionen in einem Katalog.

az sig image-definition list --gallery-name
                             --resource-group
                             [--max-items]
                             [--next-token]

Erforderliche Parameter

--gallery-name -r

Der Name des freigegebenen Bildkatalogs, aus dem Bilddefinitionen aufgelistet werden sollen.

--resource-group -g

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

Optionale Parameter

--max-items

Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtanzahl der verfügbaren Elemente größer als der angegebene Wert ist, wird ein Token in der Ausgabe des Befehls bereitgestellt. Um die Paginierung fortzusetzen, geben Sie den Tokenwert in --next-token Argument eines nachfolgenden Befehls an.

--next-token

Token, das angibt, wo die Paginierung beginnen soll. Dies ist der Tokenwert aus einer zuvor abgeschnittenen Antwort.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.

az sig image-definition list-community

Auflisten von VM-Imagedefinitionen in einer Katalogcommunity.

az sig image-definition list-community [--ids]
                                       [--location]
                                       [--marker]
                                       [--public-gallery-name]
                                       [--show-next-marker]
                                       [--subscription]

Beispiele

Auflisten einer Bilddefinition in einer Katalogcommunity.

az sig image-definition list-community --public-gallery-name publicGalleryName \
--location myLocation

Optionale Parameter

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

--location -l

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

--marker

Ein Zeichenfolgenwert, der den Teil der Liste der Container identifiziert, der mit dem nächsten Eintragsvorgang zurückgegeben werden soll. Der Vorgang gibt den NextMarker-Wert im Antworttext zurück, wenn der Eintragsvorgang nicht alle Container zurückgibt, die mit der aktuellen Seite aufgelistet werden sollen. Wenn angegeben, beginnt dieser Generator mit der Rückgabe von Ergebnissen vom Punkt, an dem der vorherige Generator beendet wurde.

--public-gallery-name

Der öffentliche Name des Communitykatalogs.

--show-next-marker

NextMarker im Ergebnis anzeigen, wenn angegeben.

--subscription

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.

az sig image-definition list-community (image-gallery Erweiterung)

Experimentell

Dieser Befehl ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Auflisten von VM-Imagedefinitionen in einer Katalogcommunity (Vorschau).

Auflisten von VM-Imagedefinitionen in einer Galeriecommunity (private Vorschaufunktion, wenden Sie sich per E-Mail an das Community-Image gallery-Team per E-Mail- sigpmdev@microsoft.com, um sich für die Vorschau zu registrieren, wenn Sie an dieser Funktion interessiert sind).

az sig image-definition list-community [--ids]
                                       [--location]
                                       [--marker]
                                       [--public-gallery-name]
                                       [--show-next-marker]
                                       [--subscription]

Beispiele

Auflisten einer Bilddefinition in einer Katalogcommunity.

az sig image-definition list-community --public-gallery-name publicGalleryName \
--location myLocation

Optionale Parameter

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

--location -l

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

--marker

Ein Zeichenfolgenwert, der den Teil der Liste der Container identifiziert, der mit dem nächsten Eintragsvorgang zurückgegeben werden soll. Der Vorgang gibt den NextMarker-Wert im Antworttext zurück, wenn der Eintragsvorgang nicht alle Container zurückgibt, die mit der aktuellen Seite aufgelistet werden sollen. Wenn angegeben, beginnt dieser Generator mit der Rückgabe von Ergebnissen vom Punkt, an dem der vorherige Generator beendet wurde.

--public-gallery-name

Der öffentliche Name des Communitykatalogs.

--show-next-marker

NextMarker im Ergebnis anzeigen, wenn angegeben.

--subscription

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.

az sig image-definition list-shared

Auflisten von VM-Imagedefinitionen in einem Katalog, der direkt für Ihr Abonnement oder Ihren Mandanten freigegeben wurde.

az sig image-definition list-shared [--gallery-unique-name]
                                    [--ids]
                                    [--location]
                                    [--marker]
                                    [--shared-to {tenant}]
                                    [--show-next-marker]
                                    [--subscription]

Beispiele

Auflisten einer Bilddefinition in einem Katalog, die direkt für Ihr Abonnement am angegebenen Speicherort freigegeben wurde.

az sig image-definition list-shared --gallery-unique-name galleryUniqueName \
--location myLocation

Auflisten einer Bilddefinition in einem Katalog, die direkt für Ihren Mandanten am angegebenen Speicherort freigegeben wurde.

az sig image-definition list-shared --gallery-unique-name galleryUniqueName \
--location myLocation --shared-to tenant

Optionale Parameter

--gallery-unique-name

Der eindeutige Name des freigegebenen Katalogs.

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

--location -l

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

--marker

Ein Zeichenfolgenwert, der den Teil der Liste der Container identifiziert, der mit dem nächsten Eintragsvorgang zurückgegeben werden soll. Der Vorgang gibt den NextMarker-Wert im Antworttext zurück, wenn der Eintragsvorgang nicht alle Container zurückgibt, die mit der aktuellen Seite aufgelistet werden sollen. Wenn angegeben, beginnt dieser Generator mit der Rückgabe von Ergebnissen vom Punkt, an dem der vorherige Generator beendet wurde.

--shared-to

Der Abfrageparameter, um zu entscheiden, welche freigegebenen Kataloge abgerufen werden sollen, wenn Listenvorgänge durchgeführt werden. Wenn dies nicht angegeben ist, führen Sie die Liste nach Abonnement-ID aus.

Zulässige Werte: tenant
--show-next-marker

NextMarker im Ergebnis anzeigen, wenn angegeben.

--subscription

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.

az sig image-definition show

Abrufen von Informationen zu einer Katalogbilddefinition.

az sig image-definition show [--gallery-image-definition]
                             [--gallery-name]
                             [--ids]
                             [--resource-group]
                             [--subscription]

Optionale Parameter

--gallery-image-definition --gallery-image-name -i

Der Name der abzurufenden Katalogbilddefinition.

--gallery-name -r

Der Name des freigegebenen Bildkatalogs, aus dem die Bilddefinitionen abgerufen werden sollen.

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

--resource-group -g

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

--subscription

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.

az sig image-definition show-community

Abrufen eines Communitykatalogbilds.

az sig image-definition show-community [--gallery-image-definition]
                                       [--ids]
                                       [--location]
                                       [--public-gallery-name]
                                       [--subscription]

Optionale Parameter

--gallery-image-definition -i

Der Name der Community gallery-Bilddefinition, aus der die Bildversionen aufgelistet werden sollen.

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

--location -l

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

--public-gallery-name

Der öffentliche Name des Communitykatalogs.

--subscription

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.

az sig image-definition show-community (image-gallery Erweiterung)

Experimentell

Dieser Befehl ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Abrufen eines Bilds in einer Galeriecommunity (Vorschau).

Holen Sie sich ein Bild in einer Galeriecommunity (private Vorschaufunktion, wenden Sie sich per E-Mail an das Community-Bildergalerieteam sigpmdev@microsoft.com, um sich für die Vorschau zu registrieren, wenn Sie an dieser Funktion interessiert sind).

az sig image-definition show-community [--gallery-image-definition]
                                       [--ids]
                                       [--location]
                                       [--public-gallery-name]
                                       [--subscription]

Beispiele

Rufen Sie eine Bilddefinition in einer Galeriecommunity an dem angegebenen Speicherort ab.

az sig image-definition show-community --public-gallery-name publicGalleryName \
--gallery-image-definition myGalleryImageName --location myLocation

Optionale Parameter

--gallery-image-definition -i

Der Name der Community gallery-Bilddefinition, aus der die Bildversionen aufgelistet werden sollen.

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

--location -l

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

--public-gallery-name

Der öffentliche Name des Communitykatalogs.

--subscription

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.

az sig image-definition show-shared

Abrufen eines freigegebenen Katalogbilds.

Rufen Sie ein freigegebenes Katalogbild ab, das direkt für Ihr Abonnement oder Ihren Mandanten freigegeben wurde.

az sig image-definition show-shared [--gallery-image-definition]
                                    [--gallery-unique-name]
                                    [--ids]
                                    [--location]
                                    [--subscription]

Beispiele

Rufen Sie eine Bilddefinition in einem Katalog ab, der direkt für Ihr Abonnement oder Ihren Mandanten am angegebenen Speicherort freigegeben wurde.

az sig image-definition show-shared --gallery-unique-name galleryUniqueName --gallery-image-definition myGalleryImageName --location myLocation

Optionale Parameter

--gallery-image-definition --gallery-image-name -i

Der Name der Definition des freigegebenen Katalogbilds, aus der die Bildversionen aufgelistet werden sollen.

--gallery-unique-name

Der eindeutige Name des freigegebenen Katalogs.

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

--location -l

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

--subscription

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.

az sig image-definition update

Aktualisieren sie eine VM-Imagedefinition.

az sig image-definition update [--add]
                               [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                               [--gallery-image-definition]
                               [--gallery-name]
                               [--ids]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--remove]
                               [--resource-group]
                               [--set]
                               [--subscription]

Beispiele

Ändern der empfohlenen Konfiguration der freigegebenen Bilddefinition

az sig image-definition update --resource-group MyResourceGroup --gallery-name MyGallery --gallery-image-definition MyImage --resource-group MyResourceGroup --set recommended.vCpUs.min=myNewvCpUsMin recommended.vCpUs.max=myNewvCpUsMax recommended.memory.min=myNewMemoryMin recommended.memory.max=myNewMemoryMax description="newDescription"

Entfernen der Konfigurationseigenschaft einer freigegebenen Bilddefinition

az sig image-definition update --resource-group MyResourceGroup --gallery-name MyGallery --gallery-image-definition MyImage --resource-group MyResourceGroup --remove recommended.vCpUs.min

Optionale Parameter

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

--force-string

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

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--gallery-image-definition -i

Der Name der abzurufenden Katalogbilddefinition.

--gallery-name -r

Der Name des freigegebenen Bildkatalogs, in dem sich die Bilddefinition befindet.

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

--no-wait

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

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--remove

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

--resource-group -g

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

--set

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

--subscription

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.

az sig image-definition wait

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

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

Optionale Parameter

--created

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

Standardwert: False
--custom

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

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--gallery-image-definition --gallery-image-name -i

Der Name der abzurufenden Katalogbilddefinition.

--gallery-name -r

Der Name des freigegebenen Bildkatalogs, aus dem die Bilddefinitionen abgerufen werden sollen.

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

--interval

Abrufintervall in Sekunden.

Standardwert: 30
--resource-group -g

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

--subscription

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

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

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

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.