Freigeben über


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