az stack-whatif sub

Gérer les résultats des piles de déploiement au niveau de l’étendue de l’abonnement.

Commandes

Nom Description Type État
az stack-whatif sub create

Créez un résultat de la pile de déploiement dans l’étendue de l’abonnement.

Core GA
az stack-whatif sub delete

Supprimez une pile de déploiement qui résulte de l’étendue de l’abonnement.

Core GA
az stack-whatif sub list

Répertorier toutes les fonctionnalités de la pile de déploiement aboutit à un abonnement.

Core GA
az stack-whatif sub show

Obtenez un résultat de la pile de déploiement à partir de l’étendue de l’abonnement.

Core GA

az stack-whatif sub create

Créez un résultat de la pile de déploiement dans l’étendue de l’abonnement.

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

Exemples

Effectuez une procédure sur une pile de déploiement à l’aide d’un fichier de modèle et détachez toutes les ressources sur 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

Effectuez une procédure sur une pile de déploiement avec un fichier de paramètres, supprimez des ressources sur unmanage et supprimez la couleur de la sortie.

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

Effectuez une procédure sur une pile de déploiement avec des spécifications de modèle.

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

Effectuez une procédure sur une pile de déploiement à l’aide du fichier bicep et supprimez toutes les ressources sur 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

Effectuez une procédure sur une pile de déploiement à un autre abonnement.

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

Effectuez une procédure sur une pile de déploiement et déployez au niveau de l’étendue du groupe de ressources.

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

Effectuez une procédure sur une pile de déploiement à l’aide de paramètres de paires clé/valeur.

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

Effectuez une procédure sur une pile de déploiement à partir d’un modèle local, à l’aide d’un fichier de paramètres, d’un fichier de paramètres distant et de substitution sélective de paires clé/valeur.

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

Effectuez une procédure sur une pile de déploiement à partir d’un modèle local, à l’aide des paramètres de refus.

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

Effectuez une procédure sur une pile de déploiement à partir d’un modèle local, appliquez des paramètres de refus aux étendues enfants.

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

Paramètres obligatoires

--action-on-unmanage --aou

Définit ce qui se passe pour les ressources qui ne sont plus gérées après la mise à jour ou la suppression de la pile.

Propriété Valeur
Valeurs acceptées: deleteAll, deleteResources, detachAll
--deny-settings-mode --dm

Définissez les opérations refusées sur les ressources gérées par la pile.

Propriété Valeur
Valeurs acceptées: denyDelete, denyWriteAndDelete, none
--location -l

Emplacement pour stocker le résultat de la pile de déploiement.

--name -n

Nom du résultat de la pile de déploiement.

--retention-interval --ri

Intervalle de rétention des résultats What-If. La valeur doit être au format ISO 8601 et entre 1 jour et 30 jours.

--stack-id

ID complet de la pile de déploiement pour effectuer une opération de simulation.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--cs --deny-settings-apply-to-child-scopes

DenySettings sera appliqué aux étendues enfants.

Propriété Valeur
Valeur par défaut: False
--deny-settings-excluded-actions --ea

Liste des opérations de gestion basées sur les rôles qui sont exclues des denySettings. Jusqu’à 200 actions sont autorisées.

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

Liste des ID de principal AAD exclus du verrou. Jusqu’à 5 principaux sont autorisés.

--deployment-resource-group --dr

Étendue à laquelle le déploiement initial doit être créé. Si aucune étendue n’est spécifiée, elle est définie par défaut sur l’étendue de la pile de déploiement.

--description

Description de la pile de déploiement.

--no-color

Désactivez la couleur dans les résultats de type what-if assez imprimés.

--no-pretty-print

Désactivez l’impression jolie pour les résultats What-If. Lorsqu’il est défini, le type de format de sortie est utilisé.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--parameters -p

Les paramètres peuvent être fournis à partir d’un fichier à l’aide de la @{path} syntaxe, d’une chaîne JSON ou en tant que <KEY=VALUE> paires. Les paramètres sont évalués dans l’ordre. Par conséquent, lorsqu’une valeur est affectée deux fois, la dernière valeur sera utilisée. Il est recommandé de fournir d’abord votre fichier de paramètres, puis de remplacer de manière sélective à l’aide de la syntaxe KEY=VALUE.

--query-string -q

Chaîne de requête (jeton SAP) à utiliser avec l’URI de modèle dans le cas de modèles liés.

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

Définit ce qui se passe pour les ressources qui ne prennent pas en charge la suppression lorsqu’elles ne sont plus gérées par la pile.

Propriété Valeur
Valeurs acceptées: detach, fail
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--template-file -f

Chemin d’accès à un fichier de modèle ou Bicep fichier dans le système de fichiers.

--template-spec -s

ID de ressource de spécification du modèle.

--template-uri -u

Uri d’un fichier de modèle distant.

--validation-level --vl

Niveau de validation pour la pile de déploiement. La valeur par défaut est « Provider ».

Propriété Valeur
Valeurs acceptées: Provider, ProviderNoRbac, Template
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az stack-whatif sub delete

Supprimez une pile de déploiement qui résulte de l’étendue de l’abonnement.

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

Exemples

Supprimez un résultat de pile par nom.

az stack-whatif sub delete --name StackName

Supprimez un résultat de pile par ID de ressource.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--id

ID de ressource de résultat de la pile de déploiement.

--name -n

Nom du résultat de la pile de déploiement.

--yes

Ne pas demander de confirmation.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az stack-whatif sub list

Répertorier toutes les fonctionnalités de la pile de déploiement aboutit à un abonnement.

az stack-whatif sub list

Exemples

Répertoriez toutes les piles qui affichent les résultats de l’abonnement actuel.

az stack-whatif sub list
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az stack-whatif sub show

Obtenez un résultat de la pile de déploiement à partir de l’étendue de l’abonnement.

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

Exemples

Obtenez un résultat de pile par nom.

az stack-whatif sub show --name ResultName

Obtenez un résultat de pile par nom sans couleur.

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

Obtenez JSON pour un résultat de pile par nom.

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

Obtenez un résultat de pile par ID de ressource.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--id

ID de ressource de résultat de la pile de déploiement.

--name -n

Nom du résultat de la pile de déploiement.

--no-color

Désactivez la couleur dans les résultats de type what-if assez imprimés.

--no-pretty-print

Désactivez l’impression jolie pour les résultats What-If. Lorsqu’il est défini, le type de format de sortie est utilisé.

--with-property-changes --wpc

Indicateur pour renvoyer les résultats What-If avec les modifications apportées aux propriétés de ressource incluses.

Propriété Valeur
Valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False