az sig image-version

Referenz

Verwalten der version des freigegebenen Katalogimages mit VM.

Befehle

az sig image-version create	Erstellt eine neue Imageversion.
az sig image-version delete	Löschen sie eine Katalogbildversion.
az sig image-version list	Listenkatalogbildversionen in einer Katalogbilddefinition.
az sig image-version list-community	Auflisten von VM-Bildversionen in einer Kataloggemeinschaft.
az sig image-version list-shared	Auflisten von VM-Bildversionen in einem Katalog, der direkt an Ihr Abonnement oder Mandanten freigegeben wurde.
az sig image-version show	Ruft Informationen zu einer Katalogbildversion ab.
az sig image-version show-community	Rufen Sie eine Communitykatalog-Bildversion ab.
az sig image-version show-shared	Rufen Sie eine Bildversion in einem Katalog ab, die direkt an Ihr Abonnement oder Ihren Mandanten freigegeben wurde.
az sig image-version update	Aktualisieren einer Freigabeimageversion.
az sig image-version wait	Warten Sie auf den zugehörigen Bildversionsvorgang.

az sig image-version create

Erstellt eine neue Imageversion.

Dieser Vorgang kann lange dauern, abhängig von der Replikationsregionsnummer. Verwenden Sie "-no-wait" wird empfohlen.

az sig image-version create --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group
                            [--data-snapshot-luns]
                            [--data-snapshots]
                            [--data-vhds-luns]
                            [--data-vhds-sa]
                            [--data-vhds-uris]
                            [--end-of-life-date]
                            [--exclude-from-latest {false, true}]
                            [--image-version]
                            [--location]
                            [--managed-image]
                            [--no-wait]
                            [--os-snapshot]
                            [--os-vhd-storage-account]
                            [--os-vhd-uri]
                            [--replica-count]
                            [--replication-mode {Full, Shallow}]
                            [--storage-account-type {Premium_LRS, Standard_LRS, Standard_ZRS}]
                            [--tags]
                            [--target-region-cvm-encryption]
                            [--target-region-encryption]
                            [--target-regions]
                            [--virtual-machine]

Beispiele

Hinzufügen einer neuen Bildversion aus einem virtuellen Computer

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM

Hinzufügen einer neuen Bildversion aus einem verwalteten Bild

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--managed-image /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/images/MyManagedImage

Hinzufügen einer neuen Bildversion aus einer anderen Bildversion

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--image-version /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/galleries/MyGallery/images/MyImageDefinition/versions/1.0.0

Hinzufügen einer neuen Imageversion von einem verwalteten Datenträger

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk

Hinzufügen einer neuen Imageversion aus einem verwalteten Datenträger und Hinzufügen zusätzlicher Datenträger

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk \
--data-snapshot-luns 0

Fügen Sie eine neue Imageversion aus einer Momentaufnahme eines Betriebssystemdatenträgers hinzu.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot

Fügen Sie eine neue Imageversion aus einer Momentaufnahme eines Betriebssystemdatenträgers hinzu und fügen Sie zusätzliche Momentaufnahmen als Datenträger hinzu.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0

Fügen Sie eine neue Imageversion aus einer VHD eines Betriebssystemdatenträgers hinzu.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file

Hinzufügen einer neuen Imageversion aus einem VHD eines Betriebssystemdatenträgers und Hinzufügen zusätzlicher VHDs als Datenträger

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-sa /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/myotherstorageaccount \
--data-vhds-uris https://myotherstorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-luns 0

Sie können Momentaufnahmen, verwaltete Datenträger und VHDs kombinieren, um eine neue Imageversion zu erstellen. Fügen Sie eine neue Imageversion mit einem VHD als Betriebssystemdatenträger und einem verwalteten Datenträger und einer Momentaufnahme als Datenträger hinzu.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0 1

Fügen Sie eine neue Bildversion hinzu, und kopieren Sie sie in zusätzliche Regionen. Der Startspeicherort für die Quelle der Bildversion muss in die Liste der Zielbereiche einbezogen werden. Für jede zusätzliche Region können Sie einen anderen Replikatanzahls- und Speicherkontotyp angeben. Andernfalls erbt die Region von der globalen. Die Standardreplikatanzahl ist 1 und der Standardspeicherkontotyp ist Standard LRS. In diesem Beispiel verfügt Eastus2 über ein Replikat, das im Standard-ZRS-Speicher gespeichert ist, ukwest verfügt über 3 Replikate, die im Standard-ZRS-Speicher gespeichert sind, southindia verfügt über ein Replikat, das im Standard LRS-Speicher gespeichert ist, und Brasiliensouth verfügt über 2 Replikate, die auf dem Standard LRS-Speicher gespeichert sind.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-regions eastus2 ukwest=3 southindia=standard_lrs \
brazilsouth=2=standard_lrs

Fügen Sie eine neue Imageversion mit Verschlüsselung mithilfe eines Datenträgerverschlüsselungssatzes hinzu. Die Verschlüsselung wird auf jeden Datenträger angewendet, der teil der Imageversion ist.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-regions westus=2=standard eastus \
--target-region-encryption WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2 \
EastUSDiskEncryptionSet1,0,EastUSDiskEncryptionSet2

Fügen Sie eine neue Bildversion hinzu, und warten Sie nicht darauf. Später können Sie den Befehl "az sig image-version wait" aufrufen, wenn sie bereit sind, einen virtuellen Computer aus der Katalogimageversion zu erstellen.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--no-wait

Fügen Sie eine neue Bildversion hinzu, entfernen Sie sie jedoch aus der Erwägung als neueste Version in der Bilddefinition.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--exclude-from-latest true

Fügen Sie eine neue Bildversion hinzu, und legen Sie das Enddatum des Lebens fest. Die Imageversion kann weiterhin verwendet werden, um einen virtuellen Computer nach dem Ende des Lebensdatums zu erstellen.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--end-of-life-date 2024-08-02T00:00:00+00:00

Erforderliche Parameter

--gallery-image-definition -i

Katalogbilddefinition.

--gallery-image-version -e

Katalogbildversion im semantischen Versionsmuster. Die zulässigen Zeichen sind Ziffern und Zeitraum. Ziffern müssen innerhalb des Bereichs einer 32-Bit-Ganzzahl liegen, z. B. <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Katalogname.

--resource-group -g

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

Optionale Parameter

--data-snapshot-luns

Logische Einheitsnummern (leergetrennt) von Datendatenträgeraufnahmen.

--data-snapshots

Namen oder IDs (Leerzeichen) von Datendatenträgeraufnahmen.

--data-vhds-luns

Logische Einheitsnummern (Leerzeichen) von Quell-VHD-URIs von Datenträgern.

--data-vhds-sa --data-vhds-storage-accounts

Namen oder IDs (Leerzeichen) von Speicherkonten der Quell-VHD-URIs von Datenträgern.

--data-vhds-uris

Quell-VHD-URIs (leerlimitiert) von Datenträgern.

--end-of-life-date

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

--exclude-from-latest

Das Flag bedeutet, dass Personen, die VMs mit nicht angegebener Version bereitstellen, diese Version nicht verwenden, wenn sie auf "true" festgelegt ist.

Zulässige Werte: false, true

--image-version

Ressourcen-ID der Katalogbildversionsquelle.

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

--managed-image

Bildname(wenn in derselben Ressourcengruppe) oder Ressourcen-ID.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--os-snapshot

Name oder ID der Betriebssystemdatenträgeraufnahme.

--os-vhd-storage-account

Name oder ID des Speicherkontos des Quell-VHD-URI des Betriebssystemdatenträgers.

--os-vhd-uri

Quell-VHD-URI des Betriebssystemdatenträgers.

--replica-count

Die Standardanzahl der Replikate, die pro Region erstellt werden sollen. Um regionale Replikationsanzahlen festzulegen, verwenden Sie --Zielregionen.

--replication-mode

Optionaler Parameter, der den Modus angibt, der für die Replikation verwendet werden soll. Diese Eigenschaft ist nicht updatable.

Zulässige Werte: Full, Shallow

--storage-account-type

Der Standardspeicherkontotyp, der pro Region verwendet werden soll. Um regionale Speicherkontotypen festzulegen, verwenden Sie --Zielregionen.

Zulässige Werte: Premium_LRS, Standard_LRS, Standard_ZRS

--tags

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

--target-region-cvm-encryption

Leergetrennte Liste des vom Kunden verwalteten Schlüssels für vertrauliche VM, der den Betriebssystemdatenträger im Katalogartefakt für jede Region verschlüsselt. Format für jede Region: <os_cvm_encryption_type>,<os_cvm_des>. Die gültigen Werte für os_cvm_encryption_type sind EncryptedVMGuestStateOnlyWithPmk, EncryptedWithPmk, EncryptedWithCmk.

--target-region-encryption

Leergetrennte Liste der vom Kunden verwalteten Schlüssel zum Verschlüsseln der Betriebssystem- und Datenträger im Katalogartefakt für jede Region. Format für jede Region: <os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>. Verwenden Sie "null" als Platzhalter.

--target-regions

Leergetrennte Liste der Regionen und deren Replikatanzahl. Verwenden Sie <region>[=<replica count>][=<storage account type>] optional die Replikatanzahl und/oder den Speicherkontotyp für jede Region. Wenn eine Replikatanzahl nicht angegeben wird, wird die Standardreplikatanzahl verwendet. Wenn kein Speicherkontotyp angegeben wird, wird der Standardspeicherkontotyp verwendet.

--virtual-machine

Ressourcen-ID der VM-Quelle.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sig image-version delete

Löschen einer Katalogbildversion.

az sig image-version delete --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group

Erforderliche Parameter

--gallery-image-definition -i

Katalogbilddefinition.

--gallery-image-version -e

Katalogbildversion im semantischen Versionsmuster. Die zulässigen Zeichen sind Ziffern und Punkt. Ziffern müssen innerhalb des Bereichs einer 32-Bit-Ganzzahl liegen, z. B. <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Katalogname.

--resource-group -g

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

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sig image-version list

Listenkatalogbildversionen in einer Katalogbilddefinition.

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

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.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sig image-version list-community

Auflisten von VM-Imageversionen in einer Katalog-Community.

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

Beispiele

Listet eine Bildversion in einer Kataloggemeinschaft auf.

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

Optionale Parameter

--gallery-image-definition -i

Der Name der Bilddefinition des Communitykatalogs, aus der 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 von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-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

"NextMarker" im Ergebnis anzeigen, wenn angegeben.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sig image-version list-shared

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

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

Beispiele

Auflisten von Bildversionen in einem Katalog, der direkt an Ihrem Abonnement an einem bestimmten Ort und in der Bilddefinition freigegeben wurde.

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

Auflisten von Bildversionen in einem Katalog, der direkt an Ihren Mandanten in der angegebenen Position und Bilddefinition freigegeben wurde.

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

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

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

--shared-to

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

Zulässige Werte: tenant

--show-next-marker

"NextMarker" im Ergebnis anzeigen, wenn angegeben.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sig image-version show

Ruft Informationen zu einer Katalogbildversion ab.

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

Erforderliche Parameter

--gallery-image-definition -i

Katalogbilddefinition.

--gallery-image-version -e

--gallery-name -r

Katalogname.

--resource-group -g

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

Optionale Parameter

--expand

Der erweiterungsausdruck, der für den Vorgang angewendet werden soll, z. B. "ReplicationStatus".

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sig image-version show-community

Rufen Sie eine Bildversion des Communitykatalogs ab.

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

Optionale Parameter

--gallery-image-definition -i

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

--gallery-image-version -e

Der Name der zu erstellenden Katalogbildversion. Muss dem Semantik-Versionsnamenmuster folgen: Die zulässigen Zeichen sind Ziffern und Punkt. Ziffern müssen innerhalb des Bereichs einer 32-Bit-Ganzzahl liegen. Format:...

--ids

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

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sig image-version show-shared

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

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

Beispiele

Rufen Sie eine Bildversion in einem Katalog ab, der direkt an Ihrem Abonnement oder Mandanten an dem angegebenen Speicherort freigegeben wurde.

az sig image-version show-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocation

Optionale Parameter

--gallery-image-definition -i

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

--gallery-image-version -e

--gallery-unique-name

Der eindeutige Name des freigegebenen Katalogs.

--ids

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

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sig image-version update

Aktualisieren einer Freigabeimageversion.

az sig image-version update --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group
                            [--add]
                            [--force-string]
                            [--no-wait]
                            [--remove]
                            [--replica-count]
                            [--set]
                            [--target-regions]

Beispiele

Ändern der Replikationsbereiche und Replikatanzahl

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-regions westcentralus=2 eastus2

Replizieren sie in einen zusätzlichen Bereich. Optional können Sie die Replikatanzahl für die Region festlegen.

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--add publishingProfile.targetRegions name=westcentralus \
regionalReplicaCount=3

Ändern Sie, ob ein Bild in die neueste Version der Bilddefinition einbezogen werden soll. Durch Festlegen dieses Werts auf "true" wird das Bild von der Berücksichtigung ausgeschlossen, und das Festlegen dieses Werts auf "false" schließt das Bild zur Berücksichtigung ein.

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.excludeFromLatest=true

Ändern Sie das Enddatum für eine Bildversion. Das Image kann weiterhin verwendet werden, um virtuelle Computer nach dem Ende des Lebenszyklus zu erstellen.

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.endOfLifeDate=2024-08-02T00:00:00+00:00

Erforderliche Parameter

--gallery-image-definition -i

Katalogbilddefinition.

--gallery-image-version -e

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

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--remove

Entfernen einer Eigenschaft oder eines Elements aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--replica-count

Die Standardanzahl der Replikate, die pro Region erstellt werden sollen. Verwenden Sie zum Festlegen der regionalen Replikationsanzahl --target-regions.

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftspfad und einen festzulegenden Wert angeben. Beispiel: --set property1.property2=.

--target-regions

Leerzeichentrennte Liste der Regionen und deren Replikatanzahl. Verwenden Sie <region>[=<replica count>][=<storage account type>] optional die Replikatanzahl und/oder den Speicherkontotyp für jede Region. Wenn keine Replikatanzahl angegeben ist, wird die Standardreplikatanzahl verwendet. Wenn kein Speicherkontotyp angegeben wird, wird der Standardspeicherkontotyp verwendet.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sig image-version wait

Warten Sie auf den zugehörigen Vorgang der Bildversion.

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

Beispiele

warten, bis eine Bildversion aktualisiert wird

az sig image-version wait --updated --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0

Warten Sie auf den zugehörigen Vorgang der Bildversion. (automatisch generiert)

az sig image-version wait --created --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0

Erforderliche Parameter

--gallery-image-definition -i

Katalogbilddefinition.

--gallery-image-version -e

--gallery-name -r

Katalogname.

--resource-group -g

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

Optionale Parameter

--created

Warten Sie, bis Sie mit "provisioningState" unter "Erfolgreich" erstellt wurden.

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

--exists

Warten Sie, bis die Ressource vorhanden ist.

--expand

Der erweiterungsausdruck, der für den Vorgang angewendet werden soll. Der Standardwert ist Keine.

--interval

Abfrageintervall in Sekunden.

Standardwert: 30

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600

--updated

Warten Sie, bis die Aktualisierung mit provisioningState unter "Erfolgreich" ausgeführt wurde.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sig image-version

Befehle

az sig image-version create

Beispiele

Erforderliche Parameter

Optionale Parameter

az sig image-version delete

Erforderliche Parameter

az sig image-version list

Erforderliche Parameter

az sig image-version list-community

Beispiele

Optionale Parameter

az sig image-version list-shared

Beispiele

Optionale Parameter

az sig image-version show

Erforderliche Parameter

Optionale Parameter

az sig image-version show-community

Optionale Parameter

az sig image-version show-shared

Beispiele

Optionale Parameter

az sig image-version update

Beispiele

Erforderliche Parameter

Optionale Parameter

az sig image-version wait

Beispiele

Erforderliche Parameter

Optionale Parameter

Feedback