次の方法で共有

Move-ServiceFabricPrimaryReplica

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

ステートフル サービス パーティションの Service Fabric プライマリ レプリカを移動します。

構文

Move-ServiceFabricPrimaryReplica
    [-NodeName <String>]
    [-IgnoreConstraints <Boolean>]
    -PartitionId <Guid>
    -ServiceName <Uri>
    [-TimeoutSec <Int32>]
    [<CommonParameters>]
Move-ServiceFabricPrimaryReplica
    [-NodeName <String>]
    [-IgnoreConstraints <Boolean>]
    -ServiceName <Uri>
    [-TimeoutSec <Int32>]
    [<CommonParameters>]
Move-ServiceFabricPrimaryReplica
    [-NodeName <String>]
    [-IgnoreConstraints <Boolean>]
    -ServiceName <Uri>
    [-PartitionKindSingleton]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]
Move-ServiceFabricPrimaryReplica
    [-NodeName <String>]
    [-IgnoreConstraints <Boolean>]
    -ServiceName <Uri>
    [-PartitionKindNamed]
    -PartitionKey <String>
    [-TimeoutSec <Int32>]
    [<CommonParameters>]
Move-ServiceFabricPrimaryReplica
    [-NodeName <String>]
    [-IgnoreConstraints <Boolean>]
    -ServiceName <Uri>
    [-PartitionKindUniformInt64]
    -PartitionKey <String>
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

説明

Move-ServiceFabricPrimaryReplica コマンドレットは、ステートフル サービス パーティションの Service Fabric プライマリ レプリカを現在のプライマリ ノードから指定されたノードに移動します。 この操作は、システム サービスでも実行できます。 このコマンドレットはステートレス サービスには使用できません。

Move-ServiceFabricPrimaryReplica コマンドレットは、コマンドが受け入れられた後、プライマリ レプリカを新しい Service Fabric ノードの場所に移動します。 ただし、ロード バランサーは、ロード バランサーの制約またはロード バランサーの分散アルゴリズムに基づいてプライマリ レプリカを再び移動する場合があります。

Service Fabric 7.1 以降では、move-ServiceFabricPrimaryReplica では、アラインされたアフィニティが考慮されます。 移動するプライマリがアラインされたアフィニティ リレーションシップの一部である場合、そのリレーションシップ内のすべてのレプリカが一緒に移動されます。 このようなサービスのプライマリ レプリカが指定されたタイムアウト内で完全に移動できない場合は、サービスが一時的に破損したアフィニティ状態であることを示す例外 (FabricErrorCode.AsyncOperationNotComplete) がスローされます。 修復するには、もう一度操作を発行します。

このコマンドレットを使用するには、Administrators グループのメンバーである必要があります。

このコマンドレットを使用する前に、Service Fabric クラスターに接続します。

例

例 1: ステートフル サービス パーティションのプライマリ レプリカを指定されたノードに移動する

PS C:\> Move-ServiceFabricPrimaryReplica -PartitionId 93838f53-f1d9-4b99-8492-b802ee807d03 -NodeName "N0050" -ServiceName fabric:/SampleApp/SampleService

このコマンドは、指定されたステートフル サービス パーティションのプライマリ レプリカを N0050 という名前のノードに移動します。

例 2: ステートフル サービス パーティションのプライマリ レプリカをランダム ノードに移動する

PS C:\> Move-ServiceFabricPrimaryReplica -ServiceName fabric:/SampleApp/SampleService -PartitionId 93838f53-f1d9-4b99-8492-b802ee807d03

このコマンドは、NodeName パラメーターが指定されていないため、指定したステートフル サービス パーティションのプライマリ レプリカをランダム ノードに移動します。

例 3: ステートフル サービス パーティションのプライマリ レプリカをランダム ノードに移動する

PS C:\> Move-ServiceFabricPrimaryReplica -ServiceName fabric:/SampleApp1/PersistServ

このコマンドは、NodeName パラメーターが指定されていないため、指定したステートフル サービス パーティションのプライマリ レプリカをランダム ノードに移動します。 指定されたサービスのランダム パーティションが選択されます。

パラメーター

-IgnoreConstraints

コマンドレットが制約を無視するかどうかを示します。

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

-NodeName

Service Fabric ノードの名前を指定します。 このコマンドレットは、指定したノードにプライマリ レプリカを移動します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る: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

-ServiceName

移動するレプリカのサービス名を指定します。

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

-TimeoutSec

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

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

入力

System.String

System.Boolean

System.Guid

System.Uri

出力

System.Object