az stack mg

參考

管理管理群組中的部署堆疊。

命令

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

az stack mg create

在管理群組範圍建立或更新部署堆疊。

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

範例

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

az stack mg create --name StackName --management-group-id myMg --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll

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

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

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

az stack mg create --name StackName --management-group-id myMg --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources

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

az stack mg create --name StackName --management-group-id myMg --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

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

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

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

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

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

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

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

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

必要參數

--action-on-unmanage --aou

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

接受的值: deleteAll, deleteResources, detachAll

--deny-settings-mode --dm

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

接受的值: denyDelete, denyWriteAndDelete, none

--location -l

儲存部署堆疊的位置。

--management-group-id -m

要建立堆疊的管理群組標識碼。

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

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

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

從管理群組範圍中刪除指定的部署堆疊。

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

範例

依名稱刪除堆疊。

az stack mg delete --name StackName --management-group-id myMg --action-on-unmanage detachAll

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

az stack mg delete --id /providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/StackName --management-group-id myMg --action-on-unmanage deleteAll

必要參數

--action-on-unmanage --aou

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

接受的值: deleteAll, deleteResources, detachAll

--management-group-id -m

要建立堆疊的管理群組標識碼。

選擇性參數

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

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

az stack mg export --management-group-id
                   [--id]
                   [--name]

範例

依名稱匯出範本。

az stack mg export --name StackName --management-group-id myMg

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

az stack mg export --id /providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/StackName --management-group-id myMg

必要參數

--management-group-id -m

要建立堆疊的管理群組標識碼。

選擇性參數

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

列出管理群組中的所有部署堆疊。

az stack mg list --management-group-id

範例

列出所有堆疊

az stack mg list --management-group-id myMg

必要參數

--management-group-id -m

要建立堆疊的管理群組標識碼。

全域參數

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

從管理群組範圍取得指定的部署堆疊。

az stack mg show --management-group-id
                 [--id]
                 [--name]

範例

依名稱取得堆疊。

az stack mg show --name StackName --management-group-id myMg

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

az stack mg show --id /providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/StackName --management-group-id myMg

必要參數

--management-group-id -m

要建立堆疊的管理群組標識碼。

選擇性參數

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

驗證管理群組範圍的部署堆疊。

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

範例

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

az stack mg validate --name StackName --management-group-id myMg --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll

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

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

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

az stack mg validate --name StackName --management-group-id myMg --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources

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

az stack mg validate --name StackName --management-group-id myMg --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

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

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

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

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

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

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

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

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

必要參數

--action-on-unmanage --aou

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

接受的值: deleteAll, deleteResources, detachAll

--deny-settings-mode --dm

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

接受的值: denyDelete, denyWriteAndDelete, none

--location -l

儲存部署堆疊的位置。

--management-group-id -m

要建立堆疊的管理群組標識碼。

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

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

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

命令

az stack mg create

範例

必要參數

選擇性參數

az stack mg delete

範例

必要參數

選擇性參數

az stack mg export

範例

必要參數

選擇性參數

az stack mg list

範例

必要參數

az stack mg show

範例

必要參數

選擇性參數

az stack mg validate

範例

必要參數

選擇性參數

其他資源