Windows Server 2008 R2では、Active Directory (AD) やフェールオーバー クラスタリング (WSFC)、グループ ポリシーといった役割および機能がインストールされたサーバーの管理、もしくは管理したい役割および機能についてリモート サーバー管理ツールをインストールしたサーバー上で、PowerShellコマンドレットを用いて管理することが可能です。
各役割および機能に関するPowerShellコマンドレットのヘルプについて、オンライン上で公開されていますが、主に英語のみで日本語の情報はあまり公開されていないようです。
ここでは、WSFCに関するPowerShellコマンドレットの情報について、日本語としてオンライン上で備忘録として確認したいと思い、本ブログ上で纏めてみることにしました (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集したものとなります)。
この記事では、「Suspend-ClusterNode」コマンドレットについて記載します (他のコマンドレットについては、「Windows Server 2008 R2のWSFCで使用できるPowerShellコマンドレットについて」を参照)。
■名前
Suspend-ClusterNode
■概要
フェールオーバー クラスター ノード上のアクティビティを中断 (ノードを一時停止) します。
■構文
| Suspend-ClusterNode [-InputObject <psobject>] [[-Name] <StringCollection>] [-Cluster <string>] [<CommonParameters>] |
■説明
通常、ノードにソフトウェア更新プログラムを適用するときに、ノードを一時停止 (中断) します。その場合の手順として、そのノードからすべてのサービスとアプリケーションを移動し、ノードを一時停止させてから、ノードにソフトウェア更新プログラムを適用することをお勧めします。クラスター ノードで広範な診断またはメンテナンスを実行する必要がある場合は、そのノード上のクラスター サービスを停止 (一時停止ではなく) する方が現実的です。
■パラメーター
-Cluster <string>
このコマンドレットを実行するクラスターの名前を指定します。「-Cluster .」と入力するか、パラメーターを省略した場合、コマンドレットはローカル クラスターで実行されます。
| 必須 | false |
| 位置 | named |
| 既定値 | |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-InputObject <psobject>
中断するクラスター ノードを指定します。
| 必須 | false |
| 位置 | named |
| 既定値 | |
| パイプライン入力を許可する | true (ByValue) |
| ワイルドカード文字を許可する | false |
-Name <StringCollection>
中断するクラスター ノードの名前を指定します。
| 必須 | false |
| 位置 | 1 |
| 既定値 | |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。
■入力
Microsoft.FailoverClusters.PowerShell.ClusterNode
■出力
Microsoft.FailoverClusters.PowerShell.ClusterNode
■メモ
■例
例1
Suspend-ClusterNode node1
例1:出力結果
| Name State —- —– node1 Paused |
例1:説明
このコマンドは、ローカル クラスター上のnode1を一時停止します。
例2
Suspend-ClusterNode node2 -Cluster cluster2
例2:出力結果
| Name State —- —– node2 Paused |
例2:説明
このコマンドは、cluster2上のnode2を一時停止します。
■関連するリンク
- New-Cluster
- Remove-Cluster
- Start-Cluster
- Stop-Cluster
- Test-Cluster
[参考]
- Suspend-ClusterNode
http://technet.microsoft.com/en-us/library/ee461051.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
コメント
[…] Suspend-ClusterNode […]
[…] Windows Server 2008 R2のWSFCで使用できるPowerShellコマンドレット (Suspend-ClusterNode) について « 焦げloghttps://kogelog.com/2012/09/15/20120915-02/ […]