az sig image-version

  • Referens

Kommentar

Den här kommandogruppen har kommandon som definieras i både Azure CLI och minst ett tillägg. Installera varje tillägg för att dra nytta av dess utökade funktioner. Läs mer om tillägg.

Hantera delad galleriavbildningsversion med virtuell dator.

Kommandon

Name Description Typ Status
az sig image-version create

Skapa en ny avbildningsversion.

 Kärna Allmän tillgänglighet
az sig image-version delete

Ta bort en galleribildversion.

 Kärna Allmän tillgänglighet
az sig image-version list

Lista galleribildversioner i en galleribilddefinition.

 Kärna Allmän tillgänglighet
az sig image-version list-community

Visa en lista över vm-avbildningsversioner i en gallericommunity.

 Kärna Allmän tillgänglighet
az sig image-version list-community (image-gallery anknytning)

Visa en lista över vm-avbildningsversioner i en gallericommunity (förhandsversion).

 Anknytning Experimentell
az sig image-version list-shared

Visa en lista över vm-avbildningsversioner i ett galleri som delas direkt till din prenumeration eller klientorganisation.

 Kärna Allmän tillgänglighet
az sig image-version show

Hämtar information om en galleribildversion.

 Kärna Allmän tillgänglighet
az sig image-version show-community

Hämta en avbildningsversion för communitygalleriet.

 Kärna Allmän tillgänglighet
az sig image-version show-community (image-gallery anknytning)

Hämta en avbildningsversion i en gallericommunity (förhandsversion).

 Anknytning Experimentell
az sig image-version show-shared

Hämta en avbildningsversion i ett galleri som delas direkt till din prenumeration eller klientorganisation.

 Kärna Allmän tillgänglighet
az sig image-version undelete

Återställ mjuk borttagen avbildningsversion.

 Kärna Förhandsgranska
az sig image-version update

Uppdatera en resursbildversion.

 Kärna Allmän tillgänglighet
az sig image-version wait

Vänta tills avbildningsversionen är relaterad till åtgärden.

 Kärna Allmän tillgänglighet

az sig image-version create

Skapa en ny avbildningsversion.

Den här åtgärden kan ta lång tid beroende på det replikerade regionnumret. Använd "--no-wait" rekommenderas.

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]

Exempel

Lägga till en ny avbildningsversion från en virtuell dator

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

Lägga till en ny avbildningsversion från en hanterad avbildning

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

Lägga till en ny avbildningsversion från en annan avbildningsversion

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

Lägga till en ny avbildningsversion från en hanterad disk

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

Lägg till en ny avbildningsversion från en hanterad disk och lägg till ytterligare datadiskar

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

Lägg till en ny avbildningsversion från en ögonblicksbild av en OS-disk.

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

Lägg till en ny avbildningsversion från en ögonblicksbild av en OS-disk och lägg till ytterligare ögonblicksbilder som datadiskar

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

Lägg till en ny avbildningsversion från en virtuell hårddisk på en OS-disk.

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

Lägg till en ny avbildningsversion från en virtuell hårddisk på en OS-disk och lägg till ytterligare virtuella hårddiskar som datadiskar

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

Du kan kombinera ögonblicksbilder, hanterade diskar och virtuella hårddiskar för att skapa en ny avbildningsversion. Lägg till en ny avbildningsversion med en virtuell hårddisk som OS-disk och en hanterad disk och en ögonblicksbild som datadiskar.

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

Lägg till en ny avbildningsversion och kopiera den till ytterligare regioner. Startplatsen för avbildningsversionens källa måste ingå i listan över målregioner. För varje ytterligare region kan du ange olika replikantal och lagringskontotyp. Annars ärver regionen från den globala. Standardreplikantalet är 1 och standardlagringskontotypen är Standard LRS. I det här exemplet har eastus2 en replik lagrad på Standard ZRS-lagring, ukwest har 3 repliker lagrade på Standard ZRS-lagring, southindia har en replik lagrad på Standard LRS-lagring och brazilsouth har 2 repliker lagrade på Standard LRS-lagring.

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

Lägg till en ny avbildningsversion med kryptering med hjälp av en diskkrypteringsuppsättning. Kryptering tillämpas på varje disk som är en del av avbildningsversionen.

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

Lägg till en ny avbildningsversion och kopiera den till utökade platser.

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

Lägg till en ny avbildningsversion och kopiera den till utökade platser med kryptering med hjälp av en diskkrypteringsuppsättning.

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

Lägg till en ny avbildningsversion och vänta inte på den. Senare kan du anropa kommandot "az sig image-version wait" när du är redo att skapa en virtuell dator från galleriavbildningsversionen

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

Lägg till en ny avbildningsversion men ta bort den från övervägandet som den senaste versionen i avbildningsdefinitionen

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

Lägg till en ny avbildningsversion och ange dess slutdatum. Avbildningsversionen kan fortfarande användas för att skapa en virtuell dator efter dess slutdatum.

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

Obligatoriska parametrar

--gallery-image-definition -i

Galleribilddefinition.

--gallery-image-version -e

Galleribildversion i semantiskt versionsmönster. De tillåtna tecknen är siffror och punkt. Siffrorna måste ligga inom intervallet för ett 32-bitars heltal, t.ex. <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Gallerinamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--allow-replicated-location-deletion

Ange om det är tillåtet att ta bort den här galleribildversionen från replikerade regioner.

accepterade värden: false, true
--data-snapshot-luns

Logiska enhetsnummer (utrymmesavgränsade) för ögonblicksbilder av datadiskar.

--data-snapshots

Namn eller ID:er (utrymmesavgränsade) för ögonblicksbilder av datadiskar.

--data-vhds-luns

Logiska enhetsnummer (utrymmesavgränsade) för käll-VHD-URI:er för datadiskar.

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

Namn eller ID:er (utrymmesavgränsade) för lagringskonton för käll-VHD-URI:er för datadiskar.

--data-vhds-uris

Käll-VHD-URI:er (utrymmesavgränsade) för datadiskar.

--end-of-life-date

Slutdatum, t.ex. "2020-12-31".

--exclude-from-latest

Flaggan innebär att om den är inställd på sant kommer personer som distribuerar virtuella datorer med version utelämnad inte att använda den här versionen.

accepterade värden: false, true
--image-version

Resurs-ID för galleribildversionskälla.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--managed-image

Bildnamn (om det finns i samma resursgrupp) eller resurs-ID.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--os-snapshot

Namn eller ID för ögonblicksbild av OS-disk.

--os-vhd-storage-account

Namn eller ID för lagringskontot för VHD-käll-URI:n för OS-disken.

--os-vhd-uri

VHD-käll-URI för OS-disk.

--replica-count

Standardantalet repliker som ska skapas per region. Om du vill ange regionala replikeringsantal använder du --target-regions.

--replication-mode

Valfri parameter som anger det läge som ska användas för replikering. Den här egenskapen är inte uppdaterad.

accepterade värden: Full, Shallow
--storage-account-type

Standardtypen för lagringskontot som ska användas per region. Om du vill ange regionala lagringskontotyper använder du --target-regions.

accepterade värden: Premium_LRS, Standard_LRS, Standard_ZRS
--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

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

Utrymmesavgränsad lista över kundhanterade nycklar för kryptering av operativsystemet och datadiskar i galleriartefakten för varje region. Format för varje gränszon: ,<os_des>,,<lun1_des>,,<lun2_des>.

--target-edge-zones

Utrymmesavgränsad lista över regioner, gränszoner, antal repliker och lagringstyper. Använd =[=][=] om du vill ange antal repliker och/eller lagringskontotyp för varje region. Om inget replikantal har angetts används standardantalet repliker. Om en lagringskontotyp inte har angetts används standardtypen för lagringskontot. Om "--target-edge-zones None" anges rensas de utökade målplatserna.

--target-region-cvm-encryption

Utrymmesavgränsad lista över kundhanterad nyckel för konfidentiell virtuell dator som krypterar OS-disken i galleriartefakten för varje region. Format för varje region: <os_cvm_encryption_type>,<os_cvm_des>. Giltiga värden för os_cvm_encryption_type är EncryptedVMGuestStateOnlyWithPmk, EncryptedWithPmk, EncryptedWithCmk.

--target-region-encryption

Utrymmesavgränsad lista över kundhanterade nycklar för kryptering av operativsystemet och datadiskar i galleriartefakten för varje region. Format för varje region: <os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>. Använd "null" som platshållare.

--target-regions

Utrymmesavgränsad lista över regioner och deras antal repliker. Använd <region>[=<replica count>][=<storage account type>] för att ange replikantal och/eller lagringskontotyp för varje region. Om inget replikantal har angetts används standardantalet repliker. Om en lagringskontotyp inte har angetts används standardtypen för lagringskontot.

--virtual-machine

Resurs-ID för VM-källa.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sig image-version delete

Ta bort en galleribildversion.

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]

Valfria parametrar

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

Namnet på galleribilddefinitionen där avbildningsversionen finns.

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

Namnet på den galleribildversion som ska tas bort.

--gallery-name -r

Namnet på det delade bildgalleriet där bilddefinitionen finns.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sig image-version list

Lista galleribildversioner i en galleribilddefinition.

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

Obligatoriska parametrar

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

Galleribilddefinition.

--gallery-name -r

Gallerinamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--max-items

Totalt antal objekt som ska returneras i kommandots utdata. Om det totala antalet tillgängliga objekt är mer än det angivna värdet anges en token i kommandots utdata. Om du vill återuppta sidnumreringen anger du tokenvärdet i --next-token argumentet för ett efterföljande kommando.

--next-token

Token för att ange var sidnumrering ska börja. Detta är tokenvärdet från ett tidigare trunkerat svar.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sig image-version list-community

Visa en lista över vm-avbildningsversioner i en gallericommunity.

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

Exempel

Visa en lista över en bildversion i en gallericommunity.

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

Valfria parametrar

--gallery-image-definition -i

Namnet på bilddefinitionen för communitygalleriet som avbildningsversionerna ska visas från.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--marker

Ett strängvärde som identifierar den del av listan med containrar som ska returneras med nästa liståtgärd. Åtgärden returnerar värdet NextMarker i svarstexten om liståtgärden inte returnerade alla containrar som återstår för att visas med den aktuella sidan. Om det anges börjar den här generatorn returnera resultat från den punkt där den tidigare generatorn stoppades.

--public-gallery-name

Det offentliga namnet på communitygalleriet.

--show-next-marker

Visa nextMarker i resultat när det anges.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

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

Experimentell

Det här kommandot är experimentellt och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Visa en lista över vm-avbildningsversioner i en gallericommunity (förhandsversion).

Visa en lista över vm-avbildningsversioner i en gallerigrupp (privat förhandsversionsfunktion, kontakta communityns bildgalleriteam via e-post sigpmdev@microsoft.com för att registrera dig för förhandsversion om du är intresserad av att använda den här funktionen).

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

Exempel

Visa en lista över en bildversion i en gallericommunity.

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

Valfria parametrar

--gallery-image-definition -i

Namnet på bilddefinitionen för communitygalleriet som avbildningsversionerna ska visas från.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--marker

Ett strängvärde som identifierar den del av listan med containrar som ska returneras med nästa liståtgärd. Åtgärden returnerar värdet NextMarker i svarstexten om liståtgärden inte returnerade alla containrar som återstår för att visas med den aktuella sidan. Om det anges börjar den här generatorn returnera resultat från den punkt där den tidigare generatorn stoppades.

--public-gallery-name

Det offentliga namnet på communitygalleriet.

--show-next-marker

Visa nextMarker i resultat när det anges.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sig image-version list-shared

Visa en lista över vm-avbildningsversioner i ett galleri som delas direkt till din prenumeration eller klientorganisation.

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

Exempel

Lista bildversioner i ett galleri som delas direkt till din prenumeration på den angivna platsen och bilddefinitionen.

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

Visa en lista över bildversioner i ett galleri som delas direkt till din klientorganisation på den angivna platsen och bilddefinitionen.

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

Valfria parametrar

--gallery-image-definition -i

Namnet på den bilddefinition för delat galleri som bildversionerna ska visas från.

--gallery-unique-name

Det unika namnet på det delade galleriet.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--marker

Ett strängvärde som identifierar den del av listan med containrar som ska returneras med nästa liståtgärd. Åtgärden returnerar värdet NextMarker i svarstexten om liståtgärden inte returnerade alla containrar som återstår för att visas med den aktuella sidan. Om det anges börjar den här generatorn returnera resultat från den punkt där den tidigare generatorn stoppades.

--shared-to

Frågeparametern för att bestämma vilka delade gallerier som ska hämtas när liståtgärder utförs. Om det inte anges anger du efter prenumerations-ID.

accepterade värden: tenant
--show-next-marker

Visa nextMarker i resultat när det anges.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sig image-version show

Hämtar information om en galleribildversion.

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

Obligatoriska parametrar

--gallery-image-definition -i

Galleribilddefinition.

--gallery-image-version -e

Galleribildversion i semantiskt versionsmönster. De tillåtna tecknen är siffror och punkt. Siffrorna måste ligga inom intervallet för ett 32-bitars heltal, t.ex. <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Gallerinamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--expand

Det expanderingsuttryck som ska tillämpas på åtgärden, t.ex. "ReplicationStatus".

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sig image-version show-community

Hämta en avbildningsversion för communitygalleriet.

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

Valfria parametrar

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

Namnet på bilddefinitionen för communitygalleriet som avbildningsversionerna ska visas från.

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

Galleribildversion i semantiskt versionsmönster. De tillåtna tecknen är siffror och punkt. Siffrorna måste ligga inom intervallet för ett 32-bitars heltal, t.ex. <MajorVersion>.<MinorVersion>.<Patch>.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--public-gallery-name

Det offentliga namnet på communitygalleriet.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

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

Experimentell

Det här kommandot är experimentellt och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hämta en avbildningsversion i en gallericommunity (förhandsversion).

Hämta en bildversion i en gallerigrupp (privat förhandsversionsfunktion, kontakta communityns bildgalleriteam via e-post sigpmdev@microsoft.com för att registrera dig för förhandsversion om du är intresserad av att använda den här funktionen).

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

Exempel

Hämta en avbildningsversion i en gallericommunity på den angivna platsen.

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

Valfria parametrar

--gallery-image-definition -i

Namnet på bilddefinitionen för communitygalleriet som avbildningsversionerna ska visas från.

--gallery-image-version -e

Namnet på den galleribildversion som ska skapas. Måste följa mönster för semantisk version: De tillåtna tecknen är siffror och punkt. Siffrorna måste ligga inom intervallet för ett 32-bitars heltal. Format:...

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--public-gallery-name

Det offentliga namnet på communitygalleriet.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sig image-version show-shared

Hämta en avbildningsversion i ett galleri som delas direkt till din prenumeration eller klientorganisation.

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

Exempel

Hämta en avbildningsversion i ett galleri som delas direkt till din prenumeration eller klientorganisation på den angivna platsen.

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

Valfria parametrar

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

Namnet på den bilddefinition för delat galleri som bildversionerna ska visas från.

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

Namnet på den galleribildversion som ska skapas. Måste följa mönster för semantisk version: De tillåtna tecknen är siffror och punkt. Siffrorna måste ligga inom intervallet för ett 32-bitars heltal. Format:...

--gallery-unique-name

Det unika namnet på det delade galleriet.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sig image-version undelete

Förhandsgranskning

Det här kommandot är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Återställ mjuk borttagen avbildningsversion.

Åtgärden lyckas endast om den används i ett galleri med mjuk borttagning på.

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]

Exempel

Återställa en mjuk borttagen avbildningsversion

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

Obligatoriska parametrar

--gallery-image-definition -i

Galleribilddefinition.

--gallery-image-version -e

Galleribildversion i semantiskt versionsmönster. De tillåtna tecknen är siffror och punkt. Siffrorna måste ligga inom intervallet för ett 32-bitars heltal, t.ex. <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Gallerinamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--allow-replicated-location-deletion

Ange om det är tillåtet att ta bort den här galleribildversionen från replikerade regioner.

accepterade värden: false, true
--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sig image-version update

Uppdatera en resursbildversion.

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]

Exempel

Ändra replikeringsregionerna och antalet repliker

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

Ändra de utökade platserna för replikering

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

Rensa de utökade platserna för replikering

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

Replikera till ytterligare en region. Valfritt kan du ange antalet repliker för regionen och exkludera den här avbildningen när du använder den senaste versionen av bilddefinitionen.

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

Ändra om en bild ska tas med i övervägandet för den senaste versionen i bilddefinitionen. Om du ställer in det här värdet på true undantas bilden från att övervägas och om värdet anges till false inkluderas bilden för övervägande.

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

Ändra slutdatumet för en avbildningsversion. Avbildningen kan fortfarande användas för att skapa virtuella datorer efter slutdatumet.

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

Tillåt att du tar bort galleribildversionen från replikerade regioner.

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

Obligatoriska parametrar

--gallery-image-definition -i

Galleribilddefinition.

--gallery-image-version -e

Galleribildversion i semantiskt versionsmönster. De tillåtna tecknen är siffror och punkt. Siffrorna måste ligga inom intervallet för ett 32-bitars heltal, t.ex. <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Gallerinamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

standardvärde: []
--allow-replicated-location-deletion

Ange om det är tillåtet att ta bort den här galleribildversionen från replikerade regioner.

accepterade värden: false, true
--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

standardvärde: False
--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

standardvärde: []
--replica-count

Standardantalet repliker som ska skapas per region. Om du vill ange regionala replikeringsantal använder du --target-regions.

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

standardvärde: []
--target-edge-zones

Utrymmesavgränsad lista över regioner, gränszoner, antal repliker och lagringstyper. Använd =[=][=] om du vill ange antal repliker och/eller lagringskontotyp för varje region. Om inget replikantal har angetts används standardantalet repliker. Om en lagringskontotyp inte har angetts används standardtypen för lagringskontot. Om "--target-edge-zones None" anges rensas de utökade målplatserna.

--target-regions

Utrymmesavgränsad lista över regioner och deras antal repliker. Använd <region>[=<replica count>][=<storage account type>] för att ange replikantal och/eller lagringskontotyp för varje region. Om inget replikantal har angetts används standardantalet repliker. Om en lagringskontotyp inte har angetts används standardtypen för lagringskontot.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az sig image-version wait

Vänta tills avbildningsversionen är relaterad till åtgärden.

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

Exempel

vänta tills en avbildningsversion uppdateras

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

vänta på avbildningsversionsrelaterad åtgärd. (automatiskt genererad)

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

Obligatoriska parametrar

--gallery-image-definition -i

Galleribilddefinition.

--gallery-image-version -e

Galleribildversion i semantiskt versionsmönster. De tillåtna tecknen är siffror och punkt. Siffrorna måste ligga inom intervallet för ett 32-bitars heltal, t.ex. <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Gallerinamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

standardvärde: False
--exists

Vänta tills resursen finns.

standardvärde: False
--expand

Det expanderingsuttryck som ska tillämpas på åtgärden. Standardvärdet "ReplicationStatus" är Ingen.

--interval

Avsökningsintervall i sekunder.

standardvärde: 30
--timeout

Maximal väntetid i sekunder.

standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.