az stack-whatif sub

Gerir as pilhas de resultados hipotéticos da implantação no âmbito da subscrição.

Comandos

Nome Descrição Tipo Estado
az stack-whatif sub create

Crie um resultado hipotético de stack de implementação no âmbito da subscrição.

Core disponibilidade geral
az stack-whatif sub delete

Eliminar um resultado hipotético da pilha de implementação do âmbito da subscrição.

Core disponibilidade geral
az stack-whatif sub list

Liste todos os resultados hipotéticos da pilha de implementação numa subscrição.

Core disponibilidade geral
az stack-whatif sub show

Obtenha um resultado hipotético da stack de implementação a partir do âmbito de subscrição.

Core disponibilidade geral

az stack-whatif sub create

Crie um resultado hipotético de stack de implementação no âmbito da subscrição.

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

Faz um 'e se' numa stack de implementação usando ficheiro template e desanexa 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

Realizar um 'e se' numa pilha de implementação com ficheiro de parâmetros, apagar recursos em unmanage e remover 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

Faz um 'e se' numa stack de implementação com especificação de template.

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

Faz um what-if numa stack de deployment usando o ficheiro bicep e apaga todos os recursos no modo 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

Faz um 'e se' numa stack de implementação numa subscrição 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

Realizar um 'e se' numa pilha de deployment e implementar no âmbito 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

Realizar um 'e se' numa stack de implementaçã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

Realizar um 'e se' numa pilha de implementação a partir de um template local, usando um ficheiro de parâmetros, um ficheiro de parâmetros remoto e sobrescrevendo 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 'e se' numa pilha de implementação a partir de um template local, usando as definições de recusa.

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

Realizar um 'e se' numa pilha de implementação a partir de um template local, aplicar definições de negação a escopos filhos.

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 os recursos que não são mais gerenciados depois que a pilha é atualizada ou excluída.

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

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

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

O local para armazenar o resultado hipotético da pilha de implantação.

--name -n

O nome do resultado hipotético 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 e 30 dias.

--stack-id

O ID totalmente qualificado da pilha de implementação para realizar uma operação hipotética.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

O ID de referência de alteração relacionado 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 predefinido: False
--deny-settings-excluded-actions --ea

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

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

Lista de IDs principais do AAD excluídos do bloqueio. São permitidos até 5 princípios.

--deployment-resource-group --dr

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

--description

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

--no-color

Desative a cor nos resultados de 'e se' impressos de forma bonita.

--no-pretty-print

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

--no-wait

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

Propriedade Valor
Valor predefinido: False
--parameters -p

Os parâmetros podem ser fornecidos a partir de um ficheiro usando a @{path} sintaxe, uma string JSON ou em <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 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.

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

Define o que acontece aos recursos que não suportam eliminação quando deixam de ser geridos pela pilha.

Propriedade Valor
Valores aceites: detach, fail
--tags

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

--template-file -f

Um caminho para um ficheiro modelo ou ficheiro Bicep no sistema de ficheiros.

--template-spec -s

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

--template-uri -u

Um uri para um arquivo de modelo remoto.

--validation-level --vl

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

Propriedade Valor
Valores aceites: Provider, ProviderNoRbac, Template
Parâmetros de Globais
--debug

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor predefinido: False

az stack-whatif sub delete

Eliminar um resultado hipotético da pilha de implementação do âmbito da subscrição.

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

Exemplos

Apaga um resultado de 'e se' da pilha pelo nome.

az stack-whatif sub delete --name StackName

Apaga um resultado de 'e se' da pilha por ID de 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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

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

O ID de referência de alteração relacionado para esta operação de recurso.

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

O ID do recurso do resultado do "what-se" da pilha de implantação.

--name -n

O nome do resultado hipotético da pilha de implantação.

--yes

Não solicite confirmação.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor predefinido: False

az stack-whatif sub list

Liste todos os resultados hipotéticos da pilha de implementação numa subscrição.

az stack-whatif sub list

Exemplos

Liste todos os resultados do 'e se' da subscrição atual.

az stack-whatif sub list
Parâmetros de Globais
--debug

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor predefinido: False

az stack-whatif sub show

Obtenha um resultado hipotético da stack de implementação a partir do âmbito de subscrição.

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

Exemplos

Obtém um resultado de 'e se' de stack pelo nome.

az stack-whatif sub show --name ResultName

Obtém um stack de resultados hipotéticos por nome sem cor.

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

Obtenha JSON para o resultado de um stack what-if pelo nome.

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

Obtenha um resultado de 'e se' de stack por ID de 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 tornar-se necessários para que o comando seja executado com êxito.

--id

O ID do recurso do resultado do "what-se" da pilha de implantação.

--name -n

O nome do resultado hipotético da pilha de implantação.

--no-color

Desative a cor nos resultados de 'e se' impressos de forma bonita.

--no-pretty-print

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

--with-property-changes --wpc

Flag para devolver os resultados What-If com alterações de propriedades de recursos incluídas.

Propriedade Valor
Valores aceites: false, true
Parâmetros de Globais
--debug

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

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor predefinido: False