az deployment sub

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

Comandi

Nome	Descrizione	Tipo	Status
az deployment sub cancel	Annullare una distribuzione nell'ambito della sottoscrizione.	Core	GA
az deployment sub create	Avviare una distribuzione nell'ambito della sottoscrizione.	Core	GA
az deployment sub delete	Eliminare una distribuzione nell'ambito della sottoscrizione.	Core	GA
az deployment sub export	Esportare il modello usato per una distribuzione.	Core	GA
az deployment sub list	Elencare le distribuzioni nell'ambito della sottoscrizione.	Core	GA
az deployment sub show	Visualizzare una distribuzione nell'ambito della sottoscrizione.	Core	GA
az deployment sub validate	Verificare se un modello è valido nell'ambito della sottoscrizione.	Core	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.	Core	GA
az deployment sub what-if	Eseguire un'operazione di distribuzione What-If nell'ambito della sottoscrizione.	Core	GA

az deployment sub cancel

Modifica

Annullare una distribuzione nell'ambito della sottoscrizione.

az deployment sub cancel --name

Esempio

Annullare una distribuzione nell'ambito della sottoscrizione.

az deployment sub cancel -n deployment01

Parametri necessari

--name -n

Nome della distribuzione.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az deployment sub create

Modifica

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 sub 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 sub 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 sub 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 sub create --location WestUS --template-file azuredeploy.json  \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Parametri necessari

--location -l

Percorso in cui archiviare i metadati di distribuzione.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà	Valore
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.

Proprietà	Valore
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.

Proprietà	Valore
Valore predefinito:	FullResourcePayloads
Valori accettati:	FullResourcePayloads, ResourceIdOnly

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az deployment sub delete

Modifica

Eliminare una distribuzione nell'ambito della sottoscrizione.

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

Esempio

Eliminare una distribuzione nell'ambito della sottoscrizione.

az deployment sub delete -n deployment01

Parametri necessari

--name -n

Nome della distribuzione.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà	Valore
Valore predefinito:	False

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az deployment sub export

Modifica

Esportare il modello usato per una distribuzione.

az deployment sub export --name

Esempio

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

az deployment sub export --name MyDeployment

Parametri necessari

--name -n

Nome della distribuzione.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az deployment sub list

Modifica

Elencare le distribuzioni nell'ambito della sottoscrizione.

az deployment sub list [--filter]

Esempio

Elencare le distribuzioni nell'ambito della sottoscrizione.

az deployment sub list

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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 la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az deployment sub show

Modifica

Visualizzare una distribuzione nell'ambito della sottoscrizione.

az deployment sub show --name

Esempio

Visualizzare una distribuzione nell'ambito della sottoscrizione.

az deployment sub show -n deployment01

Parametri necessari

--name -n

Nome della distribuzione.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az deployment sub validate

Modifica

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 sub 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 sub validate --location westus2 --template-file {template-file}

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

az deployment sub 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--parameters -p

Specificare i valori dei parametri di distribuzione.

--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 la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az deployment sub 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 sub 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. (autogenerated)

az deployment sub wait --created --name MyDeployment

Parametri necessari

--name -n

Nome della distribuzione.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Proprietà	Valore
Parameter group:	Wait Condition Arguments
Valore predefinito:	False

--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Proprietà	Valore
Parameter group:	Wait Condition Arguments

--deleted

Attendere l'eliminazione.

Proprietà	Valore
Parameter group:	Wait Condition Arguments
Valore predefinito:	False

--exists

Attendere che la risorsa esista.

Proprietà	Valore
Parameter group:	Wait Condition Arguments
Valore predefinito:	False

--interval

Intervallo di polling in secondi.

Proprietà	Valore
Parameter group:	Wait Condition Arguments
Valore predefinito:	30

--timeout

Attesa massima in secondi.

Proprietà	Valore
Parameter group:	Wait Condition Arguments
Valore predefinito:	3600

--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Proprietà	Valore
Parameter group:	Wait Condition Arguments
Valore predefinito:	False

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

az deployment sub what-if

Modifica

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

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

az deployment sub what-if --location
                          [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                          [--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 una sottoscrizione.

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

Eseguire un'operazione di distribuzione What-If in una sottoscrizione con formato ResourceIdOnly.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Eseguire un'operazione di distribuzione What-If in una sottoscrizione senza stampare il risultato.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Parametri necessari

--location -l

Percorso in cui archiviare i metadati dell'operazione di distribuzione What-If.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--exclude-change-types -x

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

Proprietà	Valore
Valori accettati:	Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported

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

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--parameters -p

Specificare i valori dei parametri di distribuzione.

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

Proprietà	Valore
Valore predefinito:	FullResourcePayloads
Valori accettati:	FullResourcePayloads, ResourceIdOnly

--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 la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

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

--verbose

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

Proprietà	Valore
Valore predefinito:	False

Condividi tramite

az deployment sub

Comandi

az deployment sub cancel

Esempio

Parametri necessari

az deployment sub create

Esempio

Parametri necessari

Parametri facoltativi

az deployment sub delete

Esempio

Parametri necessari

Parametri facoltativi

az deployment sub export

Esempio

Parametri necessari

az deployment sub list

Esempio

Parametri facoltativi

az deployment sub show

Esempio

Parametri necessari

az deployment sub validate

Esempio

Parametri necessari

Parametri facoltativi

az deployment sub wait

Esempio

Parametri necessari

Parametri facoltativi

az deployment sub what-if

Esempio

Parametri necessari

Parametri facoltativi

Commenti e suggerimenti