Get-SPEnterpriseSearchStatus

Ruft Diagnoseinformationen für die Suchkomponenten ab.

Syntax

Get-SPEnterpriseSearchStatus
   -SearchApplication <SearchServiceApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Component <String>]
   [-Constellation]
   [-Detailed]
   [-DetailSearchRuntime]
   [-HealthReport]
   [-JobStatus]
   [-Primary]
   [-Text]
   [<CommonParameters>]

Beschreibung

Dieses Cmdlet ruft Diagnoseinformationen für alle oder angegebene Suchkomponenten in der aktiven Topologie einer Suchdienstanwendung ab.

Wenn Sie keinen der optionalen Parameter angeben, ruft das Cmdlet den Integritätsstatus aller Suchkomponenten in der Suchdienstanwendung ab. Die einzelnen Suchkomponenten besitzen einen der folgenden Status:

  • Aktiv: Die Suchkomponente wird ordnungsgemäß ausgeführt.
  • Heruntergestuft: Die Suchkomponente befindet sich in einem Zustand, in dem nicht alle Vorgänge ordnungsgemäß ausgeführt werden können. Der heruntergestufte Status wird in der Regel durch vorübergehende Situationen wie Neustarts oder Netzwerkprobleme verursacht.
  • Fehler: Die Suchkomponente wird nicht ausgeführt. Dieser Status weist darauf hin, dass von der Komponente Vorgänge nicht ordnungsgemäß ausgeführt werden können.
  • Unbekannt: Die Komponente kann nicht erreicht werden. Der unbekannte Status wird in der Regel durch Hardware- oder Kommunikationsprobleme verursacht.

Falls Sie mehrere Indexkomponenten für eine Partition in der Suchtopologie definiert haben, gibt dieses Cmdlet an, welche Indexkomponente die primäre Rolle für diese Partition innehat.

Mit diesem Cmdlet können Sie die folgenden zusätzlichen Informationen ausgeben:

  • Auflisten des Status von Hintergrundaktivitäten (Batchaufträge), die von den Suchkomponenten initiiert wurden
  • Auflisten des Status von Hintergrundaktivitäten (Batchaufträge), die von den Suchkomponenten initiiert wurden
  • Auflisten detaillierter Diagnoseinformationen für die Indexkomponente
  • Debuginformationen, die von Microsoft für die detaillierte Problemlösung verwendet werden können

Wenn Sie die Ausgabe in einem Skript nicht durchlaufen möchten, verwenden Sie den Text-Parameter. Wird der Parameter Text nicht verwendet, wird vom Cmdlet eine Gruppe von Objekten mit den folgenden Eigenschaften ausgegeben:

  • Zeichenfolge "Name": Name einer Suchkomponente, ein Integritätsberichtelement oder eine Struktureigenschaft
  • Zeichenfolge "State": Status der Suchkomponente
  • Zeichenfolge "Level": Bei der Verwendung des Parameters HealthReport gibt diese Eigenschaft die Wichtigkeitsstufe der einzelnen Integritätsberichtselemente (Fehler, Warnung, Info, Ausführlich) an.
  • Zeichenfolge "Message": Als Textzeichenfolge angegebene zusätzliche Informationen
  • ReadOnlyDictionary<string,string>Details: Wörterbuchname-Wert-Paare, die zusätzliche Diagnoseinformationen bereitstellen

Berechtigungen und aktuelle Informationen zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter https://go.microsoft.com/fwlink/p/?LinkId=251831.

Beispiele

------------------BEISPIEL 1------------------

Get-SPEnterpriseSearchServiceApplication | Get-SPEnterpriseSearchStatus -Text

In diesem Beispiel wird eine Liste abgerufen, die Diagnoseinformationen zu allen Suchkomponenten der Standardmäßigen Suchdienstanwendung enthält.

------------------BEISPIEL 2------------------

Get-SPEnterpriseSearchStatus -SearchApplication 'Search Service Application' -JobStatus -Text

In diesem Beispiel wird der Auftragsstatus von Hintergrundaktivitäten für die Suchanalysen-Zeitgeberaufträge abgerufen.

------------------BEISPIEL 3------------------

Get-SPEnterpriseSearchServiceApplication | Get-SPEnterpriseSearchStatus -HealthReport -Component IndexComponent1 -Text

In diesem Beispiel werden die Diagnoseinformation für die Indexkomponente IndexComponent1 abgerufen.

Parameter

-AssignmentCollection

Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.

Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Component

Gibt den Namen der Suchkomponente an. Dieser Parameter wird nur in Verbindung mit den Parametern HealthReport und Primary verwendet.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Constellation

Gibt an, ob interne Diagnoseinformationen für die Suchtopologie angegeben werden müssen. Dieser Parameter sollte nur für das Debuggen verwendet werden.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Detailed

Gibt den Detailgrad für den HealthReport-Parameter an. Bei der Verwendung dieses Parameters gibt das Cmdlet auch ausführliche Diagnoseinformationen aus.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DetailSearchRuntime

Gibt an, ob interne Diagnoseinformationen für die Suchlaufzeit angegeben werden müssen. Dieser Parameter sollte nur für das Debuggen verwendet werden.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-HealthReport

Gibt an, ob Diagnoseinformationen für die Suchkomponente angegeben werden müssen. Bei Verwendung dieses Parameters müssen Sie mit dem Component-Parameter den Komponentennamen angeben.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-JobStatus

Gibt an, ob für die Zeitgeberaufträge Suchanalyse und Verwendungsanalyse Statusinformationen bereitgestellt werden.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Primary

Gibt an, ob die Verwaltungskomponente die primäre Rolle innehat. Bei Verwendung dieses Parameters müssen Sie mit dem Component-Parameter den Komponentennamen angeben. Wenn die Verwaltungskomponente die primäre Rolle innehat, wird "True" zurückgegeben.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SearchApplication

Gibt die Suchdienstanwendung an, die die Suchkomponente enthält.

Type:SearchServiceApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Text

Gibt an, ob die Ausgabe auf dem Bildschirm dieses Cmdlets in einem Format ausgegeben wird, das sich zum Lesen eignet. Wird dieser Parameter nicht verwendet, gibt dieses Cmdlet ein SearchStatusInfo-Objekt aus.

Bei Verwendung dieses Parameters erfolgt die Ausgabe in der Konsole und kann nicht in eine Datei oder ein anderes Programm geleitet werden.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019