Disable-ServiceFabricNode

リファレンス

モジュール:: ServiceFabric

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

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-Intent

無効化ノードの意図を指定します。意図によって、Service Fabric がノードに対して実行するアクションが決定されます。このパラメーターの有効値は、次のとおりです。

[一時停止]。ノードに新しいレプリカは配置されません。既存のレプリカは引き続き実行されます。この設定は、ノードで実行されるレプリカをデバッグするために指定できます。
再起動して。ノード上の既存のレプリカは閉じられます。レプリカは他のノードに移動されません。この設定は、パッチをインストールするためにノードの再起動が必要な場合に指定できます。
RemoveData。ノード上のデータが完全に失われることを指定します。このコマンドレットは、高可用性を確保するために、他のノード上のノードで実行されるレプリカのコピーを作成します。ハードディスクを再イメージ化するときに、この設定を指定できます。
RemoveNode。ノード上のデータが完全に失われることを指定します。このコマンドレットは、高可用性を確保するために、他のノード上のノードで実行されるレプリカのコピーを作成します。この設定は、ノードがクラスターから削除されるときに指定できます。

Type:	NodeDeactivationIntent
Accepted values:	Invalid, Pause, Restart, RemoveData, RemoveNode
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeName

Service Fabric ノードの名前を指定します。コマンドレットは、指定したノードを無効にします。

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

-TimeoutSec

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

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

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

入力

None

出力

System.Object