New-SPEnterpriseSearchResultItemType

  • Ссылка
Модуль:
sharepoint-server
Применяется к:
SharePoint Server Subscription Edition

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

Синтаксис

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

Описание

New-SPEnterpriseSearchResultItemType Используйте командлет для создания нового типа элемента результата.

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

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

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

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

Примеры

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

$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"
$web = Get-SPWeb https://webUrl
$tenantOwner = Get-SPEnterpriseSearchOwner -Level SPSite -SPWeb $web
$proxy = Get-SPEnterpriseSearchServiceApplicationProxy
New-SPEnterpriseSearchResultItemType -SearchApplicationProxy $proxy `
>> -Name "CustomResultType" `
>> -Rules $ruleCollection `
>> -RulePriority 1 `
>> -DisplayProperties $displayProperties `
>> -DisplayTemplateUrl $displaytemplateUrl `
>> -Owner $tenantOwner

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

После этого в примере определяются свойства результата, которые следует отображать, и URL-адрес шаблона отображения, определяющего вид воспроизводимых результатов.

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

Параметры

-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

-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

-DisplayProperties

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

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

-DisplayTemplateUrl

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

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

-ExistingResultItemType

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

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

-ExistingResultItemTypeOwner

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

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

-Name

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

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

-OptimizeForFrequentUse

Включите этот флаг, если хотите, чтобы свойства этого типа элемента результата запрашивались всегда независимо от того, активируется ли тип результата. Это повышает производительность, если флаг включается только на наиболее часто используемых типах элементов результатов.

Type:Boolean
Aliases:opt
Position:Named
Default value:None
Required:False
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

-RulePriority

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

Type:Int32
Aliases:priority
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Rules

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

Type:PropertyRuleCollection
Aliases:rule
Position:3
Default value:None
Required:True
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:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

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

-SourceID

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

Type:Guid
Aliases:sid
Position:6
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