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

az stack sub

在订阅中管理部署堆栈。

命令

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

示例

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

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

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

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

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

--deployment-resource-group --dr

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

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

按堆栈资源 ID 删除堆栈。

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

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

导出用于创建部署堆栈的模板。

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

示例

按名称导出模板。

az stack sub export --name StackName

按堆栈资源 ID 导出模板。

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

可选参数

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

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

按堆栈资源 ID 获取堆栈。

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

可选参数

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

示例

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

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

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

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

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

--deployment-resource-group --dr

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

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