Restart-ServiceFabricReplica
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
操作が再起動操作の完了を待機するかどうかを指定します。
型: | 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