使用 PowerShell 指令碼進行受限制的 SharePoint 搜尋

重要事項

受限制的 SharePoint 搜尋即將淘汰。 自 2026 年 7 月 31 日起，將會封鎖新的啟用。 使用完整的資料控制項，例如 限制內容探索 (RCD) ，以促進內容探索性。

受限制的 SharePoint 搜尋是專為具有Microsoft Copilot Chat和代理經驗的客戶所設計。 它被設計為短期解決方案，讓貴組織的系統管理員有時間徹底檢閱和稽核網站和檔案權限，但它並不適用於或無法長期使用。 提供完整的資料安全性解決方案，包括 SharePoint 進階管理 及 Microsoft Purview。

如何使用 PowerShell 指令碼啟用和管理受限制的 SharePoint 搜尋

預設不會啟用受限制的 SharePoint 搜尋。 若要啟用和設定受限制的 SharePoint 搜尋，您至少需要擁有 Microsoft 365 SharePoint 系統管理員 的權限。 視案例而定，您需要採取的一些動作包括：

本文涵蓋如何在 PowerShell 中使用系統管理指令碼來執行這些動作。

開始之前

您必須是 SharePoint 系統管理員 ，或在 Microsoft 365 中具有同等權限才能執行 PowerShell 系統管理指令碼。

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

在在本文中使用 PowerShell 指令碼之前，請參閱 SharePoint Online PowerShell 模組需求。

受限制的 SharePoint 搜尋預設為停用。 若要驗證此功能的目前模式，您可以執行下列命令：

Get-SPOTenantRestrictedSearchMode

模組： Microsoft.Online.SharePoint.PowerShell

適用於： SharePoint Online

語法

Get-SPOTenantRestrictedSearchMode

範例

Get-SPOTenantRestrictedSearchMode

此範例可讓系統管理員在租用戶中取得現有的允許清單。 根據目前的設定，結果可以是 [已啟用] 或 [已停用]。

啟用或停用限制搜尋設定。 預設值為 disabled。 第一次啟用此設定時，允許清單是空的。 若要啟用或停用受限制的 SharePoint 搜尋，請執行此命令：

Set-SPOTenantRestrictedSearchMode

模組： Microsoft.Online.SharePoint.PowerShell

適用於：SharePoint Online

語法

Set-SPOTenantRestrictedSearchMode 
[-Mode] {Disabled | Enabled}
 [<CommonParameters>]

範例 1

Set-SPOTenantRestrictedSearchMode -Mode Enabled

注意事項

啟用之後，除非您將新網站新增至允許清單，否則會排除任何新網站。

範例 1 為租用戶設定或啟用受限制的租用戶搜尋模式。

範例 2

Set-SPOTenantRestrictedSearchMode – Mode Disabled

範例 2 會停用租用戶的受限制租用戶搜尋模式。

參數

-Mode

設定受限制租用戶搜尋的模式。

類型 字串
職位： 0
預設值： Disabled
必要項目： True
接受管線輸入： False
接受萬用字元： False

將網站新增至允許清單

啟用受限制的 SharePoint 搜尋時，請使用下列命令將網站 URL 新增至字串或 CSV 檔案中的允許清單：

Add-SPOTenantRestrictedSearchAllowedList

模組：Microsoft.Online.SharePoint.PowerShell

適用於： SharePoint Online

語法

Add-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]

Add-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]  
 [<CommonParameters>]

範例 1

Add-SPOTenantRestrictedSearchAllowedList -SitesList @("[https://contoso.sharepoint.com/sites/Marketing](https://contoso.sharepoint.com/sites/Marketing)", "[https://contoso.sharepoint.com/sites/Benefits](https://contoso.sharepoint.com/sites/Benefits)")

此範例顯示系統管理員如何將網站新增至允許清單。

範例 2

Add-SPOTenantRestrictedSearchAllowedList  -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv

注意事項

若要產生所有 SharePoint 網站 URL 的清單，請移至 SharePoint Online 系統管理中心，移至 [使用中的網站]，然後選取 [ 匯出]。 匯出的清單也包含傳統網站。 從此清單移除任何您不想要編製索引的網站。 您最多可以包含 100 個網址。

此範例顯示系統管理員如何提供 CSV 檔案，將網站新增至允許清單。 在 [URL] 欄中新增網站 URL 清單。

參數

-SitesList

允許清單的網站清單。

類型 字串
職位： 0
預設值： None
必要項目： True
接受管線輸入： False
接受萬用字元： False

-SitesListFileURL

檔案包含網站 URL 清單，當租用戶設定為受限制的租用戶搜尋模式時，您可以將其新增至允許清單。

類型 字串
職位： 0
預設值： None
必要項目： True
接受管線輸入： False
接受萬用字元： False

從允許清單移除網站

使用下列 PowerShell 命令，以字串或 CSV 檔案提供網站 URL，以從允許清單移除網站：

Remove-SPOTenantRestrictedSearchAllowedList

模組：Microsoft.Online.SharePoint.PowerShell

適用於： SharePoint Online

語法

Remove-SPOTenantRestrictedSearchAllowedList -SitesList <List[string]> [<CommonParameters>]

Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl <string> [-ContainsHeader <bool>]
 [<CommonParameters>]

範例 1

Remove-SPOTenantRestrictedSearchAllowedList -SitesList @("[https://contoso.sharepoint.com/sites/Marketing](https://contoso.sharepoint.com/sites/Marketing)", "[https://contoso.sharepoint.com/sites/HR](https://contoso.sharepoint.com/sites/HR)")

範例 1 顯示系統管理員如何從允許清單中移除網站。

範例 2

Remove-SPOTenantRestrictedSearchAllowedList -SitesListFileUrl C:\Users\admin\Downloads\UrlList.csv

範例 2 顯示系統管理員如何透過提供 CSV 檔案，將網站新增至允許清單。

參數

-SitesList

您想要從允許清單中移除的網站清單。

類型 字串
職位： 0
預設值： None
必要項目： True
接受管線輸入： False
接受萬用字元： False

-SitesListFileURL

檔案包含當租用戶設定為受限制租用戶搜尋模式時，您可以從允許清單中移除的網站清單。

類型 字串
職位： 0
預設值： None
必要項目： True
接受管線輸入： False
接受萬用字元： False

取得允許清單中的現有 URL 清單

若要取得允許清單中的現有 URL 清單，請執行下列 PowerShell 命令：

Get-SPOTenantRestrictedSearchAllowedList

模組：Microsoft.Online.SharePoint.PowerShell

適用於： SharePoint Online

語法

Get-SPOTenantRestrictedSearchAllowedList

範例

Get-SPOTenantRestrictedSearchAllowedList

此範例顯示系統管理員如何在租用戶中取得現有的允許清單。

  • 上次更新時間：