Поделиться через


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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-Description

Задает описание нового источника результатов.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-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 Subscription Edition

-Name

Задает имя нового источника результатов.

Имена должны быть уникальными на каждом административном уровне.

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Owner

Задает владельца объекта поиска, определяющего область, в которой создается соответствующий источник результатов.

Type:SearchObjectOwner
Aliases:o
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition