Get-SPOCopilotAgentInsightsReport
此 cmdlet 使管理员能够在没有报表 ID 时检查所有活动报表和可用报表的状态，以及查看或下载报表 ID（如果存在报表 ID）。
注意
与此 cmdlet 关联的功能即将推出。
语法
Get-SPOCopilotAgentInsightsReport
[-ReportId <Guid>]
[-Content <SPOCopilotAgentInsightType>]
[-Action <ActionType>] 说明
如果执行此 cmdlet 时不带任何参数，则会显示具有以下属性的所有活动报表和已完成报表的状态：
| 属性 | 说明 |
|---|---|
| Id | 报表的唯一 ID。 |
| CreatedDateTimeInUtc | 触发报表创建时的 UTC 日期和时间。 |
| 状态 | 报表的状态。 |
| ReportPeriodInDays | 报告持续时间（天）。 |
注意
根据数据访问治理，所有报表都遵循任何保留时间线。
示例
-----------------------示例 1-----------------------------
Get-SPOCopilotAgentInsightsReport示例 1 使管理员能够查看所有活动报表和已完成报表的状态。
-----------------------示例 2-----------------------------
Get-SPOCopilotAgentInsightsReport -ReportId 9d946216-afe7-49f5-8267-7b662435c70b示例 2 使管理员能够查看 ReportId 的 Copilot 代理见解报告： 9d946216-afe7-49f5-8267-7b662435c70b。
-----------------------示例 3-----------------------------
Get-SPOCopilotAgentInsightsReport - ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Action Download示例 3 使管理员能够将 ReportId 的 9d946216-afe7-49f5-8267-7b662435c70b Copilot 代理见解报告下载到运行命令的同一路径。
参数
-Action
它确定是查看还是下载报表。 如果 的值 -Action 设置为 View，它将在 PowerShell 屏幕上显示输出。 否则，如果 的值 -Action 设置为 Download，则会将 CSV 格式的完整报表下载到运行命令的同一路径。
| 类型: | ActionType |
| Position: | Named |
| 默认值: | View |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | SharePoint Online |
-Content
它指定要查看或下载的报表类型。 子报表有 3 种：CopilotAgentsOnSites、TopSites、SiteDistribution。
如果此 cmdlet 作为 -ContentCopilotAgentsOnSites执行，则将显示一个报告，其中包含创建 Copilot 代理的所有站点的列表，以及指定天数中创建的 Copilot 代理的名称，并具有以下属性：
| 属性 | 说明 |
|---|---|
| 网站名称 | SharePoint 网站的名称。 |
| URL | SharePoint 网站的 URL。 |
| 模板 | SharePoint 网站的网站模板。 |
| 网站所有者 | SharePoint 网站所有者的名称。 |
| Copilot 名称 | SharePoint 网站上的 Copilot 代理的名称。 |
| 敏感度 | SharePoint 网站的敏感度标签。 |
| 限制已启用站点访问 | (SharePoint 网站的“是/否”) 限制网站访问状态。 |
| 限制启用站点发现 | 将网站发现状态限制 (SharePoint 网站的“是”/“否”) 。 |
| 外部共享 | 外部共享状态 (SharePoint 网站的“是/否”) 。 |
如果此 cmdlet 以 -ReportId 作为 参数 和 -Content 的形式 TopSites执行，则会显示具有下列属性的前 100 条记录，这些记录汇总了在指定天数内创建的站点上的 Copilot 代理数：
| 属性 | 说明 |
|---|---|
| 网站名称 | SharePoint 网站的名称。 |
| URL | SharePoint 网站的 URL。 |
| 模板 | SharePoint 网站的网站模板。 |
| 网站所有者 | SharePoint 网站所有者的名称。 |
| Copilot 代理 | SharePoint 网站上的 Copilot 代理数。 |
| 敏感度 | SharePoint 网站的敏感度标签。 |
| 限制已启用站点访问 | (SharePoint 网站的“是/否”) 限制网站访问状态。 |
| 限制启用站点发现 | 将网站发现状态限制 (SharePoint 网站的“是”/“否”) 。 |
| 外部共享 | 外部共享状态 (SharePoint 网站的“是/否”) 。 |
如果使用 作为 参数 和 -ContentSiteDistribution执行-ReportId此 cmdlet，则会显示一个报告，其中显示了在指定天数内跨站点分布的 Copilot 分布情况，并具有以下属性：
| 属性 | 说明 |
|---|---|
| 网站模板 | SharePoint 网站的网站模板。 |
| 网站 | 对应于该特定网站模板的网站数。 |
| Copilot 代理 | SharePoint 网站上对应于该特定网站模板的 Copilot 代理数。 |
| 类型: | SPOCopilotAgentInsightType |
| Position: | Named |
| 默认值: | CopilotAgentsOnSites |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | SharePoint Online |
-ReportId
它指定要查看或下载的报表的唯一 ID。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
| 适用于: | SharePoint Online |