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サービスのパーティション分割の詳細については、「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

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

Type:	CompletionMode
Accepted values:	Invalid, DoNotVerify, Verify
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

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

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

関連リンク

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