az image

Not

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 anpassade avbildningar av virtuella datorer.

Kommandon

Name	Description	Typ	Status
az image builder	Hantera och skapa mallar för avbildningsverktyget.	Kärna	GA
az image builder cancel	Avbryt den långvariga avbildningsversionen baserat på avbildningsmallen.	Kärna	GA
az image builder create	Skapa en mall för avbildningsverktyget.	Kärna	GA
az image builder customizer	Hantera mallanpassare för avbildningsverktyget.	Kärna	GA
az image builder customizer add	Lägg till en anpassning av avbildningsverktyget i en mall för avbildningsverktyget.	Kärna	GA
az image builder customizer clear	Ta bort alla anpassningar av avbildningsverktyget från en mall för bildverktyget.	Kärna	GA
az image builder customizer remove	Ta bort en anpassning av bildverktyget från en mall för bildverktyget.	Kärna	GA
az image builder delete	Ta bort mallen image builder.	Kärna	GA
az image builder error-handler	Hantera felhanteraren för avbildningsverktygets mall.	Kärna	GA
az image builder error-handler add	Lägg till felhanterare i en befintlig mall för avbildningsverktyget.	Kärna	GA
az image builder error-handler remove	Ta bort felhanteraren från en befintlig mall för avbildningsverktyget.	Kärna	GA
az image builder error-handler show	Visa felhanteraren för en befintlig mall för avbildningsverktyget.	Kärna	GA
az image builder identity	Hantera identiteter för en mall för bildverktyget.	Kärna	GA
az image builder identity assign	Lägg till hanterade identiteter i en befintlig mall för avbildningsverktyget. För närvarande stöds endast en användaridentitet.	Kärna	GA
az image builder identity remove	Ta bort hanterade identiteter från en befintlig mall för avbildningsverktyget.	Kärna	GA
az image builder identity show	Visa hanterade identiteter för en mall för bildverktyget.	Kärna	GA
az image builder list	Lista mallar för avbildningsverktyget.	Kärna	GA
az image builder optimizer	Hantera malloptimeraren för image builder.	Kärna	GA
az image builder optimizer add	Lägg till optimizer i en befintlig mall för avbildningsverktyget.	Kärna	GA
az image builder optimizer remove	Ta bort optimeraren från en befintlig mall för avbildningsverktyget.	Kärna	GA
az image builder optimizer show	Visa optimeraren för en befintlig mall för avbildningsverktyget.	Kärna	GA
az image builder optimizer update	Uppdatera en optimerare från en befintlig mall för avbildningsverktyget.	Kärna	GA
az image builder output	Hantera utdatadistributörer för image builder-mallar.	Kärna	GA
az image builder output add	Lägg till en utdatadistributör för avbildningsverktyget i en mall för bildverktyget.	Kärna	GA
az image builder output clear	Ta bort alla avbildningsverktygets utdatadistributörer från en mall för bildverktyget.	Kärna	GA
az image builder output remove	Ta bort en utdatadistributör för avbildningsverktyget från en mall för avbildningsverktyget.	Kärna	GA
az image builder output versioning	Hantera utdataversioner för image builder-mallar.	Kärna	GA
az image builder output versioning remove	Ta bort alla versionsalternativ för angivna utdata.	Kärna	GA
az image builder output versioning set	Ange avbildningsverktygets utdataversioner för en mall för bildverktyget.	Kärna	GA
az image builder output versioning show	Visa versionsalternativ för angivna utdata.	Kärna	GA
az image builder run	Skapa en mall för avbildningsverktyget.	Kärna	GA
az image builder show	Visa en mall för bildverktyget.	Kärna	GA
az image builder show-runs	Visa körningsutdata för en avbildningsverktygets mall.	Kärna	GA
az image builder trigger	Hantera utlösaren för avbildningsverktygets mall.	Kärna	GA
az image builder trigger create	Skapa en utlösare för den angivna mallen för avbildning av virtuella datorer.	Kärna	GA
az image builder trigger delete	Ta bort en utlösare för den angivna mallen för avbildning av virtuella datorer.	Kärna	GA
az image builder trigger list	Visa en lista över alla utlösare för den angivna resursen för bildmallen.	Kärna	GA
az image builder trigger show	Hämta den angivna utlösaren för den angivna resursen för avbildningsmallen.	Kärna	GA
az image builder trigger wait	Placera CLI i vänteläge tills ett villkor uppfylls.	Kärna	GA
az image builder update	Uppdatera en mall för avbildningsverktyget.	Kärna	GA
az image builder validator	Verifiera mallen hantera avbildningsverktyget.	Kärna	GA
az image builder validator add	Lägg till verifiering i en befintlig mall för avbildningsverktyget.	Kärna	GA
az image builder validator remove	Ta bort verifiering från en befintlig mall för avbildningsverktyget.	Kärna	GA
az image builder validator show	Visa verifiering av en befintlig mall för avbildningsverktyget.	Kärna	GA
az image builder wait	Placera CLI i vänteläge tills ett villkor för mallen uppfylls.	Kärna	GA
az image copy	Kopiera en hanterad avbildning (eller virtuell dator) till andra regioner. Det kräver att källdisken är tillgänglig.	Förlängning	GA
az image create	Skapa en anpassad virtuell datorbild från hanterade diskar eller ögonblicksbilder.	Kärna	GA
az image delete	Ta bort en bild.	Kärna	GA
az image list	Visa en lista över bilder under en resursgrupp.	Kärna	GA
az image show	Hämta en bild.	Kärna	GA
az image update	Uppdatera anpassade VM-avbildningar.	Kärna	GA
az image wait	Placera CLI i vänteläge tills ett villkor uppfylls.	Kärna	GA

az image copy

Kopiera en hanterad avbildning (eller virtuell dator) till andra regioner. Det kräver att källdisken är tillgänglig.

az image copy --source-object-name
              --source-resource-group
              --target-location
              --target-resource-group
              [--cleanup]
              [--export-as-snapshot]
              [--parallel-degree]
              [--source-type {image, vm}]
              [--tags]
              [--target-name]
              [--target-subscription]
              [--temporary-resource-group-name]
              [--timeout]

Exempel

Kopiera en bild till flera regioner och rensa i slutet.

az image copy --source-resource-group mySources-rg --source-object-name myImage \
    --target-location uksouth northeurope --target-resource-group "images-repo-rg" --cleanup

Använd en redan generaliserad virtuell dator för att skapa avbildningar i andra regioner.

az image copy --source-resource-group mySources-rg --source-object-name myVm \
    --source-type vm --target-location uksouth northeurope --target-resource-group "images-repo-rg"

Obligatoriska parametrar

--source-object-name

Namnet på avbildningen eller vm-resursen.

--source-resource-group

Namnet på källresursens resursgrupp.

--target-location

Utrymmesavgränsad platslista för att skapa avbildningen i (t.ex. westeurope osv.).

--target-resource-group

Namnet på resursgruppen som ska skapas avbildningar i.

Valfria parametrar

--cleanup

Inkludera den här växeln om du vill ta bort tillfälliga resurser när du är klar.

Standardvärde: False

--export-as-snapshot

Inkludera den här växeln för att exportera kopiorna som ögonblicksbilder i stället för bilder.

Standardvärde: False

--parallel-degree

Antal parallella kopieringsåtgärder.

Standardvärde: -1

--source-type

Avbildning eller virtuell dator.

Godkända värden: image, vm

Standardvärde: image

--tags

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

--target-name

Namnet på den slutliga avbildningen som ska skapas.

--target-subscription

Namn eller ID för prenumerationen där den slutliga avbildningen ska skapas.

--temporary-resource-group-name

Resursgruppsnamn där ett tillfälligt lagringskonto skapas.

Standardvärde: image-copy-rg

--timeout

Tid i sekunder för kopieringsåtgärden att slutföras. Öka den här gången om du ska kopiera stora avbildningar (diskar) som 512 GB eller mer.

Standardvärde: 3600

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.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc

Standardvärde: json

--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az image create

Skapa en anpassad virtuell datorbild från hanterade diskar eller ögonblicksbilder.

az image create --name
                --resource-group
                --source
                [--data-disk-caching {None, ReadOnly, ReadWrite}]
                [--data-disk-sources]
                [--edge-zone]
                [--hyper-v-generation {V1, V2}]
                [--location]
                [--os-disk-caching {None, ReadOnly, ReadWrite}]
                [--os-type {Linux, Windows}]
                [--storage-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
                [--tags]
                [--zone-resilient {false, true}]

Exempel

Skapa en avbildning från en befintlig disk.

az image create -g MyResourceGroup -n image1 --os-type Linux \
    --source /subscriptions/db5eb68e-73e2-4fa8-b18a-0123456789999/resourceGroups/rg1/providers/Microsoft.Compute/snapshots/s1

Skapa en avbildning genom att samla in en befintlig generaliserad virtuell dator i samma resursgrupp.

az image create -g MyResourceGroup -n image1 --source MyVm1

Obligatoriska parametrar

--name -n

Nytt avbildningsnamn.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--source

OS-diskkälla från samma region, inklusive ett virtuellt dator-ID eller namn, OS-diskblob-URI, hanterat OS-disk-ID eller namn eller os-ögonblicksbild-ID eller namn.

Valfria parametrar

--data-disk-caching

Cachelagringstyp för avbildningens datadisk.

Godkända värden: None, ReadOnly, ReadWrite

--data-disk-sources

Utrymmesavgränsad lista över datadiskkällor, inklusive ohanterad blob-URI, hanterat disk-ID eller namn eller ögonblicksbilds-ID eller namn.

--edge-zone

Namnet på gränszonen.

--hyper-v-generation

Hypervisor-genereringen av den virtuella datorn som skapats från avbildningen.

Godkända värden: V1, V2

Standardvärde: V1

--location -l

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

--os-disk-caching

Cachelagringstyp för avbildningens OS-disk.

Godkända värden: None, ReadOnly, ReadWrite

--os-type

Godkända värden: Linux, Windows

--storage-sku

SKU:n för lagringskontot som vm-avbildningen ska skapas med. Används inte om den virtuella källdatorn har angetts.

Godkända värden: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

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

--zone-resilient

Anger om en avbildning är zontålig eller inte. Standardvärdet är falskt. Zontåliga avbildningar kan bara skapas i regioner som tillhandahåller zonredundant lagring.

Godkända värden: false, true

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.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc

Standardvärde: json

--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az image delete

Ta bort en bild.

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

Valfria parametrar

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

--image-name --name -n

Namnet på avbildningen.

--no-wait

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

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av 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.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc

Standardvärde: json

--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az image list

Visa en lista över bilder under en resursgrupp.

az image list [--max-items]
              [--next-token]
              [--resource-group]

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

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

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.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc

Standardvärde: json

--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az image show

Hämta en bild.

az image show [--expand]
              [--ids]
              [--image-name]
              [--resource-group]
              [--subscription]

Valfria parametrar

--expand

Det expanderingsuttryck som ska tillämpas på åtgärden.

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

--image-name --name -n

Namnet på avbildningen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av 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.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc

Standardvärde: json

--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az image update

Uppdatera anpassade VM-avbildningar.

az image update [--add]
                [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                [--ids]
                [--image-name]
                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                [--remove]
                [--resource-group]
                [--set]
                [--subscription]
                [--tags]

Exempel

Lägg till eller uppdatera taggar.

az image update -n ImageName -g ResourceGroup --tags tag1=val1 tag2=val2

Ta bort alla taggar.

az image update -n ImageName -g resourceGroup --tags

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

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

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes

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

--image-name --name -n

Namnet på avbildningen.

--no-wait

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

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes

--remove

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

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--set

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--tags

Resurstaggar Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

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.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc

Standardvärde: json

--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az image wait

Placera CLI i vänteläge tills ett villkor uppfylls.

az image wait [--created]
              [--custom]
              [--deleted]
              [--exists]
              [--expand]
              [--ids]
              [--image-name]
              [--interval]
              [--resource-group]
              [--subscription]
              [--timeout]
              [--updated]

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.

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

--image-name --name -n

Namnet på avbildningen.

--interval

Avsökningsintervall i sekunder.

Standardvärde: 30

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

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

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc

Standardvärde: json

--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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