Get-ServiceFabricNode

  • Referenz
Modul:
ServiceFabric

Ruft Informationen für alle Knoten in einem Service Fabric-Cluster oder für einen bestimmten Knoten ab.

Syntax

Get-ServiceFabricNode
   [[-NodeName] <String>]
   [-StatusFilter <NodeStatusFilter>]
   [-ContinuationToken <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricNode
   [[-NodeName] <String>]
   [-StatusFilter <NodeStatusFilter>]
   [-GetSinglePage]
   [-ContinuationToken <String>]
   [-MaxResults <Int64>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Beschreibung

Das Get-ServiceFabricNode Cmdlet ruft Informationen für alle Knoten in einem eigenständigen Service Fabric-Cluster oder für einen bestimmten Knoten ab. Die zurückgegebenen Knoteninformationen umfassen den Knotennamen, den Status, den Typ und den Integritätszustand (weitere Details finden Sie im Abschnitt Ausgabe).

Beachten Sie, dass Sie vor dem Ausführen eines Vorgangs für einen Service Fabric-Cluster eine Verbindung mit dem Cluster herstellen müssen, indem Sie das Cmdlet Connect-ServiceFabricCluster verwenden.

Beispiele

Beispiel 1: Abrufen von Informationen für alle Knoten im Cluster

PS C:\> Get-ServiceFabricNode

Dieser Befehl gibt Informationen für alle Knoten im Service Fabric-Cluster zurück.

Beispiel 2: Abrufen von Informationen für einen bestimmten Knoten

PS C:\> Get-ServiceFabricNode -NodeName Node1

Dieser Befehl gibt Informationen für den Knoten mit dem Namen Node1 zurück.

Parameter

-ContinuationToken

Gibt das Fortsetzungstoken an, mit dem die nächste Seite der Abfrageergebnisse abgerufen werden kann.

Wenn zu viele Ergebnisse die bereitgestellten Filter berücksichtigen, passen sie möglicherweise nicht in eine Nachricht. Paging wird verwendet, um dies zu berücksichtigen, indem die Sammlung der zurückgegebenen Ergebnisse in separate Seiten aufgeteilt wird. Das Fortsetzungstoken wird verwendet, um zu wissen, wo die vorherige Seite aufgehört hat, wobei nur die Abfrage selbst von Bedeutung ist. Dieser Wert sollte aus der Ausführung dieser Abfrage generiert werden und kann an die nächste Abfrageanforderung übergeben werden, um nachfolgende Seiten abzurufen. Ein Nicht-NULL-Fortsetzungstokenwert wird nur als Teil des Ergebnisses zurückgegeben, wenn eine nachfolgende Seite vorhanden ist. Wenn dieser Wert ohne die Option -GetSinglePage bereitgestellt wird, gibt die Abfrage alle Seiten ab dem Fortsetzungstokenwert zurück.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GetSinglePage

Gibt an, ob die Abfrage eine Seite mit Abfrageergebnissen mit einem Fortsetzungstokenwert zurückgibt, oder ob alle Seiten in einer Liste von Ergebnissen kombiniert werden. Wenn diese Option ausgewählt ist, liegt es in der Verantwortung des Aufrufers der Abfrage, nach nachfolgenden Seiten zu suchen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxResults

Gibt die maximale Anzahl von Ergebniselementen an, die pro Seite zurückgegeben werden können. Dadurch wird die obere Grenze für die Anzahl der zurückgegebenen Ergebnisse definiert, nicht mindestens. Wenn die Seite beispielsweise maximal 1000 zurückgegebene Elemente gemäß den in der Konfiguration definierten Einschränkungen für die maximale Nachrichtengröße einpasst und der MaxResults-Wert auf 2000 festgelegt ist, werden nur 1000 Ergebnisse zurückgegeben, auch wenn 2000 Ergebniselemente der Abfragebeschreibung entsprechen. Für diesen Wert ist die Auswahl des GetSinglePage-Flags erforderlich; andernfalls wird sie ignoriert.

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodeName

Gibt den Namen des Service Fabric-Knotens an, dessen Informationen zurückgegeben werden. Wenn nicht angegeben, gibt das Cmdlet Informationen für alle Knoten im Cluster zurück.

Typ:String
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StatusFilter

Gibt den Knotenstatusfilter als System.Fabric.Query.NodeStatusFilter -Objekt an.

In den Ergebnissen werden nur Knoten mit dem Status zurückgegeben, der diesem Filter entspricht.

Typ:NodeStatusFilter
Zulässige Werte:Default, Up, Down, Enabling, Disabling, Disabled, Unknown, Removed, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt den Timeoutzeitraum für den Vorgang in Sekunden an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

System.String

Ausgaben

System.Object