Set-SPEnterpriseSearchResultSource
Устанавливает свойства источника результатов.
Синтаксис
Set-SPEnterpriseSearchResultSource
[-AssignmentCollection <SPAssignmentCollection>]
[-AuthenticationType <FederationAuthType>]
[-AutoDiscover <Boolean>]
[-Confirm]
[-Description <String>]
-Identity <ResultSourcePipeBind>
[-MakeDefault <Boolean>]
[-Name <String>]
[-Owner <SearchObjectOwner>]
[-Password <String>]
[-ProviderId <Guid>]
[-QueryTemplate <String>]
[-RemoteUrl <String>]
[-SearchApplication <SearchServiceApplicationPipeBind>]
[-SsoId <String>]
[-UserName <String>]
[-WhatIf]
[<CommonParameters>]
Описание
Этот командлет обновляет свойства источников результатов, созданных пользователем. Этот командлет поддерживает те же операции обновления, которые поддерживаются на странице "Управление источниками результатов" в центре администрирования. Для любой операции обновления, кроме изменения источника результатов с помощью параметра MakeDefault, источник результатов не должен быть встроенным источником (параметр BuiltIn встроенного источника имеет значение True). Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
--------------------ПРИМЕР 1---------------------
$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
Set-SPEnterpriseSearchResultSource -Identity $customResultSource -Name "Basic SharePoint Result Source"
В этом примере обновляется имя источника результата, а идентификатор источника результата указывается как экземпляр источника результата. SearchApplication и Owner не требуются для этой операции обновления.
--------------------ПРИМЕР 2---------------------
$ssa = Get-SPEnterpriseSearchServiceApplication
$owner = Get-SPEnterpriseSearchOwner -Level SSA
$customResultSource = New-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -ProviderId fa947043-6046-4f97-9714-40d4c113963d -Name "Custom SharePoint Result Source"
Set-SPEnterpriseSearchResultSource -SearchApplication $ssa -Owner $owner -Identity "Custom SharePoint Result Source" -Description "A custom SharePoint Result Source for demonstration purposes"
В этом примере обновляется описание источника результатов, а идентификатор источника результата указывается по имени.
Параметры
-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), автоматическое определение будет использоваться.
Если параметр не задан, значение не изменяется.
Доступен исключительно при использовании службы поиска 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 |
-Identity
Определяет источник результатов, который необходимо обновить.
Возможные типы: действительный идентификатор GUID в виде 12345678-90ab-cdef-1234-567890bcdefgh, действительное имя источника результатов (например, Custom SharePoint Result Source) или экземпляр действительного объекта Source.
Type: | ResultSourcePipeBind |
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 |
-MakeDefault
Указывает, следует ли задать источник результата в качестве источника результатов по умолчанию для области, заданной параметром Owner.
Если параметр не указан, источник результата по умолчанию не изменится.
Если параметр имеет значение True ($true), источник результатов будет использоваться по умолчанию.
При установке значения false ($false) указывается, что источник результатов не должен быть задан по умолчанию. В этом случае, если обновляемая версия является источником результатов по умолчанию, исходный источник результатов по умолчанию ("Локальные результаты SharePoint") будет снова установлен по умолчанию.
Совет. Используйте экземпляр , а не идентификатор строки GUID в качестве идентификатора при использовании Makedefault, чтобы четко указать, что владелец будет использоваться только для указания уровня, на котором источник результатов должен быть задан по умолчанию (если значение 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: | False |
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: | False |
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: | False |
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: | False |
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 Id, который используется для подключения к источнику результатов.
Если параметр не задан, значение не изменяется.
Необходимо указать, если для типа проверки подлинности (AUthenticationType) задано значение FederationAuthType.SSO (Single Sign On).
При подключении к интрасети через обратный прокси-сервер необходимо ввести код 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 |