SharePoint 代理上的见解报表

2025-06-24

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

见解报表是一项SharePoint 高级管理功能，在组织中提供SharePoint 高级管理加载项 SKU 或智能 Microsoft 365 Copilot 副驾驶®许可证。见解报告基于通过 FileCreated 和 FileRenamed 事件为 SharePoint 代理记录的Microsoft审核数据。

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

在 SharePoint 管理员中心中创建和查看 SharePoint 代理见解报表

使用 SharePoint 管理员凭据登录 SharePoint 管理员 Center 后，可以创建和查看 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 高级版 - 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 统一的审核数据生成，可能不会涵盖所有审核事件。

通过