New-SPEnterpriseSearchResultSource
Создает новый источник результатов.
Синтаксис
New-SPEnterpriseSearchResultSource
[-AssignmentCollection <SPAssignmentCollection>]
[-AuthenticationType <FederationAuthType>]
[-AutoDiscover <Boolean>]
[-Confirm]
[-Description <String>]
[-MakeDefault <Boolean>]
-Name <String>
-Owner <SearchObjectOwner>
[-Password <String>]
-ProviderId <Guid>
[-QueryTemplate <String>]
[-RemoteUrl <String>]
-SearchApplication <SearchServiceApplicationPipeBind>
[-SsoId <String>]
[-UserName <String>]
[-WhatIf]
[<CommonParameters>] Описание
Этот командлет создает источник результатов. Используйте источники результатов, чтобы определять область результатов поиска и устанавливать федеративные отношения запросов и внешних источников, таких как системы поиска в Интернете. После определения источника результатов, чтобы использовать его, настройте веб-части поиска и действия правила запроса. Источники результатов заменяют области поиска, которые больше не поддерживаются. Этот командлет поддерживает те же операции создания, которые поддерживаются на странице "Управление источниками результатов" в центре администрирования, за исключением операций "Проверка подлинности формы" и "Проверка подлинности файлов cookie". Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
------------------ПРИМЕР------------------
$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"В этом примере создается новый источник результатов на уровне приложения службы поиска с именем "Настраиваемый источник результатов SharePoint".
Параметры
-AssignmentCollection
Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.
При использовании параметра Global все объекты содержатся в глобальном хранилище.
Если объекты не используются сразу или удаляются с помощью команды Stop-SPAssignment, может возникнуть нехватка памяти.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-AuthenticationType
Определяет тип проверки подлинности для нового источника результатов.
Для каждого типа службы поиска поддерживается определенный набор типов проверки подлинности, и если параметр не задан, тип проверки подлинности задается по умолчанию в зависимости от типа службы поиска.
Этот командлет поддерживает следующий набор механизмов проверки подлинности и соответствующих типов: проверка подлинности по умолчанию для SharePoint (FederationAuthType.LocalNTAuth), базовая проверка подлинности (FederationAuthType.SingleAccountBasicAuth — задайте имя пользователя и пароль), удаленная проверка подлинности в SharePoint (FederationAuthType.PerUserBasicAuth), единый вход (FederationAuthType.SSO — необходимо задать SsoId), анонимная проверка (FederationAuthType.Anonymous), дайджест-проверка (FederationAuthType.SingleAccountDigest — задайте имя пользователя и пароль), удостоверение пула приложений NTLM (FederationAuthType.ApplicationPoolIdentity), имя пользователя и пароль NTLM (FederationAuthType.SingleAccountNTLM — задайте имя пользователя и пароль).
При использовании локальной службы поиска / локальной службы поиска людей SharePoint поддерживаются типы FederationAuthType.LocalNTAuth (значение по умолчанию) и FederationAuthType.SingleAccountBasicAuth.
При использовании удаленной службы поиска / удаленной службы поиска людей SharePoint поддерживаются типы FederationAuthType.PerUserBasicAuth (значение по умолчанию) и FederationAuthType.SSO.
При использовании службы поиска OpenSearch 1.0/1.1 поддерживаются следующие типы проверки подлинности: FederationAuthType.Anonymous (значение по умолчанию), FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest, FederationAuthType.SingleAccountNTLM и FederationAuthType.ApplicationPoolIdentity.
Все типы проверки подлинности перечислены в перечислении FederationAuthType.
| Type: | FederationAuthType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-AutoDiscover
Указывает, следует ли использовать автоматическое обнаружение конечной точки Exchange Server для нового источника результатов.
Если параметр имеет значение True ($true), автоматическое определение будет использоваться. Если он не задан или имеет значение False ($false), автоматическое определение не применяется.
Доступен исключительно при использовании службы поиска Exchange.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Confirm
Предлагает подтвердить выполнение команды.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Description
Задает описание нового источника результатов.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-MakeDefault
Определяет, использовать ли новый источник результатов в качестве источника по умолчанию для области, определяемой параметром Owner.
Если параметр имеет значение True ($true), источник результатов будет использоваться по умолчанию. Если не задано или задано значение false, новый источник результатов не будет установлен по умолчанию.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Name
Задает имя нового источника результатов.
Имена должны быть уникальными на каждом административном уровне.
Например, у двух источников результатов на сайте имена совпадать не могут, но имя на сайте и имя, предоставляемое семейством сайтов, могут совпадать.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Owner
Задает владельца объекта поиска, определяющего область, в которой создается соответствующий источник результатов.
| Type: | SearchObjectOwner |
| Aliases: | o |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Password
Задает пароль для пользовательских учетных данных, используемых для подключения к новому источнику результатов.
Применяется, если тип проверки подлинности (AuthenticationType) является типом, который использует пользовательские учетные данные (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest или FederationAuthType.SingleAccountNTLM).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ProviderId
Задает службу поиска, которая будет использоваться новым источником результатов.
Указывается как строка Guid или GUID, которая должна совпадать с одной из следующих: FA947043-6046-4F97-9714-40D4C113963D (локальный поиск SharePoint), E4BCC058-F133-4425-8FFC-1D70596FFD33 (локальный поиск людей SharePoint), 1E0C8601-2E5D-4CCB-9561-53743B5DBDE7 (удаленный поиск SharePoint), E377CAAA-FCAF-4a1b-B7A1-E69A506A07AA (удаленный поиск людей SharePoint), 3A17E140-1574-4093-BAD6-E19CDF1C0122 (поиск Exchange), 3A17E140-1574-4093-BAD6-E19CDF1C0121 (OpenSearch 1.0/1.1).
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-QueryTemplate
Задает шаблон преобразования запроса нового источника результатов.
Входящие запросы преобразовываются согласно шаблонам; вместо них используется новый текст запроса. Чтобы включить входящий запрос в новый текст, используйте переменную запроса "{searchTerms}". Применяется для определения области результатов.
Например, чтобы вернуть только элементы OneNote, задайте для нового текста значение "{searchTerms} fileextension=one. После этого входящий запрос "sharepoint" превращается в "sharepoint fileextension=one". Значение по умолчанию — {searchTerms}.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-RemoteUrl
Задает шаблон URL-адреса соединения для нового источника результатов.
Должен быть задан при использовании поставщика поиска, который его использует: удаленный поиск SharePoint, удаленный поиск SharePoint Люди, OpenSearch 1.0/1.1 и Exchange (если автообнаружения не включен).
При использовании других служб параметр игнорируется.
Для удаленного поиска SharePoint или удаленного поиска людей SharePoint необходимо задать адрес корневого семейства веб-сайтов удаленной фермы SharePoint.
Для OpenSearch 1.0/1.1 задается URL-адрес источника OpenSearch.
Включите запрос в URL-адрес, используя переменную запроса "{searchTerms}", которая будет автоматически заменяться запросом. Для Exchange необходимо определить URL-адрес веб-служб Exchange, из которых требуется получать результаты.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SearchApplication
Задает приложение поиска.
Тип должен быть допустимым ИДЕНТИФИКАТОРом GUID в форме 12345678-90ab-cdef-1234-567890bcdefgh; допустимое имя приложения поиска, например SearchApp1, или экземпляр допустимого объекта SearchServiceApplication.
| Type: | SearchServiceApplicationPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SsoId
Указывает идентификатор сертификата обратного прокси-сервера Secure Store, используемый для подключения к новому источнику результатов.
Должен быть задан, если тип проверки подлинности (AuthenticationType) — FederationAuthType.SSO (единый вход).
При подключении к интрасети через обратный прокси-сервер необходимо ввести код SSO записи единого входа, в которой хранится сертификат, используемый для проверки подлинности на обратном прокси-сервере.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-UserName
Задает имя пользователя для пользовательских учетных данных, используемых для подключения к новому источнику результатов.
Применяется, если тип проверки подлинности (AuthenticationType) является типом, который использует пользовательские учетные данные (FederationAuthType.SingleAccountBasicAuth, FederationAuthType.SingleAccountDigest или FederationAuthType.SingleAccountNTLM).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WhatIf
Отображает описание команды. При этом сама команда не выполняется.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |