Verwalten von Suchkomponenten in SharePoint Server

  • Artikel

 

**Gilt für:**SharePoint Server 2013, SharePoint Server 2016

**Letztes Änderungsdatum des Themas:**2017-09-08

Zusammenfassung: Informationen zum Verwalten von Suchkomponenten in einer vorhandenen Suchtopologie, in der Inhalte im SharePoint Server-Suchindex vorhanden sind, mithilfe von Windows PowerShell. Mithilfe dieser Verfahren können Sie die Suchtopologie der Suchdienstanwendung horizontal oder vertikal skalieren.

Bei den Verfahren und Beispielen in diesem Artikel wird davon ausgegangen, dass SharePoint ServerSharePoint Server 2016 und die Suchdienstanwendung installiert sind und dass es eine vorhandene Suchtopologie und Elemente im SharePoint Server-Suchindex gibt. 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.

Inhalt dieses Artikels:

  • Bevor Sie beginnen

  • Starten einer Suchdienstinstanz auf einem Server

  • Abrufen der aktiven Suchtopologie

  • Klonen der aktiven Suchtopologie

  • Hinzufügen einer Suchkomponente

  • Entfernen einer Suchkomponente

  • Verschieben einer Suchkomponente

  • Aktivieren einer Suchtopologie

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.

Wichtig

Für die Verfahren in diesem Artikel wird Microsoft PowerShell verwendet. Die Microsoft PowerShell-Befehle können auf jedem Server in der Farm ausgeführt werden. Falls Sie allerdings mehrere Suchtopologieverfahren ausführen, sollten Sie dieselbe SharePoint 2016-Verwaltungsshell für alle Microsoft PowerShell-Befehle verwenden, damit Sie die Microsoft PowerShell-Objektreferenzen gemeinsam für die Befehle verwenden können.

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 dieser Vorgang ausgeführt wird, Mitglied der Gruppe der 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>

    Dabei gilt Folgendes:

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

    • Mit <Server name> wird der Server angegeben, auf dem Sie eine Indexkomponente hinzufügen möchten. Bei der Eingabe muss es sich um eine gültige GUID in der Form 12345678-90ab-cdef-1234-567890bcdefgh, um einen gültigen Namen eines Servers (z. B. myserver1) oder um eine Instanz eines gültigen SearchServiceInstance-Objekts handeln.

    Beispiel:

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

    Sie verwenden die Referenzen ($<host n>) zum Angeben des Zielservers, 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 dieser Vorgang ausgeführt wird, Mitglied der Gruppe der 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

Zum Anzeigen einer Liste der Suchkomponenten in der aktiven Suchtopologie mit ihren Eigenschaften müssen Sie Microsoft PowerShell verwenden. Eine der Eigenschaften von Suchkomponenten ist die Suchkomponenten-ID. Sie benötigen die Suchkomponenten-ID nur zum Entfernen einer Suchkomponente.

So zeigen Sie eine Liste aller Suchkomponenten an

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

  2. Starten Sie eine SharePoint 15-Verwaltungsshell. Falls bereits eine SharePoint 2016-Verwaltungsshell geöffnet ist, in der Sie wiederverwendbare SharePoint 15-Verwaltungsshell-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
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 dieser Vorgang ausgeführt wird, Mitglied der Gruppe der 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

    Mit diesem Befehl wird eine Klonsuchtopologie erstellt, auf die mit $clone verwiesen werden kann, falls Sie dieselbe SharePoint 15-Verwaltungsshell zum Hinzufügen oder Entfernen von Suchkomponenten und zum Aktivieren der Suchtopologie verwenden.

  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

Hinweis

Das Verfahren zum Hinzufügen einer Indexkomponente weicht davon ab. Weitere Informationen finden Sie unter Verwalten der Indexkomponente in SharePoint Server.

So fügen Sie eine Suchkomponente hinzu

  1. Stellen Sie sicher, dass das Benutzerkonto, mit dem dieser Vorgang ausgeführt wird, Mitglied der Gruppe der 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>

    Dabei gilt Folgendes:

    • <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 die PowerShell-Objektreferenz für 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.

Hinweis

Das Verfahren zum Entfernen einer Indexkomponente weicht davon ab. Weitere Informationen finden Sie unter Verwalten der Indexkomponente in SharePoint Server.

So entfernen Sie eine Suchkomponente

  1. Stellen Sie sicher, dass das Benutzerkonto, mit dem dieser Vorgang ausgeführt wird, Mitglied der Gruppe der 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. Den Status der Suchtopologie können Sie auf der Seite Suchverwaltung der Zentraladministration oder durch Ausführen des Windows PowerShell-Cmdlets Get-SPEnterpriseSearchStatus anzeigen.

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

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

    Dabei gilt Folgendes:

    • <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. Den Status der Suchtopologie können Sie auf der Seite Suchverwaltung der Zentraladministration oder durch Ausführen des Windows PowerShell-Cmdlets Get-SPEnterpriseSearchStatus anzeigen.

  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 dieser Vorgang ausgeführt wird, Mitglied der Gruppe der 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

    Dabei gilt Folgendes:

    • $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.