Administrar componentes de búsqueda en SharePoint Server

SE APLICA A:2013 2016 2019 Subscription Edition SharePoint en Microsoft 365

Los procedimientos y los ejemplos de este artículo suponen que SharePoint ServerSharePoint Server y la aplicación servicio Search están instalados, y que hay una topología de búsqueda y elementos existentes en el índice de búsqueda de SharePoint Server. Si SharePoint Server y la aplicación de servicio de búsqueda se instalaron recientemente y no hay elementos en el índice de búsqueda de SharePoint Server, siga los procedimientos descritos en Cambiar la topología de búsqueda predeterminada en SharePoint Server.

Los procedimientos de este artículo son válidos para los siguientes componentes de búsqueda:

• Componente de procesamiento de Analytics

• Componente de procesamiento de contenido

• Componente de rastreo

• Componente de administración de búsqueda

• Componente de procesamiento de consulta

Para obtener información sobre los procedimientos para administrar el componente de índice, consulte Administrar el componente de índice en SharePoint Server.

Antes de empezar

Antes de empezar, revise los requisitos previos siguientes.

• SharePoint Server debe estar instalado y debe haberse creado una aplicación del servicio de búsqueda con una topología de búsqueda. La aplicación de servicio de búsqueda está en buen estado y no se ha pausado por ningún motivo.

• La cuenta de usuario que lleva a cabo las operaciones descritas en este artículo debe ser miembro del grupo Administradores de la granja de servidores.

• Ha planeado una topología de búsqueda objetivo.

• SharePoint Server se instala en todos los servidores donde quiera hospedar componentes de búsqueda. Los servidores se agregaron a la granja de servidores y el usuario debe ser administrador en todos estos servidores. Puede crear otros servidores de aplicaciones o definir servidores de aplicaciones en una implementación existente.

Importante

En los procedimientos de este artículo se usa PowerShell de Microsoft. Los comandos de PowerShell de Microsoft se pueden ejecutar en cualquier servidor de la granja de servidores. Sin embargo, si va a realizar varios procedimientos de topología de búsqueda, debe usar el mismo Shell de administración de SharePoint para todos los comandos de Microsoft PowerShell, de modo que pueda compartir referencias de objetos de Microsoft PowerShell entre comandos.

Iniciar una instancia de servicio de búsqueda en un servidor

Antes de agregar componentes de búsqueda a un nuevo servidor, debe crear una instancia de servicio de búsqueda en el servidor. Esta instancia de servicio de búsqueda inicia todos los servicios de Windows necesarios (OSearch16 y SPSearchHostController) que el servicio de búsqueda usa.

Para iniciar una instancia de servicio de búsqueda

1. Compruebe si la cuenta de usuario que va a realizar este procedimiento es miembro del grupo Administradores de la granja de servidores.

2. Inicie un Shell de administración de SharePoint en uno de los servidores de la granja.

3. Escriba los siguientes comandos en el símbolo del sistema de PowerShell de Microsoft:

   $<host n > = Get-SPEnterpriseSearchServiceInstance -Identity "<Server name>"
   Start-SPEnterpriseSearchServiceInstance -Identity $<host n >
   

   Donde:

   • $ <host n> es la referencia al objeto de PowerShell relativa a la instancia del servicio de búsqueda.

   • <Nombre del servidor> especifica el servidor en el que desea agregar un componente de índice. La entrada debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh; un nombre válido de un servidor (por ejemplo, myserver1 ); o una instancia de un objeto SearchServiceInstance válido.

   Por ejemplo:

   $hostA = Get-SPEnterpriseSearchServiceInstance -Identity "myserver1"
   $hostB = Get-SPEnterpriseSearchServiceInstance -Identity "myserver2"
   Start-SPEnterpriseSearchServiceInstance -Identity $hostA
   Start-SPEnterpriseSearchServiceInstance -Identity $hostB 
   
   

   Las referencias ($<host n>) se usan para especificar el servidor de destino al agregar componentes de búsqueda.

4. Espere a que todas las instancias de servicio de búsqueda se ejecuten. En cada una de ellas, escriba el siguiente comando en el símbolo del sistema de PowerShell de Microsoft hasta que el comando devuelva el estado Online:

   Get-SPEnterpriseSearchServiceInstance -Identity $<host n >
   
   

   Por ejemplo:

   Get-SPEnterpriseSearchServiceInstance -Identity $hostA
   TypeName    : SharePoint Server Search
   Description : Index content and serve search queries
   Id          : 82ce8815-ecbd-4cf3-a98e-33f20bd86039
   Server      : SPServer Name=myserver1.example.com
   Service     : SearchService Name=OSearch16
   Role        : None
   Status      : Online
   
   

Recuperar la topología de búsqueda activa

Se debe usar PowerShell de Microsoft para ver la topología de búsqueda activa de la aplicación de servicio de búsqueda.

Para ver la topología de búsqueda activa

1. Compruebe si la cuenta de usuario que va a realizar este procedimiento es miembro del grupo Administradores de la granja de servidores.

2. Inicie un Shell de administración de SharePoint. Si ya hay un Shell de administración de SharePoint abierto en el que haya creado referencias de objeto de PowerShell de Microsoft reutilizables, úselo.

3. En el símbolo del sistema de Microsoft PowerShell, escriba el siguiente comando:

   $ssa = Get-SPEnterpriseSearchServiceApplication
   $active = Get-SPEnterpriseSearchTopology -Active -SearchApplication $ssa 
   $active
   

El comando devuelve información sobre la topología activa. Por ejemplo: TopologyId : 2d7bb046-1ad4-43a9-9984-754c4551a3ec CreationDate : 1/25/2016 3:06:00 AM State : Active ComponentCount : 6.

Recuperar una lista de componentes de búsqueda

Se debe usar PowerShell de Microsoft para ver una lista de componentes de búsqueda en la topología de búsqueda activa con sus propiedades correspondientes. Una de las propiedades de componente de búsqueda es el identificador de componente de búsqueda, que es lo único que se necesita para eliminar un componente de búsqueda.

Para ver una lista de todos los componentes de búsqueda

1. Compruebe si la cuenta de usuario que va a realizar este procedimiento es miembro del grupo Administradores de la granja de servidores.

2. Inicie un Shell de administración de SharePoint. Si ya tiene un Shell de administración de SharePoint abierto en el que ha creado referencias de objetos reutilizables de Shell de administración de SharePoint, use el shell abierto en su lugar.

3. En el símbolo del sistema de PowerShell de Microsoft, escriba los comandos siguientes:

   $ssa = Get-SPEnterpriseSearchServiceApplication
   $active = Get-SPEnterpriseSearchTopology -SearchApplication $ssa -Active
   Get-SPEnterpriseSearchComponent -SearchTopology $active
   

   El comando devuelve una lista de los componentes de búsqueda que hay en la topología de búsqueda activa, junto con sus propiedades.

Clonar la topología de búsqueda activa

Para poder cambiar la topología de búsqueda en una instalación de búsqueda que tiene elementos en el índice de búsqueda, primero hay que crear un objeto de topología. Después, este nuevo objeto topología (clon de la topología activa) se modifica agregando o quitando componentes de búsqueda. Tras efectuar los cambios en el clon de objeto de topología, solo queda convertir dicho clon en la topología activa.

Para clonar la topología activa

1. Compruebe si la cuenta de usuario que va a realizar este procedimiento es miembro del grupo Administradores de la granja de servidores.

2. Inicie un Shell de administración de SharePoint. Si ya hay un Shell de administración de SharePoint abierto en el que haya creado referencias de objeto de PowerShell de Microsoft reutilizables, úselo.

3. En el símbolo del sistema de Microsoft PowerShell, escriba los siguientes comandos:

   $ssa = Get-SPEnterpriseSearchServiceApplication
   $active = Get-SPEnterpriseSearchTopology -SearchApplication $ssa -Active
   $clone = New-SPEnterpriseSearchTopology -SearchApplication $ssa -Clone -SearchTopology $active
   

   El comando crea una topología de búsqueda clonada a la que se puede hacer referencia con $clone si continúa usando el mismo Shell de administración de SharePoint para agregar o quitar componentes de búsqueda y activar la topología de búsqueda.

4. (Opcional) En caso de que tenga que quitar componentes de búsqueda de la topología, deberá recuperar el identificador de dichos componentes. Escriba los siguientes comandos en el símbolo del sistema de PowerShell de Microsoft:

   Get-SPEnterpriseSearchComponent -SearchTopology $clone
   

   El comando devuelve una lista de los componentes de búsqueda que hay en la topología de búsqueda clonada y sus propiedades correspondientes, además del identificador de cada uno de ellos.

Agregar un componente de búsqueda

La topología de búsqueda activa no se puede cambiar de forma directa. En este procedimiento se da por hecho que ha creado un objeto de topología clonado, tal y como se describe en Clonar la topología de búsqueda activa. Puede usar los siguientes cmdlets de PowerShell de Microsoft para cada uno de los componentes de búsqueda:

• New-SPEnterpriseSearchAdminComponent

• New-SPEnterpriseSearchAnalyticsProcessingComponent

• New-SPEnterpriseSearchContentProcessingComponent

• New-SPEnterpriseSearchCrawlComponent

• New-SPEnterpriseSearchQueryProcessingComponent

Nota:

El procedimiento para agregar un componente de índice es distinto. Para obtener más información, consulte Administrar el componente de índice en SharePoint Server.

Para agregar un componente de búsqueda

1. Compruebe si la cuenta de usuario que va a realizar este procedimiento es miembro del grupo Administradores de la granja de servidores.

2. Inicie un Shell de administración de SharePoint. Si ya hay un Shell de administración de SharePoint abierto en el que haya creado referencias de objeto de PowerShell de Microsoft reutilizables, úselo.

3. En el símbolo del sistema de Microsoft PowerShell, escriba los siguientes comandos:

   New-SPEnterpriseSearch<SearchComponent> -SearchTopology $clone -SearchServiceInstance $<host n >
   

   Donde:

   • <SearchComponent> es el nombre del tipo de componente de búsqueda que se va a agregar.

   • $clone es la topología clonada que va a cambiar. Consulte Clonar la topología de búsqueda activa.

   • $<host n> es la referencia de objeto de PowerShell a la instancia del servicio de búsqueda en ejecución en el servidor al que desea agregar el componente de búsqueda. Consulte Iniciar una instancia de servicio de búsqueda en un servidor.

   Por ejemplo, con el siguiente comando se agrega un componente de procesamiento de contenido a la topología clonada en el servidor identificado mediante la referencia de instancia de servicio de búsqueda $hostA.

   New-SPEnterpriseSearchContentProcessingComponent -SearchTopology $clone -SearchServiceInstance $hostA
   

4. Asegúrese de que el nuevo componente de búsqueda se haya agregado a la topología clonada. Escriba el siguiente comando en el símbolo del sistema de PowerShell de Microsoft:

   Get-SPEnterpriseSearchComponent -SearchTopology $clone
   

Quitar un componente de búsqueda

Para quitar un componente de búsqueda se debe usar Windows PowerShell. La topología de búsqueda activa no se puede cambiar de forma directa. En este procedimiento se da por hecho que ha creado un objeto de topología clonado, tal y como se describe en Clonar la topología de búsqueda activa.

Nota:

El procedimiento para quitar un componente de índice es distinto. Para obtener más información, consulte Administrar el componente de índice en SharePoint Server.

Para quitar un componente de búsqueda

1. Compruebe si la cuenta de usuario que va a realizar este procedimiento es miembro del grupo Administradores de la granja de servidores.

2. Inicie un Shell de administración de SharePoint. Si ya hay un Shell de administración de SharePoint abierto en el que haya creado referencias de objeto de PowerShell de Microsoft reutilizables, úselo.

3. Procure que la topología activa actual sea correcta y que el componente de búsqueda que va a quitar esté en estado activo. Vea el estado de la topología de búsqueda en la página Administración de búsqueda de Administración central o ejecute el cmdlet Get-SPEnterpriseSearchStatusWindows PowerShell .

4. En el símbolo del sistema de Microsoft PowerShell, escriba los siguientes comandos:

   Remove-SPEnterpriseSearchComponent -Identity <Search component id> -SearchTopology $clone
   

   Donde:

   • <Search component id> es el identificador del componente de búsqueda que desea quitar. Use el identificador de componente de búsqueda de la topología clonada. Para hallarlo, consulte el paso 4 en Clonar la topología de búsqueda activa.

   • $clone es la topología clonada que va a cambiar. Consulte Clonar la topología de búsqueda activa.

5. Cuando se le pida, confirme que quiere quitar el componente de búsqueda.

Mover un componente de búsqueda

En caso de que quiera mover un componente de búsqueda de un servidor a otro, le recomendamos que, antes de eliminar el componente de búsqueda antiguo, agregue uno nuevo a la topología de búsqueda.

Para mover un componente de búsqueda

1. Clone la topología de búsqueda activa. Consulte Clonar la topología de búsqueda activa.

2. Agregue un componente de búsqueda nuevo al servidor en el que desea hospedar el componente de búsqueda en última instancia. Consulte Agregar un componente de búsqueda.

3. Active la topología de búsqueda. Esta topología tendrá un componente de búsqueda irrelevante. Consulte Activar una topología de búsqueda.

4. Procure que la topología activa actual sea correcta. Vea el estado de la topología de búsqueda en la página Administración de búsqueda de Administración central o ejecute el cmdlet Get-SPEnterpriseSearchStatusWindows PowerShell .

5. Vuelva a clonar la topología de búsqueda. Consulte Clonar la topología de búsqueda activa.

6. Quite el componente de búsqueda irrelevante. Consulte Quitar un componente de búsqueda.

7. Vuelva a activar la topología de búsqueda. Consulte Activar una topología de búsqueda.

Activar una topología de búsqueda

Para activar una topología de búsqueda debe usar Windows PowerShell.

Para activar una topología de búsqueda

1. Compruebe si la cuenta de usuario que va a realizar este procedimiento es miembro del grupo Administradores de la granja de servidores.

2. Inicie un Shell de administración de SharePoint. Si ya hay un Shell de administración de SharePoint abierto en el que haya creado referencias de objeto de PowerShell de Microsoft reutilizables, úselo.

3. En el símbolo del sistema de Microsoft PowerShell, escriba los siguientes comandos:

   Set-SPEnterpriseSearchTopology -Identity $clone
   

   Donde:

   • $clone es la topología clonada que va a cambiar. Consulte Clonar la topología de búsqueda activa.

4. Asegúrese de que la nueva topología está activa. Escriba los siguientes comandos en el símbolo del sistema de Windows PowerShell:

   Get-SPEnterpriseSearchTopology -Active -SearchApplication $ssa
   

   El comando devuelve información acerca de las topologías activas e inactivas. Por ejemplo:

   TopologyId     : fce8507d-61c6-4498-8038-4fd2d0a62c6e
   CreationDate   : 1/30/2016 2:52:00 AM
   State          : Inactive
   ComponentCount : 6
   TopologyId     : b63d48b2-df5c-41be-a7f4-9abaee483611
   CreationDate   : 1/30/2016 4:30:00 AM
   State          : Active
   ComponentCount : 7
   

   Verá que el recuento de componentes de la topología activa los cambios realizados.