Freigeben über


Remove-ServiceFabricReplica

Entfernt ein Replikat aus einem Cluster, um einen Replikatfehler zu simulieren.

Syntax

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

Beschreibung

Das cmdlet Remove-ServiceFabricReplica simuliert einen Service Fabric-Replikatfehler, indem ein Replikat aus einem Service Fabric-Cluster entfernt wird. Das Entfernen schließt das Replikat, übergibt das Replikat auf die Rolle "Keine", und entfernt dann alle Statusinformationen des Replikats aus dem Cluster. Dieses Cmdlet testet den Pfad zum Entfernen des Replikatstatus und simuliert den dauerhaften Berichtpfad über Client-APIs.

Um das zu entfernende Replikat anzugeben, 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 angeben, indem wir entweder das Paar (Benennungsschema, Partitionsschlüssel) oder die Partitions-ID angeben. Weitere Informationen zur Partitionierung von Microsoft Azure Service Fabric finden Sie im Artikel Partition Service Fabric zuverlässige Dienste (/azure/service-fabric/service-fabric-concepts-partitioning).

Schließlich müssen wir möglicherweise angeben, auf welches Replikat der Partition verwiesen wird und auf die verwiesen werden kann, indem entweder die Replikatrolle (primäres oder sekundäres Replikat) angegeben oder die Replikat-ID angegeben wird.

In einigen Fällen möchte der Benutzer möglicherweise eine zufällige Partitions-/Replikatkombination für einen Dienst anstelle eines bestimmten entfernen. 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 Fehler zu simulieren. Wenn Sie z. B. nur den Dienstnamen für dieses Cmdlet bereitstellen und die Partitions- und/oder Replikatinformationen auslassen, trifft das Cmdlet zufällig eine Wahl, um eine Partition und ein zu fehlerhaftes Replikat auszuwählen. Bitte beachten Sie, dass die ausgewählte Partition oder das Replikat nur zum angegebenen Dienst gehört.

Beispiele

Beispiel 1: Entfernen eines Replikats

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

Bevor Sie einen Vorgang auf einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her. Mit diesem Befehl wird ein Replikat entfernt, das zur angegebenen Partition gehört, die auf dem angegebenen Knoten bereitgestellt wird.

Beispiel 2: Entfernen eines primären Replikats

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

Mit diesem Befehl wird das primäre Replikat entfernt, das zu einer angegebenen benannten Partition gehört.

Parameter

-CommandCompletionMode

Gibt an, ob die Aktion auf den Abschluss des Entfernungsvorgangs wartet.

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

-ForceRemove

Gibt an, dass dieses Cmdlet das Entfernen des Replikats erzwingt. Mit ForceRemove-überspringen wir die Sequenz zum Herunterfahren des Replikats, und das Replikat wird unauffällig entfernt. Für zustandsbehaftetes Dienstreplikat würde der persistente Zustand nicht bereinigt werden. Um zu überprüfen, ob Replikate vorhanden sind, verwenden Sie Get-ServiceFabricReplica.

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

-NodeName

Gibt den Namen eines Service Fabric-Knotens an. Das Cmdlet entfernt ein Replikat, das auf dem 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, aus der das Replikat entfernt werden soll.

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

-PartitionKey

Gibt den Partitionsschlüssel an.

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 entfernt.

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

-PartitionKindSingleton

Gibt an, dass dieses Cmdlet ein Replikat auf einer Singletonpartition entfernt.

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 entfernt.

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 entfernt.

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 entfernt.

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 des zu entfernenden Diensts an.

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.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