Использование скриптов PowerShell для ограниченного поиска SharePoint
Важно!
Ограниченный поиск SharePoint предназначен для клиентов Microsoft 365 Copilot. Дополнительные сведения см. здесь и обзор ограниченного поиска SharePoint .
По умолчанию ограниченный поиск SharePoint не включен. Чтобы включить и настроить ограниченный поиск SharePoint, необходимо иметь роль администратора SharePoint или более поздней роли в Microsoft 365. В зависимости от сценария необходимо выполнить следующие действия:
Получение текущего режима для ограниченного поиска
Включение и отключение ограниченного поиска SharePoint
Добавление сайтов в список разрешенных, указав URL-адрес
Удаление сайтов из списка разрешенных путем предоставления URL-адреса
Получение существующего списка URL-адресов, добавленных в список разрешений
В этой статье описывается использование сценариев администратора в PowerShell для этих действий.
Перед началом работы
Для выполнения следующих сценариев администратора необходимо быть администратором SharePoint или более поздней версии в Microsoft 365. Перед использованием скриптов PowerShell, описанных в этой статье, необходимо выполнить следующие действия.
Если вы этого не сделали, скачайте последнюю версию командной консоли SharePoint Online.
Примечание.
Если вы установили предыдущую версию командной консоли SharePoint Online, перейдите к разделу "Установка и удаление программ" и удалите компонент "Командная консоль SharePoint Online".
Подключитесь к SharePoint в качестве администратора SharePoint или более поздней версии в Microsoft 365 в Microsoft 365. Сведения о том, как это сделать, см. в статье Начало работы с командной консолью 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 режим поиска ограниченного клиента отключается для клиента.
Параметры
-Режим
Задает режим ограниченного поиска клиента.
| Тип | String |
|---|---|
| Позиция: | 0 |
| Значение по умолчанию: | Отключено |
| Обязательно: | Верно |
| Принять входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
Добавление сайтов в список разрешенных
Если включен ограниченный поиск 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-адрес.
Parameters
-SitesList
Список сайтов для списка разрешенных.
| Тип | String |
|---|---|
| Позиция: | 0 |
| Значение по умолчанию: | Нет |
| Обязательно: | Верно |
| Принять входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-SitesListFileURL
Файл со списком URL-адресов сайтов, которые можно добавить в список разрешенных, если для клиента задано значение Ограниченный режим поиска клиента.
| Тип | String |
|---|---|
| Позиция: | 0 |
| Значение по умолчанию: | Нет |
| Обязательно: | Верно |
| Принять входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
Удаление сайтов из списка разрешенных
Вы можете удалить сайты из списка разрешенных, указав URL-адрес сайта в строковом или CSV-файле с помощью скрипта PowerShell:
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-файл.
Parameters
-SitesList
Список сайтов, который будет удален из списка разрешенных.
| Тип | String |
|---|---|
| Позиция: | 0 |
| Значение по умолчанию: | Нет |
| Обязательно: | Верно |
| Принять входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
-SitesListFileURL
Файл со списком сайтов, которые можно удалить из списка разрешенных, если для клиента задан режим ограниченного поиска клиента.
| Тип | String |
|---|---|
| Позиция: | 0 |
| Значение по умолчанию: | Нет |
| Обязательно: | Верно |
| Принять входные данные конвейера: | Неверно |
| Примите подстановочные знаки: | Неверно |
Получение существующего списка URL-адресов в списке разрешенных
Вы можете получить существующий список URL-адресов в списке разрешенных, выполнив следующий сценарий PowerShell:
Get-SPOTenantRestrictedSearchAllowedList
Module:Microsoft.Online.SharePoint.PowerShell
Область применения: SharePoint Online
Синтаксис
Get-SPOTenantRestrictedSearchAllowedList
```
**Example**
```powershell
Get-SPOTenantRestrictedSearchAllowedList
Этот пример позволяет администратору получить существующий список разрешенных в клиенте.