Set-SPEnterpriseSearchResultItemType
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 $tenantOwnerEn 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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 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
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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |