az deployment tenant

  • Riferimento

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

Comandi

Nome Descrizione Tipo Stato
az deployment tenant cancel

Annullare una distribuzione nell'ambito del tenant.

 Memoria centrale Disponibilità generale
az deployment tenant create

Avviare una distribuzione nell'ambito del tenant.

 Memoria centrale Disponibilità generale
az deployment tenant delete

Eliminare una distribuzione nell'ambito del tenant.

 Memoria centrale Disponibilità generale
az deployment tenant export

Esporta il modello usato per una distribuzione.

 Memoria centrale Disponibilità generale
az deployment tenant list

Elencare le distribuzioni nell'ambito del tenant.

 Memoria centrale Disponibilità generale
az deployment tenant show

Visualizzare una distribuzione nell'ambito del tenant.

 Memoria centrale Disponibilità generale
az deployment tenant validate

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

 Memoria centrale Disponibilità generale
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.

 Memoria centrale Disponibilità generale
az deployment tenant what-if

Eseguire un'operazione di simulazione della distribuzione nell'ambito del tenant.

 Memoria centrale Disponibilità generale

az deployment tenant cancel

Modifica

Annullare una distribuzione nell'ambito del tenant.

az deployment tenant cancel --name

Esempio

Annullare una distribuzione nell'ambito del tenant.

az deployment tenant cancel -n deployment01

Parametri necessari

--name -n

Nome della distribuzione.

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

Modifica

Avviare una distribuzione nell'ambito del tenant.

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

az deployment tenant 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 del tenant da un file modello remoto usando i parametri di un file JSON locale.

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

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

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

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

az deployment tenant create --name rollout01 --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

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

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.

--proceed-if-no-change

Indicare al comando di eseguire la distribuzione se il risultato di simulazione 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 di simulazione. Applicabile quando è impostato --confirm-with-what-if.

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

Formato dei risultati di Simulazione. Applicabile quando --confirm-with-what-if è impostato.

valori accettati: FullResourcePayloads, ResourceIdOnly
valore predefinito: FullResourcePayloads
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 deployment tenant delete

Modifica

Eliminare una distribuzione nell'ambito del tenant.

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

Esempio

Eliminare una distribuzione nell'ambito del tenant.

az deployment tenant delete -n deployment01

Parametri necessari

--name -n

Nome della distribuzione.

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 deployment tenant export

Modifica

Esporta il modello usato per una distribuzione.

az deployment tenant export --name

Esempio

Esportare il modello usato per una distribuzione nell'ambito del tenant.

az deployment tenant export --name MyDeployment

Parametri necessari

--name -n

Nome della distribuzione.

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 deployment tenant list

Modifica

Elencare le distribuzioni nell'ambito del tenant.

az deployment tenant list [--filter]

Esempio

Elencare le distribuzioni nell'ambito del tenant.

az deployment tenant 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://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

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

Modifica

Visualizzare una distribuzione nell'ambito del tenant.

az deployment tenant show --name

Esempio

Visualizzare una distribuzione nell'ambito del tenant.

az deployment tenant show -n deployment01

Parametri necessari

--name -n

Nome della distribuzione.

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

Modifica

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

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

az deployment tenant 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 del tenant.

az deployment tenant validate --location WestUS --template-file {template-file}

Verificare se un modello è valido nell'ambito del tenant. (generato automaticamente)

az deployment tenant validate --location WestUS --name mydeployment --parameters @myparameters.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 @{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.

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

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 deployment tenant 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 tenant 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 tenant wait --deleted --name MyDeployment

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

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

Modifica

Eseguire un'operazione di simulazione della distribuzione nell'ambito del tenant.

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

az deployment tenant 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 simulazione della distribuzione nell'ambito del tenant.

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

Eseguire un'operazione di simulazione della distribuzione nell'ambito del tenant con il formato ResourceIdOnly.

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

Eseguire un'operazione di simulazione della distribuzione nell'ambito del tenant senza stampare il risultato.

az deployment tenant 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 simulazione della distribuzione.

Parametri facoltativi

--exclude-change-types -x

Elenco separato da spazi dei tipi di modifica delle risorse da escludere dai risultati di simulazione.

valori accettati: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--name -n

Nome della distribuzione.

--no-pretty-print

Disabilitare pretty-print per i risultati di Simulazione. 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 @{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.

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

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

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.