Disable-ServiceFabricNode
Service Fabric ノードを無効にします。
構文
Disable-ServiceFabricNode
[-NodeName] <String>
[-Intent] <NodeDeactivationIntent>
[-Force]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Disable-ServiceFabricNode コマンドレットは、ノード上のレプリカに影響を与える可能性があるノードに対して管理アクションが実行される前に、Service Fabric に通知します。
たとえば、ノードを再起動する前に、意図を再起動してノードを無効にすると、Service Fabric にノード上のレプリカを正常に閉じるよう通知されます。 ノードが無効になるまで待ってから、ノードを再起動する必要があります。 Get-ServiceFabricNode コマンドレットを使用して、ノードの無効化状態を表示します。 Service Fabric を使用すると、これらのレプリカが閉じられている場合でも、サービスを引き続き利用できます。 ノードは、サービスの可用性に影響を与えずに無効にしても安全になるまで、無効化状態のままになります。 再起動が完了したら、 Enable-ServiceFabricNode コマンドレットを使用してノードを有効にできます。これにより、ノードをレプリカの配置に使用できるようになったことを Service Fabric に通知します。
Service Fabric クラスターを管理するには、[管理者として実行] オプションを使用してWindows PowerShellを開始します。 Service Fabric クラスターで操作を実行する前に、 Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。
例
例 1: 意図を再起動してノードを非アクティブ化する
PS C:\> Disable-ServiceFabricNode -NodeName "DB.41" -Intent Restart
このコマンドは、意図の再起動を伴うノード名 DB.41 を持つノードを無効にします。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Intent
無効化ノードの意図を指定します。 意図によって、Service Fabric がノードに対して実行するアクションが決定されます。 このパラメーターの有効値は、次のとおりです。
- [一時停止]。 ノードに新しいレプリカは配置されません。 既存のレプリカは引き続き実行されます。 この設定は、ノードで実行されるレプリカをデバッグするために指定できます。
- 再起動して。 ノード上の既存のレプリカは閉じられます。 レプリカは他のノードに移動されません。 この設定は、パッチをインストールするためにノードの再起動が必要な場合に指定できます。
- RemoveData。 ノード上のデータが完全に失われることを指定します。 このコマンドレットは、高可用性を確保するために、他のノード上のノードで実行されるレプリカのコピーを作成します。 ハード ディスクを再イメージ化するときに、この設定を指定できます。
- RemoveNode。 ノード上のデータが完全に失われることを指定します。 このコマンドレットは、高可用性を確保するために、他のノード上のノードで実行されるレプリカのコピーを作成します。 この設定は、ノードがクラスターから削除されるときに指定できます。
型: | NodeDeactivationIntent |
指定可能な値: | Invalid, Pause, Restart, RemoveData, RemoveNode |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NodeName
Service Fabric ノードの名前を指定します。 コマンドレットは、指定したノードを無効にします。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TimeoutSec
操作のタイムアウト期間を秒単位で指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object