Partager via


Gérer les composants de recherche dans SharePoint Server

S’APPLIQUE À :oui-img-132013 oui-img-162016 oui-img-192019 oui-img-seÉdition d’abonnement no-img-sopSharePoint dans Microsoft 365

Les procédures et les exemples de cet article supposent que SharePoint ServerSharePoint Server et l’application de service de recherche sont installés, et qu’il existe une topologie de recherche et 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.

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.

Importante

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 Management Shell pour toutes les commandes Microsoft PowerShell afin de 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. L’entrée doit être un GUID valide, au format 12345678-90ab-cdef-1234-567890bcdefgh; un nom valide d’un serveur (par exemple, myserver1 ) ou une instance d’un 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 du composant de recherche est l’ID du composant de recherche. Vous aurez uniquement besoin de l’ID du composant de recherche 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 disposez déjà d’un sharePoint Management Shell ouvert dans lequel vous avez créé des références d’objets SharePoint Management Shell réutilisables, utilisez plutôt l’interpréteur de commandes 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 une topologie de recherche de clone qui peut être référencée avec $clone si vous continuez à utiliser le même SharePoint Management Shell pour ajouter ou supprimer des composants de recherche et 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

[!REMARQUE] 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ù :

    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

[!REMARQUE] 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 dans l’Administration centrale ou exécutez l’applet de commande Get-SPEnterpriseSearchStatusWindows PowerShell .

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

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

    Où :

  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 dans l’Administration centrale ou exécutez l’applet de commande Get-SPEnterpriseSearchStatusWindows PowerShell .

  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ù :

  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.