共用方式為

使用 PowerShell 腳本進行受限制的 SharePoint 搜尋

重要事項

受限制的 SharePoint 搜尋是專為 Microsoft 365 Copilot 的客戶所設計。 請瀏覽 這裡 以及 受限制的 SharePoint 搜尋概觀 以取得更多資訊。

如何使用 PowerShell 腳本啟用和管理受限制的 SharePoint 搜尋

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

本文說明如何使用 PowerShell 中的系統管理腳本來執行這些動作。

開始之前

您必須是 SharePoint 系統管理員 ，或在 Microsoft 365 中具有對等許可權，才能執行 PowerShell 系統管理腳本。

使用本文中的 PowerShell 腳本之前，您必須執行下列步驟：

  1. 如果您尚未下載最新的 SharePoint Online 管理命令介面。

    注意事項

    如果您安裝的是舊版 SharePoint Online 管理命令介面，請移至 [新增或移除程式]，並解除安裝 [SharePoint Online 管理命令介面]。

  2. 以 SharePoint 系統管理員 身分連線到 SharePoint，或在 Microsoft 365 中具有 Microsoft 365 中的對等許可權。 若要了解如何進行，請參閱開始使用 SharePoint Online 管理命令介面。

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

Get-SPOTenantRestrictedSearchMode

模組： Microsoft.Online.SharePoint.PowerShell

適用於： SharePoint 線上版

語法

Get-SPOTenantRestrictedSearchMode

範例

Get-SPOTenantRestrictedSearchMode

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

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

Set-SPOTenant受限搜尋模式

模組： Microsoft.Online.SharePoint.PowerShell

適用於：SharePoint Online

語法

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

範例 1

Set-SPOTenantRestrictedSearchMode -Mode Enabled

注意事項

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

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

範例 2

Set-SPOTenantRestrictedSearchMode – Mode Disabled

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

參數

-方式

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

類型 字串
位： 0
預設值： 已停用
必要條件： True
接受管線輸入： 錯
接受萬用字元： 錯

將網站新增至允許清單

啟用受限制的 SharePoint 搜尋時，您可以將網站 URL 新增至字串或 csv 檔案中的允許清單：

Add-SPOTenantRestrictedSearchAllowedList

模組：Microsoft.Online.SharePoint.PowerShell

適用於： SharePoint 線上版

語法

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 線上系統管理中心，流覽至 [作用中網站] ，然後選取 [ 匯出]。 匯出的清單也包括傳統網站。 從此清單中移除您不想編製索引的任何網站。 您最多可以包含 100 個 URL。

此範例可讓管理員透過提供 CSV 檔案將網站新增至允許清單。 在 URL 欄中新增網站 URL 清單。

參數

-網站列表

允許清單的網站清單。

類型 字串
位： 0
預設值： 無
必要條件： True
接受管線輸入： 錯
接受萬用字元： 錯

-SitesListFileURL

具有網站 URL 清單的檔案，當租用戶設定為受限制的租用戶搜尋模式時，這些網站 URL 可以新增至允許清單。

類型 字串
位： 0
預設值： 無
必要條件： True
接受管線輸入： 錯
接受萬用字元： 錯

從許可清單中移除網站

您可以使用 PowerShell 腳本在字串或 csv 檔案中提供網站 URL，從允許清單中移除網站：

Remove-SPOTenantRestrictedSearchAllowedList

模組：Microsoft.Online.SharePoint.PowerShell

適用於： SharePoint 線上版

語法

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 檔案將網站新增至允許清單。

參數

-網站列表

將從允許清單中移除的網站清單。

類型 字串
位： 0
預設值： 無
必要條件： True
接受管線輸入： 錯
接受萬用字元： 錯

-SitesListFileURL

具有當租用戶設定為受限制租用戶搜尋模式時可從允許清單中移除的站台清單的檔案。

類型 字串
位： 0
預設值： 無
必要條件： True
接受管線輸入： 錯
接受萬用字元： 錯

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

您可以執行下列 PowerShell 腳本，以取得允許清單中現有的 URL 清單：

Get-SPOTenantRestrictedSearchAllowedList

模組：Microsoft.Online.SharePoint.PowerShell

適用於： SharePoint 線上版

語法

Get-SPOTenantRestrictedSearchAllowedList

範例

Get-SPOTenantRestrictedSearchAllowedList

此範例可讓系統管理員取得租用戶中現有的允許清單。

  • Last updated on