New-SPEnterpriseSearchResultItemType

Ссылка

Модуль:: SharePointServer

Применяется к:: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Синтаксис

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 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:	5
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-адрес шаблона отображения, который следует использовать при воспроизведении результатов. Указывайте абсолютный URL-адрес.

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

-ExistingResultItemType

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

Type:	ResultItemTypePipeBind
Aliases:	copy
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

-ExistingResultItemTypeOwner

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

Type:	SearchObjectOwner
Aliases:	eo
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

-Name

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

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

-OptimizeForFrequentUse

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

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:	4
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:	3
Default value:	None
Required:	True
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:	True
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:	6
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

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

New-SPEnterpriseSearchResultItemType

Синтаксис

Описание

Примеры

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

Параметры

-AssignmentCollection

-Confirm

-DisplayProperties

-DisplayTemplateUrl

-ExistingResultItemType

-ExistingResultItemTypeOwner

-Name

-OptimizeForFrequentUse

-Owner

-RulePriority

-Rules

-SearchApplication

-SearchApplicationProxy

-SourceID

-WhatIf

Обратная связь

Дополнительные ресурсы

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

New-SPEnterpriseSearchResultItemType

Синтаксис

Описание

Примеры

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

Параметры

-AssignmentCollection

-Confirm

-DisplayProperties

-DisplayTemplateUrl

-ExistingResultItemType

-ExistingResultItemTypeOwner

-Name

-OptimizeForFrequentUse

-Owner

-RulePriority

-Rules

-SearchApplication

-SearchApplicationProxy

-SourceID

-WhatIf

Связанные ссылки

Обратная связь

Дополнительные ресурсы