監視代理程式對 SharePoint 和 OneDrive 的存取

代理程式存取深入解析報告可為 SharePoint 系統管理員提供有關代理程式如何存取組織中所有 SharePoint 和 OneDrive 網站內容的豐富資訊。 該報告包括所有已註冊和激活的代理，例如：

• 在 SharePoint 中建立的代理程式
• 宣告式代理程式
• 自訂代理程式
• ...以及其他功能

透過使用此報告，您可以查看代理如何與您的內容互動、發現存取模式，以及查看代理在各個網站的分佈。 使用這些深入解析來強化您的安全性並套用管理控制，例如 受限制的存取控制 和 受限制的內容探索。

代理存取深入解析使用 Microsoft 365 統一稽核記錄來追蹤代理如何存取您的 SharePoint 網站和 OneDrive 帳戶。 這些日誌捕獲閱讀、搜索和與內容交互等信號，讓您清楚地了解代理活動。

您可以在 SharePoint 管理員中心或使用 SharePoint Online 管理命令介面來產生和管理代理程式存取深入解析報告。 您必須獲指派適當的角色，例如 SharePoint 系統管理員，才能建立或檢視代理程式存取報告。

開始之前

請參閱 SharePoint 進階管理必要條件。

如何？在 SharePoint 系統管理中心存取代理程式存取深入解析報告？

1. 前往 SharePoint 系統管理中心 並登入。

2. 在瀏覽窗格中，展開 [報告]，然後選取 [ 代理程式深入解析]。

3. 選取 代理程式存取。

4. 檢閱報告詳細資料，包括客服專員活動、存取模式和網站發佈。

   螢幕

如何在 SharePoint 系統管理中心建立代理程式存取報告

1. 在 SharePoint 系統管理中心的瀏覽窗格中，展開 [報告]，然後選取 [代理程式深入解析]。

2. 選取 [建立報表]。

3. 指定報告的名稱，報告持續時間 (1、7、14 或 28 天) 。

4. 選取 建立並執行 (或 建立) 。

   

在 SharePoint 系統管理中心檢視代理程式存取報告狀態

1. 在 SharePoint 系統管理中心的瀏覽窗格中，展開 [報告]，然後選取 [代理程式深入解析]。

2. 檢查 [狀態 ] 欄以查看報告是否準備就緒或上次更新的時間。

   

在 SharePoint 系統管理中心檢視代理程式存取報告詳細資料

1. 在 SharePoint 系統管理中心的瀏覽窗格中，展開 [報告]，然後選取 [代理程式深入解析]。

2. 檢查 [狀態 ] 欄以查看報告是否準備就緒或上次更新的時間。

3. 選取報表以檢視資料。 您可以檢視託管最多代理程式數量的前 100 個網站。 您可以搜尋網站，或依網站範本和治理原則進行篩選。

   

檢視特定網站的前 20 個代理程式

1. 在 SharePoint 系統管理中心的瀏覽窗格中，展開 [報告]，然後選取 [代理程式深入解析]。

2. 選取 代理程式存取。

3. 選取網站以檢視跨所選網站存取內容的前 20 個代理程式。

   

檢視跨網站的代理程式分佈

1. 在 SharePoint 系統管理中心的瀏覽窗格中，展開 [報告]，然後選取 [代理程式深入解析]。

2. 選取 代理程式存取。

3. 選擇 SharePoint 網站中的唯一代理程式 或 OneDrive 帳戶中的唯一代理程式。

   此檢視會顯示代理程式在組織網站中的分佈方式。 您可以快速查看每個網站範本類別中的網站數目，以及正在存取這些網站的唯一代理程式數量。

   

從存取報告套用內容控管原則

您可以從 Access Insights 報告在網站上套用內容控管原則。 可用的原則包括：

• 限制網站存取原則
• 限制內容探索原則

使用 SharePoint Online 管理命令介面存取代理程式存取深入解析報告

您可以使用 SharePoint Online 管理命令介面來產生、檢查和管理代理程式存取深入解析報告。

必要條件

• 如果您尚未下載並安裝最新版本的 SharePoint Online 管理命令介面。
• 您必須在 Microsoft 365 中至少指派一名 SharePoint 系統管理員 。
• 連線至 SharePoint Online 管理命令介面。 請參閱開始使用 SharePoint Online 管理命令介面。
• 請確定貴組織擁有 SharePoint 進階管理附加元件或 Microsoft Copilot 的授權。

使用 SharePoint Online 管理命令介面建立和檢視代理程式存取深入解析報告

在至少具有 SharePoint 系統管理員權限的情況下，您可以使用下列命令產生和檢視深入解析報告：

1. 若要產生預設一天報告持續時間的報告，請執行以下命令：

   Start-SPOM365AgentAccessInsightsReport
   

   根據預設，此命令會產生過去一天的代理程式存取深入解析報告。

2. 您可以使用參數指定 -ReportPeriodInDays 不同的持續時間 (7、14 或 28 天) 。 例如，若要建立過去 28 天的報告，請執行：

   Start-SPOM365AgentAccessInsightsReport -ReportPeriodInDays <28>
   

3. 若要檢查所有使用中和可用報表的狀態，請執行下列命令：

   Get-SPOM365AgentAccessInsightsReport
   

4. 若要檢視特定報告的詳細資料，請執行以下命令：

   Get-SPOM365AgentAccessInsightsReport -ReportId <ReportId>
   

   <ReportId>取代為從上一個命令取得的實際報表識別碼。

5. 若要下載和檢視報告，請執行以下命令：

   Export-SPOM365AgentAccessInsightsReport -ReportId <ReportId> -Action Download
   

   注意事項

   PowerShell 最多會顯示 100 個網站，但下載的報告最多可包含 100 萬個網站。

   Export-SPOM365AgentAccessInsightsReport -ReportId <ReportId> -View Download
   

   <ReportId>取代為實際的報表識別碼。

6. 您也可以執行下列命令，檢視所有網站類型代理程式的摘要深入解析：

   Get-SPOM365AgentAccessInsightsReport –ReportId -Content SiteDistribution
   

   SiteDistribution 提供跨所有類型網站的代理程式摘要檢視，例如通訊網站、Microsoft 365 群組連線網站、OneDrive 帳戶等。

代理程式存取深入解析報告的資料收集

如果您沒有 Microsoft SharePoint 進階管理授權，則需要啟用資料收集。 本節說明如何啟用和檢查代理程式存取深入解析報告的資料收集狀態。

啟用資料收集

下列 PowerShell 命令會開始收集前一天活動報告的稽核資料：

Start-SPOAuditDataCollectionForActivityInsights –ReportEntity M365AgentInsights

檢查資料收集狀態

啟用資料收集之後，您可以在 24 小時後產生報告。 若要檢查您是否可以產生報告，請使用下列 PowerShell 命令：

Get-SPOAuditDataCollectionStatusForActivityInsights -ReportEntity M365AgentInsights

此指令會傳回目前的資料收集狀態，可以是 NotInitiated、 InProgress或 Paused。 您可以在狀態為 時產生報告。InProgress

Microsoft 365 代理程式存取深入解析的已知體驗

在 SharePoint 系統管理中心或 SharePoint Online 管理命令介面中使用代理程式存取深入解析報告時，請記住這些重要的已知體驗：

• 您只能在上次報表產生後 24 小時後才能執行報表。
• 對於大型租用戶，最多可能需要 48 小時才能使用資料。
• 每個報表範圍值 (1、7、14 或 28 天) 只能存在一個報表。 這項限制表示您在任何指定時間點最多只能看到四個報告。
• 當您針對相同的日期範圍產生新報表時，它會取代上一個報表。 若要保留舊報表，請先下載報表再建立新報表。
• 報告會使用 Microsoft 365 統一稽核資料，其中可能不會包含每個稽核事件。

相關文章

• 管理對 SharePoint 中代理程式的存取權

• 有關在 SharePoint 中建立的代理程式的深入解析

• 使用 Microsoft 365 群組和 Microsoft Entra 安全性群組限制 SharePoint 網站存取

• 限制 SharePoint 網站和內容的探索