Set-SPEnterpriseSearchResultItemType

  • Referencia
Módulo:
sharepoint-server
Se aplica a:
SharePoint Server Subscription Edition

Establece las propiedades de un tipo de elemento de resultado.

Syntax

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>]

Description

El Set-SPEnterpriseSearchResultItemType cmdlet establece las propiedades de los tipos de elementos de resultado creados por el usuario. No puede usar este cmdlet para establecer o cambiar las propiedades de los tipos de elementos de resultado integrados que se incluyen con productos de SharePoint.

Los tipos de elemento de resultado permiten cambiar el aspecto de los resultados de búsqueda en función del tipo de resultado. Debe comenzar por definir una colección de reglas, que se evaluarán según las propiedades de los resultados. A continuación, debe definir la plantilla de visualización que se usará para representar el tipo de resultado. Cuando haya creado el tipo de elemento de resultado, los resultados que coincidan con las reglas del tipo de elemento de resultado se representarán con la plantilla de visualización especificada.

Casos de uso de ejemplo:

  • Cambie el aspecto de los resultados de una extensión de nombre de archivo determinada, por ejemplo, documentos de Word.
  • Cambia la apariencia de un tipo de contenido determinado en los resultados de la búsqueda.
  • Cambia la apariencia de los resultados de un autor determinado.
  • Se agrega una acción de resultado a los resultados de un origen de resultados determinado, como parte de una aplicación de búsqueda personalizada.

Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

--------------------EJEMPLO---------------------

$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

En este ejemplo se definen primero las variables de la dirección URL del sitio, el propietario de la búsqueda y la aplicación de búsqueda. Recupera el tipo de elemento de resultado y comprueba si el tipo de elemento de resultado es un tipo de elemento de resultado integrado. Si $resultType.BuiltIn devuelve false, el tipo de elemento de resultado no está integrado y puede establecer sus propiedades mediante Set-SPEnterpriseSearchResultItemType.

A continuación, en el ejemplo se crea la regla con la que deben coincidir los tipos de elemento de resultado y se agrega a una colección de reglas de propiedad.

Acto seguido, el ejemplo define qué propiedades del tipo de elemento de contenido deben mostrarse y muestra la plantilla que se va a usar.

Por último, en el ejemplo se usa el Set-SPEnterpriseSearchResultItemType cmdlet para modificar el tipo de elemento de resultado.

Parámetros

-AssignmentCollection

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

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

-Confirm

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: 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

Especifica el tipo de propiedades de resultados que se van a mostrar.

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

-DisplayTemplateUrl

Especifica la dirección URL de la plantilla para mostrar que se usará para representar los resultados.

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

-Identity

Especifica el tipo de elemento de resultado que se va a actualizar. El tipo debe ser un GUID válido, con el formato 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 Subscription Edition

-Name

Especifica el nombre del tipo de elemento de resultado.

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

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

-Owner

Especifica el propietario del objeto de búsqueda que define el ámbito en el que se creó el tipo de elemento de resultado correspondiente.

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

Especifica la prioridad que tiene la colección de reglas en comparación con otras reglas.

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

-Rules

Especifica la colección de reglas con respecto a las que se van a evaluar las propiedades de los resultados.

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

-SearchApplication

Especifica el nombre de la aplicación de búsqueda. El tipo debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh; un nombre de aplicación de búsqueda válido (por ejemplo, SearchApp1); o una instancia de un objeto SearchServiceApplication válido.

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

-SearchApplicationProxy

Especifica el proxy de la aplicación de búsqueda que contiene el tipo de elemento de resultado. El tipo debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh; un nombre de proxy de aplicación de búsqueda válido (por ejemplo, SearchAppProxy1); o una instancia de un objeto SearchServiceApplicationProxy válido.

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

-SourceID

Identifica el origen del resultado de búsqueda al que se aplica el tipo de elemento de resultado.

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

-WhatIf

Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando. Para obtener más información, escriba el siguiente comando: 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