Freigeben über


Restart-ServiceFabricReplica

Startet ein Service Fabric-Replikat neu, um die Erneutes Öffnen eines Zustandsdienstreplikats zu simulieren.

Syntax

Restart-ServiceFabricReplica
       [-NodeName] <String>
       [-PartitionId] <Guid>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Beschreibung

Das Cmdlet Restart-ServiceFabricReplica simuliert einen Dienstreplikatfehler, indem ein beibehaltenes Dienstreplikat neu gestartet wird, das Replikat geschlossen und dann erneut geöffnet wird. Verwenden Sie dieses Cmdlet, um Ihren Dienst auf Probleme entlang des Replikat-erneuten Pfads zu testen. Dieses Cmdlet hilft beim Simulieren des temporären Berichtspfads über Client-APIs. Dieses Cmdlet ist nur für Replikate gültig, die zu stateful persistenten Diensten gehören.

Um das Replikat anzugeben, das neu gestartet werden soll, können wir entweder mit dem Knotennamen oder dem Dienstnamen beginnen.

Anschließend müssen wir die Partition angeben, zu der das Replikat gehört. Wir können die Partition entweder angeben, indem sie das Paar (Benennungsschema, Partitionsschlüssel) oder die Partitions-ID angeben. Weitere Details zu Microsoft Azure Service Fabric Dienstpartitionierung finden Sie unter Partition Service Fabric zuverlässige Dienste.

Schließlich müssen wir möglicherweise angeben, welche Replikate der Partition, auf die wir verweisen, und die entweder durch Angeben der Replikatrolle (primärer oder sekundärer Replikat) oder durch Angeben der Replikat-ID erfolgen können.

In einigen Fällen möchte der Benutzer möglicherweise eine zufällige Partitions-Replikatkombination für einen Dienst neu starten, anstatt einer bestimmten. Dies ist nützlich für die Testbarkeit Ihrer Dienste, wenn Sie einen zufälligen Satz von Übergängen für Ihre Dienste ausführen möchten, um reale Weltfehler zu simulieren. Wenn Sie z. B. nur den Dienstnamen für dieses Cmdlet bereitstellen und die Partitions- und/oder Replikatinformationen auslassen, macht das Cmdlet zufällig eine Wahl, um eine Partition und ein Replikat zu beheben. Bitte beachten Sie, dass die ausgewählte Partition oder das Replikat nur zum angegebenen Dienst gehört.

Bevor Sie einen Vorgang in einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Beispiele

Beispiel 1: Neustart eines Replikats

PS C:\> Restart-ServiceFabricReplica -NodeName "Node07" -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaOrInstanceId 12345098480948

Dieser Befehl startet das Replikat auf Node07 auf der angegebenen Partition neu.

Beispiel 2: Neustart eines primären Replikats

PS C:\> Restart-ServiceFabricReplica -ReplicaKindPrimary -PartitionKindNamed -PartitionKey "Partition1" -ServiceName fabric:/App/Service

Dieser Befehl startet ein primäres Replikat auf der angegebenen Partition neu.

Parameter

-CommandCompletionMode

Gibt an, ob die Aktion darauf wartet, dass der Neustartvorgang abgeschlossen ist.

Typ:CompletionMode
Zulässige Werte:Invalid, DoNotVerify, Verify
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodeName

Gibt den Namen eines Service Fabric-Knotens an. Das Cmdlet startet ein Replikat neu, das auf dem von Ihnen angegebenen Knoten bereitgestellt wird.

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

-PartitionId

Gibt die ID der Partition an, für die das Replikat neu gestartet werden soll.

Typ:Guid
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PartitionKey

Gibt den Schlüssel der Partition an, für die das Replikat neu gestartet wird.

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

-PartitionKindNamed

Gibt an, dass dieses Cmdlet ein Replikat auf einer benannten Partition neu startet.

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

-PartitionKindSingleton

Gibt an, dass dieses Cmdlet ein Replikat auf einer Singleton-Partition neu startet.

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

-PartitionKindUniformInt64

Gibt an, dass dieses Cmdlet ein Replikat auf einer UniformInt64-Partition neu startet.

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

-ReplicaKindPrimary

Gibt an, dass dieses Cmdlet das Replikat für das primäre Replikat neu startet.

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

-ReplicaKindRandomSecondary

Gibt an, dass dieses Cmdlet ein Replikat für ein zufälliges sekundäres Replikat neu startet.

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

-ReplicaOrInstanceId

Gibt ein Service Fabric-Dienstreplikat oder eine Instanz-ID an.

Typ:Int64
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServiceName

Gibt den Namen eines Service Fabric-Diensts an.

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

-TimeoutSec

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

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

Eingaben

System.String

System.Guid

System.Uri

System.Management.Automation.SwitchParameter

System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Ausgaben

System.Object