az stack-whatif sub

Gerenciar implantação empilha resultados de hipóteses no escopo da assinatura.

Comandos

Nome Description Tipo Status
az stack-whatif sub create

Crie um resultado de hipóteses de pilha de implantação no escopo da assinatura.

Core GA
az stack-whatif sub delete

Exclua um resultado de hipóteses da pilha de implantação do escopo da assinatura.

Core GA
az stack-whatif sub list

Listar todos os resultados da pilha de implantação em uma assinatura.

Core GA
az stack-whatif sub show

Obtenha um resultado de hipóteses da pilha de implantação do escopo da assinatura.

Core GA

az stack-whatif sub create

Crie um resultado de hipóteses de pilha de implantação no escopo da assinatura.

az stack-whatif sub create --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
                           --deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
                           --location
                           --name
                           --retention-interval --ri
                           --stack-id
                           [--acquire-policy-token]
                           [--change-reference]
                           [--cs --deny-settings-apply-to-child-scopes]
                           [--deny-settings-excluded-actions --ea]
                           [--deny-settings-excluded-principals --ep]
                           [--deployment-resource-group --dr]
                           [--description]
                           [--no-color]
                           [--no-pretty-print]
                           [--no-wait]
                           [--parameters]
                           [--query-string]
                           [--resources-without-delete-support --rwd {detach, fail}]
                           [--tags]
                           [--template-file]
                           [--template-spec]
                           [--template-uri]
                           [--validation-level --vl {Provider, ProviderNoRbac, Template}]

Exemplos

Execute um what-if em uma pilha de implantação usando o arquivo de modelo e desanexe todos os recursos em unmanage.

az stack-whatif sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

Execute um what-if em uma pilha de implantação com arquivo de parâmetro, exclua recursos em unmanage e remova a cor da saída.

az stack-whatif sub create --name StackName --action-on-unmanage deleteResources --no-color --template-file simpleTemplate.json --parameters simpleTemplateParams.json --location westus2 --description description --deny-settings-mode None --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

Execute um what-if em uma pilha de implantação com especificação de modelo.

az stack-whatif sub create --name StackName --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

Execute um what-if em uma pilha de implantação usando o arquivo bicep e exclua todos os recursos em unmanage.

az stack-whatif sub create --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

Execute um what-if em uma pilha de implantação em uma assinatura diferente.

az stack-whatif sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

Execute um what-if em uma pilha de implantação e implante no escopo do grupo de recursos.

az stack-whatif sub create --name StackName --template-file simpleTemplate.json --location westus --deployment-resource-group ResourceGroup --description description --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

Execute um what-if em uma pilha de implantação usando parâmetros de pares chave/valor.

az stack-whatif sub create --name StackName --template-file simpleTemplate.json --location westus --description description --parameters simpleTemplateParams.json value1=foo value2=bar --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

Execute um what-if em uma pilha de implantação de um modelo local, usando um arquivo de parâmetro, um arquivo de parâmetro remoto e substituindo seletivamente pares chave/valor.

az stack-whatif sub create --name StackName --template-file azuredeploy.json --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json --location westus --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

Execute um what-if em uma pilha de implantação de um modelo local, usando configurações de negação.

az stack-whatif sub create --name StackName --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-excluded-principals "test1 test2" --location westus --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

Execute um what-if em uma pilha de implantação de um modelo local, aplique configurações de negação a escopos filho.

az stack-whatif sub create --name StackName --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-apply-to-child-scopes --location westus --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

Parâmetros obrigatórios

--action-on-unmanage --aou

Define o que acontece com recursos que não são mais gerenciados depois que a pilha é atualizada ou excluída.

Propriedade Valor
Valores aceitos: deleteAll, deleteResources, detachAll
--deny-settings-mode --dm

Defina quais operações são negadas em recursos gerenciados pela pilha.

Propriedade Valor
Valores aceitos: denyDelete, denyWriteAndDelete, none
--location -l

O local para armazenar o resultado de hipóteses da pilha de implantação.

--name -n

O nome do resultado de hipóteses da pilha de implantação.

--retention-interval --ri

O intervalo de retenção para What-If resultados. O valor deve estar no formato ISO 8601 e entre 1 dia e 30 dias.

--stack-id

A ID totalmente qualificada da pilha de implantação na qual executar uma operação de hipóteses.

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.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--cs --deny-settings-apply-to-child-scopes

DenySettings será aplicado a escopos filho.

Propriedade Valor
Valor padrão: False
--deny-settings-excluded-actions --ea

Lista de operações de gerenciamento baseadas em função que são excluídas das denySettings. Até 200 ações são permitidas.

--deny-settings-excluded-principals --ep

Lista de IDs de entidade de segurança do AAD excluídas do bloqueio. Até 5 entidades de segurança são permitidas.

--deployment-resource-group --dr

O escopo no qual a implantação inicial deve ser criada. Se um escopo não for especificado, ele usará como padrão o escopo da pilha de implantação.

--description

A descrição da pilha de implantação.

--no-color

Desabilite a cor em resultados de what-if bastante impressos.

--no-pretty-print

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

--no-wait

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

Propriedade Valor
Valor padrão: False
--parameters -p

Os parâmetros podem ser fornecidos de um arquivo usando a @{path} sintaxe, uma cadeia de caracteres JSON ou como <KEY=VALUE> pares. 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.

--query-string -q

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

--resources-without-delete-support --rwd

Define o que acontece com recursos que não dão suporte à exclusão quando eles não são mais gerenciados pela pilha.

Propriedade Valor
Valores aceitos: detach, fail
--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--template-file -f

Um caminho para um arquivo de modelo ou Bicep arquivo no sistema de arquivos.

--template-spec -s

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

--template-uri -u

Um uri para um arquivo de modelo remoto.

--validation-level --vl

Nível de validação para a pilha de implantação. O padrão é 'Provider'.

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 stack-whatif sub delete

Exclua um resultado de hipóteses da pilha de implantação do escopo da assinatura.

az stack-whatif sub delete [--acquire-policy-token]
                           [--change-reference]
                           [--id]
                           [--name]
                           [--yes]

Exemplos

Exclua um resultado de hipóteses de pilha por nome.

az stack-whatif sub delete --name StackName

Exclua um resultado de hipóteses de pilha por ID do recurso.

az stack-whatif sub delete --id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacksWhatIfResults/ResultName

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.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--id

A ID do recurso de resultado da pilha de implantação.

--name -n

O nome do resultado de hipóteses da pilha de implantação.

--yes

Não solicite confirmação.

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 stack-whatif sub list

Listar todos os resultados da pilha de implantação em uma assinatura.

az stack-whatif sub list

Exemplos

Listar todos os resultados de hipóteses de pilha da assinatura atual.

az stack-whatif sub list
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 stack-whatif sub show

Obtenha um resultado de hipóteses da pilha de implantação do escopo da assinatura.

az stack-whatif sub show [--id]
                         [--name]
                         [--no-color]
                         [--no-pretty-print]
                         [--with-property-changes --wpc {false, true}]

Exemplos

Obtenha um resultado de hipóteses de pilha por nome.

az stack-whatif sub show --name ResultName

Obtenha um resultado de hipóteses de pilha por nome sem cor.

az stack-whatif sub show --name ResultName --no-color

Obtenha JSON para um resultado de hipóteses de pilha por nome.

az stack-whatif sub show --name ResultName --no-pretty-print

Obtenha um resultado de hipóteses de pilha por ID do recurso.

az stack-whatif sub show --id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacksWhatIfResults/ResultName

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.

--id

A ID do recurso de resultado da pilha de implantação.

--name -n

O nome do resultado de hipóteses da pilha de implantação.

--no-color

Desabilite a cor em resultados de what-if bastante impressos.

--no-pretty-print

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

--with-property-changes --wpc

Sinalizador para retornar os resultados do What-If com alterações de propriedade de recurso incluídas.

Propriedade Valor
Valores aceitos: false, true
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