Gérer les composants de recherche dans SharePoint Server

 

**Sapplique à :**SharePoint Server 2013, SharePoint Server 2016

**Dernière rubrique modifiée :**2017-09-08

Résumé : Découvrez comment utiliser Windows PowerShell pour gérer les composants de recherche dans une topologie de recherche existante disposant de contenu dans l’index de recherche SharePoint Server. Appliquez ces procédures pour agrandir ou réduire la topologie de recherche de l’application Service de recherche.

Les procédures et exemples de cet article partent du principe que SharePoint ServerSharePoint Server 2016 et l’application Service de recherche sont installés, qu’il existe une topologie de recherche et qu’il y a des éléments dans l’index de recherche SharePoint Server. Si SharePoint Server et l’application Service de recherche viennent d’être installés et qu’il n’y a pas d’éléments dans l’index de recherche SharePoint Server, appliquez les procédures décrites dans Modifier la topologie de recherche par défaut dans SharePoint Server.

Les procédures décrites dans cet article s’appliquent aux composants de recherche suivants :

• Composant de traitement de l’analyse

• Composant de traitement du contenu

• Composant d’analyse

• Composant d’administration de la recherche

• Composant de traitement des requêtes

Pour plus d’informations sur les procédures de gestion du composant d’index, voir Gérer le composant d’index dans SharePoint Server.

Dans cet article :

• Avant de commencer

• Démarrer une instance de service de recherche sur un serveur

• Récupérer la topologie de recherche active

• Cloner la topologie de recherche active

• Ajouter un composant de recherche

• Supprimer un composant de recherche

• Déplacer un composant de recherche

• Activer une topologie de recherche

Avant de commencer

Avant de commencer, vérifiez les conditions préalables suivantes.

• SharePoint Server est installé et une application de service de recherche avec une topologie de recherche est créée. L’application de service de recherche fonctionne correctement et n’est pas suspendue pour une raison quelconque.

• Le compte d’utilisateur qui exécute les procédures de cet article est membre du groupe Administrateurs de batterie.

• Vous avez planifié une topologie de recherche cible.

• SharePoint Server est installé sur tous les serveurs qui doivent héberger des composants de recherche. Les serveurs ont été ajoutés à la batterie de serveurs et vous êtes administrateur sur tous ces serveurs. Vous pouvez créer de nouveaux serveurs d’applications ou définir des serveurs d’applications dans un déploiement existant.

Important

Les procédures de cet article font appel à Microsoft PowerShell. Vous pouvez exécuter les commandes Microsoft PowerShell sur n’importe quel serveur de la batterie. Toutefois, si vous effectuez plusieurs procédures de topologie de recherche, vous devez utiliser le même SharePoint 2016 Management Shell pour toutes les commandes Microsoft PowerShell, de façon à pouvoir partager des références d’objets Microsoft PowerShell entre les commandes.

Démarrer une instance de service de recherche sur un serveur

Avant d’ajouter des composants de recherche à un nouveau serveur, vous devez tout d’abord démarrer une instance de service de recherche sur le serveur. Celle-ci démarre tous les services Windows nécessaires utilisés par le service de recherche (OSearch16 et SPSearchHostController).

Pour démarrer une instance de service de recherche

1. Vérifiez que le compte d’utilisateur qui exécute cette procédure est membre du groupe Administrateurs de batterie.

2. Démarrez SharePoint Management Shell sur l’un des serveurs de la batterie.

3. À l’invite de commandes Microsoft PowerShell, tapez la ou les commandes suivantes :

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

   Où :

   • $<host n> spécifie la référence d’objet PowerShell pour l’instance de service de recherche.

   • <Server name> spécifie le serveur sur lequel vous voulez ajouter un composant d’index. Il doit s’agir d’un GUID valide, au format 12345678-90ab-cdef-1234-567890bcdefgh, d’un nom de serveur valide (par exemple, myserver1) ou d’une instance d’objet SearchServiceInstance valide.

   Par exemple :

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

   Vous utilisez les références ($<host n>) pour spécifier le serveur cible lorsque vous ajoutez des composants de recherche.

4. Patientez jusqu’à ce que toutes les instances du service de recherche soient en cours d’exécution. Pour chacune des instances du service de recherche, à l’invite de commandes Microsoft PowerShell, tapez la commande suivante jusqu’à ce qu’elle renvoie l’état En ligne :

   Get-SPEnterpriseSearchServiceInstance -Identity $<host n>
   

   Par exemple :

   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
   

Récupérer la topologie de recherche active

Pour afficher la topologie de recherche active de l’application de service de recherche, vous devez utiliser Microsoft PowerShell.

Pour afficher la topologie de recherche active

1. Vérifiez que le compte d’utilisateur qui exécute cette procédure est membre du groupe Administrateurs de batterie.

2. Démarrez SharePoint Management Shell. Si vous avez déjà ouvert une instance de SharePoint Management Shell dans laquelle vous avez créé des références d’objet Microsoft PowerShell réutilisables, utilisez plutôt l’environnement ouvert.

3. À l’invite de commandes Microsoft PowerShell, tapez la commande suivante :

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

La commande renvoie des informations sur la topologie active, par exemple : TopologyId : 2d7bb046-1ad4-43a9-9984-754c4551a3ec CreationDate : 1/25/2016 3:06:00 AM State : Active ComponentCount : 6

Récupérer la liste des composants de recherche

Pour afficher la liste des composants de recherche dans la topologie de recherche active avec leurs propriétés, vous devez utiliser Microsoft PowerShell. L’une des propriétés de composant de recherche est l’ID de composant de recherche. Vous n’aurez besoin de cet ID que pour supprimer un composant de recherche.

Pour afficher la liste de tous les composants de recherche

1. Vérifiez que le compte d’utilisateur qui exécute cette procédure est membre du groupe Administrateurs de batterie.

2. Démarrez SharePoint Management Shell. Si vous avez déjà ouvert une instance de SharePoint 2016 Management Shell dans laquelle vous avez créé des références d’objet SharePoint Management Shell réutilisables, utilisez plutôt l’environnement ouvert.

3. À l’invite de commandes Microsoft PowerShell, tapez la ou les commandes suivantes :

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

   La commande renvoie la liste des composants de recherche dans la topologie de recherche active et leurs propriétés.

Cloner la topologie de recherche active

Pour apporter des modifications à la topologie de recherche dans une installation de recherche pour laquelle des éléments figurent dans l’index de recherche, vous devez d’abord créer un objet de topologie. Ensuite, vous modifiez cet objet, un clone de la topologie active, en ajoutant ou en supprimant des composants de recherche. Après avoir apporté des modifications à l’objet de topologie de recherche, vous faites du clone la topologie active.

Pour cloner la topologie active

1. Vérifiez que le compte d’utilisateur qui exécute cette procédure est membre du groupe Administrateurs de batterie.

2. Démarrez SharePoint Management Shell. Si vous avez déjà ouvert une instance de SharePoint Management Shell dans laquelle vous avez créé des références d’objet Microsoft PowerShell réutilisables, utilisez plutôt l’environnement ouvert.

3. À l’invite de commandes Microsoft PowerShell, tapez la ou les commandes suivantes :

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

   La commande crée un clone de topologie de recherche qui peut être référencé avec $clone si vous continuez à utiliser le même SharePoint Management Shell pour ajouter ou supprimer des composants de recherche et pour activer la topologie de recherche.

4. (Facultatif) Si vous devez supprimer des composants de recherche de la topologie, vous devez récupérer l’ID de composant de recherche. À l’invite de commandes Microsoft PowerShell, tapez la ou les commandes suivantes :

   Get-SPEnterpriseSearchComponent -SearchTopology $clone
   

   La commande renvoie la liste des composants de recherche dans la topologie de recherche clonée et leurs propriétés, y compris l’ID de composant de recherche.

Ajouter un composant de recherche

Vous ne pouvez pas modifier la topologie de recherche active directement. Cette procédure part du principe que vous avez créé un objet clone de topologie comme décrit dans Cloner la topologie de recherche active. Vous pouvez utiliser les applets de commande Microsoft PowerShell suivantes pour chaque composant de recherche component:

• New-SPEnterpriseSearchAdminComponent

• New-SPEnterpriseSearchAnalyticsProcessingComponent

• New-SPEnterpriseSearchContentProcessingComponent

• New-SPEnterpriseSearchCrawlComponent

• New-SPEnterpriseSearchQueryProcessingComponent

Notes

La procédure d’ajout de composant d’index est différente. Pour plus d’informations, voir Gérer le composant d’index dans SharePoint Server.

Pour ajouter un composant de recherche

1. Vérifiez que le compte d’utilisateur qui exécute cette procédure est membre du groupe Administrateurs de batterie.

2. Démarrez SharePoint Management Shell. Si vous avez déjà ouvert une instance de SharePoint Management Shell dans laquelle vous avez créé des références d’objet Microsoft PowerShell réutilisables, utilisez plutôt l’environnement ouvert.

3. À l’invite de commandes Microsoft PowerShell, tapez la ou les commandes suivantes :

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

   Où :

   • <SearchComponent> est le nom du type de composant de recherche que vous ajoutez.

   • $clone est la topologie clonée que vous modifiez. Voir Cloner la topologie de recherche active.

   • $<host n> est la référence d’objet PowerShell à l’instance du service de recherche en cours d’exécution sur le serveur auquel vous souhaitez ajouter le composant de recherche. Voir Démarrer une instance de service de recherche sur un serveur.

   Par exemple, la commande suivante ajoute un composant de traitement du contenu au clone de topologie sur le serveur identifié par la référence d’instance de service de recherche $hostA.

   New-SPEnterpriseSearchContentProcessingComponent -SearchTopology $clone -SearchServiceInstance $hostA
   

4. Vérifiez que le nouveau composant de recherche a été ajouté à la topologie de clone. À l’invite de commandes Microsoft PowerShell, tapez la commande :

   Get-SPEnterpriseSearchComponent -SearchTopology $clone
   

Supprimer un composant de recherche

Pour supprimer un composant de recherche, vous devez utiliser Windows PowerShell. Vous ne pouvez pas modifier la topologie de recherche active directement. Cette procédure part du principe que vous avez créé un objet clone de topologie comme décrit dans Cloner la topologie de recherche active.

Notes

La procédure de suppression de composant d’index est différente. Pour plus d’informations, voir Gérer le composant d’index dans SharePoint Server.

Pour supprimer un composant de recherche

1. Vérifiez que le compte d’utilisateur qui exécute cette procédure est membre du groupe Administrateurs de batterie.

2. Démarrez SharePoint Management Shell. Si vous avez déjà ouvert une instance de SharePoint Management Shell dans laquelle vous avez créé des références d’objet Microsoft PowerShell réutilisables, utilisez plutôt l’environnement ouvert.

3. Vérifiez que la topologie actuellement active est intègre et que le composant de recherche que vous êtes sur le point de supprimer est Actif. Affichez l’état de la topologie de recherche dans la page Administration de la recherche de l’Administration centrale ou exécutez l’applet de commande Windows PowerShell Get-SPEnterpriseSearchStatus.

4. À l’invite de commandes Microsoft PowerShell, tapez la ou les commandes suivantes :

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

   Où :

   • <Search component id> est l’ID du composant de recherche que vous souhaitez supprimer. Utilisez l’ID du composant de recherche du clone de topologie. Pour récupérer l’ID du composant de recherche, voir l’étape 4 dans Cloner la topologie de recherche active.

   • $clone est la topologie clonée que vous modifiez. Voir Cloner la topologie de recherche active.

5. À l’invite, confirmez la suppression du composant de recherche.

Déplacer un composant de recherche

Si vous souhaitez déplacer un composant de recherche d’un serveur à un autre, nous vous recommandons d’ajouter un nouveau composant de recherche à la topologie de recherche avant de supprimer l’ancien composant de recherche.

Pour déplacer un composant de recherche

1. Clonez la topologie de recherche active. Voir Cloner la topologie de recherche active.

2. Ajoutez un nouveau composant de recherche au serveur sur lequel vous souhaitez que le composant de recherche soit hébergé. Voir Ajouter un composant de recherche.

3. Activez la topologie de recherche. Cette topologie aura un composant de recherche en trop. Voir Activer une topologie de recherche.

4. Vérifiez que la topologie actuellement active est intègre. Affichez l’état de la topologie de recherche dans la page Administration de la recherche de l’Administration centrale ou exécutez l’applet de commande Windows PowerShell Get-SPEnterpriseSearchStatus.

5. Clonez de nouveau la topologie de recherche. Voir Cloner la topologie de recherche active.

6. Supprimez le composant de recherche superflu. Voir Supprimer un composant de recherche.

7. Réactivez la topologie de recherche. Voir Activer une topologie de recherche.

Activer une topologie de recherche

Pour activer une topologie de recherche, vous devez utiliser Windows PowerShell.

Pour activer une topologie de recherche

1. Vérifiez que le compte d’utilisateur qui exécute cette procédure est membre du groupe Administrateurs de batterie.

2. Démarrez SharePoint Management Shell. Si vous avez déjà ouvert une instance de SharePoint Management Shell dans laquelle vous avez créé des références d’objet Microsoft PowerShell réutilisables, utilisez plutôt l’environnement ouvert.

3. À l’invite de commandes Microsoft PowerShell, tapez la ou les commandes suivantes :

   Set-SPEnterpriseSearchTopology -Identity $clone
   

   Où :

   • $clone est la topologie clonée que vous modifiez. Voir Cloner la topologie de recherche active.

4. Vérifiez que la nouvelle topologie est active. À l’invite de commandes Windows PowerShell, tapez la ou les commandes suivantes :

   Get-SPEnterpriseSearchTopology -Active -SearchApplication $ssa
   

   La commande renvoie une vue d’ensemble des topologies actives et inactives, par exemple :

   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
   

   Vous constaterez que le nombre de composants de la topologie active reflète les modifications que vous avez apportées.