Move-ServiceFabricPrimaryReplica

ステートフル サービス パーティションの 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

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NodeName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PartitionId

移動するパーティションの ID を指定します。

Type:Guid
Position:Named
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:False
Accept wildcard characters:False

-PartitionKindSingleton

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartitionKindUniformInt64

このコマンドレットが UniformInt64 パーティション分割されたサービスを移動することを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServiceName

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

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.Boolean

System.Guid

System.Uri

出力

System.Object