Condividi tramite

az image builder customizer

  • Riferimento

Gestire i personalizzatori di modelli di Image Builder.

Comandi

Nome Descrizione Tipo Status
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 customizer add

Aggiungere un personalizzatore di generatore di immagini a un modello di generatore di immagini.

Deve essere usato con --defer.

az image builder customizer add --customizer-name
                                --type {file, powershell, shell, windows-restart, windows-update}
                                [--defer]
                                [--dest-path]
                                [--exit-codes]
                                [--file-source]
                                [--filters]
                                [--ids]
                                [--inline-script]
                                [--name]
                                [--resource-group]
                                [--restart-check-command]
                                [--restart-command]
                                [--restart-timeout]
                                [--script-url]
                                [--search-criteria]
                                [--subscription]
                                [--update-limit]

Esempio

Aggiungere un personalizzatore della shell inline a un modello di immagine nella cache degli oggetti dell'interfaccia della riga di comando

az image builder customizer add -n myTemplate -g myGroup \
    --inline-script "sudo mkdir /buildArtifacts" \
                    "sudo cp /tmp/index.html /buildArtifacts/index.html" \
    --customizer-name shellScriptInline --type shell --defer

Aggiungere un personalizzatore di file a un modello di immagine nella cache degli oggetti dell'interfaccia della riga di comando

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFile --type file \
    --file-source "https://my-remote-file.html" --dest-path "/tmp/index.html" --defer

Aggiungere un personalizzatore di riavvio di Windows a un modello di immagine nella cache degli oggetti dell'interfaccia della riga di comando

az image builder customizer add -n myTemplate -g myGroup \
--customizer-name shellScriptUrl \
--restart-check-command "echo Azure-Image-Builder-Restarted-the-VM  > \
                        c:\buildArtifacts\restart.txt" \
    --type windows-restart --restart-timeout 10m --defer

Aggiungere un personalizzatore di aggiornamento di Windows a un modello di immagine nella cache degli oggetti dell'interfaccia della riga di comando.

az image builder customizer add -n myTemplate -g myGroup --customizer-name winUpdate --type windows-update --search-criteria IsInstalled=0 --filters "exclude:\$_.Title -like \'*Preview*\'" "include:\$true" --update-limit 20 --defer

Parametri necessari

--customizer-name

Nome del personalizzatore.

--type -t

Tipo di personalizzatore da aggiungere al modello di immagine.

Valori accettati: file, powershell, shell, windows-restart, windows-update

Parametri facoltativi

--defer

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

--dest-path

Percorso di destinazione assoluto in cui il file specificato in --file-source verrà scaricato nell'immagine.

--exit-codes -e

Elenco delimitato da spazi di codici di uscita validi, come numeri interi.

--file-source

URI del file da scaricare nell'immagine. Può essere un collegamento github, un URI di firma di accesso condiviso per Archiviazione di Azure e così via.

--filters

Filtri delimitati da spazi per selezionare gli aggiornamenti da applicare. Omettere o specificare una matrice vuota per usare il valore predefinito (nessun filtro).

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

--inline-script

Elenco delimitato da spazi di righe di script inline con cui personalizzare l'immagine.

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

--restart-check-command

Comando per verificare che il riavvio sia riuscito.

--restart-command

Comando per eseguire l'operazione di riavvio.

--restart-timeout

Timeout di riavvio specificato come stringa costituita da una grandezza e un'unità, ad esempio '5m' (5 minuti) o '2h' (2 ore).

Valore predefinito: 5m
--script-url

URL dello script con cui personalizzare l'immagine. L'URL deve essere accessibile pubblicamente.

--search-criteria

Criteri per la ricerca degli aggiornamenti. Omettere o specificare una stringa vuota per usare il valore predefinito (cerca tutto). Fare riferimento al collegamento precedente per esempi e descrizione dettagliata di questo campo.

--subscription

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

--update-limit

Numero massimo di aggiornamenti da applicare alla volta. Omettere o specificare 0 per usare il valore predefinito (1000).

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 customizer clear

Rimuovere tutti i personalizzatori di generatore di immagini da un modello di generatore di immagini.

Deve essere usato con --defer.

az image builder customizer clear [--defer]
                                  [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

Parametri facoltativi

--defer

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

--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 customizer remove

Rimuovere un personalizzatore di generatore di immagini da un modello di generatore di immagini.

Deve essere usato con --defer.

az image builder customizer remove --customizer-name
                                   [--defer]
                                   [--ids]
                                   [--name]
                                   [--resource-group]
                                   [--subscription]

Parametri necessari

--customizer-name

Nome del personalizzatore.

Parametri facoltativi

--defer

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

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