Restart-ServiceFabricNode

  • リファレンス
モジュール:
ServiceFabric

Service Fabric ノードを再起動して、クラスター ノードの障害をシミュレートします。

構文

Restart-ServiceFabricNode
       [-NodeName] <String>
       [[-NodeInstanceId] <BigInteger>]
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

説明

Restart-ServiceFabricNode コマンドレットは、ノードをホストするFabric.exe プロセスを再起動することで、Service Fabric ノードを再起動します。 このコマンドレットは、クラスター内の Service Fabric ノードの障害をシミュレートします。これにより、サービスのフェールオーバー復旧パスがテストされます。 詳細については、「 テスト アクションの使用」を参照してください。

再起動する Service Fabric ノードは、次の方法で指定できます。

  • ノード名と、必要に応じてノード インスタンス ID を指定します。
  • ステートフル サービス レプリカまたはステートレス サービス インスタンスを指定し、コマンドレットがホストするノードを識別して再起動できるようにします。 レプリカ/インスタンスの選択に対する暗黙的な動作は注目に値します。
    • サービスが Singleton パーティションを使用せず、 PartitionId パラメーターも PartitionKey パラメーターも指定されていない場合、コマンドレットはパーティションをランダムに選択します。
    • サービスがステートフル サービスであり、 プライマリ、 RandomSecondary 、 ReplicaOrInstanceId の各パラメーターが指定されていない場合、コマンドレットはロールに関係なくレプリカをランダムに選択します。
    • サービスがステートレス サービスであり、 ReplicaOrInstanceId パラメーターが指定されていない場合、コマンドレットはインスタンスをランダムに選択します。

NodeInstanceId パラメーターにゼロ以外の値を指定した場合、その ID はアクティブなノード ID と比較されます。 ID が一致しない場合、プロセスは再開されず、エラーが発生します。 古いメッセージが原因でこのエラーが発生する可能性があります。

CreateFabricDump パラメーターを指定すると、再起動時に指定したノードでFabric.exe プロセスがクラッシュします。 このクラッシュにより、Fabric.exeのプロセス ダンプが作成されます。

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

例

例 1: プライマリ レプリカをホストするノードを再起動する

PS C:\> Restart-ServiceFabricNode -ReplicaKindPrimary -PartitionKindNamed -PartitionKey "Partition3" -CommandCompletionMode Verify

このコマンドは、Partition3 という名前のパーティションのプライマリ レプリカをホストするノードを再起動します。 CommandCompletionMode パラメーターは Verify の値で指定されているため、コマンドはターゲット ノードの再起動を待機してから完了します。

例 2: 指定したノードを再起動する

PS C:\> Restart-ServiceFabricNode -NodeName "Node01" -CommandCompletionMode DoNotVerify

このコマンドは、Node01 という名前のノードを再起動します。 CommandCompletionMode パラメーターは DoNotVerify の値で指定されているため、コマンドはノードの再起動が完了するまで待機しません。

パラメーター

-CommandCompletionMode

再起動が完了するまでアクションが待機するかどうかを指定します。 再起動が完了するまでコマンドレットを待機する 場合は [確認 ] を指定し、 DoNotVerify は再起動が完了するまで待たずにコマンドレットを返します。

型:CompletionMode
指定可能な値:Invalid, DoNotVerify, Verify
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CreateFabricDump

指定したノードのFabric.exeに対してプロセス ダンプを作成する必要があることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-NodeInstanceId

ノード インスタンス ID を指定します。 0 を指定しない限り、指定するノード インスタンス ID は、現在実行中のノードと一致する必要があります。 ノード インスタンス ID を取得するには、ターゲット ノードに対 して Get-ServiceFabricNode を実行します。 たとえば、ノード N0050 の場合、このコマンドはノード インスタンス ID を含む Node オブジェクトを返しますGet-ServiceFabricNode -NodeName "N0050"。

型:BigInteger
配置:1
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-NodeName

Service Fabric ノードの名前を指定します。 コマンドレットは、指定したノードを再起動します。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PartitionId

Service Fabric サービス パーティションのパーティション ID を指定します。 このコマンドレットは、このパーティションのレプリカまたはインスタンスをホストするノードを再起動します。

型:Guid
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PartitionKey

Service Fabric サービス パーティションのパーティション キーを指定します。 このコマンドレットは、このパーティション キーがマップされるパーティションを識別し、そのパーティションのレプリカまたはインスタンスをホストするノードを再起動します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PartitionKindNamed

PartitionKey パラメーターが、名前付きパーティション構成を使用するサービスのパーティション キーを指定することを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PartitionKindSingleton

ServiceName パラメーターで指定されたサービスがシングルトン パーティションを使用することを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PartitionKindUniformInt64

PartitionKey パラメーターが、UniformInt64 パーティション構成を使用するサービスのパーティション キーを指定することを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ReplicaKindPrimary

このコマンドレットは、指定したパーティションのプライマリ レプリカをホストするノードを再起動することを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ReplicaKindRandomSecondary

このコマンドレットは、指定したパーティションのランダムなセカンダリ レプリカをホストするノードを再起動することを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ReplicaOrInstanceId

Service Fabric サービス のレプリカまたはインスタンス ID を指定します。 コマンドレットは、指定したレプリカまたはインスタンスをホストするノードを再起動します。

型:Int64
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ServiceName

Service Fabric サービスの名前を指定します。 このコマンドレットは、このサービスのレプリカまたはインスタンスをホストするノードを再起動します。

型:Uri
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-TimeoutSec

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

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

System.String

System.Nullable`1[[System.Numerics.BigInteger, System.Numerics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

System.Guid

System.Uri

System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

出力

System.Object