az stack-whatif sub

管理部署堆疊，在訂閱範圍內呈現假設結果。

命令

名稱	Description	類型	狀態
az stack-whatif sub create	在訂閱範圍內建立部署堆疊的假設結果。	Core	GA
az stack-whatif sub delete	刪除一個部署堆疊的「如果」結果，來自訂閱範圍。	Core	GA
az stack-whatif sub list	列出所有部署堆疊的假設結果，匯聚於訂閱結果。	Core	GA
az stack-whatif sub show	根據訂閱範圍取得部署堆疊的假設結果。	Core	GA

az stack-whatif sub create

在訂閱範圍內建立部署堆疊的假設結果。

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

範例

用範本檔對部署堆疊執行假設，然後在 unmanaged 中移除所有資源。

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

用參數檔對部署堆疊做假設，取消管理時刪除資源，並從輸出中移除顏色。

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

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

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

用 bicep 檔案對部署堆疊做假設，然後在取消管理時刪除所有資源。

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

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

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

在部署堆疊上執行假設，並在資源群組範圍內部署。

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

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

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

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

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

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

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

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

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

必要參數

--action-on-unmanage --aou

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

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

--deny-settings-mode --dm

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

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

--location -l

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

--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-resource-group --dr

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

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