az sig image-version

  • Referenz

Hinweis

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. Weitere Informationen zu Erweiterungen

Verwalten sie die Imageversion des freigegebenen Katalogs mit vm.

Befehle

Name Beschreibung Typ Status
az sig image-version create

Erstellt eine neue Imageversion.

 Core Allgemein verfügbar
az sig image-version delete

Löschen sie eine Katalogbildversion.

 Core Allgemein verfügbar
az sig image-version list

Listenkatalogbildversionen in einer Katalogbilddefinition.

 Core Allgemein verfügbar
az sig image-version list-community

Auflisten von VM-Imageversionen in einer Katalogcommunity.

 Core Allgemein verfügbar
az sig image-version list-community (image-gallery Erweiterung)

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

 Erweiterung Experimentell
az sig image-version list-shared

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

 Core Allgemein verfügbar
az sig image-version show

Ruft Informationen zu einer Katalogbildversion ab.

 Core Allgemein verfügbar
az sig image-version show-community

Rufen Sie eine Bilderversion des Communitykatalogs ab.

 Core Allgemein verfügbar
az sig image-version show-community (image-gallery Erweiterung)

Abrufen einer Bildversion in einer Galeriecommunity (Vorschau).

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

 Core Allgemein verfügbar
az sig image-version undelete

Wiederherstellen vorläufig gelöschter Bildversion.

 Core Vorschau
az sig image-version update

Aktualisieren sie eine Freigabebildversion.

 Core Allgemein verfügbar
az sig image-version wait

Warten Sie auf den Vorgang im Zusammenhang mit der Bildversion.

 Core Allgemein verfügbar

az sig image-version create

Erstellt eine neue Imageversion.

Dieser Vorgang kann je nach Replikationsregionsnummer eine lange Zeit in Anspruch nehmen. Verwenden Sie "--no-wait" wird empfohlen.

az sig image-version create --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group
                            [--allow-replicated-location-deletion {false, true}]
                            [--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-edge-zone-encryption]
                            [--target-edge-zones]
                            [--target-region-cvm-encryption]
                            [--target-region-encryption]
                            [--target-regions]
                            [--virtual-machine]

Beispiele

Hinzufügen einer neuen Imageversion von 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 Image

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

Hinzufügen einer neuen Imageversion aus einem Momentaufnahme eines Betriebssystemdatenträgers und Hinzufügen zusätzlicher Momentaufnahme 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-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 von 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 von einer 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 Momentaufnahme, verwaltete Datenträger und VHDs kombinieren, um eine neue Imageversion zu erstellen. Fügen Sie eine neue Imageversion mit einer 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 Bereiche. Der Startspeicherort für die Quelle der Bildversion muss in der Liste der Zielregionen enthalten sein. Für jede zusätzliche Region können Sie eine andere Replikatanzahl und einen anderen 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 im 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 mit einem Datenträgerverschlüsselungssatz hinzu. 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 kopieren Sie sie an erweiterte Speicherorte.

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-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1 \
brazilsouth=2=standard_lrs

Fügen Sie eine neue Imageversion hinzu, und kopieren Sie sie an erweiterte Speicherorte mit Verschlüsselung mithilfe eines Datenträgerverschlüsselungssatzes.

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-edge-zones westus=microsoftlosangeles1 \
--target-edge-zone-encryption microsoftlosangeles1,WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2

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 Berücksichtigung 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 Lebenszyklus fest. Die Imageversion kann weiterhin verwendet werden, um einen virtuellen Computer nach dem Enddatum des Lebenszyklus 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 Punkt. Ziffern müssen sich innerhalb des Bereichs einer 32-Bit-Ganzzahl befinden, 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

--allow-replicated-location-deletion

Gibt an, ob das Entfernen dieser Katalogbildversion aus replizierten Regionen zulässig ist.

Zulässige Werte: false, true
--data-snapshot-luns

Logische Einheitennummern (durch Leerzeichen getrennt) von Datenträgern Momentaufnahme s.

--data-snapshots

Namen oder IDs (durch Leerzeichen getrennt) von Datenträgern Momentaufnahme s.

--data-vhds-luns

Logische Einheitennummern (durch Leerzeichen getrennt) von VHD-Quell-URIs von Datenträgern.

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

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

--data-vhds-uris

Quell-VHD-URIs (durch Leerzeichen getrennt) von Datenträgern.

--end-of-life-date

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

--exclude-from-latest

Das Kennzeichen bedeutet, dass personen, die virtuelle Computer 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 Bildversionsquelle des Katalogs.

--location -l

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

Standardwert: False
--os-snapshot

Name oder ID des Betriebssystemdatenträgers Momentaufnahme.

--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. Verwenden Sie "--target-regions", um die Anzahl der regionalen Replikationen festzulegen.

--replication-mode

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

Zulässige Werte: Full, Shallow
--storage-account-type

Der Standardspeicherkontotyp, der pro Region verwendet werden soll. Verwenden Sie "--target-regions", um regionale Speicherkontotypen festzulegen.

Zulässige Werte: Premium_LRS, Standard_LRS, Standard_ZRS
--tags

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

--target-edge-zone-encryption --zone-encryption

Durch Leerzeichen getrennte Liste der vom Kunden verwalteten Schlüssel zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt für jede Region. Format für jede Randzone: ,<os_des>,,<lun1_des>,,<lun2_des>.

--target-edge-zones

Durch Leerzeichen getrennte Liste von Regionen, Edgezonen, Replikatanzahl und Speichertypen. Verwenden Sie =[=][=] zum optionalen Festlegen der Replikatanzahl und/oder des Speicherkontotyps für jede Region. Wenn keine Replikatanzahl angegeben ist, wird die Standardreplikatanzahl verwendet. Wenn kein Speicherkontotyp angegeben ist, wird der Standardspeicherkontotyp verwendet. Wenn "--target-edge-zones None" angegeben ist, werden die erweiterten Zielspeicherorte gelöscht.

--target-region-cvm-encryption

Durch Leerzeichen getrennte Liste des vom Kunden verwalteten Schlüssels für den vertraulichen virtuellen Computer, 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

Durch Leerzeichen getrennte Liste der vom Kunden verwalteten Schlüssel zum Verschlüsseln des Betriebssystems und der 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

Durch Leerzeichen getrennte Liste der Regionen und deren Replikatanzahl. Wird <region>[=<replica count>][=<storage account type>] verwendet, um optional die Replikatanzahl und/oder den Speicherkontotyp für jede Region festzulegen. Wenn keine Replikatanzahl angegeben ist, wird die Standardreplikatanzahl verwendet. Wenn kein Speicherkontotyp angegeben ist, 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.

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

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 sie eine Katalogbildversion.

az sig image-version delete [--gallery-image-definition]
                            [--gallery-image-version]
                            [--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 Katalogbilddefinition, in der sich die Bildversion befindet.

--gallery-image-version --gallery-image-version-name -e

Der Name der Katalogbildversion, die gelöscht werden soll.

--gallery-name -r

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

--ids

Eine oder mehrere 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

Nicht auf den Abschluss lang andauernder Vorgänge warten

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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID 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.

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

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
                          [--max-items]
                          [--next-token]

Erforderliche Parameter

--gallery-image-definition --gallery-image-name -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

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

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.

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

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

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

Beispiele

Auflisten einer Bildversion in einer Katalogcommunity.

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 Community gallery-Bilddefinition, aus der die Bildversionen aufgelistet werden sollen.

--ids

Eine oder mehrere 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

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, 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 erneut zurückgibt Standard 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID 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.

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

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 (image-gallery Erweiterung)

Experimentell

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

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

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

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

Beispiele

Auflisten einer Bildversion in einer Katalogcommunity.

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 Community gallery-Bilddefinition, aus der die Bildversionen aufgelistet werden sollen.

--ids

Eine oder mehrere 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

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, 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 erneut zurückgibt Standard 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID 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.

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

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

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

Beispiele

Auflisten von Bildversionen in einem Katalog, die direkt für Ihr Abonnement am angegebenen Speicherort und in der angegebenen Bilddefinition freigegeben wurden.

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

Auflisten von Bildversionen in einem Katalog, die direkt für Ihren Mandanten freigegeben wurden, im angegebenen Speicherort und in der angegebenen Bilddefinition.

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 Definition des freigegebenen Katalogbilds, 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). 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

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, 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 erneut zurückgibt Standard 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID 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.

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

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

Katalogbildversion im semantischen Versionsmuster. Die zulässigen Zeichen sind Ziffern und Punkt. Ziffern müssen sich innerhalb des Bereichs einer 32-Bit-Ganzzahl befinden, 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

--expand

Der erweiterungsausdruck, der auf 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.

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

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 Bilderversion des Communitykatalogs ab.

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

Optionale Parameter

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

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

--gallery-image-version --gallery-image-version-name -e

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

--ids

Eine oder mehrere 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

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.

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

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.

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

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 (image-gallery Erweiterung)

Experimentell

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

Abrufen einer Bildversion in einer Galeriecommunity (Vorschau).

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

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

Beispiele

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

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

Optionale Parameter

--gallery-image-definition -i

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

--gallery-image-version -e

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

--ids

Eine oder mehrere 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

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.

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

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.

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

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]
                                 [--subscription]

Beispiele

Rufen Sie eine Bildversion in einem Katalog ab, der direkt für Ihr Abonnement oder Ihren Mandanten am 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 --gallery-image-name -i

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

--gallery-image-version --gallery-image-version-name -e

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

--gallery-unique-name

Der eindeutige Name des freigegebenen Katalogs.

--ids

Eine oder mehrere 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

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

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

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.

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

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 undelete

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Wiederherstellen vorläufig gelöschter Bildversion.

Der Vorgang ist nur erfolgreich, wenn er in einem Katalog mit vorläufigem Löschen verwendet wird.

az sig image-version undelete --gallery-image-definition
                              --gallery-image-version
                              --gallery-name
                              --resource-group
                              [--allow-replicated-location-deletion {false, true}]
                              [--location]
                              [--no-wait]
                              [--tags]

Beispiele

Wiederherstellen einer vorläufig gelöschten Bildversion

az sig image-version undelete --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.1.1

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 sich innerhalb des Bereichs einer 32-Bit-Ganzzahl befinden, 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

--allow-replicated-location-deletion

Gibt an, ob das Entfernen dieser Katalogbildversion aus replizierten Regionen zulässig ist.

Zulässige Werte: false, true
--location -l

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

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--tags

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

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.

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

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 sie eine Freigabebildversion.

az sig image-version update --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group
                            [--add]
                            [--allow-replicated-location-deletion {false, true}]
                            [--force-string]
                            [--no-wait]
                            [--remove]
                            [--replica-count]
                            [--set]
                            [--target-edge-zones]
                            [--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

Ändern der erweiterten Replikationsspeicherorte

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1

Löschen der erweiterten Replikationsstandorte

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones None

Replizieren in einen zusätzlichen Bereich. Optional können Sie die Replikatanzahl für den Bereich festlegen und dieses Bild ausschließen, wenn Sie die neueste Version der Bilddefinition verwenden.

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 excludeFromLatest=true

Ändern Sie, ob ein Bild bei der neuesten Version in der Bilddefinition berücksichtigt werden soll. Wenn Sie diesen Wert auf "true" festlegen, wird das Bild von der Berücksichtigung ausgeschlossen, und wenn dieser Wert auf "false" festgelegt wird, wird das Bild zur Berücksichtigung berücksichtigt.

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 Datum des Lebenszyklus für eine Bildversion. Das Image kann weiterhin verwendet werden, um virtuelle Computer nach ablaufen des Lebenszyklusdatums 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

Zulassen, dass die Katalogbildversion aus replizierten Regionen entfernt werden kann.

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

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 sich innerhalb des Bereichs einer 32-Bit-Ganzzahl befinden, 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

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

Standardwert: []
--allow-replicated-location-deletion

Gibt an, ob das Entfernen dieser Katalogbildversion aus replizierten Regionen zulässig ist.

Zulässige Werte: false, true
--force-string

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

Standardwert: False
--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--remove

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

Standardwert: []
--replica-count

Die Standardanzahl der Replikate, die pro Region erstellt werden sollen. Verwenden Sie "--target-regions", um die Anzahl der regionalen Replikationen festzulegen.

--set

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

Standardwert: []
--target-edge-zones

Durch Leerzeichen getrennte Liste von Regionen, Edgezonen, Replikatanzahl und Speichertypen. Verwenden Sie =[=][=] zum optionalen Festlegen der Replikatanzahl und/oder des Speicherkontotyps für jede Region. Wenn keine Replikatanzahl angegeben ist, wird die Standardreplikatanzahl verwendet. Wenn kein Speicherkontotyp angegeben ist, wird der Standardspeicherkontotyp verwendet. Wenn "--target-edge-zones None" angegeben ist, werden die erweiterten Zielspeicherorte gelöscht.

--target-regions

Durch Leerzeichen getrennte Liste der Regionen und deren Replikatanzahl. Wird <region>[=<replica count>][=<storage account type>] verwendet, um optional die Replikatanzahl und/oder den Speicherkontotyp für jede Region festzulegen. Wenn keine Replikatanzahl angegeben ist, wird die Standardreplikatanzahl verwendet. Wenn kein Speicherkontotyp angegeben ist, 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.

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

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 Vorgang im Zusammenhang mit 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 Vorgang mit bildversionsbezogener Version. (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

Katalogbildversion im semantischen Versionsmuster. Die zulässigen Zeichen sind Ziffern und Punkt. Ziffern müssen sich innerhalb des Bereichs einer 32-Bit-Ganzzahl befinden, 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

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

Der erweiterungsausdruck, der für den Vorgang angewendet werden soll. Der Standardwert "ReplicationStatus" ist "None".

--interval

Abrufintervall in Sekunden.

Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

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

Standardwert: False
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.

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

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.