Condividi tramite

az deployment group

  • Riferimento

Gestire la distribuzione dei modelli di Azure Resource Manager nel gruppo di risorse.

Comandi

Nome Descrizione Tipo Status
az deployment group cancel

Annullare una distribuzione nel gruppo di risorse.

 Nucleo GA
az deployment group create

Avviare una distribuzione nel gruppo di risorse.

 Nucleo GA
az deployment group delete

Eliminare una distribuzione in un gruppo di risorse.

 Nucleo GA
az deployment group export

Esportare il modello usato per una distribuzione.

 Nucleo GA
az deployment group list

Elencare le distribuzioni nel gruppo di risorse.

 Nucleo GA
az deployment group show

Visualizzare una distribuzione nel gruppo di risorse.

 Nucleo GA
az deployment group validate

Verificare se un modello è valido nel gruppo di risorse.

 Nucleo GA
az deployment group wait

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

 Nucleo GA
az deployment group what-if

Eseguire un'operazione di distribuzione What-If nell'ambito del gruppo di risorse.

 Nucleo GA

az deployment group cancel

Modifica

Annullare una distribuzione nel gruppo di risorse.

az deployment group cancel --name
                           --resource-group

Esempio

Annullare una distribuzione nel gruppo di risorse.

az deployment group cancel -g testrg -n deployment01

Parametri necessari

--name -n

Nome della distribuzione.

--resource-group -g

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

Parametri globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az deployment group create

Modifica

Avviare una distribuzione nel gruppo di risorse.

Specificare solo un file --template-file | --template-URI | --template-spec per immettere il modello di Resource Manager.

az deployment group create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--confirm-with-what-if]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--proceed-if-no-change]
                           [--query-string]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-spec]
                           [--template-uri]
                           [--what-if]
                           [--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                           [--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]

Esempio

Creare una distribuzione in un gruppo di risorse da un file modello remoto usando i parametri di un file JSON locale.

az deployment group create --resource-group testrg --name rollout01 \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Creare una distribuzione in un gruppo di risorse da un file modello locale usando i parametri di una stringa JSON.

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Creare una distribuzione in un gruppo di risorse da un file modello locale usando i parametri di una stringa di matrice.

az deployment group create --resource-group testgroup --template-file demotemplate.json --parameters exampleString='inline string' exampleArray='("value1", "value2")'

Creare una distribuzione in un gruppo di risorse da un modello locale, usando un file di parametri, un file di parametri remoto e eseguendo l'override selettiva delle coppie chiave/valore.

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Creare una distribuzione nell'ambito del gruppo di risorse da una specifica di modello

az deployment group create --resource-group testrg --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"

Creare una distribuzione nell'ambito del gruppo di risorse da un file di parametri bicepparam

az deployment group create --resource-group testrg --parameters parameters.bicepparam

Creare una distribuzione in un gruppo di risorse tra tenant

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json --parameters @myparameters.json --aux-tenants auxiliary_tenant01 auxiliary_tenant02

Parametri necessari

--resource-group -g

Gruppo di risorse in cui creare la distribuzione.

Parametri facoltativi

--aux-subs
Deprecato

L'opzione '--aux-subs' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--aux-tenants'.

Sottoscrizioni ausiliarie che verranno usate durante la distribuzione tra tenant.

--aux-tenants

Tenant ausiliari che verranno usati durante la distribuzione tra tenant.

--confirm-with-what-if -c

Indicare al comando di eseguire la distribuzione What-If prima di eseguire la distribuzione. Richiede quindi di confermare le modifiche alle risorse prima che continui.

--handle-extended-json-format -j
Deprecato

L'opzione '--handle-extended-json-format/-j' è stata deprecata e verrà rimossa in una versione futura.

Supporto per gestire il contenuto del modello esteso, tra cui più righe e commenti nella distribuzione.

--mode

Modalità di distribuzione.

Valori accettati: Complete, Incremental
Valore predefinito: Incremental
--name -n

Nome della distribuzione.

--no-prompt

Opzione per disabilitare la richiesta di parametri mancanti per il modello di Resource Manager. Quando il valore è true, il prompt che richiede agli utenti di fornire un parametro mancante verrà ignorato. Il valore predefinito è false.

Valori accettati: false, true
Valore predefinito: False
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valore predefinito: False
--parameters -p

Specificare i valori dei parametri di distribuzione.

I parametri possono essere forniti da un file usando la sintassi @{path}, una stringa JSON o come coppie di <KEY=VALUE>. I parametri vengono valutati in ordine, quindi quando un valore viene assegnato due volte, verrà usato il secondo valore. È consigliabile specificare prima il file dei parametri e quindi eseguire l'override in modo selettivo usando la sintassi KEY=VALUE. Si noti anche se si specifica un file bicepparam, è possibile usare questo argomento una sola volta.

--proceed-if-no-change

Indicare al comando di eseguire la distribuzione se il risultato What-If non contiene modifiche alle risorse. Applicabile quando è impostato --confirm-with-what-if.

--query-string -q

Stringa di query (token di firma di accesso condiviso) da usare con l'URI modello nel caso di modelli collegati.

--rollback-on-error

Nome di una distribuzione a cui eseguire il rollback in caso di errore o usare come flag per eseguire il rollback all'ultima distribuzione riuscita.

--template-file -f

Percorso del file modello o del file Bicep.

--template-spec -s

ID risorsa specifica modello.

--template-uri -u

URI del file modello.

--what-if -w

Indicare al comando di eseguire la distribuzione What-If.

--what-if-exclude-change-types -x

Elenco separato da spazi dei tipi di modifica delle risorse da escludere dai risultati What-If. Applicabile quando è impostato --confirm-with-what-if.

Valori accettati: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

Formato dei risultati What-If. Applicabile quando --confirm-with-what-if è impostato.

Valori accettati: FullResourcePayloads, ResourceIdOnly
Valore predefinito: FullResourcePayloads
Parametri globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az deployment group delete

Modifica

Eliminare una distribuzione in un gruppo di risorse.

az deployment group delete --name
                           --resource-group
                           [--no-wait]

Esempio

Eliminare una distribuzione in un gruppo di risorse.

az deployment group delete -g testrg -n deployment01

Parametri necessari

--name -n

Nome della distribuzione.

--resource-group -g

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

Parametri facoltativi

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valore predefinito: False
Parametri globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az deployment group export

Modifica

Esportare il modello usato per una distribuzione.

az deployment group export --name
                           --resource-group

Esempio

Esportare il modello usato per una distribuzione in un gruppo di risorse.

az deployment group export --resource-group testrg --name MyDeployment

Parametri necessari

--name -n

Nome della distribuzione.

--resource-group -g

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

Parametri globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az deployment group list

Modifica

Elencare le distribuzioni nel gruppo di risorse.

az deployment group list --resource-group
                         [--filter]

Esempio

Elencare le distribuzioni nel gruppo di risorse.

az deployment group list -g testrg

Parametri necessari

--resource-group -g

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

Parametri facoltativi

--filter
Anteprima

Filtrare l'espressione usando la notazione OData. È possibile usare --filter "provisioningState eq '{state}'" per filtrare provisioningState. Per altre informazioni, visitare https://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

Parametri globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az deployment group show

Modifica

Visualizzare una distribuzione nel gruppo di risorse.

az deployment group show --name
                         --resource-group

Esempio

Visualizzare una distribuzione nel gruppo di risorse.

az deployment group show -g testrg -n deployment01

Parametri necessari

--name -n

Nome della distribuzione.

--resource-group -g

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

Parametri globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az deployment group validate

Modifica

Verificare se un modello è valido nel gruppo di risorse.

Specificare solo un file --template-file | --template-URI | --template-spec per immettere il modello di Resource Manager.

az deployment group validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--name]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--query-string]
                             [--rollback-on-error]
                             [--template-file]
                             [--template-spec]
                             [--template-uri]

Esempio

Verificare se un modello è valido nel gruppo di risorse.

az deployment group validate --resource-group testrg --template-file {template-file}

Verificare se un modello è valido nel gruppo di risorse. (generato automaticamente)

az deployment group validate --parameters MyValue=This MyArray=@array.json --resource-group testrg --template-file azuredeploy.json

Parametri necessari

--resource-group -g

Gruppo di risorse in cui creare la distribuzione.

Parametri facoltativi

--handle-extended-json-format -j
Deprecato

L'opzione '--handle-extended-json-format/-j' è stata deprecata e verrà rimossa in una versione futura.

Supporto per gestire il contenuto del modello esteso, tra cui più righe e commenti nella distribuzione.

--mode

Modalità di distribuzione.

Valori accettati: Complete, Incremental
Valore predefinito: Incremental
--name -n

Nome della distribuzione.

--no-prompt

Opzione per disabilitare la richiesta di parametri mancanti per il modello di Resource Manager. Quando il valore è true, il prompt che richiede agli utenti di fornire un parametro mancante verrà ignorato. Il valore predefinito è false.

Valori accettati: false, true
Valore predefinito: False
--parameters -p

Specificare i valori dei parametri di distribuzione.

I parametri possono essere forniti da un file usando la sintassi @{path}, una stringa JSON o come coppie di <KEY=VALUE>. I parametri vengono valutati in ordine, quindi quando un valore viene assegnato due volte, verrà usato il secondo valore. È consigliabile specificare prima il file dei parametri e quindi eseguire l'override in modo selettivo usando la sintassi KEY=VALUE.

--query-string -q

Stringa di query (token di firma di accesso condiviso) da usare con l'URI modello nel caso di modelli collegati.

--rollback-on-error

Nome di una distribuzione a cui eseguire il rollback in caso di errore o usare come flag per eseguire il rollback all'ultima distribuzione riuscita.

--template-file -f

Percorso del file modello o del file Bicep.

--template-spec -s

ID risorsa specifica modello.

--template-uri -u

URI del file modello.

Parametri globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az deployment group wait

Modifica

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

az deployment group wait --name
                         --resource-group
                         [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--interval]
                         [--timeout]
                         [--updated]

Esempio

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

az deployment group wait --created --name MyDeployment --resource-group MyResourceGroup

Parametri necessari

--name -n

Nome della distribuzione.

--resource-group -g

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

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

Intervallo di polling in secondi.

Valore predefinito: 30
--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

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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

az deployment group what-if

Modifica

Eseguire un'operazione di distribuzione What-If nell'ambito del gruppo di risorse.

Specificare solo un file --template-file | --template-URI | --template-spec per immettere il modello di Resource Manager.

az deployment group what-if --resource-group
                            [--aux-tenants]
                            [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                            [--mode {Complete, Incremental}]
                            [--name]
                            [--no-pretty-print]
                            [--no-prompt {false, true}]
                            [--parameters]
                            [--query-string]
                            [--result-format {FullResourcePayloads, ResourceIdOnly}]
                            [--template-file]
                            [--template-spec]
                            [--template-uri]

Esempio

Eseguire un'operazione di distribuzione What-If in un gruppo di risorse.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Eseguire un'operazione di distribuzione What-If in un gruppo di risorse con formato ResourceIdOnly.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Eseguire un'operazione di distribuzione What-If in un gruppo di risorse senza stampare il risultato.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Parametri necessari

--resource-group -g

Gruppo di risorse in cui eseguire l'operazione di distribuzione What-If.

Parametri facoltativi

--aux-tenants

Tenant ausiliari che verranno usati durante la distribuzione tra tenant.

--exclude-change-types -x

Elenco separato da spazi dei tipi di modifica delle risorse da escludere dai risultati What-If.

Valori accettati: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--mode

Modalità di distribuzione.

Valori accettati: Complete, Incremental
Valore predefinito: Incremental
--name -n

Nome della distribuzione.

--no-pretty-print

Disabilitare la stampa per What-If risultati. Se impostato, verrà usato il tipo di formato di output.

--no-prompt

Opzione per disabilitare la richiesta di parametri mancanti per il modello di Resource Manager. Quando il valore è true, il prompt che richiede agli utenti di fornire un parametro mancante verrà ignorato. Il valore predefinito è false.

Valori accettati: false, true
Valore predefinito: False
--parameters -p

Specificare i valori dei parametri di distribuzione.

I parametri possono essere forniti da un file usando la sintassi @{path}, una stringa JSON o come coppie di <KEY=VALUE>. I parametri vengono valutati in ordine, quindi quando un valore viene assegnato due volte, verrà usato il secondo valore. È consigliabile specificare prima il file dei parametri e quindi eseguire l'override in modo selettivo usando la sintassi KEY=VALUE.

--query-string -q

Stringa di query (token di firma di accesso condiviso) da usare con l'URI modello nel caso di modelli collegati.

--result-format -r

Formato dei risultati What-If.

Valori accettati: FullResourcePayloads, ResourceIdOnly
Valore predefinito: FullResourcePayloads
--template-file -f

Percorso del file modello o del file Bicep.

--template-spec -s

ID risorsa specifica modello.

--template-uri -u

URI del file modello.

Parametri globali
--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

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

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