使用 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 Management Shell，请进入添加或删除程序并卸载 "SharePoint Online Management Shell"。
在 Microsoft 365 Microsoft 365 中以 SharePoint 管理员或更高版本的身份连接到 SharePoint。 若要了解具体操作步骤，请参阅 SharePoint 在线管理壳入门。
获取为受限搜索设置的当前模式
默认情况下，受限 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 禁用租户的受限租户搜索模式。
参数
-模式
设置受限租户搜索的模式。
| 类型 | String |
|---|---|
| 位置： | 0 |
| 默认值： | Disabled |
| 必需： | True |
| 接受管道输入： | False |
| 接受通配符： | False |
将网站添加到允许列表
启用受限 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
允许列表的网站列表。
| 类型 | String |
|---|---|
| 位置： | 0 |
| 默认值： | None |
| 必需： | True |
| 接受管道输入： | False |
| 接受通配符： | False |
-SitesListFileURL
包含网站 URL 列表的文件，当租户设置为“受限租户搜索模式”时，这些 URL 可以添加到允许列表。
| 类型 | String |
|---|---|
| 位置： | 0 |
| 默认值： | None |
| 必需： | True |
| 接受管道输入： | False |
| 接受通配符： | False |
从允许列表中删除网站
可以通过使用 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
将从允许列表中删除的网站列表。
| 类型 | String |
|---|---|
| 位置： | 0 |
| 默认值： | None |
| 必需： | True |
| 接受管道输入： | False |
| 接受通配符： | False |
-SitesListFileURL
包含网站列表的文件，当租户设置为“受限租户搜索模式”时，可从允许列表中删除这些站点。
| 类型 | String |
|---|---|
| 位置： | 0 |
| 默认值： | None |
| 必需： | True |
| 接受管道输入： | False |
| 接受通配符： | False |
获取允许列表中的现有 URL 列表
可以通过运行以下 PowerShell 脚本来获取允许列表中现有的 URL 列表：
Get-SPOTenantRestrictedSearchAllowedList
Module：Microsoft.Online.SharePoint.PowerShell
适用于：SharePoint Online
语法
Get-SPOTenantRestrictedSearchAllowedList
```
**Example**
```powershell
Get-SPOTenantRestrictedSearchAllowedList
此示例允许管理员获取租户中的现有允许列表。