az deployment group

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

Comandos

az deployment group cancel

Cancelar uma implantação no grupo de recursos.

az deployment group create

Inicie uma implantação no grupo de recursos.

az deployment group delete

Exclua uma implantação no grupo de recursos.

az deployment group export

Exportar o modelo usado para uma implantação.

az deployment group list

Listar implantações no grupo de recursos.

az deployment group show

Mostrar uma implantação no grupo de recursos.

az deployment group validate

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

az deployment group wait

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

az deployment group what-if

Execute uma operação de What-If de implantação no escopo do grupo de recursos.

az deployment group cancel

Cancelar uma implantação no grupo de recursos.

az deployment group cancel --name
                           --resource-group
                           [--subscription]

Exemplos

Cancelar uma implantação no grupo de recursos.

az deployment group cancel -g testrg -n deployment01

Parâmetros Exigidos

--name -n

O nome da implantação.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--subscription

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

az deployment group create

Inicie uma implantação no grupo de recursos.

az deployment group create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--confirm-with-what-if]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--proceed-if-no-change]
                           [--query-string]
                           [--rollback-on-error]
                           [--subscription]
                           [--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 grupo de recursos de um arquivo de modelo remoto usando parâmetros de um arquivo JSON local.

az deployment group create --resource-group testrg --name rollout01 \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Crie uma implantação no grupo de recursos de um arquivo de modelo local usando parâmetros de uma cadeia de caracteres JSON.

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Crie uma implantação no grupo de recursos de um arquivo de modelo local usando parâmetros de uma cadeia de caracteres de matriz.

az deployment group create --resource-group testgroup --template-file demotemplate.json --parameters exampleString='inline string' exampleArray='("value1", "value2")'

Crie uma implantação no grupo de recursos de um modelo local, usando um arquivo de parâmetro, um arquivo de parâmetro remoto e substituindo seletivamente pares chave/valor.

az deployment group create --resource-group testrg --name rollout01 \
    --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 de uma especificação de modelo

az deployment group create --resource-group testrg --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"

Parâmetros Exigidos

--resource-group -g

O grupo de recursos em que a implantação será criado.

Parâmetros Opcionais

--aux-subs

Assinaturas auxiliares que serão usadas durante a implantação entre locatários.

--aux-tenants

Locatários auxiliares que serão usados durante a implantação entre locatários.

--confirm-with-what-if -c

Instrua o comando para executar a implantação What-If 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

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

--mode

O modo de implantação.

valores aceitos: Complete, Incremental
valor padrão: Incremental
--name -n

O nome da implantação.

--no-prompt

A opção de desabilitar o prompt de parâmetros ausentes para o modelo do 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
--no-wait

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

--parameters -p

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

--proceed-if-no-change

Instrua o comando a executar a implantação se o 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 template-uri no caso de modelos vinculados.

--rollback-on-error

O nome de uma implantação a ser retordada em caso de erro ou use como um sinalizador para reverter para a última implantação bem-sucedida.

--subscription

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

--template-file -f

O caminho para o arquivo de modelo ou o arquivo Bicep.

--template-spec -s

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

--template-uri -u

O URI para o arquivo de modelo.

--what-if -w

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

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

Lista separada por espaço dos tipos de alteração de recurso a serem excluídos What-If resultados. 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 de What-If resultados. Aplicável quando --confirm-with-what-if é definido.

valores aceitos: FullResourcePayloads, ResourceIdOnly
valor padrão: FullResourcePayloads

az deployment group delete

Exclua uma implantação no grupo de recursos.

az deployment group delete --name
                           --resource-group
                           [--no-wait]
                           [--subscription]

Exemplos

Exclua uma implantação no grupo de recursos.

az deployment group delete -g testrg -n deployment01

Parâmetros Exigidos

--name -n

O nome da implantação.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

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

--subscription

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

az deployment group export

Exportar o modelo usado para uma implantação.

az deployment group export --name
                           --resource-group
                           [--subscription]

Exemplos

Exporte o modelo usado para uma implantação no grupo de recursos.

az deployment group export --resource-group testrg --name MyDeployment

Parâmetros Exigidos

--name -n

O nome da implantação.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--subscription

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

az deployment group list

Listar implantações no grupo de recursos.

az deployment group list --resource-group
                         [--filter]
                         [--query-examples]
                         [--subscription]

Exemplos

Listar implantações no grupo de recursos.

az deployment group list -g testrg

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--filter

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

--query-examples

Recomendamos cadeia de caracteres JMESPath para você. Você pode copiar uma da consulta e colar depois do parâmetro --query entre aspas duplas para ver os resultados. Você pode adicionar uma ou mais palavras-chave posicionais para que possamos dar sugestões com base nessas palavras-chave.

--subscription

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

az deployment group show

Mostrar uma implantação no grupo de recursos.

az deployment group show --name
                         --resource-group
                         [--query-examples]
                         [--subscription]

Exemplos

Mostrar uma implantação no grupo de recursos.

az deployment group show -g testrg -n deployment01

Parâmetros Exigidos

--name -n

O nome da implantação.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--query-examples

Recomendamos cadeia de caracteres JMESPath para você. Você pode copiar uma da consulta e colar depois do parâmetro --query entre aspas duplas para ver os resultados. Você pode adicionar uma ou mais palavras-chave posicionais para que possamos dar sugestões com base nessas palavras-chave.

--subscription

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

az deployment group validate

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

az deployment group validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--name]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--query-string]
                             [--rollback-on-error]
                             [--subscription]
                             [--template-file]
                             [--template-spec]
                             [--template-uri]

Exemplos

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

az deployment group validate --resource-group testrg --template-file {template-file}

Valide se um modelo é válido no grupo de recursos. (gerado automaticamente)

az deployment group validate --parameters MyValue=This MyArray=@array.json --resource-group testrg --template-file azuredeploy.json

Parâmetros Exigidos

--resource-group -g

O grupo de recursos em que a implantação será criado.

Parâmetros Opcionais

--handle-extended-json-format -j

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

--mode

O modo de implantação.

valores aceitos: Complete, Incremental
valor padrão: Incremental
--name -n

O nome da implantação.

--no-prompt

A opção de desabilitar o prompt de parâmetros ausentes para o modelo do 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
--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 template-uri no caso de modelos vinculados.

--rollback-on-error

O nome de uma implantação a ser retordada em caso de erro ou use como um sinalizador para reverter para a última implantação bem-sucedida.

--subscription

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

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

az deployment group wait

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

az deployment group wait --name
                         --resource-group
                         [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--interval]
                         [--subscription]
                         [--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 group wait --created --name MyDeployment --resource-group MyResourceGroup

Parâmetros Exigidos

--name -n

O nome da implantação.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--created

Aguarde até que seja criado com ' provisioningState ' em ' êxito '.

--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por ex.: provisioningState! = ' em andamento ', instanceView. status [? código = = ' PowerState/em execução '].

--deleted

Aguarde até que seja excluído.

--exists

Aguarde até que o recurso exista.

--interval

Intervalo de sondagem em segundos.

valor padrão: 30
--subscription

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

--timeout

Espera máxima em segundos.

valor padrão: 3600
--updated

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

az deployment group what-if

Execute uma operação de What-If de implantação no escopo do grupo de recursos.

az deployment group what-if --resource-group
                            [--aux-tenants]
                            [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                            [--mode {Complete, Incremental}]
                            [--name]
                            [--no-pretty-print]
                            [--no-prompt {false, true}]
                            [--parameters]
                            [--query-string]
                            [--result-format {FullResourcePayloads, ResourceIdOnly}]
                            [--subscription]
                            [--template-file]
                            [--template-spec]
                            [--template-uri]

Exemplos

Execute uma operação de What-If de implantação em um grupo de recursos.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Execute uma operação de What-If de implantação em um grupo de recursos com o formato ResourceIdOnly.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Execute uma operação de What-If de implantação em um grupo de recursos sem imprimir o resultado.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Parâmetros Exigidos

--resource-group -g

O grupo de recursos para executar a implantação What-If operação em.

Parâmetros Opcionais

--aux-tenants

Locatários auxiliares que serão usados durante a implantação entre locatários.

--exclude-change-types -x

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

valores aceitos: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--mode

O modo de implantação.

valores aceitos: Complete, Incremental
valor padrão: Incremental
--name -n

O nome da implantação.

--no-pretty-print

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

--no-prompt

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

valores aceitos: false, true
--parameters -p

Forneça os valores de parâmetro de implantação.

--query-string -q

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

--result-format -r

O formato dos resultados de What-If.

valores aceitos: FullResourcePayloads, ResourceIdOnly
valor padrão: FullResourcePayloads
--subscription

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

--template-file -f

O caminho para o arquivo de modelo ou arquivo Bicpe.

--template-spec -s

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

--template-uri -u

O URI para o arquivo de modelo.