az image builder

Gestire e compilare modelli di generatore di immagini.

Comandi

Nome	Descrizione	Tipo	Status
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 builder cancel

Annullare la compilazione dell'immagine a esecuzione prolungata in base al modello di immagine.

az image builder cancel [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Esempio

Annullare una compilazione di immagini.

az image builder cancel -n mytemplate -g my-group

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

--name -n

Nome del modello di 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 builder create

Creare un modello di generatore di immagini.

az image builder create --name
                        --resource-group
                        [--build-timeout]
                        [--build-vm-identities]
                        [--checksum]
                        [--defer]
                        [--identity]
                        [--image-source]
                        [--image-template]
                        [--location]
                        [--managed-image-destinations]
                        [--no-wait]
                        [--os-disk-size]
                        [--proxy-vm-size]
                        [--scripts]
                        [--shared-image-destinations]
                        [--staging-resource-group]
                        [--subnet]
                        [--tags]
                        [--validator]
                        [--vm-size]
                        [--vnet]

Esempio

Creare un modello di generatore di immagini da un'immagine Ubuntu2204. Distribuirlo come immagine gestita e come versione dell'immagine della raccolta di immagini condivise. Specificare l'ID del gruppo di risorse di staging come modello di immagine che verrà usato per compilare l'immagine.

scripts="https://my-script-url.net/customize_script.sh"
imagesource="Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest"

az image builder create --image-source $imagesource -n myTemplate -g myGroup \
    --scripts $scripts --managed-image-destinations image_1=westus \
    --shared-image-destinations my_shared_gallery/linux_image_def=westus,brazilsouth \
    --identity myIdentity --staging-resource-group myStagingResourceGroup

Creare un modello di generatore di immagini usando un file modello di immagine.

az image builder create -g my-group -n myTemplate --image-template filename

[Avanzate] Creare un modello di immagine con più personalizzatori e server di distribuzione usando la cache degli oggetti dell'interfaccia della riga di comando tramite --defer. Supporta funzionalità come: personalizzatori e nomi di output, codici di uscita di PowerShell, script inline, riavvio di Windows, personalizzatori di file, tag di artefatti e server di distribuzione di output vhd.

script="https://my-script-url.com/customize_script.ps1"
imagesource="MicrosoftWindowsServer:WindowsServer:2019-Datacenter:2019.0.20190214"

# create and update template object in local cli cache. Defers put request to ARM
# Cache object ttl set via az configure.
az image builder create --image-source $imagesource -n myTemplate \
    -g myGroup --scripts $script --identity myIdentity --defer

# add customizers
az image builder customizer add -n myTemplate -g myGroup  \
    --customizer-name myPwshScript --exit-codes 0 1 --inline-script \
    "mkdir c:\buildActions" "echo Azure-Image-Builder-Was-Here \
     > c:\buildActions\Output.txt" --type powershell --defer

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFileCustomizer --type file \
    --file-source "https://my-file-source.net/file.txt"  \
    --dest-path "c:\buildArtifacts\file.txt" --defer

# add distributors
az image builder output add -n myTemplate -g myGroup --is-vhd \
    --output-name myWinImageVhd --artifact-tags "is_vhd=True" --defer

az image builder output add -n myTemplate -g myGroup \
    --output-name myWinImageManaged --managed-image winImage \
    --managed-image-location eastus \
    --artifact-tags "is_vhd=False" --defer

# Stop deferring put request to ARM. Create the template from the object cache.
# Cache object will be deleted.
az image builder update -n myTemplate -g myGroup

Parametri necessari

--name -n

Nome del modello di immagine.

--resource-group -g

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

Parametri facoltativi

--build-timeout

Durata massima di attesa durante la compilazione del modello di immagine, in minuti. Il valore predefinito è 60.

--build-vm-identities

Configurazione facoltativa della rete virtuale da usare per distribuire la macchina virtuale di compilazione in. Omettere se non è necessario usare una rete virtuale specifica.

--checksum

Checksum SHA256 dell'immagine ISO di Red Hat.

--defer

Archiviare temporaneamente l'oggetto nella cache locale anziché inviarlo ad Azure. Usare az cache i comandi per visualizzare/cancellare.

--identity

Elenco delle identità assegnate dall'utente (nome o ID, spazio delimitato) del modello di immagine.

--image-source -i

Immagine di base da personalizzare. Deve essere un URN dell'immagine della piattaforma valido, un alias dell'immagine della piattaforma, un URI immagine ISO Red Hat, un nome/ID immagine gestita o un ID versione dell'immagine condivisa.

Valore da: az vm image list, az vm image show

--image-template

Percorso locale o URL di un file modello di immagine. Quando si usa --image-template, tutti gli altri parametri vengono ignorati tranne -g e -n. Riferimento: https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

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

--managed-image-destinations

Informazioni sul server di distribuzione dell'output dell'immagine gestita. Elenco delimitato da spazi di coppie chiave-valore. Ad esempio "image_1=westus2 image_2=westus". Ogni chiave è il nome o l'ID risorsa dell'immagine gestita da creare. Ogni valore è la posizione dell'immagine.

--no-wait

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

Valore predefinito: False

--os-disk-size

Dimensioni del disco del sistema operativo in GB. Omettere o specificare 0 per usare le dimensioni predefinite del disco del sistema operativo di Azure.

--proxy-vm-size

Dimensioni della macchina virtuale usata per compilare, personalizzare e acquisire immagini (Standard_D1_v2 per immagini Gen1 e Standard_D2ds_v4 per immagini Gen2).

--scripts

Elenco separato da spazi di script della shell o di PowerShell con cui personalizzare l'immagine. Ogni script deve essere un URL accessibile pubblicamente. Deduce il tipo di script dall'estensione di file ('.sh' o '.ps1') o dal tipo di origine. Altre opzioni di personalizzazione e flessibilità, vedere: 'az image template customizer add'.

--shared-image-destinations

Informazioni sul server di distribuzione di output della raccolta immagini condivise (sig). Elenco delimitato da spazi di coppie chiave-valore. Ad esempio "my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth". Ogni chiave è l'ID definizione immagine sig o il nome della raccolta sig e la definizione dell'immagine sig delimitata da un "/". Ogni valore è un elenco delimitato da virgole di posizioni di replica.

--staging-resource-group

ID del gruppo di risorse di staging nella stessa sottoscrizione del modello di immagine che verrà usato per compilare l'immagine.

--subnet

Nome o ID della subnet per distribuire la macchina virtuale di compilazione.

--tags

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

--validator

Tipo di convalida da usare nell'immagine. Ad esempio, "Shell" può essere convalida della shell.

--vm-size

Dimensioni della macchina virtuale usata per compilare, personalizzare e acquisire immagini. Omettere o specificare una stringa vuota per usare il valore predefinito (Standard_D1_v2).

--vnet

Nome della rete virtuale per distribuire la macchina virtuale di compilazione. È consigliabile specificarlo solo quando la subnet è un nome.

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 builder delete

Eliminare il modello del generatore di immagini.

az image builder delete [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Esempio

Eliminare il modello del generatore di immagini. (generato automaticamente)

az image builder delete --name MyImageTemplate --resource-group MyResourceGroup

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

--name -n

Nome del modello di 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 builder list

Elencare i modelli di Generatore di immagini.

az image builder list [--resource-group]

Parametri facoltativi

--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 builder run

Creare un modello di generatore di immagini.

az image builder run [--ids]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--subscription]

Esempio

Avviare un'esecuzione della compilazione del modello e attendere il completamento.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

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

--name -n

Nome del modello di immagine.

--no-wait

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

Valore predefinito: False

--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 builder show

Visualizzare un modello di generatore di immagini.

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

Esempio

Visualizzare un modello di generatore di immagini (generato automaticamente)

az image builder show --name mytemplate  --resource-group my-group

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

--name -n

Nome del modello di 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 builder show-runs

Visualizzare gli output di esecuzione di un modello di generatore di immagini.

az image builder show-runs [--ids]
                           [--name]
                           [--output-name]
                           [--resource-group]
                           [--subscription]

Esempio

Eseguire un'esecuzione di compilazione del modello e quindi visualizzarne gli output di esecuzione.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show-runs -n mytemplate -g my-group

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

--name -n

Nome del modello di immagine.

--output-name

Nome dell'output dell'esecuzione del generatore di immagini.

--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 builder update

Aggiornare un modello di generatore di immagini.

L'aggiornamento di modelli di generatore di immagini non è attualmente supportato. Questo comando può essere usato insieme a --defer per aggiornare un oggetto modello di immagine all'interno della cache dell'interfaccia della riga di comando. Senza --rinvia recupera il modello di immagine specificato dalla cache e invia una richiesta ad Azure per creare il modello di immagine.

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

Esempio

Creare una risorsa modello da un oggetto modello nella cache dell'interfaccia della riga di comando. Per altre informazioni, vedere "az image builder create/output add/customizer add --help" e "az cache -h"

# create and write template object to local cli cache
az image builder create --image-source {image_source} -n mytemplate -g my-group \
    --scripts {script} --managed-image-destinations image_1=westus --identity myidentity --defer

# add customizers and outputs to local cache template object via az image template output / customizer add
# one can also update cache object properties through generic update options, such as: --set
az image builder output add -n mytemplate -g my-group --output-name my-win-image-managed \
    --artifact-tags "is_vhd=False"  --managed-image winImage --managed-image-location eastus --defer

# send template create request to azure to create template resource
az image builder update -n mytemplate -g my-group

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

--defer

Archiviare temporaneamente l'oggetto nella cache locale anziché inviarlo ad Azure. Usare az cache i comandi per visualizzare/cancellare.

--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 del modello di immagine.

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

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 builder wait

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

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

Esempio

Avviare un'esecuzione della compilazione del modello e attendere il completamento.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

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

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

--interval

Intervallo di polling in secondi.

Valore predefinito: 30

--name -n

Nome del modello di 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.

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