Remove-ServiceFabricReplica
レプリカの障害をシミュレートするために、クラスターからレプリカを削除します。
構文
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>]
説明
Remove-ServiceFabricReplica コマンドレットは、Service Fabric クラスターからレプリカを削除することで、Service Fabric レプリカのエラーをシミュレートします。 削除により、レプリカが閉じられ、ロールが None のレプリカに移行され、レプリカのすべての状態情報がクラスターから削除されます。 このコマンドレットは、レプリカ状態の削除パスをテストし、クライアント API を介してレポート エラーの永続的パスをシミュレートします。
削除するレプリカを指定するには、ノード名またはサービス名で開始します。
次に、レプリカが属するパーティションを指定する必要があります。 パーティションを指定するには、ペア (名前付けスキーム、パーティション キー) を指定するか、パーティション ID を指定します。 Microsoft Azure Service Fabricパーティション分割の詳細については、Partition Service Fabric Reliable Services (/azure/service-fabric/service-fabric-concepts-partitioning) に関する記事を参照してください。
最後に、参照しているパーティションのどのレプリカを指定する必要があり、レプリカ ロール (プライマリまたはセカンダリ レプリカ) を指定するか、レプリカ ID を指定して実行できます。
場合によっては、ユーザーは、特定のパーティション/レプリカの代わりに、サービスのランダムなパーティション/レプリカの組み合わせを削除したい場合があります。 これは、実際の障害をシミュレートするためにサービスのランダムな一連の遷移を実行する場合に、サービスのテスト可能性に役立ちます。 たとえば、このコマンドレットにサービス名のみを指定し、パーティションやレプリカ情報を除外した場合、コマンドレットはランダムにパーティションと障害を発生させるレプリカを選択します。 選択したパーティションまたはレプリカは、指定されたサービスにのみ属します。
例
例 1: レプリカを削除する
PS C:\> Remove-ServiceFabricReplica -NodeName "Node07" -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaOrInstanceId 12345098480948
Service Fabric クラスターで操作を実行する前に、 Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。 このコマンドは、指定したノードにデプロイされている指定されたパーティションに属するレプリカを削除します。
例 2: プライマリ レプリカを削除する
PS C:\> Remove-ServiceFabricReplica -ReplicaKindPrimary -PartitionKindNamed -PartitionKey "Partition1" -ServiceName fabric:/App/Service
このコマンドは、指定された名前付きパーティションに属するプライマリ レプリカを削除します。
パラメーター
-CommandCompletionMode
削除操作が完了するまでアクションが待機するかどうかを指定します。
型: | CompletionMode |
指定可能な値: | Invalid, DoNotVerify, Verify |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceRemove
このコマンドレットによってレプリカが強制的に削除されることを示します。 ForceRemove を使用すると、レプリカのシャットダウン シーケンスがスキップされ、レプリカが正常に削除されます。 ステートフル サービス レプリカの場合、その永続的な状態はクリーンアップされません。 レプリカが存在するかどうかを確認するには、 Get-ServiceFabricReplica を使用します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NodeName
Service Fabric ノードの名前を指定します。 コマンドレットは、指定したノードにデプロイされたレプリカを削除します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PartitionId
レプリカを削除するパーティションの ID を指定します。
型: | Guid |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PartitionKey
パーティション キーを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PartitionKindNamed
このコマンドレットは、名前付きパーティション上のレプリカを削除することを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PartitionKindSingleton
このコマンドレットは、シングルトン パーティション上のレプリカを削除することを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PartitionKindUniformInt64
このコマンドレットによって UniformInt64 パーティション上のレプリカが削除されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ReplicaKindPrimary
このコマンドレットは、プライマリ レプリカのレプリカを削除することを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ReplicaKindRandomSecondary
このコマンドレットは、ランダムなセカンダリ レプリカのレプリカを削除することを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ReplicaOrInstanceId
Service Fabric サービス のレプリカまたはインスタンス ID を指定します。
型: | Int64 |
配置: | 2 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ServiceName
削除するサービスの名前を指定します。
型: | Uri |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-TimeoutSec
操作のタイムアウト期間を秒単位で指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
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]]
出力
System.Object