Get-ServiceFabricNode
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