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

az stack group

管理资源组中的部署堆栈。

命令

名称 说明 类型 状态
az stack group create

在资源组范围内创建或更新部署堆栈。

核心 GA
az stack group delete

从资源组范围中删除指定的部署堆栈。

核心 GA
az stack group export

导出用于从资源组范围创建部署堆栈的模板。

核心 GA
az stack group list

列出资源组中的所有部署堆栈。

核心 GA
az stack group show

从资源组范围获取指定的部署堆栈。

核心 GA
az stack group validate

验证资源组范围内的部署堆栈。

核心 GA

az stack group create

在资源组范围内创建或更新部署堆栈。

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

示例

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

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

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

az stack group create --name StackName --resource-group ResourceGroup --action-on-unmanage detachAll --template-file simpleTemplate.json --parameters simpleTemplateParams.json --description description --deny-settings-mode None

使用模板规格创建部署堆栈,并删除非托管上的所有资源。

az stack group create --name StackName --resource-group ResourceGroup --action-on-unmanage deleteAll --template-spec TemplateSpecResourceIDWithVersion --description description --deny-settings-mode None

使用 bicep 文件创建部署堆栈。

az stack group create --name StackName --resource-group ResourceGroup --template-file simple.bicep --description description --deny-settings-mode None --action-on-unmanage deleteResources

在不同的订阅中创建部署堆栈。

az stack group create --name StackName --resource-group ResourceGroup --template-file simpleTemplate.json --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources

使用键/值对中的参数创建部署堆栈。

az stack group create --name StackName --template-file simpleTemplate.json --resource-group ResourceGroup --description description --parameters simpleTemplateParams.json value1=foo value2=bar --deny-settings-mode None --action-on-unmanage deleteResources

使用参数文件、远程参数文件以及选择性地重写键/值对,从本地模板创建部署堆栈。

az stack group create --name StackName --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

使用拒绝设置从本地模板创建部署堆栈。

az stack group create --name StackName --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

从本地模板创建部署堆栈,将拒绝设置应用于子范围。

az stack group create --name StackName --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

必需参数

--action-on-unmanage --aou

定义在更新或删除堆栈后不再管理的资源会发生什么情况。

接受的值: deleteAll, deleteResources, detachAll
--deny-settings-mode --dm

定义堆栈管理的资源上拒绝的操作。

接受的值: denyDelete, denyWriteAndDelete, none
--name -n

部署堆栈的名称。

--resource-group -g

将在其中创建部署堆栈的资源组。

可选参数

--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 个主体。

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

从资源组范围中删除指定的部署堆栈。

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

示例

按名称删除堆栈。

az stack group delete --name StackName --resource-group ResourceGroup --action-on-unmanage deleteResources

按堆栈资源 ID 删除堆栈。

az stack group delete --id /subscriptions/111111111111/resourceGroups/ResourceGroup/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

部署堆栈资源 ID。

--name -n

部署堆栈名称。

--resource-group -g

部署堆栈所在的资源组。

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

导出用于从资源组范围创建部署堆栈的模板。

az stack group export [--id]
                      [--name]
                      [--resource-group]

示例

按名称导出模板。

az stack group export --name StackName --resource-group ResourceGroup

按堆栈资源 ID 导出模板。

az stack group export --id /subscriptions/111111111111/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/StackName

可选参数

--id

部署堆栈资源 ID。

--name -n

部署堆栈名称。

--resource-group -g

部署堆栈所在的资源组。

全局参数
--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 group list

列出资源组中的所有部署堆栈。

az stack group list --resource-group

示例

列出资源组中的所有堆栈

az stack group list --resource-group ResourceGroup

必需参数

--resource-group -g

部署堆栈所在的资源组。

全局参数
--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 group show

从资源组范围获取指定的部署堆栈。

az stack group show [--id]
                    [--name]
                    [--resource-group]

示例

按名称获取堆栈。

az stack group show --name StackName --resource-group ResourceGroup

按堆栈资源 ID 获取堆栈。

az stack group show --id /subscriptions/111111111111/resourceGroups/ResourceGroup/providers/Microsoft.Resources/deploymentStacks/StackName

可选参数

--id

部署堆栈资源 ID。

--name -n

部署堆栈名称。

--resource-group -g

部署堆栈所在的资源组。

全局参数
--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 group validate

验证资源组范围内的部署堆栈。

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

示例

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

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

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

az stack group validate --name StackName --resource-group ResourceGroup --action-on-unmanage detachAll --template-file simpleTemplate.json --parameters simpleTemplateParams.json --description description --deny-settings-mode None

使用模板规格验证部署堆栈,并删除非托管上的所有资源。

az stack group validate --name StackName --resource-group ResourceGroup --action-on-unmanage deleteAll --template-spec TemplateSpecResourceIDWithVersion --description description --deny-settings-mode None

使用 bicep 文件验证部署堆栈。

az stack group validate --name StackName --resource-group ResourceGroup --template-file simple.bicep --description description --deny-settings-mode None --action-on-unmanage deleteResources

验证不同订阅中的部署堆栈。

az stack group validate --name StackName --resource-group ResourceGroup --template-file simpleTemplate.json --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources

使用键/值对中的参数验证部署堆栈。

az stack group validate --name StackName --template-file simpleTemplate.json --resource-group ResourceGroup --description description --parameters simpleTemplateParams.json value1=foo value2=bar --deny-settings-mode None --action-on-unmanage deleteResources

使用参数文件、远程参数文件以及选择性地重写键/值对,从本地模板验证部署堆栈。

az stack group validate --name StackName --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

使用拒绝设置从本地模板验证部署堆栈。

az stack group validate --name StackName --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

从本地模板验证部署堆栈,将拒绝设置应用于子范围。

az stack group validate --name StackName --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

必需参数

--action-on-unmanage --aou

定义在更新或删除堆栈后不再管理的资源会发生什么情况。

接受的值: deleteAll, deleteResources, detachAll
--deny-settings-mode --dm

定义堆栈管理的资源上拒绝的操作。

接受的值: denyDelete, denyWriteAndDelete, none
--name -n

部署堆栈的名称。

--resource-group -g

将在其中创建部署堆栈的资源组。

可选参数

--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 个主体。

--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 获取完整的调试日志。