az image

Nota

Questo gruppo di comandi include comandi definiti sia nell'interfaccia della riga di comando di Azure che in almeno un'estensione. Installare ogni estensione per trarre vantaggio dalle funzionalità estese. Altre informazioni sulle estensioni.

Gestire immagini di macchine virtuali personalizzate.

Comandi

Nome	Descrizione	Tipo	Status
az image builder	Gestire e compilare modelli di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder cancel	Annullare la compilazione dell'immagine a esecuzione prolungata in base al modello di immagine.	Memoria centrale	Disponibilità generale
az image builder create	Creare un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder customizer	Gestire i personalizzatori di modelli di Image Builder.	Memoria centrale	Disponibilità generale
az image builder customizer add	Aggiungere un personalizzatore di generatore di immagini a un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder customizer clear	Rimuovere tutti i personalizzatori di generatore di immagini da un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder customizer remove	Rimuovere un personalizzatore di generatore di immagini da un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder delete	Eliminare il modello del generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder error-handler	Gestire il gestore degli errori del modello del generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder error-handler add	Aggiungere il gestore degli errori a un modello di generatore di immagini esistente.	Memoria centrale	Disponibilità generale
az image builder error-handler remove	Rimuovere il gestore degli errori da un modello di generatore di immagini esistente.	Memoria centrale	Disponibilità generale
az image builder error-handler show	Mostra il gestore degli errori di un modello di generatore di immagini esistente.	Memoria centrale	Disponibilità generale
az image builder identity	Gestire le identità di un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder identity assign	Aggiungere identità gestite a un modello di generatore di immagini esistente. Attualmente è supportata una sola identità utente.	Memoria centrale	Disponibilità generale
az image builder identity remove	Rimuovere le identità gestite da un modello di generatore di immagini esistente.	Memoria centrale	Disponibilità generale
az image builder identity show	Visualizzare le identità gestite di un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder list	Elencare i modelli di Generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder optimizer	Gestire l'utilità di ottimizzazione dei modelli del generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder optimizer add	Aggiungere Optimizer a un modello di generatore di immagini esistente.	Memoria centrale	Disponibilità generale
az image builder optimizer remove	Rimuovere Optimizer da un modello di generatore di immagini esistente.	Memoria centrale	Disponibilità generale
az image builder optimizer show	Mostra optimizer di un modello di generatore di immagini esistente.	Memoria centrale	Disponibilità generale
az image builder optimizer update	Aggiornare un ottimizzatore da un modello di generatore di immagini esistente.	Memoria centrale	Disponibilità generale
az image builder output	Gestire i server di distribuzione di output dei modelli di Image Builder.	Memoria centrale	Disponibilità generale
az image builder output add	Aggiungere un server di distribuzione di output del generatore di immagini a un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder output clear	Rimuovere tutti i server di output del generatore di immagini da un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder output remove	Rimuovere un server di distribuzione di output del generatore di immagini da un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder output versioning	Gestire la versioner di output del modello del generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder output versioning remove	Rimuovere tutte le opzioni di controllo delle versioni per gli output specificati.	Memoria centrale	Disponibilità generale
az image builder output versioning set	Impostare la versioner di output del generatore di immagini di un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder output versioning show	Mostra le opzioni di controllo delle versioni sugli output specificati.	Memoria centrale	Disponibilità generale
az image builder run	Creare un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder show	Visualizzare un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder show-runs	Visualizzare gli output di esecuzione di un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder trigger	Gestire il trigger del modello del generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder trigger create	Creare un trigger per il modello di immagine di macchina virtuale specificato.	Memoria centrale	Disponibilità generale
az image builder trigger delete	Eliminare un trigger per il modello di immagine della macchina virtuale specificato.	Memoria centrale	Disponibilità generale
az image builder trigger list	Elencare tutti i trigger per la risorsa modello di immagine specificata.	Memoria centrale	Disponibilità generale
az image builder trigger show	Ottenere il trigger specificato per la risorsa modello di immagine specificata.	Memoria centrale	Disponibilità generale
az image builder trigger wait	Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.	Memoria centrale	Disponibilità generale
az image builder update	Aggiornare un modello di generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder validator	Gestire la convalida del modello del generatore di immagini.	Memoria centrale	Disponibilità generale
az image builder validator add	Aggiungere la convalida a un modello di generatore di immagini esistente.	Memoria centrale	Disponibilità generale
az image builder validator remove	Rimuovere la convalida da un modello di generatore di immagini esistente.	Memoria centrale	Disponibilità generale
az image builder validator show	Visualizzare la convalida di un modello di generatore di immagini esistente.	Memoria centrale	Disponibilità generale
az image builder wait	Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione del modello.	Memoria centrale	Disponibilità generale
az image copy	Copiare un'immagine gestita (o una macchina virtuale) in altre aree. Richiede che il disco di origine sia disponibile.	Estensione	Disponibilità generale
az image create	Creare un'immagine di macchina virtuale personalizzata da dischi gestiti o snapshot.	Memoria centrale	Disponibilità generale
az image delete	Eliminare un'immagine.	Memoria centrale	Disponibilità generale
az image list	Elencare l'elenco di immagini in un gruppo di risorse.	Memoria centrale	Disponibilità generale
az image show	Ottenere un'immagine.	Memoria centrale	Disponibilità generale
az image update	Aggiornare immagini di vm personalizzate.	Memoria centrale	Disponibilità generale
az image wait	Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.	Memoria centrale	Disponibilità generale

az image copy

Copiare un'immagine gestita (o una macchina virtuale) in altre aree. Richiede che il disco di origine sia disponibile.

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]

Esempio

Copiare un'immagine in diverse aree e pulire alla fine.

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

Usare una macchina virtuale già generalizzata per creare immagini in altre aree.

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"

Parametri necessari

--source-object-name

Nome dell'immagine o della risorsa vm.

--source-resource-group

Nome del gruppo di risorse della risorsa di origine.

--target-location

Elenco di posizioni separate da spazi per creare l'immagine in (ad esempio westeurope e così via).

--target-resource-group

Nome del gruppo di risorse in cui creare immagini.

Parametri facoltativi

--cleanup

Includere questa opzione per eliminare le risorse temporanee al completamento.

Valore predefinito: False

--export-as-snapshot

Includere questa opzione per esportare le copie come snapshot anziché come immagini.

Valore predefinito: False

--parallel-degree

Numero di operazioni di copia parallela.

Valore predefinito: -1

--source-type

Immagine o macchina virtuale.

Valori accettati: image, vm

Valore predefinito: image

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--target-name

Nome dell'immagine finale che verrà creata.

--target-subscription

Nome o ID della sottoscrizione in cui deve essere creata l'immagine finale.

--temporary-resource-group-name

Nome del gruppo di risorse in cui verrà creato l'account di archiviazione temporaneo.

Valore predefinito: image-copy-rg

--timeout

Tempo in secondi per il completamento dell'operazione di copia. Aumentare questo tempo se si intende copiare immagini di grandi dimensioni (dischi) come 512 GB o più.

Valore predefinito: 3600

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az image create

Creare un'immagine di macchina virtuale personalizzata da dischi gestiti o snapshot.

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

Esempio

Creare un'immagine da un disco esistente.

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

Creare un'immagine acquisendo una macchina virtuale generalizzata esistente nello stesso gruppo di risorse.

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

Parametri necessari

--name -n

Nuovo nome immagine.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--source

Origine del disco del sistema operativo dalla stessa area, inclusi un ID macchina virtuale o un nome, un URI BLOB del disco del sistema operativo, un ID o un nome del disco del sistema operativo gestito o un NOME o un ID snapshot del sistema operativo.

Parametri facoltativi

--data-disk-caching

Archiviazione tipo di memorizzazione nella cache per il disco dati dell'immagine.

Valori accettati: None, ReadOnly, ReadWrite

--data-disk-sources

Elenco separato da spazi di origini disco dati, inclusi l'URI BLOB non gestito, l'ID o il nome del disco gestito o l'ID o il nome dello snapshot.

--edge-zone

Nome della zona perimetrale.

--hyper-v-generation

Generazione dell'hypervisor della macchina virtuale creata dall'immagine.

Valori accettati: V1, V2

Valore predefinito: V1

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--os-disk-caching

Archiviazione tipo di memorizzazione nella cache per il disco del sistema operativo dell'immagine.

Valori accettati: None, ReadOnly, ReadWrite

--os-type

Valori accettati: Linux, Windows

--storage-sku

SKU dell'account di archiviazione con cui creare l'immagine della macchina virtuale. Non usato se viene specificata la macchina virtuale di origine.

Valori accettati: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--zone-resilient

Specifica se un'immagine è resiliente alla zona o meno. Il valore predefinito è false. Le immagini resilienti della zona possono essere create solo in aree che forniscono Archiviazione con ridondanza della zona.

Valori accettati: false, true

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az image delete

Eliminare un'immagine.

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--image-name --name -n

Nome dell'immagine.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az image list

Elencare l'elenco di immagini in un gruppo di risorse.

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

Parametri facoltativi

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token nell'argomento --next-token di un comando successivo.

--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az image show

Ottenere un'immagine.

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

Parametri facoltativi

--expand

Espressione di espansione da applicare all'operazione.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--image-name --name -n

Nome dell'immagine.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az image update

Aggiornare immagini di vm personalizzate.

az image update [--add]
                [--force-string]
                [--ids]
                [--name]
                [--remove]
                [--resource-group]
                [--set]
                [--subscription]
                [--tags]

Esempio

Aggiungere o aggiornare i tag.

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

Rimuovere tutti i tag.

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

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

Valore predefinito: []

--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

Valore predefinito: False

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

Nome dell'immagine. Obbligatorio.

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Valore predefinito: []

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

Valore predefinito: []

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az image wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

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

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False

--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

Valore predefinito: False

--exists

Attendere che la risorsa esista.

Valore predefinito: False

--expand

Espressione di espansione da applicare all'operazione.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--image-name --name -n

Nome dell'immagine.

--interval

Intervallo di polling in secondi.

Valore predefinito: 30

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--timeout

Attesa massima in secondi.

Valore predefinito: 3600

--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.