Restart-ServiceFabricDeployedCodePackage

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

プロセスエラーをシミュレートするために、クラスター内のノードにデプロイされたコード パッケージを再起動します。

構文

Restart-ServiceFabricDeployedCodePackage
       [-NodeName] <String>
       [-ApplicationName] <Uri>
       [-ServiceManifestName] <String>
       [-CodePackageName] <String>
       [[-CodePackageInstanceId] <Int64>]
       [-ServicePackageActivationId <String>]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -PartitionId <Guid>
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

説明

Restart-ServiceFabricDeployedCodePackage コマンドレットは、コード パッケージ プロセスを終了し、そのプロセスでホストされているすべてのユーザー サービス レプリカを再起動します。 この再起動により、クラスター内のコード パッケージ プロセスエラーがシミュレートされ、サービスのフェールオーバー復旧パスがテストされます。

コード パッケージを指定することも、ReplicaSelector を指定して、レプリカがホストされているノードとコード パッケージの組み合わせを再起動することもできます。 これにより、プライマリ ホスト ノードのテストが簡略化されます。そのノードを再起動する前に、どの Service Fabric ノードがプライマリ ノードであるかを判断する必要がありません。

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

例

例 1: ランダム セカンダリ レプリカのコード パッケージを再起動する

PS C:\> Restart-ServiceFabricDeployedCodePackage -ReplicaKindRandomSecondary -PartitionKindSingleton -ServiceName fabric:/SampleApp/SampleService -ApplicationName fabric:/SampleApp -CommandCompletionMode Verify

このコマンドは、シングルトン パーティション上のランダム セカンダリ レプリカのコード パッケージを再起動します。

例 2: 指定したコード パッケージを再起動する

PS C:\> Restart-ServiceFabricDeployedCodePackage -NodeName "Node01" -ApplicationName fabric:/App -CodePackageName "CodePackage01" -ServiceManifestName "ServiceManifest01" -CommandCompletionMode Verify

このコマンドは、Node01 という名前のノード上の ServiceManifest01 というサービス マニフェストから CodePackage01 という名前のコード パッケージを再起動します。

パラメーター

-ApplicationName

コード パッケージが属するアプリケーションの名前を指定します。

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

-CodePackageInstanceId

再起動する前に、デプロイされたコード パッケージに対してチェックされるコード パッケージのインスタンス ID を指定します。 0 を指定した場合、比較は行われません。

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

-CodePackageName

再起動するコード パッケージの名前を指定します。

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

-CommandCompletionMode

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

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

-NodeName

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

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

-PartitionId

コード パッケージを再起動するパーティションの ID を指定します。

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

-PartitionKey

コード パッケージを再起動するパーティションのキーを指定します。

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

-PartitionKindNamed

このコマンドレットが、名前付きパーティションのコード パッケージを再起動することを示します。

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

-PartitionKindSingleton

このコマンドレットがシングルトン パーティションのコード パッケージを再起動することを示します。

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

-PartitionKindUniformInt64

このコマンドレットが 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

-ServiceManifestName

コード パッケージが定義されているサービス マニフェストの名前を指定します。

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

-ServiceName

コード パッケージが属するサービスの名前を指定します。

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

-ServicePackageActivationId

CodePackageを含む、デプロイされた ServicePackage のアクティブ化 ID。 これは、Get-ServiceFabricDeployedCodePackageクエリを使用して取得できます。

サービスの作成時 ServicePackageActivationMode (を使用) が SharedProcess されている場合 (または指定されていない場合は、既定では SharedProcess)、ServicePackageActivationId の 値は常に空の文字列であり、指定する必要はありません。 サービス パッケージのアクティブ化 ID の詳細については、[Service Fabric ホスティング モデル][1] を参照してください。

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

-TimeoutSec

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

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

入力

System.String

System.Uri

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

System.Guid

出力

System.Object