SharePoint 代理上的见解报表

2025-10-20

SharePoint 代理上的见解报表为 SharePoint 管理员提供了有关组织中所有 SharePoint 网站和 OneDrive 网站中最近创建的 SharePoint 代理的丰富信息。此报表使管理员能够了解创建代理数最多的站点。使用此报表，SharePoint 管理员可以进一步治理和维护代理用作地面数据的内容的完整性。

见解报告基于通过 FileCreated 和 FileRenamed 事件为 SharePoint 代理记录的Microsoft审核数据。

可以在 SharePoint 管理员中心或使用 SharePoint Online 命令行管理程序生成和管理 SharePoint 代理见解报表。

访问 SharePoint 代理见解报表需要什么

若要访问本文中讨论的功能，组织必须满足特定的许可和管理要求。

许可证要求是什么？

若要使用此功能，组织必须具有以下基本许可证之一：

Office 365 E3、E5 或 A5
Microsoft 365 E1、E3、E5 或 A5

此外，至少需要以下许可证之一：

Microsoft 365 Copilot 许可证： 至少必须为组织中的一个用户分配 Copilot 许可证， (此用户不需要是 sharePoint 管理员) 。
Microsoft SharePoint 高级管理许可证：作为独立购买提供。

管理员要求

您必须是 SharePoint 管理员或具有等效权限。

其他信息

如果你的组织具有 Copilot 许可证，并且至少为组织中的一个人分配了 Copilot 许可证，SharePoint 管理员会自动获得对 Copilot 部署所需的SharePoint 高级管理功能的访问权限。 Copilot 中未包含的唯一SharePoint 高级管理功能是受限网站创建。

对于没有 Copilot 许可证的组织，可以通过购买独立的SharePoint 高级管理许可证来使用SharePoint 高级管理功能。

如何在 SharePoint 管理员中心访问 SharePoint 代理见解报表

使用组织的 SharePoint 管理员凭据登录到 SharePoint 管理中心。
在左窗格中，展开 “报表 ”，然后选择“ 代理见解”。

如何在 SharePoint 管理员中心中创建报表

使用 SharePoint 管理员的权限，可以通过选择“创建报表” 来创建报表。
提供“报告名称”，并在“报告持续时间”下指定报表的时间范围。
选择“ 创建并运行”。

注意

可以创建过去 1 天、7 天、14 天或 28 天的报表。

在 SharePoint 管理员中心查看报表状态

若要检查报表是否已准备就绪或上次更新，请参阅“状态”列。

报表状态的屏幕截图。

在 SharePoint 管理员中心查看报表

报表准备就绪后，选择它以查看数据。可以查看托管最多代理数的前 100 条记录。可以搜索站点或筛选网站模板和治理策略。

视图报表的屏幕截图。

在 SharePoint 管理员中心应用内容治理策略

可以从见解报表对网站应用内容治理策略。可用的策略包括 “限制网站访问策略 ”和 “限制内容发现策略”。

应用 RCD 的屏幕截图。

注意

从见解报表将策略应用到站点后，现有报表上的策略状态不会更新。若要查看网站上策略的更新状态，请选择策略以查看最新状态或访问“活动网站”面板并查看网站设置。

SharePoint Online 命令行管理程序中的 SharePoint 代理见解报表

可以使用 SharePoint Online 命令行管理程序生成和管理 SharePoint 代理见解报表。

如果尚未安装，请下载并安装最新版本的 SharePoint Online 命令行管理程序。
至少以 Microsoft 365 中的 SharePoint 管理员身份连接到 SharePoint Online。有关详细信息，请参阅 SharePoint Online 命令行管理程序入门。
若要生成和查看这些报告，请确保组织具有SharePoint 高级管理加载项 SKU 或 Microsoft 365 Copilot 许可证。

至少具有 SharePoint 管理员的权限，可以使用以下命令生成和查看见解报告：

若要生成一天默认报告持续时间的报告，请运行命令：
```
Start-SPOCopilotAgentInsightsReport
```
若要生成任何其他持续时间 (7、14 或 28 天) 的报告，请运行命令：
```
Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays
```
例如，若要生成过去 28 天的报告，请运行命令：
```
Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays <28>
```
若要检查所有活动报表和可用报表的状态，请运行命令：
```
Get-SPOCopilotAgentInsightsReport
```
若要检查特定报表的状态，请运行命令：
```
Get-SPOCopilotAgentInsightsReport –ReportId
```
若要下载并查看报表，请运行命令：
```
Get-SPOCopilotAgentInsightsReport –ReportId -Action Download
```
注意

PowerShell 最多显示 100 条记录，但下载的报表最多可以包含 100 万条记录。
```
Get-SPOCopilotAgentInsightsReport –ReportId -Action View
```
若要查看进一步的详细报告，可以使用以下选项：

a. CopilotAgentsOnSites：提供所有站点上当前可用的所有代理的名称。此报表最多包含 1,000,000 条记录。

注意

参数的 -Content 默认值为 CopilotAgentsOnSites。
```
Get-SPOCopilotAgentInsightsReport –ReportId -Content CopilotAgentsOnSites
```
b. TopSites：提供包含 100 个站点的列表，其中包含每个站点上可用的代理数。
```
Get-SPOCopilotAgentInsightsReport –ReportId -Content TopSites
```
c. SiteDistribution：提供跨所有类型的网站（例如通信网站、Microsoft 365 组连接站点、OneDrive 站点等）的代理的汇总视图。
```
Get-SPOCopilotAgentInsightsReport –ReportId -Content SiteDistribution
```

见解报表的数据收集

重要

如果没有Microsoft SharePoint 高级管理许可证，系统会要求你启用数据收集，以便产品开始收集相关审核数据以生成此报告。启用后，可以在 24 小时后生成报表，并包含来自收集点的数据。数据存储 28 天。如果三个月中甚至一次未生成任何报告，则数据收集将暂停并应再次启用。

启用数据收集

此 PowerShell 命令开始收集过去 28 天内有关活动的报表的审核数据。

Start-SPOAuditDataCollectionForActivityInsights

禁用数据收集

此 PowerShell 命令停止收集过去 28 天内活动报告的审核数据。


Stop-SPOAuditDataCollectionForActivityInsights

检查数据收集状态

启用数据收集后，可以在 24 小时后生成报告。若要检查是否可以生成报表，请使用 PowerShell 命令 Get-SPOAuditDataCollectionStatusForActivityInsights。该命令返回当前数据收集状态，可以是“NotInitiated”、“InProgress”、“Paused”。状态为“InProgress”时，可以生成报告。

Get-SPOAuditDataCollectionStatusForActivityInsights

SharePoint 代理见解报表的已知体验

以下是 SharePoint 管理员中心或使用 SharePoint Online 命令行管理程序生成的 SharePoint 代理见解报表的一些已知体验：

报表只能在自上次生成报告以来的 24 小时后重新运行。
在大型租户中，数据可能需要长达 48 小时才能可用。
) (1、7、14 或 28 天，每个报表范围值只能存在一个报表。这意味着在给定点最多可以看到四个报表。
新生成的报表将以前创建的报表替换为同一日期范围。若要保留以前创建的报表，请先下载报表，然后再为同一日期范围创建新报表。
这些报告使用 Microsoft 365 统一的审核数据生成，可能不会涵盖所有审核事件。

反馈

此页面是否有帮助？