Remove-ServiceFabricNodeState
ノードの状態が外部メカニズムによって削除されたことを Service Fabric に通知します。
構文
Remove-ServiceFabricNodeState
[-NodeName] <String>
[-Force]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-ServiceFabricNodeState コマンドレットは、ダウンしているクラスター内の特定のノードについて、そのノード上のすべてのサービスまたは状態が失われ、回復不能であることを Service Fabric に通知します。そのため、削除されています。 たとえば、これはハード ディスクがクラッシュした場合に発生する可能性があります。 このコマンドは、ノードの自動削除を行わずにダウンスケールする場合にも役立ちます。
ステートフル サービスの場合、Service Fabric はダウン ノード上の状態とサービスが復旧されるまで待機します。 場合によっては、ノード (およびその状態) が完全に失われることを管理者が認識します。 このような場合は、Service Fabric がそのノードの復旧を待機するのを停止するために、この操作を呼び出す必要があります。
警告: ノードが状態をそのまま使用して復帰することが予想される場合は、このコマンドレットを実行しないでください。
ノードを削除するプロセスは、ノードの非アクティブ化、ノード構成の削除、最後にノードの状態の削除で構成されます。 クラッシュの場合、最初の 2 つの手順は既に発生しています。
Service Fabric クラスターを管理するには、[管理者として実行] オプションを使用して Windows PowerShell を起動します。
Service Fabric クラスターで操作を実行する前に、Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。
注: Service Fabric 6.5 以降では、シード ノードにこのコマンドレットを使用するには、シード ノードを通常の (シード以外の) ノードに変更してから、このコマンドレットを呼び出してノードの状態を削除してください。 クラスターが Azure で実行されている場合、シード ノードがダウンした後、Service Fabric は、そのノードを非シード ノードに自動的に変更しようとします。 これを行うには、プライマリ ノード タイプの非シード ノードの数が、ダウン シード ノードの数以上であることを確認します。 必要に応じて、これを実現するために、プライマリ ノード タイプにノードを追加します。 スタンドアロン クラスターの場合、ダウン シード ノードが状態のままで復帰することが予想されない場合は、クラスターからノードを削除してください。Service Fabric スタンドアロン クラスターからノードを削除 を参照してください
例
例 1: ノード状態の削除について Service Fabric に通知する
PS C:\> Remove-ServiceFabricNodeState -NodeName "DB.41"
このコマンドは、DB.41 のノード状態が削除されたことを Service Fabric に通知します。
例 2: オプションを使用してノード状態の削除について Service Fabric に通知する
PS C:\> Remove-ServiceFabricNodeState -NodeName "DB.41" -Confirm
このコマンドを実行すると、この操作に固有の確認ウィンドウが表示されます。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。 既定では、PowerShell は、この操作を実行する前に確認を求めます。 このスイッチにより、追加の確認が追加されます。 このスイッチ パラメーターを選択する場合は、[強制] を選択しないでください。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。 このスイッチ パラメーターを選択する場合は、[確認] を選択しないでください。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NodeName
Service Fabric ノードの名前を指定します。 コマンドレットは、指定したノードのノード状態を削除します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-TimeoutSec
操作のタイムアウト期間を秒単位で指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実際には実行されません。 これは PowerShell 標準パラメーターです。 このオプションを選択しても、この操作の成功または結果は確認されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
System.String
出力
System.Object