通过

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

az blueprint assignment

  • 中断性变更

Note

此参考是 Azure CLI（版本 2.50.0 或更高版本）的 蓝图 扩展的一部分。 该扩展将在首次运行 az blueprint assignment 命令时自动安装。 了解更多关于扩展的信息。

此命令组已隐式弃用，因为命令组“az blueprint”已弃用，将在将来的版本中删除。 蓝图和关联的命令最早将于 2026 年 7 月弃用。 我们鼓励客户在此日期之后过渡到模板规范和部署堆栈，以支持他们的使用场景。 迁移文档在 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint提供。

用于管理蓝图分配的命令。

命令

名称 说明 类型 Status
az blueprint assignment create

创建蓝图分配。

 Extension GA
az blueprint assignment delete

删除蓝图分配。

 Extension Preview
az blueprint assignment list

列出订阅中的蓝图分配。

 Extension Preview
az blueprint assignment show

获取蓝图分配。

 Extension Preview
az blueprint assignment update

更新蓝图分配。

 Extension GA
az blueprint assignment wait

将 CLI 置于等待状态，直到满足蓝图分配的条件。

 Extension GA
az blueprint assignment who

获取 Blueprint Servie 主体名称 objectId。

 Extension Preview

az blueprint assignment create

中断性变更

蓝图和关联的命令最早将于 2026 年 7 月弃用。 我们鼓励客户在此日期之后过渡到模板规范和部署堆栈，以支持他们的使用场景。 迁移文档在 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint提供。 此命令已隐式弃用，因为命令组“az blueprint”已弃用，将在将来的版本中删除。

创建蓝图分配。

az blueprint assignment create --name
                               [--blueprint-version]
                               [--description]
                               [--display-name]
                               [--identity-type {None, SystemAssigned, UserAssigned}]
                               [--location]
                               [--locks-excluded-principals]
                               [--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
                               [--management-group]
                               [--parameters]
                               [--resource-group-value]
                               [--subscription]
                               [--user-assigned-identity]

示例

使用系统分配的托管标识进行分配

az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type SystemAssigned \
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/provid \
ers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=westus \
--resource-group-value artifact_name=rg-art-2 name=rg2 location=eastus \
--parameters "path/to/parameter/file" \

使用用户分配的托管标识进行分配

az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type UserAssigned \
--user-assigned-identity "/subscriptions/00000000-0000-0000-0000-000000000000 \
/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"\
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup \
/providers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=eastus \
--parameters "path/to/parameter/file" \

必需参数

--name -n

蓝图分配的名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--blueprint-version

蓝图定义的已发布版本的资源 ID。

--description

多行说明此资源。

--display-name

单行字符串解释此资源。

--identity-type

托管标识的类型。

属性 值
参数组: Identity Arguments
默认值: SystemAssigned
接受的值: None, SystemAssigned, UserAssigned
--location -l

Location. az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--locks-excluded-principals

从蓝图锁中排除的 AAD 主体列表。 最多允许 5 个主体。

--locks-mode

锁定模式。

属性 值
接受的值: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

将管理组用于蓝图分配的目标范围。 它保留供将来使用。 请改用 --subscription。

属性 值
参数组: Resource_scope Arguments
--parameters -p

蓝图分配参数值。 它可以是 JSON 字符串或 JSON 文件路径。

--resource-group-value

资源组的键=值对。 键包括“artifact_name”（必需）、“name”、“location”。

--subscription -s

将订阅用于蓝图分配的目标范围。 如果未指定选项，将使用默认 susbcription。

属性 值
参数组: Resource_scope Arguments
--user-assigned-identity

与资源关联的用户分配的托管标识。

属性 值
参数组: Identity Arguments
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

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

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

--verbose

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

属性 值
默认值: False

az blueprint assignment delete

预览 中断性变更

此命令处于预览阶段，正在开发中。 参考和支持级别：https://aka.ms/CLI_refstatus

蓝图和关联的命令最早将于 2026 年 7 月弃用。 我们鼓励客户在此日期之后过渡到模板规范和部署堆栈，以支持他们的使用场景。 迁移文档在 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint提供。 此命令已隐式弃用，因为命令组“az blueprint”已弃用，将在将来的版本中删除。

删除蓝图分配。

az blueprint assignment delete --name
                               [--delete-behavior {all, none}]
                               [--management-group]
                               [--subscription]
                               [--yes]

示例

删除分配

az blueprint assignment delete --subscription MySubscription --name MyBlueprintAssignment

必需参数

--name -n

蓝图分配的名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--delete-behavior

deleteBehavior=all 时，将删除蓝图分配创建的资源。

属性 值
接受的值: all, none
--management-group -m

将管理组用于蓝图的范围。

属性 值
参数组: Resource_scope Arguments
--subscription -s

将订阅用于蓝图的范围。 如果未指定 --management-group，则 --subscription 值或默认订阅将用作范围。

属性 值
参数组: Resource_scope Arguments
--yes -y

不要提示确认。

属性 值
默认值: False
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

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

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

--verbose

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

属性 值
默认值: False

az blueprint assignment list

预览 中断性变更

此命令处于预览阶段，正在开发中。 参考和支持级别：https://aka.ms/CLI_refstatus

蓝图和关联的命令最早将于 2026 年 7 月弃用。 我们鼓励客户在此日期之后过渡到模板规范和部署堆栈，以支持他们的使用场景。 迁移文档在 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint提供。 此命令已隐式弃用，因为命令组“az blueprint”已弃用，将在将来的版本中删除。

列出订阅中的蓝图分配。

az blueprint assignment list [--management-group]
                             [--max-items]
                             [--next-token]
                             [--subscription]

示例

列出作业

az blueprint assignment list --subscription MySubscription

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--management-group -m

将管理组用于蓝图的范围。

属性 值
参数组: Resource_scope Arguments
--max-items

命令输出中要返回的项总数。 如果可用的项总数大于指定的值，则会在命令的输出中提供令牌。 若要恢复分页，请在后续命令的 --next-token 参数中提供令牌值。

属性 值
参数组: Pagination Arguments
--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

属性 值
参数组: Pagination Arguments
--subscription -s

将订阅用于蓝图的范围。 如果未指定 --management-group，则 --subscription 值或默认订阅将用作范围。

属性 值
参数组: Resource_scope Arguments
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

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

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

--verbose

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

属性 值
默认值: False

az blueprint assignment show

预览 中断性变更

此命令处于预览阶段，正在开发中。 参考和支持级别：https://aka.ms/CLI_refstatus

蓝图和关联的命令最早将于 2026 年 7 月弃用。 我们鼓励客户在此日期之后过渡到模板规范和部署堆栈，以支持他们的使用场景。 迁移文档在 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint提供。 此命令已隐式弃用，因为命令组“az blueprint”已弃用，将在将来的版本中删除。

获取蓝图分配。

az blueprint assignment show --name
                             [--management-group]
                             [--subscription]

示例

显示工作分配

az blueprint assignment show --subscription MySubscription --name MyBlueprintAssignment

必需参数

--name -n

蓝图分配的名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--management-group -m

将管理组用于蓝图的范围。

属性 值
参数组: Resource_scope Arguments
--subscription -s

将订阅用于蓝图的范围。 如果未指定 --management-group，则 --subscription 值或默认订阅将用作范围。

属性 值
参数组: Resource_scope Arguments
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

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

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

--verbose

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

属性 值
默认值: False

az blueprint assignment update

中断性变更

蓝图和关联的命令最早将于 2026 年 7 月弃用。 我们鼓励客户在此日期之后过渡到模板规范和部署堆栈，以支持他们的使用场景。 迁移文档在 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint提供。 此命令已隐式弃用，因为命令组“az blueprint”已弃用，将在将来的版本中删除。

更新蓝图分配。

az blueprint assignment update --name
                               [--blueprint-version]
                               [--description]
                               [--display-name]
                               [--identity-type {None, SystemAssigned, UserAssigned}]
                               [--location]
                               [--locks-excluded-principals]
                               [--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
                               [--management-group]
                               [--parameters]
                               [--resource-group-value]
                               [--subscription]
                               [--user-assigned-identity]

必需参数

--name -n

蓝图分配的名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--blueprint-version

蓝图定义的已发布版本的资源 ID。

--description

多行说明此资源。

--display-name

单行字符串解释此资源。

--identity-type

托管标识的类型。

属性 值
参数组: Identity Arguments
接受的值: None, SystemAssigned, UserAssigned
--location -l

Location. az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--locks-excluded-principals

从蓝图锁中排除的 AAD 主体列表。 最多允许 5 个主体。

--locks-mode

锁定模式。

属性 值
接受的值: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

将管理组用于蓝图分配的目标范围。 它保留供将来使用。 请改用 --subscription。

属性 值
参数组: Resource_scope Arguments
--parameters -p

蓝图分配参数值。 它可以是 JSON 字符串或 JSON 文件路径。

--resource-group-value

资源组的键=值对。 键包括“artifact_name”（必需）、“name”、“location”。

--subscription -s

将订阅用于蓝图分配的目标范围。 如果未指定选项，将使用默认 susbcription。

属性 值
参数组: Resource_scope Arguments
--user-assigned-identity

与资源关联的用户分配的托管标识。

属性 值
参数组: Identity Arguments
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

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

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

--verbose

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

属性 值
默认值: False

az blueprint assignment wait

中断性变更

蓝图和关联的命令最早将于 2026 年 7 月弃用。 我们鼓励客户在此日期之后过渡到模板规范和部署堆栈，以支持他们的使用场景。 迁移文档在 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint提供。 此命令已隐式弃用，因为命令组“az blueprint”已弃用，将在将来的版本中删除。

将 CLI 置于等待状态，直到满足蓝图分配的条件。

az blueprint assignment wait --name
                             [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--interval]
                             [--management-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

示例

暂停执行下一行 CLI 脚本，直到蓝图分配成功预配。

az blueprint assignment wait --subscription MySubscription \ --name MyBlueprintAssignment --created

必需参数

--name -n

蓝图分配的名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--created

等待在“Succeeded”中使用“provisioningState”创建。

属性 值
参数组: Wait Condition Arguments
默认值: False
--custom

等待条件满足自定义 JMESPath 查询。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

属性 值
参数组: Wait Condition Arguments
--deleted

等到删除为止。

属性 值
参数组: Wait Condition Arguments
默认值: False
--exists

等待资源存在。

属性 值
参数组: Wait Condition Arguments
默认值: False
--interval

轮询间隔（以秒为单位）。

属性 值
参数组: Wait Condition Arguments
默认值: 30
--management-group -m

将管理组用于蓝图分配的目标范围。 它保留供将来使用。 请改用 --subscription。

属性 值
参数组: Resource_scope Arguments
--subscription -s

将订阅用于蓝图分配的目标范围。 如果未指定选项，将使用默认 susbcription。

属性 值
参数组: Resource_scope Arguments
--timeout

最大等待（以秒为单位）。

属性 值
参数组: Wait Condition Arguments
默认值: 3600
--updated

等到 provisioningState 更新为“Succeeded”。

属性 值
参数组: Wait Condition Arguments
默认值: False
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

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

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

--verbose

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

属性 值
默认值: False

az blueprint assignment who

预览 中断性变更

此命令处于预览阶段，正在开发中。 参考和支持级别：https://aka.ms/CLI_refstatus

蓝图和关联的命令最早将于 2026 年 7 月弃用。 我们鼓励客户在此日期之后过渡到模板规范和部署堆栈，以支持他们的使用场景。 迁移文档在 https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint提供。 此命令已隐式弃用，因为命令组“az blueprint”已弃用，将在将来的版本中删除。

获取 Blueprint Servie 主体名称 objectId。

az blueprint assignment who --name
                            [--management-group]
                            [--subscription]

示例

获取 SPN objectId

az blueprint assignment who --subscription MySubscription --name MyBlueprintAssignment

必需参数

--name -n

蓝图分配的名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--management-group -m

将管理组用于蓝图的范围。

属性 值
参数组: Resource_scope Arguments
--subscription -s

将订阅用于蓝图的范围。 如果未指定 --management-group，则 --subscription 值或默认订阅将用作范围。

属性 值
参数组: Resource_scope Arguments
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

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

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

--verbose

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

属性 值
默认值: False