Remove-SPEnterpriseSearchResultItemType

  • Referencia
Módulo:
SharePointServer
Se aplica a:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Quita un tipo de elemento de resultados de un propietario de objeto de búsqueda.

Syntax

Remove-SPEnterpriseSearchResultItemType
      [-Identity] <ResultItemTypePipeBind>
      -Owner <SearchObjectOwner>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-SearchApplication <SearchServiceApplicationPipeBind>]
      [-SearchApplicationProxy <SearchServiceApplicationProxyPipeBind>]
      [-WhatIf]
      [<CommonParameters>]

Description

El Remove-SPEnterpriseSearchResultItemType cmdlet quita un tipo de elemento de resultado creado por el usuario, dada una identidad de tipo de resultado y un propietario de búsqueda. No puede usar este cmdlet para quitar 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 mostrará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 "UrlOfTheSite"
$tenantOwner = Get-SPEnterpriseSearchOwner -Level SPSite -SPWeb $web
$searchapp = Get-SPEnterpriseSearchServiceApplication
$resultType = Get-SPEnterpriseSearchResultItemType -Owner $tenantOwner -SearchApplication $searchapp
Remove-SPEnterpriseSearchResultItemType -Identity $resultType -Owner $tenantOwner -SearchApplication $searchapp

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. A continuación, recupera el tipo de elemento de resultado y comprueba si el tipo de elemento de resultado es un tipo de elemento de resultado integrado o no. Si $resultType.BuiltIn devuelve el valor falso, quiere decir que el tipo de elemento de resultado no está integrado y puede modificarlo. Acto seguido, el ejemplo quita el tipo de elemento de resultado al que se hace referencia con $resultType para el propietario al que se hace referencia con $tenantOwner.

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

-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

-Owner

Especifica el propietario del objeto de búsqueda que define el ámbito en el que se crea 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

-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

-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