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 は、この操作を実行する前に確認を求めます。 このスイッチは、追加の確認を追加します。 このスイッチ パラメーターを選択する場合は、[強制] を選択しないでください。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。 このスイッチ パラメーターを選択する場合は、[確認] を選択しないでください。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NodeName

Service Fabric ノードの名前を指定します。 コマンドレットは、指定したノードのノード状態を削除します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeoutSec

操作のタイムアウト期間を秒単位で指定します。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 コマンドレットは実際には実行されません。 これは PowerShell 標準パラメーターです。 このオプションを選択しても、この操作の成功または結果は確認されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

System.String

出力

System.Object