Gerenciar componentes de pesquisa no SharePoint Server

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

Os procedimentos e os exemplos neste artigo partem do princípio de que o SharePoint ServerSharePoint Server e a aplicação de serviço de Pesquisa estão instalados e que existe uma topologia de pesquisa e itens existentes no índice de pesquisa do SharePoint Server. Se o SharePoint Server e o aplicativo de serviço de Pesquisa foram recentemente instalados e não houver itens no índice de pesquisa do SharePoint Server, siga os procedimentos em Alterar a topologia de pesquisa padrão no SharePoint Server.

Os procedimentos neste artigo são aplicados aos seguintes componentes de pesquisa:

• Componente de processamento de análise

• Componente de processamento de conteúdo

• Componente de rastreamento

• Componente de administração de pesquisa

• Componente do processamento de consulta

Para obter informações sobre os procedimentos para gerenciar o componente de índice, consulte Gerenciar o componente de índice no SharePoint Server.

Antes de começar

Antes de começar, veja os pré-requisitos a seguir.

• O SharePoint Server é instalado e um aplicativo de serviço de Pesquisa com uma topologia de pesquisa é criado. O aplicativo de serviço de pesquisa está em um estado íntegro e não é pausado por nenhum motivo.

• A conta de usuário que está executando os procedimentos neste artigo é membro do grupo Administradores de Farm.

• Você tem uma topologia de pesquisa de destino planejada.

• O SharePoint Server está instalado em todos os servidores nos quais você deseja hospedar componentes de pesquisa. Os servidores foram adicionados ao farm, e você é administrador em todos eles. Você pode criar novos servidores de aplicativos ou defini-los em uma implementação existente.

Iniciar uma instância de serviço de pesquisa em um servidor

Antes de adicionar componentes de pesquisa a um novo servidor, você deve iniciar uma instância do serviço de pesquisa no servidor. A instância do serviço de pesquisa inicia todos os serviços do Windows necessários usados pelo serviço de pesquisa (OSearch16 e SPSearchHostController).

Para iniciar uma instância de serviço de pesquisa

1. Verifique se a conta do usuário que está executando esse procedimento é membro do grupo Administradores de Farm.

2. Inicie o Shell de Gerenciamento do SharePoint em um dos servidores do farm.

3. No prompt de comando do Microsoft PowerShell, digite o(s) seguinte(s) comando(s):

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

   Em que:

   • $ <host n> especifica a referência de objeto do PowerShell para a instância do serviço de pesquisa.

   • <Nome do servidor> especifica o servidor no qual você deseja acrescentar um componente de índice. A entrada tem de ser um GUID válido, no formulário 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de um servidor (por exemplo, myserver1 ); ou uma instância de um objeto SearchServiceInstance válido.

   Por exemplo:

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

   Utilize as referências ($<host n>) para especificar o servidor de destino quando adiciona componentes de pesquisa.

4. Aguarde até todas as instâncias do serviço de pesquisa estiverem funcionando. Para cada instância do serviço de pesquisa, no prompt de comando do Microsoft PowerShell, digite o seguinte comando até ele retornar o status Online:

   Get-SPEnterpriseSearchServiceInstance -Identity $<host n >
   
   

   Por exemplo:

   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
   
   

Como recuperar a topologia de pesquisa ativa

Para visualizar a topologia de pesquisa ativa do Aplicativo de serviço de pesquisa, você tem que usar o Microsoft PowerShell.

Para visualizar a topologia de pesquisa ativa

1. Verifique se a conta do usuário que está executando esse procedimento é membro do grupo Administradores de Farm.

2. Inicie um Shell de Gerenciamento do SharePoint. Se você já abriu o Shell de Gerenciamento do SharePoint no qual você criou as referências de objeto do Microsoft PowerShell reutilizáveis, use o shell de abertura.

3. No prompt de comando do Microsoft PowerShell, digite o seguinte comando:

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

O comando retorna uma informação sobre a topologia ativa, por exemplo: TopologyId : 2d7bb046-1ad4-43a9-9984-754c4551a3ec CreationDate : 1/25/2016 3:06:00 AM State : Active ComponentCount : 6

Como recuperar uma lista de componentes de pesquisa

Para ver uma lista de componentes de pesquisa na topologia de pesquisa ativa com as respetivas propriedades, tem de utilizar o Microsoft PowerShell. Uma das propriedades do componente de pesquisa é o ID do componente de pesquisa. Só precisará do ID do componente de pesquisa para remover um componente de pesquisa.

Para visualizar uma lista de todos os componentes de pesquisa

1. Verifique se a conta do usuário que está executando esse procedimento é membro do grupo Administradores de Farm.

2. Inicie um Shell de Gerenciamento do SharePoint. Se já tiver uma Shell de Gestão do SharePoint aberta na qual criou referências de objetos reutilizáveis da Shell de Gestão do SharePoint, utilize a shell aberta.

3. No prompt de comando do Microsoft PowerShell, digite o(s) seguinte(s) comando(s):

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

   O comando retorna uma lista de componentes de pesquisa na topologia de pesquisa ativa e suas propriedades.

Clonar a topologia de pesquisa ativa

Para realizar qualquer alteração na topologia de pesquisa em uma instalação de pesquisa com itens no índice de pesquisa, você primeiro precisa criar um novo objeto de topologia. Você modifica este novo objeto de topologia, um clone da topologia ativa, adicionando ou removendo componentes de pesquisa. Após realizar as mudanças no objeto de topologia de clone, você cria o clone da topologia ativa.

Para clonar a topologia ativa

1. Verifique se a conta do usuário que está executando esse procedimento é membro do grupo Administradores de Farm.

2. Inicie um Shell de Gerenciamento do SharePoint. Se você já abriu o Shell de Gerenciamento do SharePoint no qual você criou as referências de objeto do Microsoft PowerShell reutilizáveis, use o shell de abertura.

3. No prompt de comando do Microsoft PowerShell, digite o(s) seguinte(s) comando(s):

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

   O comando cria uma topologia de pesquisa clone que pode ser referenciada com $clone se continuar a utilizar a mesma Shell de Gestão do SharePoint para adicionar ou remover componentes de pesquisa e ativar a topologia de pesquisa.

4. (Opcional) Se você precisa remover componentes de pesquisa da topologia de pesquisa, precisa recuperar a Id do componente de pesquisa. No prompt de comando do Microsoft PowerShell, digite o seguinte comando:

   Get-SPEnterpriseSearchComponent -SearchTopology $clone
   

   O comando retorna uma lista de componentes de pesquisa na topologia de pesquisa clonada e suas propriedades, incluindo a Id do componente de pesquisa.

Adicionar um componente de pesquisa

Não é possível alterar a topologia de pesquisa ativa diretamente. Este procedimento presume que você tenha criado um objeto de topologia clone conforme descrito em Clonar a topologia de pesquisa ativa. Você pode usar os seguintes cmdlets do Microsoft PowerShell para cada componente de pesquisa:

• New-SPEnterpriseSearchAdminComponent

• New-SPEnterpriseSearchAnalyticsProcessingComponent

• New-SPEnterpriseSearchContentProcessingComponent

• New-SPEnterpriseSearchCrawlComponent

• New-SPEnterpriseSearchQueryProcessingComponent

Para adicionar um componente de pesquisa

1. Verifique se a conta do usuário que está executando esse procedimento é membro do grupo Administradores de Farm.

2. Inicie um Shell de Gerenciamento do SharePoint. Se você já abriu o Shell de Gerenciamento do SharePoint no qual você criou as referências de objeto do Microsoft PowerShell reutilizáveis, use o shell de abertura.

3. No prompt de comando do Microsoft PowerShell, digite o(s) seguinte(s) comando(s):

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

   Em que:

   • <SearchComponent> é o nome do tipo de componente de pesquisa que você está adicionando.

   • $clone é a topologia clonada que você está mudando. Consulte Clonar a topologia de pesquisa ativa.

   • $<host n> é a referência de objeto do PowerShell à instância do serviço de pesquisa em execução no servidor ao qual pretende adicionar o componente de pesquisa. Consulte Iniciar uma instância de serviço de pesquisa em um servidor.

   Por exemplo, o seguinte comando adiciona um componente de processamento de conteúdo para a topologia clonada no servidor identificado pela referência da instância do serviço de pesquisa $hostA.

   New-SPEnterpriseSearchContentProcessingComponent -SearchTopology $clone -SearchServiceInstance $hostA
   

4. Verifique se o novo componente de pesquisa foi adicionado à topologia de clone. No prompt de comando Microsoft PowerShell, digite o comando:

   Get-SPEnterpriseSearchComponent -SearchTopology $clone
   

Remover um componente de pesquisa

Para remover um componente de pesquisa, você deve usar o Windows PowerShell. Não é possível alterar a topologia de pesquisa ativa diretamente. Este procedimento assume que você criou um objeto de topologia clone como descrito em Clonar a topologia de pesquisa ativa.

Para remover um componente de pesquisa

1. Verifique se a conta do usuário que está executando esse procedimento é membro do grupo Administradores de Farm.

2. Inicie um Shell de Gerenciamento do SharePoint. Se você já abriu o Shell de Gerenciamento do SharePoint no qual você criou as referências de objeto do Microsoft PowerShell reutilizáveis, use o shell de abertura.

3. Certifique-se de que a topologia ativa atual está íntegra e que o componente de pesquisa que você irá remover está Ativo. Veja o estado da topologia de pesquisa na página Administração de Pesquisas na Administração Central ou execute o cmdlet Get-SPEnterpriseSearchStatusdo Windows PowerShell .

4. No prompt de comando do Microsoft PowerShell, digite o(s) seguinte(s) comando(s):

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

   Em que:

   • <Id do componente de pesquisa> é a Id do componente de pesquisa que você deseja remover. Use a Id do componente de pesquisa da topologia clone. Para recuperar a Id do componente de pesquisa, consulte a etapa 4 em Clonar a topologia de pesquisa ativa.

   • $clone é a topologia clonada que você está mudando. Consulte Clonar a topologia de pesquisa ativa.

5. Quando solicitado, confirme que você quer remover o componente de pesquisa.

Mover um componente de pesquisa

Se você deseja mover um componente de pesquisa de um servidor para outro, recomendamos adicionar um novo componente de pesquisa à topologia de pesquisa antes de remover o componente de pesquisa antigo.

Para mover um componente de pesquisa

1. Clonar a topologia de pesquisa ativa. Consulte Clonar a topologia de pesquisa ativa.

2. Adicionar um novo componente de pesquisa ao servidor que você eventualmente deseja pesquisar para ser hospedado. Consulte Adicionar um componente de pesquisa.

3. Ativar a topologia de pesquisa. Esta topologia terá um componente de pesquisa supérfluo. Consulte Ativar uma topologia de pesquisa.

4. Certifique-se de que a topologia ativa atual está saudável. Veja o estado da topologia de pesquisa na página Administração de Pesquisas na Administração Central ou execute o cmdlet Get-SPEnterpriseSearchStatusdo Windows PowerShell .

5. Clone a topologia de pesquisa novamente. Consulte Clonar a topologia de pesquisa ativa.

6. Remover o componente de pesquisa supérfluo. Consulte Remover um componente de pesquisa.

7. Ativar a topologia de pesquisa novamente. Consulte Como ativar uma topologia de pesquisa.

Ativar uma topologia de pesquisa

Para ativar a topologia de pesquisa, você deve usar o Windows PowerShell.

Para ativar uma topologia de pesquisa

1. Verifique se a conta do usuário que está executando esse procedimento é membro do grupo Administradores de Farm.

2. Inicie um Shell de Gerenciamento do SharePoint. Se você já abriu o Shell de Gerenciamento do SharePoint no qual você criou as referências de objeto do Microsoft PowerShell reutilizáveis, use o shell de abertura.

3. No prompt de comando do Microsoft PowerShell, digite o(s) seguinte(s) comando(s):

   Set-SPEnterpriseSearchTopology -Identity $clone
   

   Em que:

   • $clone é a topologia clonada que você está mudando. Consulte Clonar a topologia de pesquisa ativa.

4. Verifique se a sua nova topologia está ativa. No prompt de comando Windows PowerShell, digite os seguintes comandos:

   Get-SPEnterpriseSearchTopology -Active -SearchApplication $ssa
   

   O comando retorna uma visão geral de topologias ativas e inativas, por exemplo:

   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
   

   Você verá que a contagem do componente da topologia ativa reflete as mudanças realizadas.