az deployment tenant

Gerenciar a implantação de modelo do Azure Resource Manager no escopo do locatário.

Comandos

Nome	Description	Tipo	Status
az deployment tenant cancel	Cancelar uma implantação no escopo do locatário.	Core	GA
az deployment tenant create	Inicie uma implantação no escopo do locatário.	Core	GA
az deployment tenant delete	Exclua uma implantação no escopo do locatário.	Core	GA
az deployment tenant export	Exporte o modelo usado para uma implantação.	Core	GA
az deployment tenant list	Listar implantações no escopo do locatário.	Core	GA
az deployment tenant show	Mostrar uma implantação no escopo do locatário.	Core	GA
az deployment tenant validate	Valide se um modelo é válido no escopo do locatário.	Core	GA
az deployment tenant wait	Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida.	Core	GA
az deployment tenant what-if	Execute uma operação de implantação What-If no escopo do locatário.	Core	GA

az deployment tenant cancel

Editar

Cancelar uma implantação no escopo do locatário.

az deployment tenant cancel --name

Exemplos

Cancelar uma implantação no escopo do locatário.

az deployment tenant cancel -n deployment01

Parâmetros Exigidos

--name -n

O nome da implantação.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az deployment tenant create

Editar

Inicie uma implantação no escopo do locatário.

Especifique apenas um de --template-file FILE | --template-uri URI | --template-spec para inserir o modelo do ARM.

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]
                            [--validation-level {Provider, ProviderNoRbac, Template}]
                            [--what-if]
                            [--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                            [--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]

Exemplos

Crie uma implantação no escopo do locatário a partir de um arquivo de modelo remoto usando parâmetros de um arquivo JSON local.

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

Crie uma implantação no escopo do locatário a partir de um arquivo de modelo local, usando parâmetros de uma cadeia de caracteres JSON.

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

Crie uma implantação no escopo do locatário a partir de um modelo local, usando um arquivo de parâmetro, um arquivo de parâmetro remoto e substituindo seletivamente pares chave/valor.

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

Parâmetros Exigidos

--location -l

O local para armazenar os metadados de implantação.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--confirm-with-what-if -c

Instrua o comando a executar What-If de implantação antes de executar a implantação. Em seguida, ele solicita que você reconheça as alterações de recursos antes de continuar.

--handle-extended-json-format -j

Preterido

A opção '--handle-extended-json-format/-j' foi preterida e será removida em uma versão futura.

Suporte para lidar com conteúdo de modelo estendido, incluindo várias linhas e comentários na implantação.

--name -n

O nome da implantação.

--no-prompt

A opção para desabilitar o prompt de parâmetros ausentes para o modelo do ARM. Quando o valor for verdadeiro, o prompt que exige que os usuários forneçam o parâmetro ausente será ignorado. O valor padrão é false.

Propriedade	Valor
Valor padrão:	False
Valores aceitos:	false, true

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

--parameters -p

Fornecer valores de parâmetro de implantação.

Os parâmetros podem ser fornecidos de um arquivo usando a sintaxe @{path}, uma cadeia de caracteres JSON ou como pares <KEY=VALUE>. Os parâmetros são avaliados em ordem, portanto, quando um valor é atribuído duas vezes, o último valor será usado. É recomendável que você forneça primeiro o arquivo de parâmetros e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.

--proceed-if-no-change

Instrua o comando para executar a implantação se o resultado do What-If não contiver nenhuma alteração de recurso. Aplicável quando --confirm-with-what-if está definido.

--query-string -q

A cadeia de caracteres de consulta (um token SAS) a ser usada com o modelo-uri no caso de modelos vinculados.

--template-file -f

O caminho para o arquivo de modelo ou arquivo Bicep.

--template-spec -s

A ID do recurso de especificação de modelo.

--template-uri -u

O URI para o arquivo de modelo.

--validation-level

O nível de validação da implantação. Pode ser definido como "Provedor" (o padrão), "Modelo" ou "ProviderNoRbac". Com um nível de validação de "provedor", o ARM executará a validação completa e verificará se você tem permissão suficiente para implantar todos os recursos no modelo. Com um nível de validação de "providerNoRbac", o ARM executará a validação completa, mas verificará apenas as permissões de leitura em cada recurso. Com um nível de validação de "modelo", somente a validação estática será executada: as verificações de pré-vôo e permissões serão ignoradas.

Propriedade	Valor
Valores aceitos:	Provider, ProviderNoRbac, Template

--what-if -w

Instrua o comando para executar a implantação de What-If.

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

Lista separada por espaço de tipos de alteração de recursos a serem excluídos dos resultados What-If. Aplicável quando --confirm-with-what-if está definido.

Propriedade	Valor
Valores aceitos:	Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported

--what-if-result-format -r

O formato de resultados What-If. Aplicável quando --confirm-with-what-if é definido.

Propriedade	Valor
Valor padrão:	FullResourcePayloads
Valores aceitos:	FullResourcePayloads, ResourceIdOnly

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az deployment tenant delete

Editar

Exclua uma implantação no escopo do locatário.

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

Exemplos

Exclua uma implantação no escopo do locatário.

az deployment tenant delete -n deployment01

Parâmetros Exigidos

--name -n

O nome da implantação.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az deployment tenant export

Editar

Exporte o modelo usado para uma implantação.

az deployment tenant export --name

Exemplos

Exporte o modelo usado para uma implantação no escopo do locatário.

az deployment tenant export --name MyDeployment

Parâmetros Exigidos

--name -n

O nome da implantação.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az deployment tenant list

Editar

Listar implantações no escopo do locatário.

az deployment tenant list [--filter]

Exemplos

Listar implantações no escopo do locatário.

az deployment tenant list

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--filter

Versão Prévia

Expressão de filtro usando a notação OData. Você pode usar --filter "provisioningState eq '{state}'" para filtrar provisioningState. Para obter mais informações, visite https://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az deployment tenant show

Editar

Mostrar uma implantação no escopo do locatário.

az deployment tenant show --name

Exemplos

Mostrar uma implantação no escopo do locatário.

az deployment tenant show -n deployment01

Parâmetros Exigidos

--name -n

O nome da implantação.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az deployment tenant validate

Editar

Valide se um modelo é válido no escopo do locatário.

Especifique apenas um de --template-file FILE | --template-uri URI | --template-spec para inserir o modelo do ARM.

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

Exemplos

Valide se um modelo é válido no escopo do locatário.

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

Valide se um modelo é válido no escopo do locatário. (autogenerated)

az deployment tenant validate --location WestUS --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json

Parâmetros Exigidos

--location -l

O local para armazenar os metadados de implantação.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--handle-extended-json-format -j

Preterido

A opção '--handle-extended-json-format/-j' foi preterida e será removida em uma versão futura.

Suporte para lidar com conteúdo de modelo estendido, incluindo várias linhas e comentários na implantação.

--name -n

O nome da implantação.

--no-prompt

Propriedade	Valor
Valor padrão:	False
Valores aceitos:	false, true

--parameters -p

Fornecer valores de parâmetro de implantação.

--query-string -q

A cadeia de caracteres de consulta (um token SAS) a ser usada com o modelo-uri no caso de modelos vinculados.

--template-file -f

O caminho para o arquivo de modelo ou arquivo Bicep.

--template-spec -s

A ID do recurso de especificação de modelo.

--template-uri -u

O URI para o arquivo de modelo.

--validation-level

Propriedade	Valor
Valores aceitos:	Provider, ProviderNoRbac, Template

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az deployment tenant wait

Editar

Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida.

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

Exemplos

Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida. (autogenerated)

az deployment tenant wait --deleted --name MyDeployment

Parâmetros Exigidos

--name -n

O nome da implantação.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	False

--custom

Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments

--deleted

Aguarde até ser excluído.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	False

--exists

Aguarde até que o recurso exista.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	False

--interval

Intervalo de sondagem em segundos.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	30

--timeout

Espera máxima em segundos.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	3600

--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az deployment tenant what-if

Editar

Execute uma operação de implantação What-If no escopo do locatário.

Especifique apenas um de --template-file FILE | --template-uri URI | --template-spec para inserir o modelo do ARM.

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]
                             [--validation-level {Provider, ProviderNoRbac, Template}]

Exemplos

Execute uma operação de implantação What-If no escopo do locatário.

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

Execute uma operação de implantação What-If no escopo do locatário com o formato ResourceIdOnly.

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

Execute uma operação de implantação What-If no escopo do locatário sem imprimir o resultado.

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

Parâmetros Exigidos

--location -l

O local para armazenar os metadados da operação What-If implantação.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--exclude-change-types -x

Lista separada por espaço de tipos de alteração de recursos a serem excluídos dos resultados What-If.

Propriedade	Valor
Valores aceitos:	Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported

--name -n

O nome da implantação.

--no-pretty-print

Desabilite a impressão bonita para resultados What-If. Quando definido, o tipo de formato de saída será usado.

--no-prompt

Propriedade	Valor
Valor padrão:	False
Valores aceitos:	false, true

--parameters -p

Fornecer valores de parâmetro de implantação.

--query-string -q

A cadeia de caracteres de consulta (um token SAS) a ser usada com o modelo-uri no caso de modelos vinculados.

--result-format -r

O formato de resultados What-If.

Propriedade	Valor
Valor padrão:	FullResourcePayloads
Valores aceitos:	FullResourcePayloads, ResourceIdOnly

--template-file -f

O caminho para o arquivo de modelo ou arquivo Bicep.

--template-spec -s

A ID do recurso de especificação de modelo.

--template-uri -u

O URI para o arquivo de modelo.

--validation-level

Propriedade	Valor
Valores aceitos:	Provider, ProviderNoRbac, Template

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

Comentários

Esta página foi útil?

Compartilhar via

az deployment tenant

Comandos

az deployment tenant cancel

Exemplos

Parâmetros Exigidos

az deployment tenant create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az deployment tenant delete

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az deployment tenant export

Exemplos

Parâmetros Exigidos

az deployment tenant list

Exemplos

Parâmetros Opcionais

az deployment tenant show

Exemplos

Parâmetros Exigidos

az deployment tenant validate

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az deployment tenant wait

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az deployment tenant what-if

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Comentários