你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az stack mg

管理组中的部署堆栈。

命令

名称 说明 类型 状态
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]

示例

使用模板文件创建部署堆栈,并分离非托管上的所有资源。

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

使用参数文件创建部署堆栈,并删除非托管上的资源。

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 文件创建部署堆栈,并删除非托管上的所有资源。

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

要创建堆栈的管理组 ID。

--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 主体 ID 的列表。 最多允许 5 个主体。

--deployment-subscription --ds

应在其中创建初始部署的范围。 如果未指定范围,则默认为部署堆栈的范围。

--description

部署堆栈的说明。

--no-wait

不等待长时间运行的操作完成。

默认值: False
--parameters -p

可以使用语法、JSON 字符串或 <KEY=VALUE> 对从文件@{path}提供参数。 参数按顺序计算,因此在为值分配两次时,将使用后一个值。 建议先提供参数文件,然后使用 KEY=VALUE 语法选择性地替代参数文件。

--query-string -q

在链接模板的情况下,要与模板 URI 一起使用的查询字符串(SAS 令牌)。

--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

--template-file -f

文件系统中模板文件或 Bicep 文件的路径。

--template-spec -s

模板规格资源 ID。

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

订阅的名称或 ID。 可以使用 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

按堆栈资源 ID 删除堆栈。

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

要创建堆栈的管理组 ID。

可选参数

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

用于绕过指示堆栈资源列表未正确同步的服务错误的标志。

接受的值: false, true
默认值: False
--id

部署堆栈资源 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

订阅的名称或 ID。 可以使用 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

按堆栈资源 ID 导出模板。

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

必需参数

--management-group-id -m

要创建堆栈的管理组 ID。

可选参数

--id

部署堆栈资源 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

订阅的名称或 ID。 可以使用 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

要创建堆栈的管理组 ID。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 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

按堆栈资源 ID 获取堆栈。

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

必需参数

--management-group-id -m

要创建堆栈的管理组 ID。

可选参数

--id

部署堆栈资源 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

订阅的名称或 ID。 可以使用 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]

示例

使用模板文件验证部署堆栈,并分离非托管上的所有资源。

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

使用参数文件验证部署堆栈,并删除非托管上的资源。

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 文件验证部署堆栈,并删除非托管上的所有资源。

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

要创建堆栈的管理组 ID。

--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 主体 ID 的列表。 最多允许 5 个主体。

--deployment-subscription --ds

应在其中创建初始部署的范围。 如果未指定范围,则默认为部署堆栈的范围。

--description

部署堆栈的说明。

--parameters -p

可以使用语法、JSON 字符串或 <KEY=VALUE> 对从文件@{path}提供参数。 参数按顺序计算,因此在为值分配两次时,将使用后一个值。 建议先提供参数文件,然后使用 KEY=VALUE 语法选择性地替代参数文件。

--query-string -q

在链接模板的情况下,要与模板 URI 一起使用的查询字符串(SAS 令牌)。

--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

--template-file -f

文件系统中模板文件或 Bicep 文件的路径。

--template-spec -s

模板规格资源 ID。

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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。