az stack sub

參考

管理訂用帳戶的部署堆疊。

命令

名稱	Description	類型	狀態
az stack sub create	在訂用帳戶範圍建立或更新部署堆疊。	核心	GA
az stack sub delete	從訂用帳戶範圍中刪除指定的部署堆疊。	核心	GA
az stack sub export	匯出用來建立部署堆疊的範本。	核心	GA
az stack sub list	列出訂用帳戶中的所有部署堆疊。	核心	GA
az stack sub show	從訂用帳戶範圍取得指定的部署堆疊。	核心	GA
az stack sub validate	驗證訂用帳戶範圍的部署堆疊。	核心	GA

az stack sub create

在訂用帳戶範圍建立或更新部署堆疊。

az stack sub create --action-on-unmanage {deleteAll, deleteResources, detachAll}
                    --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                    --location
                    --name
                    [--bse {false, true}]
                    [--cs]
                    [--deny-settings-excluded-actions]
                    [--deny-settings-excluded-principals]
                    [--deployment-resource-group]
                    [--description]
                    [--no-wait]
                    [--parameters]
                    [--query-string]
                    [--tags]
                    [--template-file]
                    [--template-spec]
                    [--template-uri]
                    [--yes]

範例

使用範本檔案建立部署堆疊，並在 Unmanage 上中斷連結所有資源。

az stack sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll

使用參數檔案建立部署堆疊，並在 Unmanage 上刪除資源。

az stack sub create --name StackName --action-on-unmanage deleteResources --template-file simpleTemplate.json --parameters simpleTemplateParams.json --location westus2 --description description --deny-settings-mode None

使用範本規格建立部署堆疊。

az stack sub create --name StackName --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources

使用 bicep 檔案建立部署堆疊，並刪除 Unmanage 上的所有資源。

az stack sub create --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

在不同的訂用帳戶上建立部署堆疊。

az stack sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources

建立部署堆疊，並在資源群組範圍進行部署。

az stack sub create --name StackName --template-file simpleTemplate.json --location westus --deployment-resource-group ResourceGroup --description description --deny-settings-mode None --action-on-unmanage deleteResources

使用索引鍵/值組的參數建立部署堆疊。

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

使用參數檔案、遠端參數檔案，以及選擇性地覆寫索引鍵/值組，從本機範本建立部署堆疊。

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

使用拒絕設定，從本機範本建立部署堆疊。

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

從本機範本建立部署堆疊，將拒絕設定套用至子範圍。

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

必要參數

--action-on-unmanage --aou

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

接受的值: deleteAll, deleteResources, detachAll

--deny-settings-mode --dm

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

接受的值: denyDelete, denyWriteAndDelete, none

--location -l

儲存部署堆疊的位置。

--name -n

部署堆疊的名稱。

選擇性參數

--bse --bypass-stack-out-of-sync-error

旗標以略過指出堆疊資源清單未正確同步處理的服務錯誤。

接受的值: false, true

預設值: False

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

拒絕設定會套用至子範圍。

預設值: False

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

從拒絕排除的角色型管理作業清單設定。最多允許 200 個動作。

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

從鎖定排除的 AAD 主體標識碼清單。最多允許5個主體。

--deployment-resource-group --dr

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

--description

部署堆疊的描述。

--no-wait

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

預設值: False

--parameters -p

您可以使用語法、JSON 字串或 <KEY=VALUE> 組，從檔案@{path}提供參數。參數會依序評估，因此當指派值兩次時，將會使用後者的值。建議您先提供參數檔案，然後使用KEY=VALUE語法選擇性地覆寫。

--query-string -q

在連結範本的情況下，要與 template-uri 搭配使用的查詢字串（SAS 令牌）。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用「清除現有的標記」。

--template-file -f

文件系統中範本檔案或 Bicep 檔案的路徑。

--template-spec -s

範本規格資源標識碼。

--template-uri -u

遠端範本檔案的 URI。

--yes

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az stack sub delete

從訂用帳戶範圍中刪除指定的部署堆疊。

az stack sub delete --action-on-unmanage {deleteAll, deleteResources, detachAll}
                    [--bse {false, true}]
                    [--id]
                    [--name]
                    [--yes]

範例

依名稱刪除堆疊。

az stack sub delete --name StackName --action-on-unmanage deleteResources

依堆疊資源標識碼刪除堆疊。

az stack sub delete --id /subscriptions/111111111111/providers/Microsoft.Resources/deploymentStacks/StackName --action-on-unmanage detachAll

必要參數

--action-on-unmanage --aou

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

接受的值: deleteAll, deleteResources, detachAll

選擇性參數

--bse --bypass-stack-out-of-sync-error

旗標以略過指出堆疊資源清單未正確同步處理的服務錯誤。

接受的值: false, true

預設值: False

--id

部署堆疊資源標識碼。

--name -n

部署堆疊名稱。

--yes

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az stack sub export

匯出用來建立部署堆疊的範本。

az stack sub export [--id]
                    [--name]

範例

依名稱匯出範本。

az stack sub export --name StackName

依堆疊資源標識碼匯出範本。

az stack sub export --id /subscriptions/111111111111/providers/Microsoft.Resources/deploymentStacks/StackName

選擇性參數

--id

部署堆疊資源標識碼。

--name -n

部署堆疊名稱。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az stack sub list

列出訂用帳戶中的所有部署堆疊。

az stack sub list

範例

列出所有堆疊

az stack sub list

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az stack sub show

從訂用帳戶範圍取得指定的部署堆疊。

az stack sub show [--id]
                  [--name]

範例

依名稱取得堆疊。

az stack sub show --name StackName

依堆疊資源標識碼取得堆疊。

az stack sub show --id /subscriptions/111111111111/providers/Microsoft.Resources/deploymentStacks/StackName

選擇性參數

--id

部署堆疊資源標識碼。

--name -n

部署堆疊名稱。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az stack sub validate

驗證訂用帳戶範圍的部署堆疊。

az stack sub validate --action-on-unmanage {deleteAll, deleteResources, detachAll}
                      --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                      --location
                      --name
                      [--bse {false, true}]
                      [--cs]
                      [--deny-settings-excluded-actions]
                      [--deny-settings-excluded-principals]
                      [--deployment-resource-group]
                      [--description]
                      [--parameters]
                      [--query-string]
                      [--tags]
                      [--template-file]
                      [--template-spec]
                      [--template-uri]

範例

使用範本檔案驗證部署堆疊，並中斷連結 Unmanage 上的所有資源。

az stack sub validate --name StackName --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll

使用參數檔案驗證部署堆疊，並刪除 Unmanage 上的資源。

az stack sub validate --name StackName --action-on-unmanage deleteResources --template-file simpleTemplate.json --parameters simpleTemplateParams.json --location westus2 --description description --deny-settings-mode None

使用範本規格驗證部署堆疊。

az stack sub validate --name StackName --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources

使用 bicep 檔案驗證部署堆疊，並刪除 Unmanage 上的所有資源。

az stack sub validate --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

在不同的訂用帳戶上驗證部署堆疊。

az stack sub validate --name StackName --template-file simpleTemplate.json --location westus2 --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources

驗證部署堆疊，並在資源群組範圍進行部署。

az stack sub validate --name StackName --template-file simpleTemplate.json --location westus --deployment-resource-group ResourceGroup --description description --deny-settings-mode None --action-on-unmanage deleteResources

使用索引鍵/值組的參數來驗證部署堆疊。

az stack sub validate --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

使用參數檔案、遠端參數檔案，以及選擇性地覆寫索引鍵/值組，從本機範本驗證部署堆疊。

az stack sub validate --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

使用拒絕設定，從本機範本驗證部署堆疊。

az stack sub validate --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

從本機範本驗證部署堆疊，將拒絕設定套用至子範圍。

az stack sub validate --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

必要參數

--action-on-unmanage --aou

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

接受的值: deleteAll, deleteResources, detachAll

--deny-settings-mode --dm

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

接受的值: denyDelete, denyWriteAndDelete, none

--location -l

儲存部署堆疊的位置。

--name -n

部署堆疊的名稱。

選擇性參數

--bse --bypass-stack-out-of-sync-error

旗標以略過指出堆疊資源清單未正確同步處理的服務錯誤。

接受的值: false, true

預設值: False

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

拒絕設定會套用至子範圍。

預設值: False

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

從拒絕排除的角色型管理作業清單設定。最多允許 200 個動作。

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

從鎖定排除的 AAD 主體標識碼清單。最多允許5個主體。

--deployment-resource-group --dr

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

--description

部署堆疊的描述。

--parameters -p

--query-string -q

在連結範本的情況下，要與 template-uri 搭配使用的查詢字串（SAS 令牌）。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用「清除現有的標記」。

--template-file -f

文件系統中範本檔案或 Bicep 檔案的路徑。

--template-spec -s

範本規格資源標識碼。

--template-uri -u

遠端範本檔案的 URI。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

共用方式為

az stack sub

命令

az stack sub create

範例

必要參數

選擇性參數

az stack sub delete

範例

必要參數

選擇性參數

az stack sub export

範例

選擇性參數

az stack sub list

範例

az stack sub show

範例

選擇性參數

az stack sub validate

範例

必要參數

選擇性參數

其他資源