次の方法で共有


Start-ServiceFabricNodeTransition

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-ServiceFabricNodeStop-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"

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

-NodeName

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

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

-OperationId

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

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

-Start

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

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

-Stop

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

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

-StopDurationInSeconds

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

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

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

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

-TimeoutSec

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

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

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

入力

None

出力

System.Object