Power Platform 清单

Power Platform 清单为租户管理员提供了跨组织在 Power Platform 上构建的所有代理、应用和流的统一视图。 管理员可以发现、搜索、筛选和排序这些资源，以简化常见的管理任务。

通过使用 Power Platform 清单，可以轻松完成以下任务：

• 发现你的冠军：快速确定谁正在创建最多的资源，以便你能够识别、培养和增强顶级创新者的能力。

• 强制实施符合性标准：毫不费力地检测在未批准的区域中创建的资源，以保持遵守组织策略。

• 专注治理：按资源计数对环境进行排名，以集中安全性、治理和合规性工作重点。

• 防止孤立代理：主动查找离开用户拥有的资源，以允许无缝所有权转移并确保业务连续性。

• 加速支持：即时定位支持工单中提及的大海捞针般的资源，大幅提升响应速度。

支持的资源类型

Power Platform 清单包括：

• 代理： 在 Copilot Studio 中创建的所有代理，以及 智能 Microsoft 365 Copilot 副驾驶® 代理生成器中创建的所有代理。

• 应用程序： 在 Power Apps（画布、模型驱动、代码和氛围）和 智能 Microsoft 365 Copilot 副驾驶® 的应用生成器代理中创建的所有应用。

• 流： 在 Copilot Studio 中创建的所有代理流、在 Power Automate 中创建的所有云流，以及 智能 Microsoft 365 Copilot 副驾驶® 工作流代理中创建的所有工作流。

• 环境： 租户中的所有环境。

• 环境组： 租户中的所有环境组。

主要功能

• 统一清单：所有资源的集中视图。

• 快速更新：创建、更新或删除的资源显示在 15 分钟内。

• 灵活的筛选和排序：按任何属性（包括环境组）筛选和排序资源。

• 库存计数：立即查看符合条件的项目总数。

• 可自定义列：通过选择要显示的列来定制视图。

• 资源详细信息：访问每个资源的详细信息。

• 下载：将库存导出到 Excel 进行进一步分析。

访问要求

若要查看 Power Platform 清单，必须拥有以下租户范围的管理角色之一：Power Platform 管理员或Dynamics 365 管理员。 如果没有这些角色之一，则无法访问清单。

如何访问 Power Platform 清单

可以通过多个接口和 API 访问 Power Platform 清单。 通过使用这些选项，可以将清单数据集成到所选工作流和工具中。 以下部分列出了访问清单数据的主要方法。

Power Platform 管理中心用户界面

• 管理 > 清单：主清单页提供租户中所有资源的统一视图。

• 管理 > Copilot Studio： 代理（Copilot Studio + 智能 Microsoft 365 Copilot 副驾驶® Agent Builder）、代理流和工作流。

• 管理 > Power Apps > 应用清单选项卡：画布、模型驱动、代码、氛围和应用生成器应用。

• 管理 > Power Automate > 流清单选项卡：云流。

有关编程访问选项，请参阅本文后面的 编程访问 。

应用筛选器和排序

借助 Power Platform 清单，可以使用任何列或属性筛选和排序所有资源数据。 可以将多个筛选器组合使用，以精准锁定所需资源，无论是跟踪特定应用程序还是分析环境中的趋势。 在优化条件时，始终会看到匹配资源的总计数直接显示在左上角的资源表上方，从而轻松测量筛选数据集的大小。

例如，可以合并多个筛选器以缩小结果范围。 你添加的每个筛选器都是累积的：

1. 环境类型：选择 “环境类型 ”列，然后选择“ 默认”。 可在默认环境中看到所有资源。

2. 所有者：选择 “所有者 ”列并键入人员的姓名。 可以在默认环境中看到此人拥有的所有资源。

3. 创建日期：选择列 上的“创建 ”，并将日期筛选器从 2025 年 1 月应用到今天的日期。 你将在默认环境中看到此人拥有的所有资源，这些资源是在 2025 年创建的。

若要清除所有筛选器和排序，请选择任意列，然后选择 “清除所有筛选器”。

显示更多列

清单表提供了显示更多列的选项，以帮助你更好地管理所有资源。 若要自定义显示的列，请完成以下步骤。

1. 选择“搜索”框旁边的“添加或删除列”图标。

2. 选择或取消选择要显示或隐藏的列。

搜索库存

快速搜索清单表中当前加载的所有条目中的关键字。 使用 “搜索 ”框可帮助你快速查找特定资源。

查看资源详细信息

• 选择资源，然后在命令栏中选择“ 详细信息 ”选项。

• 选择资源的显示名称，以在 Copilot Studio、Power Apps 或 Power Automate 门户中重定向到其详细信息页面。

  注释

  需要足够的权限才能访问资源详细信息页。 如果没有权限，你会看到 此链接已损坏 错误。

• 选择环境名称以查看环境详细信息。

Power Platform 清单与其他 Microsoft 管理界面的关系

Microsoft提供了多个显示代理的管理界面，你可能会注意到这些界面上的代理数量有所不同。 每个图面为不同的受众提供服务，显示不同类型的代理，并回答不同的问题。 了解这些不同有助于理解您在组织中看到的代理数量。

Power Platform 库存与 Microsoft 365 管理中心

Microsoft 365 管理中心显示可供租户中的用户使用的代理。 此视图包括 Microsoft 的第一方代理、第三方 ISV 代理以及您发布或共享的组织创建的代理。 在 Microsoft 365 管理中心中创建的组织代理来自多个创建平台，包括 Teams 应用商店平台、代理工具包、Foundry、Fabric、SharePoint 等。 它充当员工可访问的所有内容的目录。

相比之下，Power Platform 清单仅显示 Power Platform 上生成的代理。 这包括在 Copilot Studio 中创建的已发布代理和草稿代理，或智能 Microsoft 365 Copilot 副驾驶® 代理生成器。 它不包括第一方 Microsoft 代理、ISV 代理或在其他 Microsoft 平台上创建的代理。

因此，这两个界面中的智能体数量存在差异。 Microsoft 365 管理中心包含组织未生成的代理。 如果这些代理处于草稿形式且尚未发布，则 Power Platform 清单可能包括未显示在 Microsoft 365 管理中心的代理。

差异摘要

已知的限制

• 经典聊天机器人： 新的清单页不包括经典聊天机器人。 但是，仍可以通过选择 “管理>Copilot Studio>经典聊天机器人”来找到它们。

• 环境名称：按环境筛选时，需要使用完整的环境名称。 部分匹配或子字符串无效。

• Azure 资源管理器的多重身份验证（MFA）要求：Power Platform 清单需要访问 Azure 资源管理器以获取资源信息。 如果组织需要通过 Azure 资源管理器的条件访问策略进行 MFA，则清单可能不会加载。 若要解决此问题，请与 Entra ID 管理员协作，将 Power Platform 管理中心应用程序（客户端 ID： 00b46ad5-e4ae-43ac-a878-281fc03d0839）和 Microsoft Azure 管理 资源包含在 MFA 条件访问策略中。

• 修改时间和最后修改人列：这些列对智能体无效，并显示 –（连字符）字符。

• 所有者 列：云流和代理流的此列当前显示创建流的用户。 当所有者更改时，它不会更新。

• 未发布的模型驱动应用：仅捕获已发布的模型驱动应用。

• 默认环境中的模型驱动应用： 默认环境附带三个预安装的模型驱动应用：Power Platform 环境设置、Power Pages 管理和解决方案运行状况中心。 除非编辑并重新发布这些应用，否则这些应用最初不会显示在清单中。

• 主权云：Power Platform 库存目前不适用于美国政府社区云（GCC、GCC-High 和 DoD）、21Vianet（中国）或物理隔离环境。

程序化访问

Power Platform 清单数据以编程方式提供，支持自动化、报告和与外部工具集成等高级方案。 有关资源类型及其字段的完整列表，请参阅 Power Platform 清单架构参考。

Power Platform for Admins V2 连接器

可以使用Power Platform for Admins V2 连接器，直接从 Power Automate 查询 Power Platform 的清单数据。 使用 查询 Power Platform 资源 操作针对清单运行查询，并将结果添加到自动化工作流。

Power Platform API（电源平台应用程序接口）

如果你不熟悉 Power Platform API，请参阅 Power Platform API 入门 ，了解设置说明和身份验证详细信息。 设置 API 后，请参阅 清单 API 文档 ，了解如何查询库存数据。

Azure Resource Graph

可以使用 Azure Resource Graph（ARG）以编程方式查询 Power Platform 清单。 可以通过多个 Azure 接口访问 ARG 查询。 有关分步说明，请参阅以下 Azure Resource Graph 快速入门指南：

• 使用 Azure 门户运行 Resource Graph 查询

• 使用 Azure CLI 运行 Resource Graph 查询

• 使用 Azure PowerShell 运行 Resource Graph 查询

• 使用 REST API 运行 Azure Resource Graph 查询

示例查询

下面是可与任何 Azure Resource Graph 接口一起使用的示例查询。 所有查询都使用 PowerPlatformResources 表，其中包含组织的清单数据。

查询：所有资源的总数

PowerPlatformResources
| count

查询：按资源类型统计的总计数

PowerPlatformResources
| summarize resourceCount = count() by type
| order by resourceCount

查询：发现资源类型的可用字段

随着新数据字段的添加，清单架构会随着时间推移而变化。 使用此查询可查看特定资源类型的所有可用字段。 建议使用此查询来随时了解可用数据。

// Discover all available fields for Copilot Studio agents
PowerPlatformResources
| where type == "microsoft.copilotstudio/agents"
| take 1
// Parse the properties bag
| extend properties = parse_json(properties)
// Pack the base fields into a bag for expansion
| extend baseFields = pack("id", id, "location", location, "name", name, "tenantId", tenantId, "type", type)
| extend key = bag_keys(baseFields)
| mv-expand key to typeof(string)
| project FieldName = key, SampleValue = baseFields[key], Source = "base"
// Union with the extended properties
| union (
    PowerPlatformResources
    | where type == "microsoft.copilotstudio/agents"
    | take 1
    | extend properties = parse_json(properties)
    | extend key = bag_keys(properties)
    | mv-expand key to typeof(string)
    | project FieldName = key, SampleValue = properties[key], Source = "properties"
)
// Sort base fields first, then properties
| order by Source asc, FieldName asc

若要发现其他资源类型的字段，请替换 type 筛选器值。 例如：

查询：按环境计数（跨环境的库存分布）

PowerPlatformResources
| extend properties = parse_json(properties)
| extend environmentId = tostring(properties.environmentId)
| summarize resourceCount = count() by environmentId
| order by resourceCount desc

查询：按区域计数（跨区域库存分布）

PowerPlatformResources
| summarize resourceCount = count() by location
| order by resourceCount desc

查询：项目数量最多的所有者

PowerPlatformResources
| extend properties = parse_json(properties)
| extend ownerId = tostring(properties.ownerId)
| summarize resourceCount = count() by ownerId
| order by resourceCount desc

查询：在租户中查找单个代理

PowerPlatformResources
| where type == "microsoft.copilotstudio/agents"
| where name == "[Enter the agent's ID]"

查询：在过去 24 小时内创建的项

PowerPlatformResources
| extend properties = parse_json(properties)
| extend createdAt = todatetime(properties.createdAt)
| where createdAt >= ago(24h)