Condividi tramite

az deployment

  • Riferimento

Gestire la distribuzione dei modelli di Azure Resource Manager nell'ambito della sottoscrizione.

Comandi

Nome Descrizione Tipo Status
az deployment cancel

Annullare una distribuzione nell'ambito della sottoscrizione.

 Nucleo Deprecato
az deployment create

Avviare una distribuzione nell'ambito della sottoscrizione.

 Nucleo Deprecato
az deployment delete

Eliminare una distribuzione nell'ambito della sottoscrizione.

 Nucleo Deprecato
az deployment export

Esportare il modello usato per una distribuzione.

 Nucleo Deprecato
az deployment group

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

 Nucleo GA
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 list

Elencare le distribuzioni nell'ambito della sottoscrizione.

 Nucleo Deprecato
az deployment mg

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

 Nucleo GA
az deployment mg cancel

Annullare una distribuzione nel gruppo di gestione.

 Nucleo GA
az deployment mg create

Avviare una distribuzione nel gruppo di gestione.

 Nucleo GA
az deployment mg delete

Eliminare una distribuzione nel gruppo di gestione.

 Nucleo GA
az deployment mg export

Esportare il modello usato per una distribuzione.

 Nucleo GA
az deployment mg list

Elencare le distribuzioni nel gruppo di gestione.

 Nucleo GA
az deployment mg show

Visualizzare una distribuzione nel gruppo di gestione.

 Nucleo GA
az deployment mg validate

Verificare se un modello è valido nel gruppo di gestione.

 Nucleo GA
az deployment mg 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 mg what-if

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

 Nucleo GA
az deployment operation

Gestire le operazioni di distribuzione nell'ambito della sottoscrizione.

 Nucleo GA
az deployment operation group

Gestire le operazioni di distribuzione nel gruppo di risorse.

 Nucleo GA
az deployment operation group list

Elencare le operazioni di distribuzione nel gruppo di risorse.

 Nucleo GA
az deployment operation group show

Visualizzare un'operazione di distribuzione nel gruppo di risorse.

 Nucleo GA
az deployment operation list

Elencare le operazioni di distribuzione nell'ambito della sottoscrizione.

 Nucleo Deprecato
az deployment operation mg

Gestire le operazioni di distribuzione nel gruppo di gestione.

 Nucleo GA
az deployment operation mg list

Elencare le operazioni di distribuzione nel gruppo di gestione.

 Nucleo GA
az deployment operation mg show

Visualizzare un'operazione di distribuzione nel gruppo di gestione.

 Nucleo GA
az deployment operation show

Visualizzare un'operazione di distribuzione nell'ambito della sottoscrizione.

 Nucleo Deprecato
az deployment operation sub

Gestire le operazioni di distribuzione nell'ambito della sottoscrizione.

 Nucleo GA
az deployment operation sub list

Elencare le operazioni di distribuzione nell'ambito della sottoscrizione.

 Nucleo GA
az deployment operation sub show

Visualizzare un'operazione di distribuzione nell'ambito della sottoscrizione.

 Nucleo GA
az deployment operation tenant

Gestire le operazioni di distribuzione nell'ambito del tenant.

 Nucleo GA
az deployment operation tenant list

Elencare le operazioni di distribuzione nell'ambito del tenant.

 Nucleo GA
az deployment operation tenant show

Visualizzare un'operazione di distribuzione nell'ambito del tenant.

 Nucleo GA
az deployment show

Visualizzare una distribuzione nell'ambito della sottoscrizione.

 Nucleo Deprecato
az deployment sub

Gestire la distribuzione dei modelli di Azure Resource Manager nell'ambito della sottoscrizione.

 Nucleo GA
az deployment sub cancel

Annullare una distribuzione nell'ambito della sottoscrizione.

 Nucleo GA
az deployment sub create

Avviare una distribuzione nell'ambito della sottoscrizione.

 Nucleo GA
az deployment sub delete

Eliminare una distribuzione nell'ambito della sottoscrizione.

 Nucleo GA
az deployment sub export

Esportare il modello usato per una distribuzione.

 Nucleo GA
az deployment sub list

Elencare le distribuzioni nell'ambito della sottoscrizione.

 Nucleo GA
az deployment sub show

Visualizzare una distribuzione nell'ambito della sottoscrizione.

 Nucleo GA
az deployment sub validate

Verificare se un modello è valido nell'ambito della sottoscrizione.

 Nucleo GA
az deployment sub 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 sub what-if

Eseguire un'operazione di distribuzione What-If nell'ambito della sottoscrizione.

 Nucleo GA
az deployment tenant

Gestire la distribuzione dei modelli di Azure Resource Manager nell'ambito del tenant.

 Nucleo GA
az deployment tenant cancel

Annullare una distribuzione nell'ambito del tenant.

 Nucleo GA
az deployment tenant create

Avviare una distribuzione nell'ambito del tenant.

 Nucleo GA
az deployment tenant delete

Eliminare una distribuzione nell'ambito del tenant.

 Nucleo GA
az deployment tenant export

Esportare il modello usato per una distribuzione.

 Nucleo GA
az deployment tenant list

Elencare le distribuzioni nell'ambito del tenant.

 Nucleo GA
az deployment tenant show

Visualizzare una distribuzione nell'ambito del tenant.

 Nucleo GA
az deployment tenant validate

Verificare se un modello è valido nell'ambito del tenant.

 Nucleo GA
az deployment tenant 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 tenant what-if

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

 Nucleo GA
az deployment validate

Verificare se un modello è valido nell'ambito della sottoscrizione.

 Nucleo Deprecato
az deployment wait

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

 Nucleo Deprecato

az deployment cancel

Modifica
Deprecato

Questo comando è stato deprecato e verrà rimosso in una versione futura. Usare invece 'deployment sub cancel'.

Annullare una distribuzione nell'ambito della sottoscrizione.

az deployment cancel --name

Esempio

Annullare una distribuzione nell'ambito della sottoscrizione.

az deployment cancel -n deployment01

Parametri necessari

--name -n

Nome della distribuzione.

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 create

Modifica
Deprecato

Questo comando è stato deprecato e verrà rimosso in una versione futura. Usare invece "deployment sub create".

Avviare una distribuzione nell'ambito della sottoscrizione.

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

az deployment create --location
                     [--confirm-with-what-if]
                     [--handle-extended-json-format]
                     [--name]
                     [--no-prompt {false, true}]
                     [--no-wait]
                     [--parameters]
                     [--proceed-if-no-change]
                     [--query-string]
                     [--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 nell'ambito della sottoscrizione da un file modello remoto usando i parametri di un file JSON locale.

az deployment create --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Creare una distribuzione nell'ambito della sottoscrizione da un file modello locale usando i parametri di una stringa JSON.

az deployment create --location WestUS --template-file azuredeploy.json  \
    --parameters "{ \"policyName\": { \"value\": \"policy2\" }}"

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

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

Creare una distribuzione nell'ambito della sottoscrizione da una specifica di modello

az deployment create --location WestUS --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"

Parametri necessari

--location -l

Percorso in cui archiviare i metadati di distribuzione.

Parametri facoltativi

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

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

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

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

Modifica
Deprecato

Questo comando è stato deprecato e verrà rimosso in una versione futura. Usare invece 'deployment sub delete'.

Eliminare una distribuzione nell'ambito della sottoscrizione.

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

Esempio

Eliminare una distribuzione nell'ambito della sottoscrizione.

az deployment delete -n deployment01

Parametri necessari

--name -n

Nome della distribuzione.

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 export

Modifica
Deprecato

Questo comando è stato deprecato e verrà rimosso in una versione futura. Usare invece 'deployment sub export'.

Esportare il modello usato per una distribuzione.

az deployment export --name

Esempio

Esportare il modello usato per una distribuzione nell'ambito della sottoscrizione.

az deployment export --name MyDeployment

Parametri necessari

--name -n

Nome della distribuzione.

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 list

Modifica
Deprecato

Questo comando è stato deprecato e verrà rimosso in una versione futura. Usare invece "elenco secondario di distribuzione".

Elencare le distribuzioni nell'ambito della sottoscrizione.

az deployment list [--filter]

Esempio

Elencare le distribuzioni nell'ambito della sottoscrizione.

az deployment list

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 show

Modifica
Deprecato

Questo comando è stato deprecato e verrà rimosso in una versione futura. Usare invece 'deployment sub show'.

Visualizzare una distribuzione nell'ambito della sottoscrizione.

az deployment show --name

Esempio

Visualizzare una distribuzione nell'ambito della sottoscrizione.

az deployment show -n deployment01

Parametri necessari

--name -n

Nome della distribuzione.

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 validate

Modifica
Deprecato

Questo comando è stato deprecato e verrà rimosso in una versione futura. Usare invece 'deployment sub validate'.

Verificare se un modello è valido nell'ambito della sottoscrizione.

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

az deployment validate --location
                       [--handle-extended-json-format]
                       [--name]
                       [--no-prompt {false, true}]
                       [--parameters]
                       [--query-string]
                       [--template-file]
                       [--template-spec]
                       [--template-uri]

Esempio

Verificare se un modello è valido nell'ambito della sottoscrizione.

az deployment validate --location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json

Parametri necessari

--location -l

Percorso in cui archiviare i metadati di 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.

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

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

Modifica
Deprecato

Questo comando è stato deprecato e verrà rimosso in una versione futura. Usare invece 'deployment sub wait'.

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

az deployment wait --name
                   [--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 wait --deleted --name MyDeployment --subscription MySubscription

Parametri necessari

--name -n

Nome della distribuzione.

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.