重要
受限 SharePoint 搜索专为智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®聊天和代理体验的客户设计。 它设计为一种短期解决方案，允许组织的管理员有时间彻底查看和审核站点和文件权限，但不适合长期使用或可缩放。 提供全面的数据安全解决方案，包括 SharePoint 高级管理和Microsoft Purview。
如何使用 PowerShell 脚本启用和管理受限 SharePoint 搜索
默认情况下，未启用 受限 SharePoint 搜索 。 若要启用和设置受限 SharePoint 搜索，至少需要具有 Microsoft 365 中 SharePoint 管理员 的权限。 根据方案，需要执行的一些操作包括：
- 获取受限搜索的当前模式
- 启用和禁用 受限搜索
- 通过提供 URL 将网站添加到允许列表
- 通过提供 URL 从允许列表中删除网站
- 获取在允许列表中添加的现有 URL 列表
本文介绍如何在 PowerShell 中使用管理员脚本执行这些操作。
开始之前
您必须是 SharePoint 管理员 或在 Microsoft 365 中具有等效权限才能运行 PowerShell 管理员脚本。
在使用本文中的 PowerShell 脚本之前，需要执行以下步骤：
如果尚未执行此操作，请下载最新的SharePoint Online 命令行管理程序。
注意
如果你已安装早期版本的SharePoint Online 命令行管理程序，请进入添加或删除程序并卸载 "SharePoint Online 命令行管理程序"。
以 SharePoint 管理员身份或在 Microsoft 365 中具有等效权限连接到 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 禁用租户的受限租户搜索模式。
参数
-Mode
设置受限租户搜索的模式。
| 类型 | 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
注意
若要生成所有 SharePoint 网站 URL 的列表，请导航到 SharePoint Online 管理中心，导航到 “活动网站” 并选择“ 导出”。 导出的列表还包括经典网站。 从此列表中删除你不希望编制索引的任何网站。 最多可以包含 100 个 URL。
此示例允许管理员通过提供 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
示例
Get-SPOTenantRestrictedSearchAllowedList
此示例允许管理员获取租户中的现有允许列表。