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

Set-SPEnterpriseSearchResultItemType

  • Ссылка
Модуль:
SharePointServer
Применяется к:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает свойства типа результирующего элемента.

Синтаксис

Set-SPEnterpriseSearchResultItemType
   [-Identity] <ResultItemTypePipeBind>
   -Owner <SearchObjectOwner>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DisplayProperties <String>]
   [-DisplayTemplateUrl <String>]
   [-Name <String>]
   [-OptimizeForFrequentUse <Boolean>]
   [-RulePriority <Int32>]
   [-Rules <PropertyRuleCollection>]
   [-SearchApplication <SearchServiceApplicationPipeBind>]
   [-SearchApplicationProxy <SearchServiceApplicationProxyPipeBind>]
   [-SourceID <Guid>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Командлет Set-SPEnterpriseSearchResultItemType задает свойства созданных пользователем типов элементов результатов. Этот командлет нельзя использовать для задания или изменения свойств встроенных типов элементов результатов, включенных в продукты SharePoint.

Типы элементов результатов позволяют изменить вид результатов поиска в зависимости от типа результата. Сначала вы определяете набор правил, которые будут оцениваться относительно свойств результатов. Затем вы определяете шаблон отображения, который будет использоваться для воспроизведения результатов такого типа. После того как вы создадите тип элемента результата, соответствующие правилам результаты будут воспроизводиться с использованием заданного шаблона отображения.

Примеры использования:

  • Измените внешний вид результатов для определенного расширения имени файла, например документов Word.
  • изменение вида определенного типа контента в результатах поиска;
  • изменение вида результатов от конкретного автора;
  • добавление действия с результатом в результаты из конкретного источника в качестве части пользовательского приложения поиска.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

--------------------ПРИМЕР---------------------

$web = Get-SPWeb https://webUrl
$tenantOwner = Get-SPEnterpriseSearchOwner -Level SPSite -SPWeb $web
$ssa = Get-SPEnterpriseSearchServiceApplication
$resultType = Get-SPEnterpriseSearchResultItemType -Owner $tenantOwner -SearchApplication $ssa
$resultType.BuiltIn
$rule = Get-SPEnterpriseSearchPropertyRule -PropertyName "ContentTypeId" -Operator "StartsWith"
$rule.AddValue('0x010063C2F478ACC511DFB869B5BFDFD720851252')
$ruleCollection = Get-SPEnterpriseSearchPropertyRuleCollection
$ruleCollection.Add($rule)
$displayProperties = "WorkId,Rank,Title,Size,Path,Description,SiteName,HitHighlightedSummary,HitHighlightedProperties,ViewsLifeTime"
$displaytemplateUrl = "~sitecollection/_catalogs/masterpage/Display Templates/Search/Item_MyCustomDisplayTemplate.js"
Set-SPEnterpriseSearchResultItemType 
-Identity $resultType `
-SearchApplication $ssa `
-Name "CustomResultType" `
-Rules $ruleCollection `
-RulePriority 1 
-DisplayProperties $displayProperties `
-DisplayTemplateUrl $displaytemplateUrl `
-Owner $tenantOwner

В этом примере сначала определяются переменные для URL-адреса сайта, владельца поиска и приложения поиска. Затем извлекается тип элемента результата и проверяется, является ли он встроенным. Если $resultType.BuiltIn возвращает значение false, тип элемента результата не является встроенным и его свойства можно задать с помощью Set-SPEnterpriseSearchResultItemType.

Далее в примере создается правило, с которым сопоставляются типы результирующих элементов, и добавляется в коллекцию правил свойств.

Далее в примере определяется, какие свойства типа элемента результата следует отображать и какой шаблон при этом использовать.

Наконец, в примере используется Set-SPEnterpriseSearchResultItemType командлет для изменения типа элемента результата.

Параметры

-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 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 2013, SharePoint Server 2016, SharePoint Server 2019

-DisplayProperties

Задает свойства результатов, которые будут отображаться.

Type:String
Aliases:dp
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DisplayTemplateUrl

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

Type:String
Aliases:url
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Задает тип элемента результата, который нужно обновить. Возможные значения: допустимый идентификатор GUID (например, 12345678-90ab-cdef-1234-567890bcdefgh).

Type:ResultItemTypePipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Name

Задает имя типа элемента результата.

Type:String
Aliases:n
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-OptimizeForFrequentUse

{{ Fill OptimizeForFrequentUse Description }}

Type:Boolean
Aliases:opt
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 2013, SharePoint Server 2016, SharePoint Server 2019

-RulePriority

Указывает приоритет набора правил по сравнению с другими правилами.

Type:Int32
Aliases:priority
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Rules

Задает набор правил для оценки относительно свойств результатов.

Type:PropertyRuleCollection
Aliases:rule
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SearchApplicationProxy

Задает прокси приложения поиска, содержащего тип элемента результата. Возможные значения: допустимый идентификатор GUID (например, 12345678-90ab-cdef-1234-567890bcdefgh), допустимое имя прокси приложения поиска (например, SearchAppProxy1) или экземпляр допустимого объекта SearchServiceApplicationProxy.

Type:SearchServiceApplicationProxyPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SourceID

Указывает источник результатов поиска, к которым применяется тип элемента результата.

Type:Guid
Aliases:sid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 2013, SharePoint Server 2016, SharePoint Server 2019