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
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 |
Defina quais operações são negadas em recursos gerenciados pela pilha.
| Propriedade | Valor |
|---|---|
| Valores aceites: | denyDelete, denyWriteAndDelete, none |
O local para armazenar o resultado hipotético da pilha de implantação.
O nome do resultado hipotético da pilha de implantação.
O intervalo de retenção para What-If resultados. O valor deve estar no formato ISO 8601 e entre 1 e 30 dias.
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.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
DenySettings será aplicado a escopos filho.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Lista de operações de gerenciamento baseadas em função que são excluídas do denySettings. São permitidas até 200 ações.
Lista de IDs principais do AAD excluídos do bloqueio. São permitidos até 5 princípios.
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.
A descrição da pilha de implantação.
Desative a cor nos resultados de 'e se' impressos de forma bonita.
Desative a impressão bonita para What-If resultados. Quando definido, o tipo de formato de saída será usado.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
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.
A cadeia de caracteres de consulta (um token SAS) a ser usada com o template-uri no caso de modelos vinculados.
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 separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.
Um caminho para um ficheiro modelo ou ficheiro Bicep no sistema de ficheiros.
A id do recurso de especificação do modelo.
Um uri para um arquivo de modelo remoto.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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.
Aquisição automática de um token Azure Policy para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID de referência de alteração relacionado para esta operação de recurso.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Global Policy Arguments |
O ID do recurso do resultado do "what-se" da pilha de implantação.
O nome do resultado hipotético da pilha de implantação.
Não solicite confirmação.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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.
O ID do recurso do resultado do "what-se" da pilha de implantação.
O nome do resultado hipotético da pilha de implantação.
Desative a cor nos resultados de 'e se' impressos de forma bonita.
Desative a impressão bonita para What-If resultados. Quando definido, o tipo de formato de saída será usado.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor predefinido: | False |