Использование сценариев PowerShell для ограниченного поиска SharePoint

Важно!

Поддержка ограниченного поиска в SharePoint прекращается. С 31 июля 2026 г. новая возможность блокируется. Используйте комплексные средства управления данными, такие как обнаружение ограниченного содержимого (RCD), для обнаружения контента.

Ограниченный поиск SharePoint предназначен для пользователей с Microsoft Copilot Chat и агентским опытом. Оно разработано как краткосрочное решение, чтобы дать администраторам организации время для тщательной проверки и аудита разрешений сайтов и файлов, но не предназначено и не масштабируется для долгосрочного использования. Доступны комплексные решения для защиты данных, включая Расширенное управление SharePoint и Microsoft Purview.

Включение ограниченного поиска SharePoint и управление им с помощью сценариев PowerShell

По умолчанию ограниченный поиск SharePoint не включен. Чтобы включить и настроить ограниченный поиск SharePoint, вам необходимы как минимум разрешения администратора SharePoint в Microsoft 365. В зависимости от сценария вам потребуется выполнить следующие действия:

В этой статье описывается, как использовать сценарии администратора в PowerShell для этих действий.

Подготовка к работе

Вы должны быть администратором SharePoint или иметь эквивалентные разрешения в Microsoft 365, чтобы запускать сценарии администратора PowerShell.

См. статью Предварительные требования к средству расширенного управления SharePoint.

Прежде чем использовать сценарии PowerShell из этой статьи, ознакомьтесь с требованиями к модулю PowerShell в SharePoint Online.

Ограниченный поиск 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 отключает режим ограниченного поиска клиента для клиента.

Parameters

-Mode

Устанавливает режим ограниченного поиска клиента.

Тип String
Должность: 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

Примечание.

Чтобы создать список URL-адресов всех сайтов SharePoint, перейдите в Центр администрирования SharePoint Online, перейдите в раздел "Активные сайты" и выберите "Экспорт". В экспортируемый список включены и классические сайты. Удалите из этого списка все сайты, которые не нужно индексировать. Вы можете включить до 100 URL-адресов.

В этом примере показано, как добавить сайты в список разрешений, указав CSV-файл. Добавьте список URL-адресов сайтов в столбец URL-адреса.

Parameters

-SitesList

Список сайтов для списка разрешений.

Тип String
Должность: 0
Значение по умолчанию: None
Обязательно: True
Принять входные данные конвейера: False
Принятие подстановочных знаков: False

-SitesListFileURL

Файл со списком URL-адресов сайтов, которые можно добавить в список разрешений, если клиент находится в режиме поиска с ограниченным доступом.

Тип String
Должность: 0
Значение по умолчанию: None
Обязательно: True
Принять входные данные конвейера: False
Принятие подстановочных знаков: False

Удаление сайтов из списка разрешенных

Удалите сайты из списка разрешений, указав URL-адрес сайтов в строке или CSV-файле с помощью следующей команды PowerShell:

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-файла.

Parameters

-SitesList

список сайтов, который вы хотите удалить из списка разрешений.

Тип String
Должность: 0
Значение по умолчанию: None
Обязательно: True
Принять входные данные конвейера: False
Принятие подстановочных знаков: False

-SitesListFileURL

Файл со списком сайтов, которые можно удалить из списка разрешенных, если для клиента установлен режим поиска с ограниченным доступом.

Тип String
Должность: 0
Значение по умолчанию: None
Обязательно: True
Принять входные данные конвейера: False
Принятие подстановочных знаков: False

Получение существующего списка URL-адресов в списке разрешений

Чтобы получить существующий список URL-адресов в списке разрешений, выполните следующую команду PowerShell:

Get-SPOTenantRestrictedSearchAllowedList

Модуль:Microsoft.Online.SharePoint.PowerShell

Область применения: SharePoint Online

Синтаксис

Get-SPOTenantRestrictedSearchAllowedList

Пример

Get-SPOTenantRestrictedSearchAllowedList

В этом примере показано, как администратор получает существующий список разрешений в клиенте.