Verwalten von Suchkomponenten in SharePoint Server

GILT FÜR:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365

Bei den Verfahren und Beispielen in diesem Artikel wird davon ausgegangen, dass SharePoint ServerSharePoint Server und die anwendung Suchdienst installiert sind und dass im SharePoint Server-Suchindex eine Suchtopologie und Elemente vorhanden sind. Führen Sie die Verfahren unter Ändern der Standardsuchtopologie in SharePoint Server aus, falls SharePoint Server und die Suchdienstanwendung neu installiert wurden und keine Elemente im SharePoint Server-Suchindex vorhanden sind.

Die Verfahren in diesem Artikel gelten für die folgenden Suchkomponenten:

• Analyseverarbeitungskomponente

• Inhaltsverarbeitungskomponente

• Durchforstungskomponente

• Suchverwaltungskomponente

• Abfrageverarbeitungskomponente

Informationen zu Verfahren zum Verwalten der Indexkomponente finden Sie unter Verwalten der Indexkomponente in SharePoint Server.

Bevor Sie beginnen:

Lesen Sie die folgenden Voraussetzungen, ehe Sie mit diesem Vorgang beginnen.

• SharePoint Server ist installiert, und eine Suchdienstanwendung mit einer Suchtopologie wurde erstellt. Die Suchdienstanwendung befindet sich in einem fehlerfreien Zustand und wird nicht angehalten.

• Das Benutzerkonto, mit dem die Verfahren in diesem Artikel ausgeführt werden, muss ein Mitglied der Gruppe Farmadministratoren sein.

• Sie haben eine Zielsuchtopologie geplant.

• SharePoint Server ist auf allen Servern installiert, auf denen Sie Suchkomponenten hosten möchten. Die Server wurden der Farm hinzugefügt, und Sie sind auf allen diesen Servern Administrator. Sie können neue Anwendungsserver erstellen oder Anwendungsserver in einer bestehenden Bereitstellung festlegen.

Starten einer Suchdienstinstanz auf einem Server

Bevor Sie einem neuen Server Suchkomponenten hinzufügen, müssen Sie zunächst eine Suchdienstinstanz auf dem Server starten. Die Suchdienstinstanz startet alle erforderlichen Windows-Dienste, die vom Suchdienst verwendet werden (OSearch16 und SPSearchHostController).

So starten Sie eine Suchdienstinstanz

1. Stellen Sie sicher, dass das Benutzerkonto, mit dem dieses Verfahren ausgeführt wird, Mitglied der Gruppe Farmadministratoren ist.

2. Starten Sie auf einem Server in der Farm eine SharePoint 15-Verwaltungsshell.

3. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung folgende(n) Befehl(e) ein:

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

   Wobei Folgendes gilt:

   • $ <host n> bezeichnet die PowerShell-Objektreferenz für die Suchdienstinstanz.

   • <Servername> gibt den Server an, auf dem Sie eine Indexkomponente hinzufügen möchten. Die Eingabe muss eine gültige GUID im Format 12345678-90ab-cdef-1234-567890bcdefgh, ein gültiger Name eines Servers (z. B. myserver1 ) oder eine Instanz eines gültigen SearchServiceInstance-Objekts sein.

   Beispiel:

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

   Sie verwenden die Verweise ($<host n>), um den Zielserver anzugeben, wenn Sie Suchkomponenten hinzufügen.

4. Warten Sie, bis alle Suchdienstinstanzen ausgeführt werden. Geben Sie für jede der Suchdienstinstanzen an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein, bis der Status Online zurückgegeben wird:

   Get-SPEnterpriseSearchServiceInstance -Identity $<host n >
   
   

   Beispiel:

   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
   
   

Abrufen der aktiven Suchtopologie

Zum Anzeigen der aktiven Suchtopologie der Suchdienstanwendung müssen Sie Microsoft PowerShell verwenden.

So zeigen Sie die aktive Suchtopologie an

1. Stellen Sie sicher, dass das Benutzerkonto, mit dem dieses Verfahren ausgeführt wird, Mitglied der Gruppe Farmadministratoren ist.

2. Starten Sie eine SharePoint 15-Verwaltungsshell. Falls bereits eine SharePoint 15-Verwaltungsshell geöffnet ist, in der Sie wiederverwendbare Microsoft PowerShell-Objektreferenzen erstellt haben, verwenden Sie stattdessen die geöffnete Verwaltungsshell.

3. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung den folgenden Befehl ein:

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

Durch den Befehl werden Informationen über die aktive Topologie zurückgegeben, wie zum Beispiel: TopologyId : 2d7bb046-1ad4-43a9-9984-754c4551a3ec CreationDate : 1/25/2016 3:06:00 AM State : Active ComponentCount : 6

Abrufen einer Liste von Suchkomponenten

Um eine Liste der Suchkomponenten in der aktiven Suchtopologie mit ihren Eigenschaften anzuzeigen, müssen Sie Microsoft PowerShell verwenden. Eine der Eigenschaften der Suchkomponente ist die Id der Suchkomponente. Sie benötigen nur die Id der Suchkomponente, um eine Suchkomponente zu entfernen.

So zeigen Sie eine Liste aller Suchkomponenten an

1. Stellen Sie sicher, dass das Benutzerkonto, mit dem dieses Verfahren ausgeführt wird, Mitglied der Gruppe Farmadministratoren ist.

2. Starten Sie eine SharePoint 15-Verwaltungsshell. Wenn Sie bereits über eine offene SharePoint-Verwaltungsshell verfügen, in der Sie wiederverwendbare SharePoint-Verwaltungsshell-Objektverweise erstellt haben, verwenden Sie stattdessen die geöffnete Shell.

3. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung folgende(n) Befehl(e) ein:

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

   Der Befehl gibt eine Liste der Suchkomponenten in der aktiven Suchtopologie und deren Eigenschaften zurück.

Klonen der aktiven Suchtopologie

Um Änderungen an der Suchtopologie in einer Suchdienstinstallation vorzunehmen, für die Elemente im Suchindex vorhanden sind, müssen Sie zunächst ein neues Topologieobjekt erstellen. Dieses neue Topologieobjekt, ein Klone der aktiven Topologie, ändern Sie durch Hinzufügen oder Entfernen von Suchkomponenten. Nachdem Sie Änderungen am Klontopologieobjekt vorgenommen haben, legen Sie den Klon als aktive Topologie fest.

So klonen Sie die aktive Topologie

1. Stellen Sie sicher, dass das Benutzerkonto, mit dem dieses Verfahren ausgeführt wird, Mitglied der Gruppe Farmadministratoren ist.

2. Starten Sie eine SharePoint 15-Verwaltungsshell. Falls bereits eine SharePoint 15-Verwaltungsshell geöffnet ist, in der Sie wiederverwendbare Microsoft PowerShell-Objektreferenzen erstellt haben, verwenden Sie stattdessen die geöffnete Verwaltungsshell.

3. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung folgende(n) Befehl(e) ein:

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

   Der Befehl erstellt eine Klonsuchtopologie, auf die mit $clone verwiesen werden kann, wenn Sie weiterhin dieselbe SharePoint-Verwaltungsshell verwenden, um Suchkomponenten hinzuzufügen oder zu entfernen und die Suchtopologie zu aktivieren.

4. (Optional) Falls Sie Suchkomponenten aus der Suchtopologie entfernen müssen, müssen Sie die Suchkomponenten-ID abrufen. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung folgende Befehle ein:

   Get-SPEnterpriseSearchComponent -SearchTopology $clone
   

   Der Befehl gibt eine Liste der Suchkomponenten in der geklonten Suchtopologie und deren Eigenschaften einschließlich der Suchkomponenten-ID zurück.

Hinzufügen einer Suchkomponente

Die aktive Suchtopologie kann nicht direkt geändert werden. Bei diesem Verfahren wird davon ausgegangen, dass Sie ein Klontopologieobjekt wie unter Klonen der aktiven Suchtopologie. Sie können die folgenden Microsoft PowerShell-Cmdlets für jede Suchkomponente verwenden:

• New-SPEnterpriseSearchAdminComponent

• New-SPEnterpriseSearchAnalyticsProcessingComponent

• New-SPEnterpriseSearchContentProcessingComponent

• New-SPEnterpriseSearchCrawlComponent

• New-SPEnterpriseSearchQueryProcessingComponent

So fügen Sie eine Suchkomponente hinzu

1. Stellen Sie sicher, dass das Benutzerkonto, mit dem dieses Verfahren ausgeführt wird, Mitglied der Gruppe Farmadministratoren ist.

2. Starten Sie eine SharePoint 15-Verwaltungsshell. Falls bereits eine SharePoint 15-Verwaltungsshell geöffnet ist, in der Sie wiederverwendbare Microsoft PowerShell-Objektreferenzen erstellt haben, verwenden Sie stattdessen die geöffnete Verwaltungsshell.

3. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung folgende(n) Befehl(e) ein:

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

   Wobei Folgendes gilt:

   • <SearchComponent> ist der Name des Suchkomponententyps, den Sie hinzufügen.

   • $clone ist die geklonte Topologie, die Sie ändern. Weitere Informationen finden Sie unter Klonen der aktiven Suchtopologie.

   • $<host n> ist der PowerShell-Objektverweis auf die ausgeführte Suchdienstinstanz auf dem Server, dem Sie die Suchkomponente hinzufügen möchten. Weitere Informationen finden Sie unter Starten einer Suchdienstinstanz auf einem Server.

   Mit dem folgenden Befehl wird beispielsweise der Klontopologie auf dem mit der Suchdienstinstanzreferenz $hostA identifizierten Server eine Komponente zur Inhaltsverarbeitung hinzugefügt.

   New-SPEnterpriseSearchContentProcessingComponent -SearchTopology $clone -SearchServiceInstance $hostA
   

4. Vergewissern Sie sich, dass die neue Suchkomponente der Klontopologie hinzugefügt wurde. Geben Sie den folgenden Befehl an der Microsoft PowerShell-Eingabeaufforderung ein:

   Get-SPEnterpriseSearchComponent -SearchTopology $clone
   

Entfernen einer Suchkomponente

Zum Entfernen einer Suchkomponente benötigen Sie Windows PowerShell. Die aktive Suchtopologie kann nicht direkt geändert werden. Bei diesem Verfahren wird davon ausgegangen, dass Sie ein Klontopologieobjekt wie unter Klonen der aktiven Suchtopologie beschrieben erstellt haben.

So entfernen Sie eine Suchkomponente

1. Stellen Sie sicher, dass das Benutzerkonto, mit dem dieses Verfahren ausgeführt wird, Mitglied der Gruppe Farmadministratoren ist.

2. Starten Sie eine SharePoint 15-Verwaltungsshell. Falls bereits eine SharePoint 15-Verwaltungsshell geöffnet ist, in der Sie wiederverwendbare Microsoft PowerShell-Objektreferenzen erstellt haben, verwenden Sie stattdessen die geöffnete Verwaltungsshell.

3. Stellen Sie sicher, dass die aktuelle aktive Topologie fehlerfrei ist und dass die zu entfernende Suchkomponente den Status Aktiv aufweist. Zeigen Sie den Status der Suchtopologie auf der Seite Suchverwaltung in der Zentraladministration an, oder führen Sie das Cmdlet Windows PowerShell ausGet-SPEnterpriseSearchStatus.

4. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung folgende(n) Befehl(e) ein:

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

   Wobei Folgendes gilt:

   • <Search component id> ist die ID der Suchkomponente, die entfernt werden soll. Verwenden Sie die Suchkomponenten-ID aus der Klontopologie. Informationen zum Abrufen der Suchkomponenten-ID finden Sie in Schritt 4 unter Klonen der aktiven Suchtopologie.

   • $clone ist die geklonte Topologie, die Sie ändern. Weitere Informationen finden Sie unter Klonen der aktiven Suchtopologie.

5. Wenn Sie dazu aufgefordert werden, bestätigen Sie, dass die Suchkomponente entfernt werden soll.

Verschieben einer Suchkomponente

Wenn Sie eine Suchkomponente zwischen Servern verschieben möchten, wird empfohlen, der Suchtopologie eine neue Suchkomponente hinzuzufügen, bevor Sie die alte Suchkomponente entfernen.

So verschieben Sie eine Suchkomponente

1. Klonen Sie die aktive Suchtopologie. Weitere Informationen finden Sie unter Klonen der aktiven Suchtopologie.

2. Fügen Sie dem Server, auf dem die Suchkomponente letztlich gehostet werden soll, eine neue Suchkomponente hinzu. Weitere Informationen finden Sie unter Hinzufügen einer Suchkomponente.

3. Aktivieren Sie die Suchtopologie. Diese Topologie weist eine überflüssige Suchkomponente auf. Weitere Informationen finden Sie unter Aktivieren einer Suchtopologie.

4. Stellen Sie sicher, dass die aktuelle aktive Topologie fehlerfrei ist. Zeigen Sie den Status der Suchtopologie auf der Seite Suchverwaltung in der Zentraladministration an, oder führen Sie das Cmdlet Windows PowerShell ausGet-SPEnterpriseSearchStatus.

5. Klonen Sie die Suchtopologie erneut. Weitere Informationen finden Sie unter Klonen der aktiven Suchtopologie.

6. Entfernen Sie die überflüssige Suchkomponente. Weitere Informationen finden Sie unter Entfernen einer Suchkomponente.

7. Aktivieren Sie die Suchtopologie erneut. Weitere Informationen finden Sie unter Aktivieren einer Suchtopologie.

Aktivieren einer Suchtopologie

Zur Aktivierung einer Suchtopologie benötigen Sie Windows PowerShell.

So aktivieren Sie eine Suchtopologie

1. Stellen Sie sicher, dass das Benutzerkonto, mit dem dieses Verfahren ausgeführt wird, Mitglied der Gruppe Farmadministratoren ist.

2. Starten Sie eine SharePoint 15-Verwaltungsshell. Falls bereits eine SharePoint 15-Verwaltungsshell geöffnet ist, in der Sie wiederverwendbare Microsoft PowerShell-Objektreferenzen erstellt haben, verwenden Sie stattdessen die geöffnete Verwaltungsshell.

3. Geben Sie an der Microsoft PowerShell-Eingabeaufforderung folgende(n) Befehl(e) ein:

   Set-SPEnterpriseSearchTopology -Identity $clone
   

   Wobei Folgendes gilt:

   • $clone ist die geklonte Topologie, die Sie ändern. Weitere Informationen finden Sie unter Klonen der aktiven Suchtopologie.

4. Überprüfen Sie, ob die neue Topologie aktiv ist. Geben Sie an der Windows PowerShell-Eingabeaufforderung folgende Befehle ein:

   Get-SPEnterpriseSearchTopology -Active -SearchApplication $ssa
   

   Durch den Befehl wird ein Überblick über aktive und inaktive Topologien zurückgegeben, wie zum Beispiel:

   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
   

   Wie Sie sehen, entspricht die Komponentenanzahl der aktiven Topologie den von Ihnen vorgenommen Änderungen.