Restart-ServiceFabricReplica

モジュール:

ServiceFabric

Service Fabric レプリカを再起動して、ステートフル サービス レプリカの再オープンをシミュレートします。

構文

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

説明

Restart-ServiceFabricReplica コマンドレットは、永続化されたサービス レプリカを再起動し、レプリカを閉じてから再度開くことで、サービス レプリカのエラーをシミュレートします。 このコマンドレットを使用して、レプリカの再び開くパスに関する問題についてサービスをテストします。 このコマンドレットは、クライアント API を介してレポート エラーの一時パスをシミュレートするのに役立ちます。 このコマンドレットは、ステートフルな永続化されたサービスに属するレプリカに対してのみ有効です。

再起動するレプリカを指定するには、ノード名またはサービス名で開始します。

次に、レプリカが属するパーティションを指定する必要があります。 パーティションを指定するには、ペア (名前付けスキーム、パーティション キー) を指定するか、パーティション ID を指定します。 Microsoft Azure Service Fabric サービスのパーティション分割の詳細については、「Partition Service Fabric Reliable Services」を参照してください。

最後に、参照しているパーティションのレプリカを指定する必要があり、レプリカ ロール (プライマリまたはセカンダリ レプリカ) を指定するか、レプリカ ID を指定して実行できます。

場合によっては、ユーザーが特定のサービスではなく、ランダムなパーティション/レプリカの組み合わせを再起動したい場合があります。 これは、実際の障害をシミュレートするためにサービスのランダムな遷移セットを実行する場合に、サービスのテスト可能性に役立ちます。 たとえば、このコマンドレットにサービス名のみを指定し、パーティションやレプリカ情報を省略すると、コマンドレットはランダムにパーティションを選択し、障害が発生するレプリカを選択します。 選択したパーティションまたはレプリカは、指定されたサービスにのみ属します。

Service Fabric クラスターで操作を実行する前に、Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。

例

例 1: レプリカを再起動する

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

このコマンドは、指定されたパーティション上の Node07 上のレプリカを再起動します。

例 2: プライマリ レプリカを再起動する

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

このコマンドは、指定されたパーティションのプライマリ レプリカを再起動します。

パラメーター

-CommandCompletionMode

アクションが再起動操作の完了を待機するかどうかを指定します。

型:	CompletionMode
指定可能な値:	Invalid, DoNotVerify, Verify
配置:	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

Service Fabric サービスの名前を指定します。

型:	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

関連リンク

• Connect-ServiceFabricCluster
• Get-ServiceFabricReplica
• Remove-ServiceFabricReplica