使用 PowerShell 腳本進行受限制的 SharePoint 搜尋
重要事項
受限制的 SharePoint 搜尋是專為 Microsoft 365 Copilot 的客戶所設計。 如需詳細資訊，請造訪 這裡 和 受限制的 SharePoint 搜尋概觀 。
根據預設，不會啟用 受限制的 SharePoint 搜尋 。 若要啟用和設定受限制的 SharePoint 搜尋，您必須在 Microsoft 365 中具有 SharePoint 系統管理員 或 以上 角色。 視案例而定，您需要採取的一些動作如下：
取得針對限制搜尋設定的目前模式
啟用和停用受限制的 SharePoint 搜尋
提供 URL 將網站新增至允許的清單
提供 URL 從允許的清單中移除網站
取得允許清單中新增的現有URL清單
本文說明如何在PowerShell中使用系統管理員腳本來執行這些動作。
開始之前
您必須是 Microsoft 365 中的 SharePoint 系統管理員 或 更新 版本，才能執行下列系統管理員腳本。 在本文中使用 PowerShell 腳本之前，您必須執行下列動作：
如果您尚未下載，請 下載最新的 SharePoint Online 管理命令介面。
注意事項
如果您安裝的是舊版 SharePoint Online 管理命令介面，請移至 [新增或移除程式]，並解除安裝 [SharePoint Online 管理命令介面]。
在 Microsoft 365 中以 Microsoft 365 的 SharePoint 系統管理員 或 更新 版本連線到 SharePoint。 若要了解如何進行，請參閱開始使用 SharePoint Online 管理命令介面。
取得針對限制搜尋設定的目前模式
默認會停用受限制的 SharePoint 搜尋。 若要確認此功能的目前模式，您可以執行下列腳本：
Get-SPOTenantRestrictedSearchMode
模組： Microsoft.Online.SharePoint.PowerShell
適用於： SharePoint Online
語法
Get-SPOTenantRestrictedSearchMode
範例
Get-SPOTenantRestrictedSearchMode
此範例可讓系統管理員取得租用戶中現有的允許清單。 根據目前的設定，結果可以是 [已啟用] 或 [已停用]。
啟用或停用 [限制搜尋] 設定
啟用或停用 [限制搜尋] 設定，並停用預設值。 第一次啟用設定時，允許清單是空的。 若要啟用或停用受限制的 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 會停用租使用者的受限租用戶搜尋模式。
參數
-模式
設定受限制租用戶搜尋的模式。
| 類型 | 字串 |
|---|---|
| 位置： | 0 |
| 預設值： | 已停用 |
| 必填： | True |
| 接受管線輸入： | 錯 |
| 接受通配符： | 錯 |
將網站新增至允許的清單
啟用受限制的 SharePoint 搜尋時，您可以將網站 URL 新增至字串或 csv 檔案中允許的清單：
Add-SPOTenantRestrictedSearchAllowedList
Module：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
此範例可讓系統管理員提供 CSV 檔案，將網站新增至允許的清單。 在 URL 資料行中新增網站 URL 清單。
參數
-SitesList
允許清單的網站清單。
| 類型 | 字串 |
|---|---|
| 位置： | 0 |
| 預設值： | 無 |
| 必填： | True |
| 接受管線輸入： | 錯 |
| 接受通配符： | 錯 |
-SitesListFileURL
當租用戶設定為限制的租用戶搜尋模式時，具有可新增至允許清單之網站 URL 清單的檔案。
| 類型 | 字串 |
|---|---|
| 位置： | 0 |
| 預設值： | 無 |
| 必填： | True |
| 接受管線輸入： | 錯 |
| 接受通配符： | 錯 |
從允許清單中移除網站
您可以使用 PowerShell 文稿在字串或 csv 檔案中提供網站 URL，從允許的清單中移除網站：
Remove-SPOTenantRestrictedSearchAllowedList
Module：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 |
| 預設值： | 無 |
| 必填： | True |
| 接受管線輸入： | 錯 |
| 接受通配符： | 錯 |
-SitesListFileURL
當租用戶設定為限制的租用戶搜尋模式時，具有可從允許清單中移除之網站清單的檔案。
| 類型 | 字串 |
|---|---|
| 位置： | 0 |
| 預設值： | 無 |
| 必填： | True |
| 接受管線輸入： | 錯 |
| 接受通配符： | 錯 |
取得允許清單中的現有URL清單
您可以執行下列 PowerShell 腳本來取得允許清單中的現有 URL 清單：
Get-SPOTenantRestrictedSearchAllowedList
Module：Microsoft.Online.SharePoint.PowerShell
適用於： SharePoint Online
語法
Get-SPOTenantRestrictedSearchAllowedList
```
**Example**
```powershell
Get-SPOTenantRestrictedSearchAllowedList
此範例可讓系統管理員取得租用戶中現有的允許清單。