az stack-whatif group

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

命令

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

az stack-whatif group create

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

az stack-whatif group create --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
                             --deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
                             --name
                             --resource-group
                             --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]
                             [--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 group create --name ResultName --resource-group ResourceGroup --action-on-unmanage deleteResources --template-file simpleTemplate.json --description description --deny-settings-mode None --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/mySubStack

在部署堆疊上執行一個假設，使用參數檔，解除管理時將所有資源分離，並將顏色從輸出中移除。

az stack-whatif group create --name ResultName --resource-group ResourceGroup --no-color --action-on-unmanage detachAll --template-file simpleTemplate.json --parameters simpleTemplateParams.json --description description --deny-settings-mode None --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/mySubStack

在部署堆疊上執行一個假設，並設定範本規範，然後在 unmanaged 時刪除所有資源。

az stack-whatif group create --name ResultName --resource-group ResourceGroup --action-on-unmanage deleteAll --template-spec TemplateSpecResourceIDWithVersion --description description --deny-settings-mode None --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/mySubStack

用 bicep 檔案對部署堆疊執行假設。

az stack-whatif group create --name ResultName --resource-group ResourceGroup --template-file simple.bicep --description description --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/mySubStack

在另一個訂閱的部署堆疊上做假設。

az stack-whatif group create --name ResultName --resource-group ResourceGroup --template-file simpleTemplate.json --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/mySubStack

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

az stack-whatif group create --name ResultName --template-file simpleTemplate.json --resource-group ResourceGroup --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/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/mySubStack

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

az stack-whatif group create --name ResultName --template-file azuredeploy.json --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json --resource-group ResourceGroup --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/mySubStack

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

az stack-whatif group create --name ResultName --resource-group ResourceGroup --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-excluded-principals "test1 test2" --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/mySubStack

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

az stack-whatif group create --name ResultName --resource-group ResourceGroup --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-apply-to-child-scopes --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/mySubStack

必要參數

--action-on-unmanage --aou

定義在更新或刪除堆疊之後不再管理的資源會發生什麼事。

屬性	值
接受的值:	deleteAll, deleteResources, detachAll

--deny-settings-mode --dm

定義堆疊所管理資源上拒絕哪些作業。

屬性	值
接受的值:	denyDelete, denyWriteAndDelete, none

--name -n

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

--resource-group -g

建立部署堆疊假設結果的資源群組。

--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個主體。

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