az stack-whatif sub

Administrar los resultados hipotáticos de implementación en el ámbito de la suscripción.

Comandos

Nombre	Description	Tipo	Estado
az stack-whatif sub create	Cree un resultado what-if de pila de implementación en el ámbito de la suscripción.	Core	GA
az stack-whatif sub delete	Elimine un resultado what-if de la pila de implementación del ámbito de la suscripción.	Core	GA
az stack-whatif sub list	Enumere todos los resultados de what-if de la pila de implementación en una suscripción.	Core	GA
az stack-whatif sub show	Obtenga un resultado hipot si de la pila de implementación del ámbito de la suscripción.	Core	GA

az stack-whatif sub create

Cree un resultado what-if de pila de implementación en el ámbito de la suscripción.

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

Ejemplos

Realice un what-if en una pila de implementación mediante el archivo de plantilla y desasocie todos los recursos de 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

Realice un what-if en una pila de implementación con el archivo de parámetros, elimine los recursos de unmanage y quite el color de la salida.

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

Realice un what-if en una pila de implementación con la especificación de plantilla.

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

Realice un what-if en una pila de implementación mediante el archivo bicep y elimine todos los recursos de 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

Realice un what-if en una pila de implementación en una suscripción 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

Realice una operación what-if en una pila de implementación e implemente en el ámbito del 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

Realice un what-if en una pila de implementación mediante parámetros de pares clave-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

Realice una operación hipotético en una pila de implementación desde una plantilla local, mediante un archivo de parámetros, un archivo de parámetros remotos y invalide de forma selectiva pares clave-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

Realice un what-if en una pila de implementación desde una plantilla local mediante la configuración de denegación.

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

Realice un what-if en una pila de implementación desde una plantilla local y aplique la configuración de denegación a los ámbitos secundarios.

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 requeridos

--action-on-unmanage --aou

Define lo que sucede con los recursos que ya no se administran después de actualizar o eliminar la pila.

Propiedad	Valor
Valores aceptados:	deleteAll, deleteResources, detachAll

--deny-settings-mode --dm

Defina qué operaciones se deniegan en los recursos administrados por la pila.

Propiedad	Valor
Valores aceptados:	denyDelete, denyWriteAndDelete, none

--location -l

Ubicación para almacenar el resultado de what-if de la pila de implementación.

--name -n

El nombre de la pila de implementación what-if result.

--retention-interval --ri

Intervalo de retención para los resultados de What-If. El valor debe estar en formato ISO 8601 y entre 1 día y 30 días.

--stack-id

Identificador completo de la pila de implementación en el que se va a realizar una operación hipotética.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--cs --deny-settings-apply-to-child-scopes

DenySettings se aplicará a los ámbitos secundarios.

Propiedad	Valor
Valor predeterminado:	False

--deny-settings-excluded-actions --ea

Lista de operaciones de administración basadas en roles que se excluyen de denySettings. Se permiten hasta 200 acciones.

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

Lista de identificadores de entidad de seguridad de AAD excluidos del bloqueo. Se permiten hasta 5 entidades de seguridad.

--deployment-resource-group --dr

Ámbito en el que se debe crear la implementación inicial. Si no se especifica un ámbito, el valor predeterminado será el ámbito de la pila de implementación.

--description

Descripción de la pila de implementación.

--no-color

Deshabilite el color en resultados what-if impresos.

--no-pretty-print

Deshabilite la impresión bonita para los resultados de What-If. Cuando se establece, se usará el tipo de formato de salida.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--parameters -p

Los parámetros se pueden proporcionar desde un archivo mediante la @{path} sintaxis, una cadena JSON o como <KEY=VALUE> pares. Los parámetros se evalúan en orden, por lo que cuando se asigna un valor dos veces, se usará el último valor. Se recomienda proporcionar primero el archivo de parámetros y, a continuación, invalidar selectivamente mediante la sintaxis KEY=VALUE.

--query-string -q

Cadena de consulta (un token de SAS) que se va a usar con el URI de plantilla en el caso de las plantillas vinculadas.

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

Define lo que ocurre con los recursos que no admiten la eliminación cuando la pila ya no los administra.

Propiedad	Valor
Valores aceptados:	detach, fail

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--template-file -f

Ruta de acceso a un archivo de plantilla o Bicep archivo en el sistema de archivos.

--template-spec -s

Identificador de recurso de especificación de plantilla.

--template-uri -u

Identificador URI de un archivo de plantilla remoto.

--validation-level --vl

Nivel de validación de la pila de implementación. El valor predeterminado es "Provider".

Propiedad	Valor
Valores aceptados:	Provider, ProviderNoRbac, Template

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az stack-whatif sub delete

Elimine un resultado what-if de la pila de implementación del ámbito de la suscripción.

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

Ejemplos

Elimine un resultado what-if de pila por nombre.

az stack-whatif sub delete --name StackName

Elimine un resultado what-if de pila por identificador de recurso.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--id

Id. de recurso de resultado de la pila de implementación.

--name -n

El nombre de la pila de implementación what-if result.

--yes

No solicitar confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az stack-whatif sub list

Enumere todos los resultados de what-if de la pila de implementación en una suscripción.

az stack-whatif sub list

Ejemplos

Enumere todos los resultados de la pila what-if de la suscripción actual.

az stack-whatif sub list

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az stack-whatif sub show

Obtenga un resultado hipot si de la pila de implementación del ámbito de la suscripción.

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

Ejemplos

Obtiene un resultado hipotárquido de pila por nombre.

az stack-whatif sub show --name ResultName

Obtiene un resultado what-if de pila por nombre sin color.

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

Obtenga JSON para un resultado what-if de pila por nombre.

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

Obtenga un resultado what-if de pila por identificador de recurso.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--id

Id. de recurso de resultado de la pila de implementación.

--name -n

El nombre de la pila de implementación what-if result.

--no-color

Deshabilite el color en resultados what-if impresos.

--no-pretty-print

Deshabilite la impresión bonita para los resultados de What-If. Cuando se establece, se usará el tipo de formato de salida.

--with-property-changes --wpc

Marca para devolver los resultados del What-If con los cambios de propiedad de recursos incluidos.

Propiedad	Valor
Valores aceptados:	false, true

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Formato de salida.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False