Partilhar via

az deployment

  • Referência

Gerencie a implantação do modelo do Azure Resource Manager no escopo da assinatura.

Comandos

Name Description Tipo Status
az deployment cancel

Cancelar uma implantação no escopo da assinatura.

 Principal Preterido
az deployment create

Inicie uma implantação no escopo da assinatura.

 Principal Preterido
az deployment delete

Exclua uma implantação no escopo da assinatura.

 Principal Preterido
az deployment export

Exporte o modelo usado para uma implantação.

 Principal Preterido
az deployment group

Gerencie a implantação de modelo do Azure Resource Manager no grupo de recursos.

 Principal GA
az deployment group cancel

Cancelar uma implantação no grupo de recursos.

 Principal GA
az deployment group create

Inicie uma implantação no grupo de recursos.

 Principal GA
az deployment group delete

Exclua uma implantação no grupo de recursos.

 Principal GA
az deployment group export

Exporte o modelo usado para uma implantação.

 Principal GA
az deployment group list

Listar implantações no grupo de recursos.

 Principal GA
az deployment group show

Mostrar uma implantação no grupo de recursos.

 Principal GA
az deployment group validate

Valide se um modelo é válido no grupo de recursos.

 Principal GA
az deployment group wait

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

 Principal GA
az deployment group what-if

Execute uma operação hipotética de implantação no escopo do grupo de recursos.

 Principal GA
az deployment list

Listar implantações no escopo da assinatura.

 Principal Preterido
az deployment mg

Gerencie a implantação de modelo do Azure Resource Manager no grupo de gerenciamento.

 Principal GA
az deployment mg cancel

Cancelar uma implantação no grupo de gerenciamento.

 Principal GA
az deployment mg create

Inicie uma implantação no grupo de gerenciamento.

 Principal GA
az deployment mg delete

Exclua uma implantação no grupo de gerenciamento.

 Principal GA
az deployment mg export

Exporte o modelo usado para uma implantação.

 Principal GA
az deployment mg list

Listar implantações no grupo de gerenciamento.

 Principal GA
az deployment mg show

Mostrar uma implantação no grupo de gerenciamento.

 Principal GA
az deployment mg validate

Valide se um modelo é válido no grupo de gerenciamento.

 Principal GA
az deployment mg wait

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

 Principal GA
az deployment mg what-if

Execute uma operação hipotética de implantação no escopo do grupo de gerenciamento.

 Principal GA
az deployment operation

Gerencie as operações de implantação no escopo da assinatura.

 Principal GA
az deployment operation group

Gerencie operações de implantação no grupo de recursos.

 Principal GA
az deployment operation group list

Listar operações de implantação no grupo de recursos.

 Principal GA
az deployment operation group show

Mostrar uma operação de implantação no grupo de recursos.

 Principal GA
az deployment operation list

Listar operações de implantação no escopo da assinatura.

 Principal Preterido
az deployment operation mg

Gerencie as operações de implantação no grupo de gerenciamento.

 Principal GA
az deployment operation mg list

Listar operações de implantação no grupo de gerenciamento.

 Principal GA
az deployment operation mg show

Mostrar uma operação de implantação no grupo de gerenciamento.

 Principal GA
az deployment operation show

Mostrar uma operação de implantação no escopo da assinatura.

 Principal Preterido
az deployment operation sub

Gerencie as operações de implantação no escopo da assinatura.

 Principal GA
az deployment operation sub list

Listar operações de implantação no escopo da assinatura.

 Principal GA
az deployment operation sub show

Mostrar uma operação de implantação no escopo da assinatura.

 Principal GA
az deployment operation tenant

Gerencie as operações de implantação no escopo do locatário.

 Principal GA
az deployment operation tenant list

Listar operações de implantação no escopo do locatário.

 Principal GA
az deployment operation tenant show

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

 Principal GA
az deployment show

Mostrar uma implantação no escopo da assinatura.

 Principal Preterido
az deployment sub

Gerencie a implantação do modelo do Azure Resource Manager no escopo da assinatura.

 Principal GA
az deployment sub cancel

Cancelar uma implantação no escopo da assinatura.

 Principal GA
az deployment sub create

Inicie uma implantação no escopo da assinatura.

 Principal GA
az deployment sub delete

Exclua uma implantação no escopo da assinatura.

 Principal GA
az deployment sub export

Exporte o modelo usado para uma implantação.

 Principal GA
az deployment sub list

Listar implantações no escopo da assinatura.

 Principal GA
az deployment sub show

Mostrar uma implantação no escopo da assinatura.

 Principal GA
az deployment sub validate

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

 Principal GA
az deployment sub wait

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

 Principal GA
az deployment sub what-if

Execute uma operação hipotética de implantação no escopo da assinatura.

 Principal GA
az deployment tenant

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

 Principal GA
az deployment tenant cancel

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

 Principal GA
az deployment tenant create

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

 Principal GA
az deployment tenant delete

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

 Principal GA
az deployment tenant export

Exporte o modelo usado para uma implantação.

 Principal GA
az deployment tenant list

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

 Principal GA
az deployment tenant show

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

 Principal GA
az deployment tenant validate

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

 Principal GA
az deployment tenant wait

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

 Principal GA
az deployment tenant what-if

Execute uma operação hipotética de implantação no escopo do locatário.

 Principal GA
az deployment validate

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

 Principal Preterido
az deployment wait

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

 Principal Preterido

az deployment cancel

Editar
Preterido

Este 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 Obrigatórios

--name -n

O nome da implantação.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az deployment create

Editar
Preterido

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

Por favor, especifique apenas um dos --template-file 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 da 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 da 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 da 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 Obrigatórios

--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 da implantação antes de executar a implantação. Em seguida, ele solicita que você reconheça as alterações de recursos antes que elas continuem.

--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 predefinido é false.

Valores aceites: false, true
Default value: False
--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--parameters -p

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

Os parâmetros podem ser fornecidos a partir 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 seu arquivo de parâmetros primeiro 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 de hipóteses 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 para executar o 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 de hipóteses. Aplicável quando --confirm-with-what-if está definido.

Valores aceites: 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 é definido.

Valores aceites: FullResourcePayloads, ResourceIdOnly
Default value: FullResourcePayloads
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az deployment delete

Editar
Preterido

Este 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 Obrigatórios

--name -n

O nome da implantação.

Parâmetros Opcionais

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az deployment export

Editar
Preterido

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

Exporte o modelo usado para uma implantação.

az deployment export --name

Exemplos

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

az deployment export --name MyDeployment

Parâmetros Obrigatórios

--name -n

O nome da implantação.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az deployment list

Editar
Preterido

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

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
Pré-visualizar

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az deployment show

Editar
Preterido

Este 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 Obrigatórios

--name -n

O nome da implantação.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az deployment validate

Editar
Preterido

Este comando foi preterido e será removido em uma versão futura. Use 'deployment sub validate' em vez disso.

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

Por favor, especifique apenas um dos --template-file 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 Obrigatórios

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

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 predefinido é false.

Valores aceites: false, true
Default value: False
--parameters -p

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

Os parâmetros podem ser fornecidos a partir 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 seu arquivo de parâmetros primeiro e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.

--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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az deployment wait

Editar
Preterido

Este 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 Obrigatórios

--name -n

O nome da implantação.

Parâmetros Opcionais

--created

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

Default value: 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.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--interval

Intervalo de sondagem em segundos.

Default value: 30
--timeout

Espera máxima em segundos.

Default value: 3600
--updated

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

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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