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 Cmdlet Get-ServiceFabricNode 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 (siehe Abschnitt "Ausgabe" für weitere Details).

Beachten Sie, dass Sie vor dem Ausführen eines Vorgangs auf einem 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, das zum Abrufen der nächsten Seite der Abfrageergebnisse verwendet werden kann.

Wenn zu viele Ergebnisse die bereitgestellten Filter berücksichtigen, passen sie möglicherweise nicht in eine Nachricht. Das Paging wird verwendet, um dies zu berücksichtigen, indem die Auflistung der zurückgegebenen Ergebnisse in separate Seiten aufgeteilt wird. Das Fortsetzungstoken wird verwendet, um zu wissen, wo die vorherige Seite abgelassen wurde, wobei nur die Bedeutung für die Abfrage selbst besteht. Dieser Wert sollte aus der Ausführung dieser Abfrage generiert werden und kann in 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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GetSinglePage

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxResults

Gibt die maximale Anzahl der Ergebniselemente an, die pro Seite zurückgegeben werden können. Dies definiert die obere Grenze für die Anzahl der zurückgegebenen Ergebnisse, nicht mindestens. Wenn die Seite z. B. 1000 zurückgegebene Elemente gemäß den in der Konfiguration definierten Einschränkungen der Nachrichtengröße passt und der MaxResults-Wert auf 2000 festgelegt ist, werden nur 1000 Ergebnisse zurückgegeben, auch wenn 2000 Ergebniselemente der Abfragebeschreibung entsprechen. Dieser Wert erfordert die Auswahl des GetSinglePage-Flags; andernfalls wird er ignoriert.

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-StatusFilter

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

Nur Knoten mit dem Statusabgleich dieses Filters werden in den Ergebnissen zurückgegeben.

Type:	NodeStatusFilter
Accepted values:	Default, Up, Down, Enabling, Disabling, Disabled, Unknown, Removed, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

System.String

Ausgaben

System.Object