az sig image-definition

Verwalten des freigegebenen Katalogimages mit vm.

Befehle

az sig image-definition create

Erstellen Sie eine Katalogbilddefinition.

az sig image-definition delete

Löschen eines Katalogbilds.

az sig image-definition list

Listenkatalogbilddefinitionen in einem Katalog.

az sig image-definition list-community

Auflisten von VM-Imagedefinitionen in einer Kataloggemeinschaft.

az sig image-definition list-shared

Auflisten von VM-Imagedefinitionen in einem Katalog, der direkt an Ihr Abonnement oder Mandanten freigegeben wurde.

az sig image-definition show

Ruft Informationen zu einer Katalogbilddefinition ab.

az sig image-definition show-community

Rufen Sie ein Communitykatalogbild ab.

az sig image-definition show-shared

Rufen Sie ein freigegebenes Katalogbild ab.

az sig image-definition update

Aktualisieren einer VM-Imagedefinition.

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 allgemeine 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 spezielle 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 allgemeine 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 die Hibernate-Funktion 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 Bilddefinition für Bilder, die das beschleunigte Netzwerk 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 einer Bilddefinition für Bilder, die zum Erstellen vertrauenswürdiger 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 nur zum Erstellen vertrauenswürdiger VMs verwendet werden können. Nur vertrauenswürdige VMs können aus diesem Image 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. Nur vertrauliche VMs können aus diesem Image 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 einer Bilddefinition für Bilder, die zum Erstellen von vertrauenswürdigen 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 für Bilder, die zum Erstellen von vertrauenswürdigen 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 Lebenstermins

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 minimale und maximale CPU und Arbeitsspeicher (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 geben an, 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 EULA,Datenschutzbestimmungen-URI und Releasenotizen-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 VM vom Benutzerimage oder einer spezialisierten VHD erstellt wird.

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

Bildverleger.

--resource-group -g

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

--sku -s

Bildsku.

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 arbeiten würden, z. B. Standard_LRS.

--end-of-life-date

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

--eula

Der Eula-Vertrag für das Galeriebild.

--features

Eine Liste der Katalogbildfeatures. Z. B. "IsSecureBootSupported=true IsMeasuredBootSupported=false".

--hyper-v-generation

Die Hypervisor-Generation des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.

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

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit 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

Mindestspeicher 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

Planen des Herausgebers.

--privacy-statement-uri

Die Datenschutzbestimmungen uri.

--release-note-uri

Der Releasenotiz-URI.

--tags

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

az sig image-definition delete

Löschen eines Katalogbilds.

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

Optionale Parameter

--gallery-image-definition -i

Katalogbilddefinition.

--gallery-name -r

Katalogname.

--ids

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.

--resource-group -g

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

az sig image-definition list

Listenkatalogbilddefinitionen in einem Katalog.

az sig image-definition list --gallery-name
                             --resource-group

Erforderliche Parameter

--gallery-name -r

Katalogname.

--resource-group -g

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

az sig image-definition list-community

Auflisten von VM-Imagedefinitionen in einer Kataloggemeinschaft.

Auflisten von VM-Imagedefinitionen in einer Kataloggemeinschaft.

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

Beispiele

Listet eine Bilddefinition in einer Kataloggemeinschaft auf.

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

Optionale Parameter

--ids

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.

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--marker

Ein Zeichenfolgenwert, der den Teil der Liste der Container identifiziert, die mit dem nächsten Eintragsvorgang zurückgegeben werden sollen. Der Vorgang gibt den NextMarker-Wert innerhalb des Antworttexts 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 aus dem Punkt, an dem der vorherige Generator beendet wurde.

--public-gallery-name

Der öffentliche Name des Communitykatalogs.

--show-next-marker

Zeigen Sie nextMarker im Ergebnis an, wenn sie angegeben wird.

az sig image-definition list-shared

Auflisten von VM-Imagedefinitionen in einem Katalog, der direkt an Ihr Abonnement oder Mandanten freigegeben wurde.

Auflisten von VM-Imagedefinitionen in einem Katalog, der direkt an Ihr Abonnement oder Mandanten freigegeben wurde.

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

Beispiele

Listen Sie eine Bilddefinition in einem Katalog auf, der direkt an Ihr Abonnement an dem angegebenen Speicherort freigegeben wurde.

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

Listen Sie eine Bilddefinition in einem Katalog auf, der direkt an Ihren Mandanten an der angegebenen Stelle 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

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.

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--marker

Ein Zeichenfolgenwert, der den Teil der Liste der Container identifiziert, die mit dem nächsten Eintragsvorgang zurückgegeben werden sollen. Der Vorgang gibt den NextMarker-Wert innerhalb des Antworttexts 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 aus dem Punkt, an dem der vorherige Generator beendet wurde.

--shared-to

Der Abfrageparameter, um zu entscheiden, welche freigegebenen Kataloge beim Ausführen von Eintragsvorgängen abgerufen werden sollen. Wenn nicht angegeben, listet die Liste nach Abonnement-ID auf.

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

Zeigen Sie nextMarker im Ergebnis an, wenn sie angegeben wird.

az sig image-definition show

Ruft Informationen zu einer Katalogbilddefinition ab.

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

Optionale Parameter

--gallery-image-definition -i

Katalogbilddefinition.

--gallery-name -r

Katalogname.

--ids

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.

--resource-group -g

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

az sig image-definition show-community

Rufen Sie ein Communitykatalogbild ab.

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

Optionale Parameter

--gallery-image-definition -i

Der Name der Imagedefinition des Communitykatalogs, aus dem die Bildversionen aufgelistet werden sollen.

--ids

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.

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--public-gallery-name

Der öffentliche Name des Communitykatalogs.

az sig image-definition show-shared

Rufen Sie ein freigegebenes Katalogbild ab.

Rufen Sie ein freigegebenes Katalogbild ab, das direkt an Ihr Abonnement oder Mandanten freigegeben wurde.

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

Beispiele

Rufen Sie eine Bilddefinition in einem Katalog ab, der direkt an Ihr Abonnement oder Mandanten an dem 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 -i

Der Name der Freigegebenen Katalogbilddefinition, aus der die Bildversionen aufgelistet werden sollen.

--gallery-unique-name

Der eindeutige Name des freigegebenen Katalogs.

--ids

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.

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

az sig image-definition update

Aktualisieren einer VM-Imagedefinition.

az sig image-definition update --gallery-image-definition
                               --gallery-name
                               --resource-group
                               [--add]
                               [--force-string]
                               [--remove]
                               [--set]

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

Erforderliche Parameter

--gallery-image-definition -i

Katalogbilddefinition.

--gallery-name -r

Katalogname.

--resource-group -g

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

Optionale Parameter

--add

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

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgen literale beibehalten, anstatt zu versuchen, in JSON zu konvertieren.

--remove

Entfernen Sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftenpfad und einen wert angeben, der festgelegt werden soll. Beispiel: --set-property1.property2=.