az deployment

Referência

Gerenciar a implantação de modelo do Gerenciador de Recursos do Azure no escopo da assinatura.

Comandos

Nome	Description	Tipo	Status
az deployment cancel	Cancelar uma implantação no escopo da assinatura.	Núcleo	Preterido
az deployment create	Inicie uma implantação no escopo da assinatura.	Núcleo	Preterido
az deployment delete	Exclua uma implantação no escopo da assinatura.	Núcleo	Preterido
az deployment export	Exportar o modelo usado para uma implantação.	Núcleo	Preterido
az deployment group	Gerenciar a implantação de modelo do Gerenciador de Recursos do Azure no grupo de recursos.	Núcleo	GA
az deployment group cancel	Cancelar uma implantação no grupo de recursos.	Núcleo	GA
az deployment group create	Inicie uma implantação no grupo de recursos.	Núcleo	GA
az deployment group delete	Excluir uma implantação no grupo de recursos.	Núcleo	GA
az deployment group export	Exportar o modelo usado para uma implantação.	Núcleo	GA
az deployment group list	Listar implantações no grupo de recursos.	Núcleo	GA
az deployment group show	Mostrar uma implantação no grupo de recursos.	Núcleo	GA
az deployment group validate	Validar se um modelo é válido no grupo de recursos.	Núcleo	GA
az deployment group wait	Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida.	Núcleo	GA
az deployment group what-if	Execute uma operação de Hipóteses de implantação no escopo do grupo de recursos.	Núcleo	GA
az deployment list	Listar implantações no escopo da assinatura.	Núcleo	Preterido
az deployment mg	Gerenciar a implantação de modelo do Gerenciador de Recursos do Azure no grupo de gerenciamento.	Núcleo	GA
az deployment mg cancel	Cancelar uma implantação no grupo de gerenciamento.	Núcleo	GA
az deployment mg create	Inicie uma implantação no grupo de gerenciamento.	Núcleo	GA
az deployment mg delete	Excluir uma implantação no grupo de gerenciamento.	Núcleo	GA
az deployment mg export	Exportar o modelo usado para uma implantação.	Núcleo	GA
az deployment mg list	Listar implantações no grupo de gerenciamento.	Núcleo	GA
az deployment mg show	Mostrar uma implantação no grupo de gerenciamento.	Núcleo	GA
az deployment mg validate	Valide se um modelo é válido no grupo de gerenciamento.	Núcleo	GA
az deployment mg wait	Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida.	Núcleo	GA
az deployment mg what-if	Executar uma operação hipotética de implantação no escopo do grupo de gerenciamento.	Núcleo	GA
az deployment operation	Gerencie operações de implantação no escopo da assinatura.	Núcleo	GA
az deployment operation group	Gerenciar operações de implantação no grupo de recursos.	Núcleo	GA
az deployment operation group list	Listar operações de implantação no grupo de recursos.	Núcleo	GA
az deployment operation group show	Mostrar uma operação de implantação no grupo de recursos.	Núcleo	GA
az deployment operation list	Listar operações de implantação no escopo da assinatura.	Núcleo	Preterido
az deployment operation mg	Gerenciar operações de implantação no grupo de gerenciamento.	Núcleo	GA
az deployment operation mg list	Listar operações de implantação no grupo de gerenciamento.	Núcleo	GA
az deployment operation mg show	Mostrar uma operação de implantação no grupo de gerenciamento.	Núcleo	GA
az deployment operation show	Mostrar uma operação de implantação no escopo da assinatura.	Núcleo	Preterido
az deployment operation sub	Gerencie operações de implantação no escopo da assinatura.	Núcleo	GA
az deployment operation sub list	Listar operações de implantação no escopo da assinatura.	Núcleo	GA
az deployment operation sub show	Mostrar uma operação de implantação no escopo da assinatura.	Núcleo	GA
az deployment operation tenant	Gerencie as operações de implantação no escopo do locatário.	Núcleo	GA
az deployment operation tenant list	Listar operações de implantação no escopo do locatário.	Núcleo	GA
az deployment operation tenant show	Mostrar uma operação de implantação no escopo do locatário.	Núcleo	GA
az deployment show	Mostrar uma implantação no escopo da assinatura.	Núcleo	Preterido
az deployment sub	Gerenciar a implantação de modelo do Gerenciador de Recursos do Azure no escopo da assinatura.	Núcleo	GA
az deployment sub cancel	Cancelar uma implantação no escopo da assinatura.	Núcleo	GA
az deployment sub create	Inicie uma implantação no escopo da assinatura.	Núcleo	GA
az deployment sub delete	Exclua uma implantação no escopo da assinatura.	Núcleo	GA
az deployment sub export	Exportar o modelo usado para uma implantação.	Núcleo	GA
az deployment sub list	Listar implantações no escopo da assinatura.	Núcleo	GA
az deployment sub show	Mostrar uma implantação no escopo da assinatura.	Núcleo	GA
az deployment sub validate	Valide se um modelo é válido no escopo da assinatura.	Núcleo	GA
az deployment sub wait	Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida.	Núcleo	GA
az deployment sub what-if	Execute uma operação What-If de implantação no escopo da assinatura.	Núcleo	GA
az deployment tenant	Gerenciar a implantação de modelo do Gerenciador de Recursos do Azure no escopo do locatário.	Núcleo	GA
az deployment tenant cancel	Cancele uma implantação no escopo do locatário.	Núcleo	GA
az deployment tenant create	Inicie uma implantação no escopo do locatário.	Núcleo	GA
az deployment tenant delete	Exclua uma implantação no escopo do locatário.	Núcleo	GA
az deployment tenant export	Exportar o modelo usado para uma implantação.	Núcleo	GA
az deployment tenant list	Listar implantações no escopo do locatário.	Núcleo	GA
az deployment tenant show	Mostrar uma implantação no escopo do locatário.	Núcleo	GA
az deployment tenant validate	Valide se um modelo é válido no escopo do locatário.	Núcleo	GA
az deployment tenant wait	Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida.	Núcleo	GA
az deployment tenant what-if	Execute uma operação hipotética de implantação no escopo do locatário.	Núcleo	GA
az deployment validate	Valide se um modelo é válido no escopo da assinatura.	Núcleo	Preterido
az deployment wait	Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida.	Núcleo	Preterido

az deployment cancel

Editar

Preterido

Esse comando foi preterido e será removido em uma versão futura. Em vez disso, use 'deployment sub cancel'.

Cancelar uma implantação no escopo da assinatura.

az deployment cancel --name

Exemplos

Cancelar uma implantação no escopo da assinatura.

az deployment cancel -n deployment01

Parâmetros Exigidos

--name -n

O nome da implantação.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az deployment create

Editar

Preterido

Esse comando foi preterido e será removido em uma versão futura. Em vez disso, use 'deployment sub create'.

Inicie uma implantação no escopo da assinatura.

Especifique apenas um dos arquivos --template-file | --template-uri URI | --template-spec para inserir o modelo ARM.

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

Exemplos

Crie uma implantação no escopo de assinatura a partir de um arquivo de modelo remoto, usando parâmetros de um arquivo JSON local.

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

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

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

Crie uma implantação no escopo de assinatura 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 create --location WestUS --template-file azuredeploy.json  \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Criar uma implantação no escopo de assinatura a partir de uma especificação de modelo

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

Parâmetros Exigidos

--location -l

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

Parâmetros Opcionais

--confirm-with-what-if -c

Instrua o comando a executar o 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 desativar o prompt de parâmetros ausentes para o modelo ARM. Quando o valor for true, o prompt que exige que os usuários forneçam o parâmetro ausente será ignorado. O valor padrão é false.

Valores aceitos: false, true

Valor padrão: False

--no-wait

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

Valor padrão: False

--parameters -p

Forneça valores de parâmetros de implantação.

Os parâmetros podem ser fornecidos de um arquivo usando a @{path} sintaxe, 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 o arquivo de parâmetros primeiro e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.

--proceed-if-no-change

Instrua o comando a executar a implantação se o resultado do What-If não contiver alterações de recursos. 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 template-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 do modelo.

--template-uri -u

O URI para o arquivo de modelo.

--what-if -w

Instrua o comando a executar o What-If.

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

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

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

--what-if-result-format -r

O formato dos resultados hipotéticos. Aplicável quando --confirm-with-what-if está definido.

Valores aceitos: FullResourcePayloads, ResourceIdOnly

Valor padrão: FullResourcePayloads

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az deployment delete

Editar

Preterido

Esse comando foi preterido e será removido em uma versão futura. Em vez disso, use 'deployment sub delete'.

Exclua uma implantação no escopo da assinatura.

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

Exemplos

Exclua uma implantação no escopo da assinatura.

az deployment delete -n deployment01

Parâmetros Exigidos

--name -n

O nome da implantação.

Parâmetros Opcionais

--no-wait

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

Valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az deployment export

Editar

Preterido

Esse comando foi preterido e será removido em uma versão futura. Em vez disso, use 'deployment sub export'.

Exportar o modelo usado para uma implantação.

az deployment export --name

Exemplos

Exporte o modelo usado para uma implantação no escopo de assinatura.

az deployment export --name MyDeployment

Parâmetros Exigidos

--name -n

O nome da implantação.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az deployment list

Editar

Preterido

Esse comando foi preterido e será removido em uma versão futura. Em vez disso, use 'sublista de implantação'.

Listar implantações no escopo da assinatura.

az deployment list [--filter]

Exemplos

Listar implantações no escopo da assinatura.

az deployment list

Parâmetros Opcionais

--filter

Versão Prévia

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

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az deployment show

Editar

Preterido

Esse comando foi preterido e será removido em uma versão futura. Em vez disso, use 'deployment sub show'.

Mostrar uma implantação no escopo da assinatura.

az deployment show --name

Exemplos

Mostrar uma implantação no escopo da assinatura.

az deployment show -n deployment01

Parâmetros Exigidos

--name -n

O nome da implantação.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az deployment validate

Editar

Preterido

Esse comando foi preterido e será removido em uma versão futura. Em vez disso, use 'deployment sub validate'.

Valide se um modelo é válido no escopo da assinatura.

Especifique apenas um dos arquivos --template-file | --template-uri URI | --template-spec para inserir o modelo ARM.

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

Exemplos

Valide se um modelo é válido no escopo da assinatura.

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

Parâmetros Exigidos

--location -l

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

Parâmetros Opcionais

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

Valores aceitos: false, true

Valor padrão: False

--parameters -p

Forneça valores de parâmetros de implantação.

--query-string -q

A cadeia de caracteres de consulta (um token SAS) a ser usada com o template-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 do modelo.

--template-uri -u

O URI para o arquivo de modelo.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az deployment wait

Editar

Preterido

Esse comando foi preterido e será removido em uma versão futura. Em vez disso, use 'deployment sub wait'.

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

az deployment 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. (gerado automaticamente)

az deployment wait --deleted --name MyDeployment --subscription MySubscription

Parâmetros Exigidos

--name -n

O nome da implantação.

Parâmetros Opcionais

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

Valor padrão: False

--custom

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

--deleted

Aguarde até ser excluído.

Valor padrão: False

--exists

Aguarde até que o recurso exista.

Valor padrão: False

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30

--timeout

Espera máxima em segundos.

Valor padrão: 3600

--updated

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

Valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

Compartilhar via

az deployment

Comandos

az deployment cancel

Exemplos

Parâmetros Exigidos

az deployment create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az deployment delete

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az deployment export

Exemplos

Parâmetros Exigidos

az deployment list

Exemplos

Parâmetros Opcionais

az deployment show

Exemplos

Parâmetros Exigidos

az deployment validate

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az deployment wait

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Recursos adicionais