Condividi tramite

az group deployment

  • Deprecato
  • Riferimento

Questo gruppo di comandi è stato deprecato e verrà rimosso in una versione futura. Usare invece "gruppo di distribuzione".

Gestire le distribuzioni di Azure Resource Manager.

Comandi

Nome Descrizione Tipo Status
az group deployment cancel

Annulla una distribuzione di modelli attualmente in esecuzione.

 Memoria centrale Deprecato
az group deployment create

Avvia una distribuzione.

 Memoria centrale Deprecato
az group deployment delete

Elimina una distribuzione dalla cronologia di distribuzione.

 Memoria centrale Deprecato
az group deployment export

Esporta il modello usato per una distribuzione.

 Memoria centrale Deprecato
az group deployment list

Ottiene tutte le distribuzioni di un gruppo di risorse.

 Memoria centrale Deprecato
az group deployment operation

Gestire le operazioni di distribuzione.

 Memoria centrale Deprecato
az group deployment operation list

Ottiene tutte le operazioni di distribuzione per una distribuzione.

 Memoria centrale Deprecato
az group deployment operation show

Ottenere l'operazione di una distribuzione.

 Memoria centrale Deprecato
az group deployment show

Ottiene una distribuzione.

 Memoria centrale Deprecato
az group deployment validate

Verificare se un modello è sintatticamente corretto.

 Memoria centrale Deprecato
az group deployment wait

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

 Memoria centrale Deprecato

az group deployment cancel

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'group deployment' è deprecato e verrà rimosso in una versione futura. Usare invece "gruppo di distribuzione".

Annulla una distribuzione di modelli attualmente in esecuzione.

È possibile annullare una distribuzione solo se provisioningState è accettato o in esecuzione. Dopo l'annullamento della distribuzione, provisioningState è impostato su Canceled. L'annullamento di una distribuzione di modelli arresta la distribuzione del modello attualmente in esecuzione e lascia il gruppo di risorse parzialmente distribuito.

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

Parametri necessari

--name -n

Nome della distribuzione.

--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 group deployment create

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'group deployment' è deprecato e verrà rimosso in una versione futura. Usare invece "gruppo di distribuzione".

Avvia una distribuzione.

az group deployment create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-uri]

Esempio

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

az group deployment create -g MyResourceGroup --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters "{ \"location\": { \"value\": \"westus\" } }"

Creare una distribuzione da un modello locale, usando un file di parametri locale, un file di parametri remoto e sostituendo in modo selettivo coppie chiave/valore.

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Parametri necessari

--resource-group -g

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

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.

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

Incrementale (solo aggiungere risorse al gruppo di risorse) o Completa (rimuovere risorse aggiuntive dal gruppo di risorse).

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

Nome della distribuzione. Per impostazione predefinita, usare il nome di base del file modello.

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

Indica che non è necessario attendere il termine 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 @{path} sintassi, una stringa JSON o come <coppie 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.

--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 di un file modello o di un file Bicep nel file system.

--template-uri -u

URI di un file modello remoto.

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 group deployment delete

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'group deployment' è deprecato e verrà rimosso in una versione futura. Usare invece "gruppo di distribuzione".

Elimina una distribuzione dalla cronologia di distribuzione.

Non è possibile eliminare una distribuzione di modelli attualmente in esecuzione. L'eliminazione di una distribuzione di modelli rimuove le operazioni di distribuzione associate. L'eliminazione di una distribuzione di modelli non influisce sullo stato del gruppo di risorse. Si tratta di un'operazione asincrona che restituisce lo stato 202 fino a quando la distribuzione del modello non viene eliminata correttamente. L'intestazione della risposta Location contiene l'URI usato per ottenere lo stato del processo. Mentre il processo è in esecuzione, una chiamata all'URI nell'intestazione Location restituisce lo stato 202. Al termine del processo, l'URI nell'intestazione Location restituisce lo stato 204 in caso di esito positivo. Se la richiesta asincrona non è riuscita, l'URI nell'intestazione Location restituisce un codice di stato a livello di errore.

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

Parametri necessari

--name -n

Nome della distribuzione.

--resource-group -g

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

Parametri facoltativi

--no-wait

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

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.

az group deployment export

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'group deployment' è deprecato e verrà rimosso in una versione futura. Usare invece "gruppo di distribuzione".

Esporta il modello usato per una distribuzione.

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

Esempio

Esporta il modello usato per una distribuzione. (generato automaticamente)

az group deployment export --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 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 group deployment list

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'group deployment' è deprecato e verrà rimosso in una versione futura. Usare invece "gruppo di distribuzione".

Ottiene tutte le distribuzioni di un gruppo di risorse.

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

Parametri necessari

--resource-group -g

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

Parametri facoltativi

--filter

Il filtro da applicare all'operazione. Ad esempio, è possibile usare $filter=provisioningState eq '{state}'. Il valore predefinito è Nessuno.

--top

Numero di risultati da ottenere. Se viene passato null, restituisce tutte le distribuzioni. Il valore predefinito è Nessuno.

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 group deployment show

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'group deployment' è deprecato e verrà rimosso in una versione futura. Usare invece "gruppo di distribuzione".

Ottiene una distribuzione.

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

Parametri necessari

--name -n

Nome della distribuzione.

--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 group deployment validate

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'group deployment' è deprecato e verrà rimosso in una versione futura. Usare invece "gruppo di distribuzione".

Verificare se un modello è sintatticamente corretto.

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

Esempio

Verificare se un modello è sintatticamente corretto. (generato automaticamente)

az group deployment validate --parameters "{ \"location\": { \"value\": \"westus\" } }" \
    --resource-group MyResourceGroup --template-file storage.json

Parametri necessari

--resource-group -g

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

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

Incrementale (solo aggiungere risorse al gruppo di risorse) o Completa (rimuovere risorse aggiuntive dal gruppo di risorse).

Valori accettati: Complete, Incremental
Valore predefinito: Incremental
--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 @{path} sintassi, una stringa JSON o come <coppie 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.

--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 di un file modello o di un file Bicep nel file system.

--template-uri -u

URI di un file modello remoto.

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 group deployment wait

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'group deployment' è deprecato e verrà rimosso in una versione futura. Usare invece "gruppo di distribuzione".

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

az group deployment 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 group deployment wait --name MyDeployment --resource-group MyResourceGroup --updated

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 group deployment 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 con 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

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.