Windows Server 2012のWSFCで使用できるPowerShellコマンドレット (Get-ClusterNode) について

スポンサーリンク

Windows Server 2012では、Windows Server 2008 R2からActive Directory (AD)やフェールオーバー クラスタリング (WSFC) といったサーバー管理におけるPowerShellコマンドレットが強化、および追加されました。

各役割および機能に関するPowerShellコマンドレットのヘルプについて、オンライン上で公開されていますが、現時点では主に英語のみで日本語の情報はあまり公開されていないようです。

ここでは、Windows Server 2012のWSFCに関するPowerShellコマンドレットの情報について、日本語としてオンライン上で備忘録として確認したいと思い、本ブログ上で纏めてみることにしました (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集、補足したものとなります)。

この記事では、「Get-ClusterNode」コマンドレットについて記載します (他のコマンドレットについては、「Windows Server 2012のWSFCで使用できるPowerShellコマンドレットについて」を参照)。

■名前

Get-ClusterNode

■概要

フェールオーバー クラスター内の1つまたは複数のノード (サーバー) に関する情報を取得します。

■構文

Get-ClusterNode [[-Name] <StringCollection>] [-InputObject <psobject>]
     [-Cluster <string>] [<CommonParameters>]

■説明

Get-ClusterNodeコマンドレットは、フェールオーバー クラスター内の1つまたは複数のノード (サーバー) に関する情報を取得します。

このコマンドレットを使用して、ノードの状態に関する情報を取得します。特定のノードによって現在所有されているリソースを表示するには、このコマンドレットで対象のノードを指定し、実行結果をパイプライン経由でGet-ClusterResourceに渡します。

■パラメーター

-Cluster <string>
このコマンドレットを実行するクラスターの名前を指定します。「-Cluster .」と入力するか、パラメーターを省略した場合、コマンドレットはローカル クラスターで実行されます。

エイリアスなし
必須false
位置named
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-InputObject <psobject>
クラスター ノードを列挙する対象のクラスターを指定します。

エイリアスなし
必須false
位置named
既定値なし
パイプライン入力を許可するtrue (ByValue)
ワイルドカード文字を許可するfalse

-Name <StringCollection>
取得するクラスター ノードの名前を指定します。

エイリアスなし
必須false
位置1
既定値なし
パイプライン入力を許可するfalse
ワイルドカード文字を許可するtrue

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: -Verbose-Debug-ErrorAction-ErrorVariable-WarningAction-WarningVariable-OutBuffer、および-OutVariable。詳細については、「about_commonparameters」と入力してヘルプを参照してください。

■入力

System.Management.Automation.PSObject

■出力

System.Object

■エイリアス

なし

■メモ

このコマンドレットを含むモジュールのヘルプ ファイルをダウンロードしてインストールするには、Update-Helpを使用してください。

このコマンドレットのヘルプ トピックをオンラインで確認するには、「Get-Help Get-ClusterNode -Online」と入力するか、http://go.microsoft.com/fwlink/?LinkId=216215を参照してください。

■例

例1

 Get-ClusterNode 

例1:出力結果

Name                                                                      State
—-                                                                      —–
node1                                                                        Up
node2                                                                        Up
node3                                                                        Up
node4                                                                        Up

例1:説明

このコマンドは、ローカル クラスター内の各ノード (サーバー) の名前および状態を表示します。

例2

 Get-ClusterNode -Cluster cluster1 

例2:出力結果

Name                                                                      State
—-                                                                      —–
node1                                                                        Up
node2                                                                        Up

例2:説明

このコマンドは、cluster1内の各ノード (サーバー) の名前および状態を表示します。

例3

 Get-ClusterNode node1 | Get-ClusterResource 

例3:出力結果

Name                State               Group               ResourceType
—-                —–               —–               ————
Cluster Disk 1      Online              Cluster Group       Physical Disk
Cluster IP Address  Online              Cluster Group       IP Address
Cluster IP Addre… Online              Cluster Group       IPv6 Address
Cluster Name        Online              Cluster Group       Network Name
File Share Witness  Offline             Cluster Group       File Share Witness

例3:説明

このコマンドは、ローカル クラスター内のnode1によって現在所有されているすべてのクラスター リソースを一覧表示します。

■関連するリンク

  • Add-ClusterNode
  • Get-ClusterResource
  • Remove-ClusterNode
  • Resume-ClusterNode
  • Start-ClusterNode
  • Stop-ClusterNode
  • Suspend-ClusterNode

[参考]