Compartir a través de

New-SPEnterpriseSearchResultItemType

Módulo:
SharePointServer module

Crea un nuevo tipo de elemento de resultado.

Sintaxis

New 

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

Copy 

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

Description

Use el New-SPEnterpriseSearchResultItemType cmdlet para crear un nuevo tipo de elemento de resultado.

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, Word documentos.
  • 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

$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

En este ejemplo se define en primer lugar la regla que se va a aplicar a los resultados de búsqueda con el fin de establecer como destino los resultados con una propiedad específica y agrega la regla a la colección de reglas.

A continuación, el ejemplo define las propiedades del resultado que se mostrará y la dirección URL de la plantilla para mostrar que determina el aspecto de los resultados representados.

Por último, en el ejemplo se define el tipo de elemento de regla por su nombre, la colección de reglas, las propiedades para mostrar, la plantilla para mostrar y el propietario del inquilino.

Parámetros

-AssignmentCollection

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:SPAssignmentCollection
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DisplayProperties

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Dp

Conjuntos de parámetros

(All)
Posición:5
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DisplayTemplateUrl

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:url

Conjuntos de parámetros

New
Posición:7
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Copy
Posición:7
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ExistingResultItemType

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica un tipo de elemento de resultados existente al que se pueden agregar nuevas reglas o propiedades mostradas.

Propiedades del parámetro

Tipo:ResultItemTypePipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:copiar

Conjuntos de parámetros

Copy
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ExistingResultItemTypeOwner

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SearchObjectOwner
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Eo

Conjuntos de parámetros

Copy
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica el nombre del tipo de elemento de resultado.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:n

Conjuntos de parámetros

New
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Copy
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OptimizeForFrequentUse

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Habilite esta marca si siempre desea que se soliciten propiedades de este tipo de elemento de resultados, sin importar si se ha desencadenado el tipo de resultados. Esto mejorará el rendimiento solo si se habilita en los tipos de elemento de resultado usados con más frecuencia.

Propiedades del parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:optar

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Owner

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SearchObjectOwner
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:o

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RulePriority

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:priority

Conjuntos de parámetros

(All)
Posición:4
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Rules

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:PropertyRuleCollection
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:regla

Conjuntos de parámetros

New
Posición:3
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Copy
Posición:3
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SearchApplication

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica la aplicación de búsqueda que contiene el tipo de elemento de resultados. 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.

Propiedades del parámetro

Tipo:SearchServiceApplicationPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SearchApplicationProxy

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:SearchServiceApplicationProxyPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SourceID

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Identifica el origen del resultado de búsqueda al que se aplica el tipo de elemento de resultado. Deje este parámetro en blanco para aplicarlo a todos los orígenes de resultados.

Propiedades del parámetro

Tipo:Guid
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Sid

Conjuntos de parámetros

(All)
Posición:6
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.