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-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"
。
型: | 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