Windows Server 2008 R2では、Active Directory (AD) やフェールオーバー クラスタリング (WSFC)、グループ ポリシーといった役割および機能がインストールされたサーバーの管理、もしくは管理したい役割および機能についてリモート サーバー管理ツールをインストールしたサーバー上で、PowerShellコマンドレットを用いて管理することが可能です。
各役割および機能に関するPowerShellコマンドレットのヘルプについて、オンライン上で公開されていますが、主に英語のみで日本語の情報はあまり公開されていないようです。
ここでは、WSFCに関するPowerShellコマンドレットの情報について、日本語としてオンライン上で備忘録として確認したいと思い、本ブログ上で纏めてみることにしました (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集したものとなります)。
この記事では、「Get-ClusterNode」コマンドレットについて記載します (他のコマンドレットについては、「Windows Server 2008 R2のWSFCで使用できるPowerShellコマンドレットについて」を参照)。
■名前
Get-ClusterNode
■概要
フェールオーバー クラスター内の 1 つまたは複数のノード (サーバー) に関する情報を取得します。
■構文
| Get-ClusterNode [-InputObject <psobject>] [[-Name] <StringCollection>] [-Cluster <string>] [<CommonParameters>] |
■説明
このコマンドレットを使用して、ノードの状態に関する情報を取得します。特定のノードによって現在所有されているリソースを表示するには、このコマンドレットで対象のノードを指定し、実行結果をパイプライン経由で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。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。
■入力
Microsoft.FailoverClusters.PowerShell.Cluster
■出力
Microsoft.FailoverClusters.PowerShell.ClusterNode
■メモ
■例
例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
- Remove-ClusterNode
- Resume-ClusterNode
- Start-ClusterNode
- Stop-ClusterNode
- Suspend-ClusterNode
[参考]
- Get-ClusterNode
http://technet.microsoft.com/en-us/library/ee460990.aspx - Cmdlet Reference for Windows Server 2008 R2
http://technet.microsoft.com/en-us/library/ee407531.aspx - Failover Cluster Cmdlets in Windows PowerShell
http://technet.microsoft.com/en-us/library/ee461009.aspx - Getting Started with Windows PowerShell on a Failover Cluster
http://technet.microsoft.com/en-us/library/ee619762.aspx
コメント
[…] Get-ClusterNode […]
[…] Windows Server 2008 R2のWSFCで使用できるPowerShellコマンドレット (Get-ClusterNode) について « 焦げloghttps://kogelog.com/2012/08/27/20120827-01/ […]