Get-SPOM365AgentAccessInsightsReport
此 Cmdlet 可讓系統管理員在沒有報表標識碼時檢查所有作用中和可用的分析報表的狀態，並在報表標識碼存在時檢視或下載報表。
注意事項
與此 Cmdlet 相關聯的功能即將推出。
語法
Default (預設值)
Get-SPOM365AgentAccessInsightsReport
[-ReportId <Guid>]
[-Action <ActionType>]
[-Content <M365AgentsOnSites>]
[<CommonParameters>]
Description
如果此 Cmdlet 在沒有任何參數的情況下執行，它會顯示所有作用中和已完成報表的狀態。
注意事項
所有報告都會遵守 資料存取控管的任何保留時間表。
範例
範例 1
Get-SPOM365AgentAccessInsightsReport
範例 1 可讓管理員檢視所有作用中和已完成分析報告的狀態。
範例 2
Get-SPOM365AgentAccessInsightsReport –ReportId 9d946216-afe7-49f5-8267-7b662435c70b
範例 2 可讓系統管理員檢視指定報表識別碼的 Microsoft 365 代理程式深入解析報表。
範例 3
Get-SPOM365AgentAccessInsightsReport – ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Action Download
範例 3 可讓系統管理員將指定報表識別碼的 Microsoft 365 代理程式深入解析報表下載到執行命令的相同路徑。
參數
-Action
適用：SharePoint Online
它決定是否要檢視或下載報告。 如果 的 -Action 值設定為 View，它會在 PowerShell 畫面上顯示輸出。 否則，如果 的 -Action 值設定為 Download，它會將 CSV 格式的完整報告下載到執行命令的相同路徑。
參數屬性
| 類型: | ActionType |
| 預設值: | View |
| 接受的值: | View, Download |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Content
適用：SharePoint Online
它指定要檢視或下載的報表類型。
如果此 Cmdlet 以 作為M365AgentsOnSites執行-Content，則會顯示一份報告，其中包含建立代理程式的所有網站清單，以及在指定天數內建立的代理程式名稱。
如果使用 as 參數和 -Content as SiteDistribution執行-ReportId此 Cmdlet，則會顯示一份報告，顯示 Microsoft 365 代理程式在指定天數內跨網站散發。
參數屬性
| 類型: | Microsoft.Online.SharePoint.TenantAdministration.SPOM365AgentInsightType |
| 預設值: | M365AgentsOnSites |
| 接受的值: | M365AgentsOnSites, SiteDistribution |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ReportId
適用：SharePoint Online
它指定要檢視或下載的報表的唯一 ID。
參數屬性
| 類型: | System.Guid |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。