Remove-ServiceFabricReplica

リファレンス

モジュール:: ServiceFabric

レプリカの障害をシミュレートするために、クラスターからレプリカを削除します。

構文

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

削除操作が完了するまでアクションが待機するかどうかを指定します。

Type:	CompletionMode
Accepted values:	Invalid, DoNotVerify, Verify
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceRemove

このコマンドレットによってレプリカが強制的に削除されることを示します。 ForceRemove を使用すると、レプリカのシャットダウンシーケンスがスキップされ、レプリカが正常に削除されます。ステートフルサービスレプリカの場合、その永続的な状態はクリーンアップされません。レプリカが存在するかどうかを確認するには、 Get-ServiceFabricReplica を使用します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeName

Service Fabric ノードの名前を指定します。コマンドレットは、指定したノードにデプロイされたレプリカを削除します。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PartitionId

レプリカを削除するパーティションの ID を指定します。

Type:	Guid
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PartitionKey

パーティションキーを指定します。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PartitionKindNamed

このコマンドレットは、名前付きパーティション上のレプリカを削除することを示します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PartitionKindSingleton

このコマンドレットは、シングルトンパーティション上のレプリカを削除することを示します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PartitionKindUniformInt64

このコマンドレットによって UniformInt64 パーティション上のレプリカが削除されることを示します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReplicaKindPrimary

このコマンドレットは、プライマリレプリカのレプリカを削除することを示します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReplicaKindRandomSecondary

このコマンドレットは、ランダムなセカンダリレプリカのレプリカを削除することを示します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReplicaOrInstanceId

Service Fabric サービスのレプリカまたはインスタンス ID を指定します。

Type:	Int64
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ServiceName

削除するサービスの名前を指定します。

Type:	Uri
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TimeoutSec

操作のタイムアウト期間を秒単位で指定します。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Get-ServiceFabricReplica