az stack-whatif mg

管理部署堆疊在管理群組範圍內的假設結果。

命令

名稱	Description	類型	狀態
az stack-whatif mg create	在管理群組範圍內建立部署堆疊的假設結果。	Core	GA
az stack-whatif mg delete	刪除管理群組範圍中的部署堆疊假設結果。	Core	GA
az stack-whatif mg list	列出所有部署堆疊的假設結果，並建立管理群組。	Core	GA
az stack-whatif mg show	從管理群組範圍取得部署堆疊的假設結果。	Core	GA

az stack-whatif mg create

在管理群組範圍內建立部署堆疊的假設結果。

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

範例

用範本檔對部署堆疊執行假設，並分離所有未管理資源。

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

在部署堆疊上執行假設，並使用範本規範。

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 檔案對部署堆疊做假設，取消管理時刪除所有資源，並從輸出中移除顏色。

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

利用鍵值對的參數對部署堆疊執行假設。

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

從本地範本對部署堆疊執行假設假設，使用參數檔、遠端參數檔，並選擇性覆蓋鍵值對。

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

從本地範本對部署堆疊執行假設，並使用 deny 設定。

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

從本地範本對部署堆疊執行假設，對子範圍套用拒絕設定。

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

部署堆疊的「假設」結果存放位置。

--management-group-id -m

管理群組 ID 用於建立部署堆疊的假設結果。

--name -n

部署堆疊的名稱是假設結果。

--retention-interval --ri

What-If 的保留間隔結果。該數值必須符合 ISO 8601 格式，且期限介於 1 天至 30 天之間。

--stack-id

部署堆疊的完整限定識別碼，用於執行假設操作。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則令牌以進行此資源操作。

屬性	值
參數群組:	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 主體標識碼清單。最多允許5個主體。

--deployment-subscription --ds

應建立初始部署的範圍。如果未指定範圍，則會預設為部署堆疊的範圍。

--description

部署堆疊的描述。

--no-color

在漂亮印刷的假設結果中關閉顏色。

--no-pretty-print

停用 What-If 結果的美化列印。設定時，將會使用輸出格式類型。

--no-wait

請勿等候長時間執行的作業完成。

屬性	值
預設值:	False

--parameters -p

參數可透過語 @{path} 法、JSON 字串 <KEY=VALUE> 或成對從檔案中提供。參數會依序評估，因此當指派值兩次時，將會使用後者的值。建議您先提供參數檔案，然後使用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

範本規格資源標識碼。

--template-uri -u

遠端範本檔案的 URI。

--validation-level --vl

部署堆疊的驗證層級。預設是「提供者」。

屬性	值
接受的值:	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

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False