az stack-whatif mg

管理グループスコープでデプロイスタックの What-If の結果を管理します。

コマンド

Name	説明	型	状態
az stack-whatif mg create	管理グループスコープでデプロイスタックの what-if の結果を作成します。	Core	GA
az stack-whatif mg delete	デプロイスタックの what-if の結果を管理グループスコープから削除します。	Core	GA
az stack-whatif mg list	すべてのデプロイスタックの what-if 結果を管理グループに一覧表示します。	Core	GA
az stack-whatif mg show	管理グループスコープからデプロイスタックの what-if の結果を取得します。	Core	GA

az stack-whatif mg create

管理グループスコープでデプロイスタックの what-if の結果を作成します。

az stack-whatif mg create --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
                          --deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
                          --location
                          --management-group-id
                          --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-subscription --ds]
                          [--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}]

例

テンプレートファイルを使用してデプロイスタックで What-If を実行し、すべてのアンマネージドリソースをデタッチします。

az stack-whatif mg create --name StackName --management-group-id myMg --template-file simpleTemplate.json --parameters simpleTemplateParams.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll --ri P5D --stack-id /providers/Microsoft.Management/myMg/providers/Microsoft.Resources/deploymentStacks/myMgStack

テンプレートスペックを使用してデプロイスタックで what-if を実行します。

az stack-whatif mg create --name StackName --management-group-id myMg --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /providers/Microsoft.Management/myMg/providers/Microsoft.Resources/deploymentStacks/myMgStack

bicep ファイルを使用してデプロイスタックで what-if を実行し、アンマネージドのすべてのリソースを削除し、出力から色を削除します。

az stack-whatif mg create --name StackName --management-group-id myMg --no-color --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None --ri P5D --stack-id /providers/Microsoft.Management/myMg/providers/Microsoft.Resources/deploymentStacks/myMgStack

キーと値のペアのパラメーターを使用して、デプロイスタックで what-if を実行します。

az stack-whatif mg create --name StackName --management-group-id myMg --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 /providers/Microsoft.Management/myMg/providers/Microsoft.Resources/deploymentStacks/myMgStack

パラメーターファイル、リモートパラメーターファイル、およびキーと値のペアを選択的にオーバーライドして、ローカルテンプレートからデプロイスタックで what-if を実行します。

az stack-whatif mg create --name StackName --management-group-id myMg --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 /providers/Microsoft.Management/myMg/providers/Microsoft.Resources/deploymentStacks/myMgStack

拒否設定を使用して、ローカルテンプレートからデプロイスタックで What-If を実行します。

az stack-whatif mg create --name StackName --management-group-id myMg --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 /providers/Microsoft.Management/myMg/providers/Microsoft.Resources/deploymentStacks/myMgStack

ローカルテンプレートからデプロイスタックで what-if を実行し、子スコープに拒否設定を適用します。

az stack-whatif mg create --name StackName --management-group-id myMg --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 /providers/Microsoft.Management/myMg/providers/Microsoft.Resources/deploymentStacks/myMgStack

必須パラメーター

--action-on-unmanage --aou

スタックの更新または削除後に管理されなくなったリソースに対する動作を定義します。

プロパティ	値
指定可能な値:	deleteAll, deleteResources, detachAll

--deny-settings-mode --dm

スタックによって管理されるリソースに対して拒否される操作を定義します。

プロパティ	値
指定可能な値:	denyDelete, denyWriteAndDelete, none

--location -l

デプロイスタックの what-if 結果を格納する場所。

--management-group-id -m

デプロイスタックの what-if 結果を作成する管理グループ ID。

--name -n

デプロイスタックの what-if 結果の名前。

--retention-interval --ri

What-If 結果の保持間隔。値は ISO 8601 形式で、1 日から 30 日の間である必要があります。

--stack-id

What-If 操作を実行するデプロイスタックの完全修飾 ID。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ	値
パラメーターグループ:	Global Policy Arguments

--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ	値
パラメーターグループ:	Global Policy Arguments

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

DenySettings は子スコープに適用されます。

プロパティ	値
規定値:	False

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

denySettings から除外されるロールベースの管理操作の一覧。最大 200 個のアクションが許可されます。

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

ロックから除外された AAD プリンシパル ID の一覧。最大 5 つのプリンシパルが許可されます。

--deployment-subscription --ds

初期デプロイを作成するスコープ。スコープが指定されていない場合、既定ではデプロイスタックのスコープになります。

--description

デプロイスタックの説明。

--no-color

綺麗に印刷された what-if の結果で色を無効にします。

--no-pretty-print

What-If 結果のプリプリントを無効にします。設定すると、出力形式の種類が使用されます。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
規定値:	False

--parameters -p

パラメーターは、 @{path} 構文、JSON 文字列、または <KEY=VALUE> ペアを使用してファイルから指定できます。パラメーターは順番に評価されるため、値が 2 回割り当てられると、後者の値が使用されます。最初にパラメーターファイルを指定してから、KEY=VALUE 構文を使用して選択的にオーバーライドすることをお勧めします。

--query-string -q

リンクされたテンプレートの場合に template-uri と共に使用されるクエリ文字列 (SAS トークン)。

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

削除をサポートしていないリソースがスタックによって管理されなくなった場合の動作を定義します。

プロパティ	値
指定可能な値:	detach, fail

--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

--template-file -f

ファイルシステム内のテンプレートファイルまたはBicep ファイルへのパス。

--template-spec -s

テンプレートスペックのリソース ID。

--template-uri -u

リモートテンプレートファイルの URI。

--validation-level --vl

デプロイスタックの検証レベル。既定値は "Provider" です。

プロパティ	値
指定可能な値:	Provider, ProviderNoRbac, Template

グローバルパラメーター

--debug

ログの詳細度を上げて、すべてのデバッグログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプメッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。完全なデバッグログには --debug を使用します。

プロパティ	値
規定値:	False