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