Udostępnij za pośrednictwem

az sig image-version

Note

Ta grupa poleceń zawiera polecenia zdefiniowane zarówno w interfejsie wiersza polecenia platformy Azure, jak i w co najmniej jednym rozszerzeniu. Zainstaluj każde rozszerzenie, aby korzystać z rozszerzonych możliwości. Learn more about extensions.

Zarządzanie wersją obrazu galerii udostępnionej za pomocą maszyny wirtualnej.

Polecenia

Nazwa Opis Typ Stan
az sig image-version create

Utwórz nową wersję obrazu.

 Core ogólna dostępność
az sig image-version delete

Usuń wersję obrazu galerii.

 Core ogólna dostępność
az sig image-version list

Wyświetlanie listy wersji obrazów galerii w definicji obrazu galerii.

 Core ogólna dostępność
az sig image-version list-community

Wyświetlanie listy wersji obrazów maszyn wirtualnych w społeczności galerii.

 Core ogólna dostępność
az sig image-version list-community (image-gallery rozszerzenie)

Wyświetlanie listy wersji obrazów maszyn wirtualnych w społeczności galerii (wersja zapoznawcza).

 Extension Experimental
az sig image-version list-shared

Wyświetlanie listy wersji obrazów maszyny wirtualnej w galerii udostępnionej bezpośrednio w ramach subskrypcji lub dzierżawy.

 Core ogólna dostępność
az sig image-version show

Uzyskaj informacje o wersji obrazu galerii.

 Core ogólna dostępność
az sig image-version show-community

Pobierz wersję obrazu galerii społeczności.

 Core ogólna dostępność
az sig image-version show-community (image-gallery rozszerzenie)

Pobierz wersję obrazu w społeczności galerii (wersja zapoznawcza).

 Extension Experimental
az sig image-version show-shared

Pobierz wersję obrazu w galerii udostępnionej bezpośrednio do subskrypcji lub dzierżawy.

 Core ogólna dostępność
az sig image-version undelete

Przywróć nietrwałą wersję obrazu usuniętego.

 Core Preview
az sig image-version update

Aktualizowanie wersji obrazu udziału.

 Core ogólna dostępność
az sig image-version wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku.

 Core ogólna dostępność

az sig image-version create

Utwórz nową wersję obrazu.

Ta operacja może zająć dużo czasu w zależności od numeru regionu replikacji. Zaleca się użycie polecenia "--no-wait".

az sig image-version create --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group
                            [--allow-replicated-location-deletion {false, true}]
                            [--block-delete-before-eol --block-deletion-before-end-of-life {false, true}]
                            [--data-snapshot-luns]
                            [--data-snapshots]
                            [--data-vhds-luns]
                            [--data-vhds-sa --data-vhds-storage-accounts]
                            [--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]
                            [--storage-account-type {Premium_LRS, Standard_LRS, Standard_ZRS}]
                            [--tags]
                            [--target-edge-zone-encryption --zone-encryption]
                            [--target-edge-zones]
                            [--target-region-cvm-encryption]
                            [--target-region-encryption]
                            [--target-regions]
                            [--virtual-machine]

Przykłady

Dodawanie nowej wersji obrazu z maszyny wirtualnej

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

Dodawanie nowej wersji obrazu z obrazu zarządzanego

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

Dodawanie nowej wersji obrazu z innej wersji obrazu

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

Dodawanie nowej wersji obrazu z dysku zarządzanego

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

Dodawanie nowej wersji obrazu z dysku zarządzanego i dodawanie dodatkowych dysków danych

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

Dodaj nową wersję obrazu z migawki dysku systemu operacyjnego.

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

Dodawanie nowej wersji obrazu z migawki dysku systemu operacyjnego i dodawanie dodatkowych migawek jako dysków danych

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

Dodaj nową wersję obrazu z dysku VHD dysku systemu operacyjnego.

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

Dodawanie nowej wersji obrazu z dysku VHD dysku systemu operacyjnego i dodawanie dodatkowych dysków VHD jako dysków danych

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

Możesz połączyć migawki, dyski zarządzane i wirtualne dyski twarde, aby utworzyć nową wersję obrazu. Dodaj nową wersję obrazu przy użyciu dysku VHD jako dysku systemu operacyjnego i dysku zarządzanego oraz migawki jako dysków danych.

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

Dodaj nową wersję obrazu i skopiuj ją do dodatkowych regionów. Lokalizacja główna źródła wersji obrazu musi znajdować się na liście regionów docelowych. Dla każdego dodatkowego regionu można określić inną liczbę replik i typ konta magazynu. W przeciwnym razie region będzie dziedziczony z globalnego. Domyślna liczba replik to 1, a domyślny typ konta magazynu to Standardowa LRS. W tym przykładzie eastus2 będzie mieć jedną replikę przechowywaną w magazynie standardowego magazynu ZRS, ukwest będzie mieć 3 repliki przechowywane w magazynie ZRS w warstwie Standardowa, southindia będzie miała jedną replikę przechowywaną w magazynie LRS w warstwie Standardowa, a brazyliasouth będzie mieć 2 repliki przechowywane w magazynie LRS w warstwie Standardowa.

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

Dodaj nową wersję obrazu z szyfrowaniem przy użyciu zestawu szyfrowania dysków. Szyfrowanie jest stosowane do każdego dysku, który jest częścią wersji obrazu.

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

Dodaj nową wersję obrazu i skopiuj ją do lokalizacji rozszerzonych.

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

Dodaj nową wersję obrazu i skopiuj ją do lokalizacji rozszerzonych z szyfrowaniem przy użyciu zestawu szyfrowania dysków.

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

Dodaj nową wersję obrazu i nie czekaj na nią. Później możesz wywołać polecenie "az sig image-version wait", gdy wszystko będzie gotowe do utworzenia maszyny wirtualnej z poziomu wersji obrazu galerii

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

Dodaj nową wersję obrazu, ale usuń ją z uwzględnienia jako najnowszą wersję w definicji obrazu

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

Dodaj nową wersję obrazu i ustaw jej datę zakończenia użytkowania. Wersja obrazu może być nadal używana do tworzenia maszyny wirtualnej po jej dacie zakończenia użytkowania.

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

Dodaj nową wersję obrazu i zablokuj usuwanie tej wersji obrazu, jeśli jej koniec życia nie wygasł

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 \
--block-deletion-before-end-of-life true

Parametry wymagane

--gallery-image-definition -i

Definicja obrazu galerii.

--gallery-image-version -e

Wersja obrazu galerii we wzorcu wersji semantycznej. Dozwolone znaki to cyfra i kropka. Cyfry muszą należeć do zakresu 32-bitowej liczby całkowitej, np. <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Gallery name.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--allow-replicated-location-deletion

Określ, czy ta wersja obrazu galerii z replikowanych regionów jest dozwolona.

Właściwość Wartość
Dopuszczalne wartości: false, true
--block-delete-before-eol --block-deletion-before-end-of-life

Określ, czy usunięcie jest zablokowane dla tej wersji obrazu galerii, jeśli jego koniec życia nie wygasł.

Właściwość Wartość
Dopuszczalne wartości: false, true
--data-snapshot-luns

Numery jednostek logicznych (rozdzielane spacjami) migawek dysku danych.

--data-snapshots

Nazwy lub identyfikatory (rozdzielane spacjami) migawek dysku danych.

--data-vhds-luns

Numery jednostek logicznych (rozdzielane spacjami) źródłowych identyfikatorów URI dysków danych VHD.

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

Nazwy lub identyfikatory (rozdzielane spacjami) kont magazynu źródłowych identyfikatorów VHD dysków danych.

--data-vhds-uris

Źródłowe identyfikatory URI wirtualnego dysku twardego (rozdzielane spacjami) dysków danych.

--end-of-life-date

Data zakończenia życia, np. "2020-12-31".

--exclude-from-latest

Flaga oznacza, że jeśli ustawiono wartość true, osoby wdrażające maszyny wirtualne z pominiętą wersją nie będą używać tej wersji.

Właściwość Wartość
Dopuszczalne wartości: false, true
--image-version

Identyfikator zasobu źródła wersji obrazu galerii.

--location -l

Location. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--managed-image

Nazwa obrazu (jeśli w tej samej grupie zasobów) lub identyfikator zasobu.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość Wartość
Domyślna wartość: False
--os-snapshot

Nazwa lub identyfikator migawki dysku systemu operacyjnego.

--os-vhd-storage-account

Nazwa lub identyfikator konta magazynu źródłowego identyfikatora URI wirtualnego dysku twardego dysku systemu operacyjnego.

--os-vhd-uri

Źródłowy identyfikator URI wirtualnego dysku twardego dysku systemu operacyjnego.

--replica-count

Domyślna liczba replik do utworzenia w poszczególnych regionach. Aby ustawić liczbę replikacji regionalnej, użyj parametru --target-regions.

--replication-mode

Opcjonalny parametr określający tryb, który ma być używany do replikacji. Ta właściwość nie jest aktualizowalna.

--storage-account-type

Domyślny typ konta magazynu, który ma być używany w poszczególnych regionach. Aby ustawić typy kont magazynu regionalnego, użyj opcji --target-regions.

Właściwość Wartość
Dopuszczalne wartości: Premium_LRS, Standard_LRS, Standard_ZRS
--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

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

Rozdzielona spacjami lista kluczy zarządzanych przez klienta na potrzeby szyfrowania dysków systemu operacyjnego i danych w artefaktu galerii dla każdego regionu. Format dla każdej strefy krawędzi: <edge zone>,<os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>.

--target-edge-zones

Rozdzielona spacjami lista regionów, stref krawędzi, liczby replik i typów magazynu. Użyj <region>=<edge zone>[=<replica count>][=<storage account type>], aby opcjonalnie ustawić liczbę replik i/lub typ konta magazynu dla każdego regionu. Jeśli liczba replik nie zostanie określona, zostanie użyta domyślna liczba replik. Jeśli typ konta magazynu nie zostanie określony, zostanie użyty domyślny typ konta magazynu. Jeśli określono wartość "--target-edge-zones None", zostaną wyczyszczone lokalizacje rozszerzone obiektu docelowego.

--target-region-cvm-encryption

Rozdzielona spacjami lista klucza zarządzanego przez klienta dla poufnej maszyny wirtualnej szyfrujące dysk systemu operacyjnego w artefaktu galerii dla każdego regionu. Format dla każdego regionu: <os_cvm_encryption_type>,<os_cvm_des>. Prawidłowe wartości dla os_cvm_encryption_type to EncryptedVMGuestStateOnlyWithPmk, EncryptedWithPmk, EncryptedWithCmk.

--target-region-encryption

Rozdzielona spacjami lista kluczy zarządzanych przez klienta na potrzeby szyfrowania dysków systemu operacyjnego i danych w artefaktu galerii dla każdego regionu. Format dla każdego regionu: <os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>. Użyj wartości "null" jako symbolu zastępczego.

--target-regions

Rozdzielona spacjami lista regionów i ich liczby replik. Użyj <region>[=<replica count>][=<storage account type>], aby opcjonalnie ustawić liczbę replik i/lub typ konta magazynu dla każdego regionu. Jeśli liczba replik nie zostanie określona, zostanie użyta domyślna liczba replik. Jeśli typ konta magazynu nie zostanie określony, zostanie użyty domyślny typ konta magazynu.

--virtual-machine

Identyfikator zasobu źródła maszyny wirtualnej.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sig image-version delete

Usuń wersję obrazu galerii.

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

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Nazwa definicji obrazu galerii, w której znajduje się wersja obrazu.

Właściwość Wartość
Parameter group: Resource Id Arguments
--gallery-image-version --gallery-image-version-name -e

Nazwa wersji obrazu galerii, która ma zostać usunięta.

Właściwość Wartość
Parameter group: Resource Id Arguments
--gallery-name -r

Nazwa galerii obrazów udostępnionych, w której znajduje się definicja obrazu.

Właściwość Wartość
Parameter group: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Parameter group: Resource Id Arguments
--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość Wartość
Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Parameter group: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sig image-version list

Wyświetlanie listy wersji obrazów galerii w definicji obrazu galerii.

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

Parametry wymagane

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

Definicja obrazu galerii.

--gallery-name -r

Gallery name.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--max-items

Łączna liczba elementów do zwrócenia w danych wyjściowych polecenia. Jeśli łączna liczba dostępnych elementów jest większa niż określona wartość, token jest udostępniany w danych wyjściowych polecenia. Aby wznowić stronicowanie, podaj wartość tokenu w --next-token argumentu kolejnego polecenia.

Właściwość Wartość
Parameter group: Pagination Arguments
--next-token

Token do określenia, gdzie rozpocząć stronicowanie. Jest to wartość tokenu z wcześniej obciętej odpowiedzi.

Właściwość Wartość
Parameter group: Pagination Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sig image-version list-community

Wyświetlanie listy wersji obrazów maszyn wirtualnych w społeczności galerii.

az sig image-version list-community --gallery-image-definition
                                    --location
                                    --public-gallery-name
                                    [--max-items]
                                    [--next-token]

Przykłady

Wyświetlanie listy wersji obrazów w społeczności galerii.

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

Parametry wymagane

--gallery-image-definition -i

Nazwa definicji obrazu galerii społeczności, z której mają być wyświetlane wersje obrazów.

--location -l

Location. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--public-gallery-name

Publiczna nazwa galerii społeczności.

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--max-items

Łączna liczba elementów do zwrócenia w danych wyjściowych polecenia. Jeśli łączna liczba dostępnych elementów jest większa niż określona wartość, token jest udostępniany w danych wyjściowych polecenia. Aby wznowić stronicowanie, podaj wartość tokenu w --next-token argumentu kolejnego polecenia.

Właściwość Wartość
Parameter group: Pagination Arguments
--next-token

Token do określenia, gdzie rozpocząć stronicowanie. Jest to wartość tokenu z wcześniej obciętej odpowiedzi.

Właściwość Wartość
Parameter group: Pagination Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sig image-version list-community (image-gallery rozszerzenie)

Eksperymentalne

To polecenie jest eksperymentalne i opracowywane. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Wyświetlanie listy wersji obrazów maszyn wirtualnych w społeczności galerii (wersja zapoznawcza).

Wyświetlanie listy wersji obrazów maszyn wirtualnych w społeczności galerii (funkcja prywatnej wersji zapoznawczej, skontaktuj się z zespołem galerii obrazów społeczności pocztą e-mail sigpmdev@microsoft.com, aby zarejestrować się w celu uzyskania wersji zapoznawczej, jeśli interesuje Cię użycie tej funkcji).

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

Przykłady

Wyświetlanie listy wersji obrazów w społeczności galerii.

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

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--gallery-image-definition -i

Nazwa definicji obrazu galerii społeczności, z której mają być wyświetlane wersje obrazów.

Właściwość Wartość
Parameter group: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Parameter group: Resource Id Arguments
--location -l

Location. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--marker

Wartość ciągu, która identyfikuje część listy kontenerów, które mają zostać zwrócone przy użyciu następnej operacji wyświetlania listy. Operacja zwraca wartość NextMarker w treści odpowiedzi, jeśli operacja wyświetlania listy nie zwróciła wszystkich kontenerów pozostałych do wyświetlenia na bieżącej stronie. Jeśli zostanie określony, ten generator rozpocznie zwracanie wyników od momentu zatrzymania poprzedniego generatora.

--public-gallery-name

Publiczna nazwa galerii społeczności.

Właściwość Wartość
Parameter group: Resource Id Arguments
--show-next-marker

Pokaż następny znacznik w wyniku po określeniu.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Parameter group: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sig image-version list-shared

Wyświetlanie listy wersji obrazów maszyny wirtualnej w galerii udostępnionej bezpośrednio w ramach subskrypcji lub dzierżawy.

az sig image-version list-shared --gallery-image-definition
                                 --gallery-unique-name
                                 --location
                                 [--max-items]
                                 [--next-token]
                                 [--shared-to {tenant}]

Przykłady

Wyświetlanie listy wersji obrazów w galerii udostępnionej bezpośrednio do subskrypcji w danej lokalizacji i definicji obrazu.

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

Wyświetlanie listy wersji obrazów w galerii udostępnionej bezpośrednio dzierżawie w danej lokalizacji i definicji obrazu.

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

Parametry wymagane

--gallery-image-definition -i

Nazwa definicji obrazu galerii udostępnionej, z której mają być wyświetlane wersje obrazów.

--gallery-unique-name

Unikatowa nazwa galerii udostępnionej.

--location -l

Location. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--max-items

Łączna liczba elementów do zwrócenia w danych wyjściowych polecenia. Jeśli łączna liczba dostępnych elementów jest większa niż określona wartość, token jest udostępniany w danych wyjściowych polecenia. Aby wznowić stronicowanie, podaj wartość tokenu w --next-token argumentu kolejnego polecenia.

Właściwość Wartość
Parameter group: Pagination Arguments
--next-token

Token do określenia, gdzie rozpocząć stronicowanie. Jest to wartość tokenu z wcześniej obciętej odpowiedzi.

Właściwość Wartość
Parameter group: Pagination Arguments
--shared-to

Parametr zapytania, aby zdecydować, jakie galerie udostępnione mają być pobierane podczas wykonywania operacji wyświetlania listy. Jeśli nie zostanie określony, wyświetl listę według identyfikatora subskrypcji.

Właściwość Wartość
Dopuszczalne wartości: tenant
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sig image-version show

Uzyskaj informacje o wersji obrazu galerii.

az sig image-version show [--expand {ReplicationStatus, UefiSettings}]
                          [--gallery-image-definition]
                          [--gallery-image-version --gallery-image-version-name]
                          [--gallery-name]
                          [--ids]
                          [--resource-group]
                          [--subscription]

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--expand

Wyrażenie expand, które ma być stosowane w operacji.

Właściwość Wartość
Dopuszczalne wartości: ReplicationStatus, UefiSettings
--gallery-image-definition -i

Nazwa definicji obrazu galerii, w której znajduje się wersja obrazu.

Właściwość Wartość
Parameter group: Resource Id Arguments
--gallery-image-version --gallery-image-version-name -e

Nazwa wersji obrazu galerii, która ma zostać usunięta.

Właściwość Wartość
Parameter group: Resource Id Arguments
--gallery-name -r

Nazwa galerii obrazów udostępnionych, w której znajduje się definicja obrazu.

Właściwość Wartość
Parameter group: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Parameter group: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Parameter group: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sig image-version show-community

Pobierz wersję obrazu galerii społeczności.

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

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Nazwa definicji obrazu galerii społeczności, z której mają być wyświetlane wersje obrazów.

Właściwość Wartość
Parameter group: Resource Id Arguments
--gallery-image-version --gallery-image-version-name -e

Wersja obrazu galerii we wzorcu wersji semantycznej. Dozwolone znaki to cyfra i kropka. Cyfry muszą należeć do zakresu 32-bitowej liczby całkowitej, np. <MajorVersion>.<MinorVersion>.<Patch>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Parameter group: Resource Id Arguments
--location -l

Location. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--public-gallery-name

Publiczna nazwa galerii społeczności.

Właściwość Wartość
Parameter group: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Parameter group: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sig image-version show-community (image-gallery rozszerzenie)

Eksperymentalne

To polecenie jest eksperymentalne i opracowywane. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Pobierz wersję obrazu w społeczności galerii (wersja zapoznawcza).

Pobierz wersję obrazu w społeczności galerii (funkcja prywatnej wersji zapoznawczej, skontaktuj się z zespołem galerii obrazów społeczności pocztą e-mail sigpmdev@microsoft.com, aby zarejestrować się w celu uzyskania wersji zapoznawczej, jeśli interesuje Cię użycie tej funkcji).

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

Przykłady

Pobierz wersję obrazu w społeczności galerii w danej lokalizacji.

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

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--gallery-image-definition -i

Nazwa definicji obrazu galerii społeczności, z której mają być wyświetlane wersje obrazów.

Właściwość Wartość
Parameter group: Resource Id Arguments
--gallery-image-version -e

Nazwa wersji obrazu galerii do utworzenia. Musi być zgodna ze wzorcem nazwy wersji semantycznej: dozwolone znaki to cyfra i kropka. Cyfry muszą należeć do zakresu 32-bitowej liczby całkowitej. Format: <MajorVersion>.<MinorVersion>.<Patch>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Parameter group: Resource Id Arguments
--location -l

Location. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--public-gallery-name

Publiczna nazwa galerii społeczności.

Właściwość Wartość
Parameter group: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Parameter group: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sig image-version show-shared

Pobierz wersję obrazu w galerii udostępnionej bezpośrednio do subskrypcji lub dzierżawy.

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

Przykłady

Pobierz wersję obrazu w galerii udostępnionej bezpośrednio do subskrypcji lub dzierżawy w danej lokalizacji.

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

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Nazwa definicji obrazu galerii udostępnionej, z której mają być wyświetlane wersje obrazów.

Właściwość Wartość
Parameter group: Resource Id Arguments
--gallery-image-version --gallery-image-version-name -e

Nazwa wersji obrazu galerii do utworzenia. Musi być zgodna ze wzorcem nazwy wersji semantycznej: dozwolone znaki to cyfra i kropka. Cyfry muszą należeć do zakresu 32-bitowej liczby całkowitej. Format: <MajorVersion>.<MinorVersion>.<Patch>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--gallery-unique-name

Unikatowa nazwa galerii udostępnionej.

Właściwość Wartość
Parameter group: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Parameter group: Resource Id Arguments
--location -l

Location. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Parameter group: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sig image-version undelete

Wersja zapoznawcza

To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Przywróć nietrwałą wersję obrazu usuniętego.

Operacja zakończy się pomyślnie tylko wtedy, gdy zostanie użyta w galerii z nietrwałym usunięciem.

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]

Przykłady

Przywracanie nietrwałej wersji obrazu usuniętego

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

Parametry wymagane

--gallery-image-definition -i

Definicja obrazu galerii.

--gallery-image-version -e

Wersja obrazu galerii we wzorcu wersji semantycznej. Dozwolone znaki to cyfra i kropka. Cyfry muszą należeć do zakresu 32-bitowej liczby całkowitej, np. <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Gallery name.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--allow-replicated-location-deletion

Określ, czy ta wersja obrazu galerii z replikowanych regionów jest dozwolona.

Właściwość Wartość
Dopuszczalne wartości: false, true
--location -l

Location. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość Wartość
Domyślna wartość: False
--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sig image-version update

Aktualizowanie wersji obrazu udziału.

az sig image-version update --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group
                            [--add]
                            [--allow-replicated-location-deletion {false, true}]
                            [--block-delete-before-eol --block-deletion-before-end-of-life {false, true}]
                            [--force-string]
                            [--no-wait]
                            [--remove]
                            [--replica-count]
                            [--set]
                            [--target-edge-zones]
                            [--target-regions]

Przykłady

Zmienianie regionów replikacji i liczby replik

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

Zmienianie lokalizacji rozszerzonych replikacji

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

Wyczyść lokalizacje rozszerzone replikacji

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

Replikuj do dodatkowego regionu. Opcjonalnie można ustawić liczbę replik dla regionu i wykluczyć ten obraz podczas korzystania z najnowszej wersji definicji obrazu.

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

Zmień, czy obraz powinien być uwzględniony w przypadku najnowszej wersji w definicji obrazu. Ustawienie tej wartości na true powoduje wykluczenie obrazu z uwagi i ustawienie tej wartości na false zawiera obraz do rozważenia.

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

Zmień datę zakończenia życia wersji obrazu. Obraz może być nadal używany do tworzenia maszyn wirtualnych po dacie zakończenia życia.

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

Zezwalaj na usuwanie wersji obrazu galerii z replikowanych regionów.

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

Zablokuj usuwanie tej wersji obrazu z galerii, jeśli jej koniec życia nie wygasł.

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--block-deletion-before-end-of-life true

Parametry wymagane

--gallery-image-definition -i

Definicja obrazu galerii.

--gallery-image-version -e

Wersja obrazu galerii we wzorcu wersji semantycznej. Dozwolone znaki to cyfra i kropka. Cyfry muszą należeć do zakresu 32-bitowej liczby całkowitej, np. <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Gallery name.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

Właściwość Wartość
Parameter group: Generic Update Arguments
Domyślna wartość: []
--allow-replicated-location-deletion

Określ, czy ta wersja obrazu galerii z replikowanych regionów jest dozwolona.

Właściwość Wartość
Dopuszczalne wartości: false, true
--block-delete-before-eol --block-deletion-before-end-of-life

Określ, czy usunięcie jest zablokowane dla tej wersji obrazu galerii, jeśli jego koniec życia nie wygasł.

Właściwość Wartość
Dopuszczalne wartości: false, true
--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

Właściwość Wartość
Parameter group: Generic Update Arguments
Domyślna wartość: False
--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość Wartość
Domyślna wartość: False
--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Właściwość Wartość
Parameter group: Generic Update Arguments
Domyślna wartość: []
--replica-count

Domyślna liczba replik do utworzenia w poszczególnych regionach. Aby ustawić liczbę replikacji regionalnej, użyj parametru --target-regions.

--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

Właściwość Wartość
Parameter group: Generic Update Arguments
Domyślna wartość: []
--target-edge-zones

Rozdzielona spacjami lista regionów, stref krawędzi, liczby replik i typów magazynu. Użyj <region>=<edge zone>[=<replica count>][=<storage account type>], aby opcjonalnie ustawić liczbę replik i/lub typ konta magazynu dla każdego regionu. Jeśli liczba replik nie zostanie określona, zostanie użyta domyślna liczba replik. Jeśli typ konta magazynu nie zostanie określony, zostanie użyty domyślny typ konta magazynu. Jeśli określono wartość "--target-edge-zones None", zostaną wyczyszczone lokalizacje rozszerzone obiektu docelowego.

--target-regions

Rozdzielona spacjami lista regionów i ich liczby replik. Użyj <region>[=<replica count>][=<storage account type>], aby opcjonalnie ustawić liczbę replik i/lub typ konta magazynu dla każdego regionu. Jeśli liczba replik nie zostanie określona, zostanie użyta domyślna liczba replik. Jeśli typ konta magazynu nie zostanie określony, zostanie użyty domyślny typ konta magazynu.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az sig image-version wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku.

az sig image-version wait [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--expand {ReplicationStatus, UefiSettings}]
                          [--gallery-image-definition]
                          [--gallery-image-version --gallery-image-version-name]
                          [--gallery-name]
                          [--ids]
                          [--interval]
                          [--resource-group]
                          [--subscription]
                          [--timeout]
                          [--updated]

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".

Właściwość Wartość
Parameter group: Wait Condition Arguments
Domyślna wartość: False
--custom

Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Właściwość Wartość
Parameter group: Wait Condition Arguments
--deleted

Poczekaj na usunięcie.

Właściwość Wartość
Parameter group: Wait Condition Arguments
Domyślna wartość: False
--exists

Zaczekaj, aż zasób istnieje.

Właściwość Wartość
Parameter group: Wait Condition Arguments
Domyślna wartość: False
--expand

Wyrażenie expand, które ma być stosowane w operacji.

Właściwość Wartość
Dopuszczalne wartości: ReplicationStatus, UefiSettings
--gallery-image-definition -i

Nazwa definicji obrazu galerii, w której znajduje się wersja obrazu.

Właściwość Wartość
Parameter group: Resource Id Arguments
--gallery-image-version --gallery-image-version-name -e

Nazwa wersji obrazu galerii, która ma zostać usunięta.

Właściwość Wartość
Parameter group: Resource Id Arguments
--gallery-name -r

Nazwa galerii obrazów udostępnionych, w której znajduje się definicja obrazu.

Właściwość Wartość
Parameter group: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Parameter group: Resource Id Arguments
--interval

Interwał sondowania w sekundach.

Właściwość Wartość
Parameter group: Wait Condition Arguments
Domyślna wartość: 30
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Parameter group: Resource Id Arguments
--timeout

Maksymalny czas oczekiwania w sekundach.

Właściwość Wartość
Parameter group: Wait Condition Arguments
Domyślna wartość: 3600
--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

Właściwość Wartość
Parameter group: Wait Condition Arguments
Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False