Restart-ServiceFabricNode
Startet einen Service Fabric-Knoten neu, um einen Clusterknotenfehler zu simulieren.
Syntax
Restart-ServiceFabricNode
[-NodeName] <String>
[[-NodeInstanceId] <BigInteger>]
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-PartitionId <Guid>
-ServiceName <Uri>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-PartitionId <Guid>
-ServiceName <Uri>
[-ReplicaKindPrimary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-PartitionId <Guid>
-ServiceName <Uri>
[-ReplicaKindRandomSecondary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-PartitionId <Guid>
-ServiceName <Uri>
-ReplicaOrInstanceId <Int64>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindSingleton]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindNamed]
-PartitionKey <String>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindUniformInt64]
-PartitionKey <String>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindSingleton]
[-ReplicaKindRandomSecondary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindNamed]
-PartitionKey <String>
[-ReplicaKindRandomSecondary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindUniformInt64]
-PartitionKey <String>
[-ReplicaKindRandomSecondary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindSingleton]
[-ReplicaKindPrimary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindNamed]
-PartitionKey <String>
[-ReplicaKindPrimary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindUniformInt64]
-PartitionKey <String>
[-ReplicaKindPrimary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindSingleton]
-ReplicaOrInstanceId <Int64>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindNamed]
-PartitionKey <String>
-ReplicaOrInstanceId <Int64>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindUniformInt64]
-PartitionKey <String>
-ReplicaOrInstanceId <Int64>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-ReplicaKindPrimary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-ReplicaKindRandomSecondary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
-ReplicaOrInstanceId <Int64>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Restart-ServiceFabricNode cmdlet startet einen Service Fabric-Knoten neu, indem der Fabric.exe Prozess neu gestartet wird, der den Knoten hostet. Dieses Cmdlet simuliert Dienst fabric-Knotenfehler im Cluster, wodurch die Failoverwiederherstellungspfade Ihres Diensts getestet werden. Weitere Informationen finden Sie unter Verwenden von Testaktionen.
Der dienst fabric-Knoten, der neu gestartet werden soll, kann auf folgende Weise angegeben werden:
- Geben Sie den Knotennamen und optional die Knoteninstanz-ID an.
- Geben Sie ein zustandsbehaftetes Dienstreplikat oder eine zustandslose Dienstinstanz an, und lassen Sie es dem Cmdlet ermöglichen, den Knoten zu identifizieren und neu zu starten, der ihn hosten soll. Die impliziten Verhaltensweisen für die Replikat-/Instanzauswahl sind zu notieren:
- Wenn der Dienst keine Singleton-Partition verwendet und weder die PartitionId noch PartitionKey Parameter angegeben wird, wählt das Cmdlet eine Partition zufällig aus.
- Wenn der Dienst ein zustandsbehafteter Dienst ist und keines der parameter Primary, RandomSecondary und ReplicaOrInstanceId Parameter angegeben werden, wählt das Cmdlet zufällig ein Replikat aus, unabhängig von seiner Rolle.
- Wenn der Dienst ein zustandsloser Dienst ist und der ReplicaOrInstanceId Parameter nicht angegeben wird, wählt das Cmdlet zufällig eine Instanz aus.
Wenn Sie einen Wert ungleich Null für den parameter NodeInstanceId angeben, wird diese ID mit der aktiven Knoten-ID verglichen. Wenn die IDs nicht übereinstimmen, wird der Prozess nicht neu gestartet, und ein Fehler tritt auf. Eine veraltete Meldung kann diesen Fehler verursachen.
Wenn Sie den parameter CreateFabricDump angeben, führt dieses Cmdlet dazu, dass der Fabric.exe Prozess während des Neustarts auf dem angegebenen Knoten abstürzt. Dieser Absturz erstellt ein Prozessabbild für Fabric.exe.
Bevor Sie einen Vorgang auf einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.
Beispiele
Beispiel 1: Neustarten eines Knotens, der ein primäres Replikat hostt
PS C:\> Restart-ServiceFabricNode -ReplicaKindPrimary -PartitionKindNamed -PartitionKey "Partition3" -CommandCompletionMode Verify
Mit diesem Befehl wird der Knoten neu gestartet, der das primäre Replikat der Partition namens Partition3 hostet. Da der parameter CommandCompletionMode mit dem Wert "Verify" angegeben wird, wartet der Befehl auf den Neustart des Zielknotens, bevor er abgeschlossen ist.
Beispiel 2: Neustarten eines angegebenen Knotens
PS C:\> Restart-ServiceFabricNode -NodeName "Node01" -CommandCompletionMode DoNotVerify
Mit diesem Befehl wird der Knoten "Node01" neu gestartet. Da der CommandCompletionMode Parameter mit dem Wert "DoNotVerify" angegeben wird, wartet der Befehl nicht, bis der Knoten neu gestartet wird, bevor er abgeschlossen ist.
Parameter
-CommandCompletionMode
Gibt an, ob die Aktion auf den Abschluss des Neustarts wartet. Geben Sie Überprüfen an, damit das Cmdlet auf den Neustart wartet, und DoNotVerify, um das Cmdlet zurückzugeben, ohne auf den Abschluss des Neustarts zu warten.
Typ: | CompletionMode |
Zulässige Werte: | Invalid, DoNotVerify, Verify |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-CreateFabricDump
Gibt an, dass für Fabric.exe auf dem angegebenen Knoten ein Prozessabbild erstellt werden soll.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-NodeInstanceId
Gibt eine Knoteninstanz-ID an.
Sofern Sie nicht "0" angeben, muss die angegebene Knoteninstanz-ID mit dem aktuell ausgeführten Knoten übereinstimmen.
Um Knoteninstanz-IDs abzurufen, führen Sie Get-ServiceFabricNode- für den Zielknoten aus.
For example, for the node N0050, the command Get-ServiceFabricNode -NodeName "N0050"
returns a Node object that contains the node instance ID.
Typ: | BigInteger |
Position: | 1 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-NodeName
Gibt den Namen eines Service Fabric-Knotens an. Das Cmdlet startet den von Ihnen angegebenen Knoten neu.
Typ: | String |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-PartitionId
Gibt die Partitions-ID einer Service Fabric-Dienstpartition an. Das Cmdlet startet einen Knoten neu, der ein Replikat oder eine Instanz dieser Partition hostet.
Typ: | Guid |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-PartitionKey
Gibt einen Partitionsschlüssel für eine Service Fabric-Dienstpartition an. Das Cmdlet identifiziert die Partition, die dieser Partitionsschlüssel einem Knoten zugeordnet und neu startet, der ein Replikat oder eine Instanz dieser Partition hostet.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-PartitionKindNamed
Gibt an, dass der parameter PartitionKey einen Partitionsschlüssel für einen Dienst angibt, der benanntes Partitionierungsschema verwendet.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-PartitionKindSingleton
Gibt an, dass der im ServiceName Parameter angegebene Dienst eine Singleton-Partition verwendet.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-PartitionKindUniformInt64
Gibt an, dass der parameter PartitionKey einen Partitionsschlüssel für einen Dienst angibt, der das Partitionierungsschema UniformInt64 verwendet.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ReplicaKindPrimary
Gibt an, dass dieses Cmdlet den Knoten neu startet, der das primäre Replikat der angegebenen Partition hostet.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ReplicaKindRandomSecondary
Gibt an, dass dieses Cmdlet den Knoten neu startet, der ein zufälliges sekundäres Replikat der angegebenen Partition hostet.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ReplicaOrInstanceId
Gibt ein Service Fabric-Dienstreplikat oder eine Instanz-ID an. Das Cmdlet startet den Knoten neu, der das angegebene Replikat oder die angegebene Instanz hostet.
Typ: | Int64 |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ServiceName
Gibt den Namen eines Service Fabric-Diensts an. Das Cmdlet startet einen Knoten neu, der ein Replikat oder eine Instanz dieses Diensts hostet.
Typ: | Uri |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
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
System.Nullable`1[[System.Numerics.BigInteger, System.Numerics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
System.Guid
System.Uri
System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Ausgaben
System.Object