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