Start-ServiceFabricNodeTransition

リファレンス

モジュール:: ServiceFabric

Service Fabric クラスターノードを開始または停止する操作を開始します。

構文

Start-ServiceFabricNodeTransition
     [-Stop]
     -OperationId <Guid>
     -NodeName <String>
     -NodeInstanceId <BigInteger>
     -StopDurationInSeconds <Int32>
     [-TimeoutSec <Int32>]
     [<CommonParameters>]

Start-ServiceFabricNodeTransition
     [-Start]
     -OperationId <Guid>
     -NodeName <String>
     -NodeInstanceId <BigInteger>
     [-TimeoutSec <Int32>]
     [<CommonParameters>]

説明

Start-ServiceFabricNodeTransition コマンドレットは、Service Fabric クラスターノードを開始または停止するための非同期操作を開始します。

Stop パラメーターを指定すると、Service Fabric クラスターノードが停止状態になります。ノードはプロセスであり、仮想マシンやコンピューターではありません。ノードが停止した後も、仮想マシンまたはコンピューターは引き続き実行されます。停止状態では、ノードはクラスターのメンバーではなく、サービスをホストできません。停止したノードは、ダウンまたはオフラインのノードをシミュレートします。

Start パラメーターを指定すると、停止したノードが開始されます。

このコマンドレットが正常に返されると、システムは操作を受け入れます。ただし、これは操作が完了したことを意味するものではありません。操作の現在の状態に関する情報を取得するには、 Get-ServiceFabricNodeTransitionProgress コマンドレットを実行します。

Start-ServiceFabricNodeTransition コマンドレットは、古い Start-ServiceFabricNode コマンドレットと Stop-ServiceFabricNode コマンドレットよりも優先されます。このコマンドレットを Start-ServiceFabricNode と Stop-ServiceFabricNode と混在させないでください。 Stop-ServiceFabricNode を使用してノードが既に停止されている場合は、Start-ServiceFabricNodeTransition を使用する前に Start-ServiceFabricNode を使用してノードを起動します。それ以降は Start-ServiceFabricNodeTransition を 使用します。

詳細については、「ノードの開始 API と停止ノード API をノード遷移 API に置き換える」を参照してください。

例

例 1: Service Fabric ノードを停止する

PS C:\> Start-ServiceFabricNodeTransition -Stop -OperationId 097b03e3-760a-419c-9fce-e83f8cc0894b -NodeName N0050 -NodeInstanceId 131242467532403195 -StopDurationInSeconds 3600

このコマンドは、Service Fabric ノードを 1 時間停止する操作を開始します。 1 時間後、ノードは自動的に起動します。 OperationId 値を追跡します。これを使用して 、Get-ServiceFabricNodeTransitionProgress を実行できます。

例 2: Service Fabric ノードを開始する

PS C:\> Start-ServiceFabricNodeTransition -Start -OperationId 6d1bf9a1-9733-4d83-be59-0acea3be57a7 -NodeName N0050 -NodeInstanceId 131242467532403195

このコマンドは、停止した Service Fabric ノードを開始する操作を開始します。

パラメーター

-NodeInstanceId

このコマンドレットが開始または停止するノードインスタンスの ID を指定します。ノードインスタンス ID を取得するには、ターゲットノードに対 して Get-ServiceFabricNode を実行します。たとえば、ノード N0050 の場合、このコマンドはノードインスタンス ID を含む Node オブジェクトを返しますGet-ServiceFabricNode -NodeName "N0050"。

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

-NodeName

このコマンドレットが開始または停止する Service Fabric ノードの名前を指定します。クラスター内の Service Fabric ノードを取得するには、 Get-ServiceFabricNode コマンドレットを実行します。

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

-OperationId

操作を識別する一意の ID を指定します。操作を開始するこのコマンドレットと、操作の進行状況を取得する Get-ServiceFabricNodeTransitionProgress には、同じ値を使用します。

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

-Start

このコマンドレットが停止したノードを開始することを示します。

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

-Stop

このコマンドレットが実行中のノードを停止することを示します。

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

-StopDurationInSeconds

停止する操作が完了した後に停止したノードを停止し続ける期間を秒単位で指定します。この時間が経過すると、ノードが自動的に開始されます。

最小値は 600 です。最大値は 14400 です。

停止期間を指定するには、 Stop パラメーターを指定する必要があります。

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

-TimeoutSec

このコマンドレットのタイムアウト値を秒単位で指定します。

これは、停止したノードが停止したままの時間の長さではありません。ノードの停止時間を制御するには、 StopDurationInSeconds パラメーターを使用します。

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

入力

None

出力

System.Object