Windows Server 2012では、Windows Server 2008 R2からActive Directory (AD)やフェールオーバー クラスタリング (WSFC) といったサーバー管理におけるPowerShellコマンドレットが強化、および追加されました。
各役割および機能に関するPowerShellコマンドレットのヘルプについて、オンライン上で公開されていますが、現時点では主に英語のみで日本語の情報はあまり公開されていないようです。
ここでは、Windows Server 2012のWSFCに関するPowerShellコマンドレットの情報について、日本語としてオンライン上で備忘録として確認したいと思い、本ブログ上で纏めてみることにしました (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集、補足したものとなります)。
この記事では、「Start-ClusterNode」コマンドレットについて記載します (他のコマンドレットについては、「Windows Server 2012のWSFCで使用できるPowerShellコマンドレットについて」を参照)。
■名前
Start-ClusterNode
■概要
フェールオーバー クラスター内のノード上のクラスター サービスを開始します。
■構文
Start-ClusterNode [[-Name] <StringCollection>] [-FixQuorum] [-IgnorePersistentState] [-PreventQuorum] [-Wait <int32>] [-InputObject <psobject>] [-Cluster <string>] [<CommonParameters>]
■説明
Start-ClusterNodeコマンドレットは、フェールオーバー クラスター内のノード上のクラスター サービスを開始します。
開始する最初のノードに該当する場合、対象のノードは他のノードの参加が完了するまで待機します。クォーラムが形成された時点で、クラスターの実行が開始されます。このコマンドレットを -FixQuorumオプションと共に使用して、クォーラムを強制できます。具体的には、クォーラムが形成されていない場合でも、クラスター ノードの開始を強制します。対象のノードに対してクォーラムを強制すると、そのノード上のクラスター構成のコピーは正式なコピーとして扱われ、他のすべてのノードに複製されます。したがって、クラスター構成の変更内容の一部が失われる可能性があるので、クォーラムの強制は最後の手段として使用してください。クォーラムの強制機能が特に便利な場合としては、マルチサイト クラスターでプライマリ サイト (多数のノードを含む) が使用できなくなり、セカンダリ サイト (少数のノードを含む) をサービス状態に移行する必要がある場合が挙げられます。同様に、使用可能なクラスター ノードにクラスター構成の現在のコピーが含まれていない場合、クォーラムの強制機能により、[ノードおよびファイル共有マジョリティ] クォーラム オプションを使用するクラスターを開始できます。
注: このコマンドレットは、Credential Security Service Provider (CredSSP) 認証なしで、サーバー コンピューター上からリモートで実行することはできません。
■パラメーター
-Cluster <string>
このコマンドレットを実行するクラスターの名前を指定します。「-Cluster .」と入力するか、パラメーターを省略した場合、コマンドレットはローカル クラスターで実行されます。
エイリアス | なし |
必須 | false |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-FixQuorum
このノードに対してクォーラムを強制すると、そのノード上のクラスター構成のコピーが正式なコピーとして扱われ、他のすべてのノードに複製されます。クォーラムの強制は、最後の手段として使用してください。
エイリアス | fq |
必須 | false |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-IgnorePersistentState
ノード上のリソースをオンラインにすることなく、クラスター ノードを開始します。
エイリアス | なし |
必須 | false |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-InputObject <psobject>
開始するクラスター ノードを指定します。
エイリアス | なし |
必須 | false |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | true (ByValue) |
ワイルドカード文字を許可する | false |
-Name <StringCollection>
開始するクラスター ノードの名前を指定します。
エイリアス | なし |
必須 | false |
位置 | 1 |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-PreventQuorum
ノードを開始しますが、クォーラムから動作することを防止し、実行しているクラスタの2つの処理インスタンスで分割される状況を防ぐために、クラスタを整形します。
エイリアス | なし |
必須 | false |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-Wait <int32>
操作の待機時間を秒単位で指定します。このパラメーターが指定されていない場合は、操作が完了するまで待機します。”-Wait 0″を指定した場合、呼び出しが開始され、すぐにコマンドレットに戻ります。
エイリアス | なし |
必須 | false |
位置 | named |
既定値 | なし |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-WarningAction、-WarningVariable、-OutBuffer、および-OutVariable。詳細については、「about_commonparameters」と入力してヘルプを参照してください。
■入力
System.Management.Automation.PSObject
■出力
System.Object
■エイリアス
なし
■メモ
このコマンドレットを含むモジュールのヘルプ ファイルをダウンロードしてインストールするには、Update-Helpを使用してください。
このコマンドレットのヘルプ トピックをオンラインで確認するには、「Get-Help Start-ClusterNode -Online」と入力するか、http://go.microsoft.com/fwlink/?LinkId=216253を参照してください。
■例
例1
Start-ClusterNode node3
例1:出力結果
Name State —- —– node3 Joining |
例1:説明
このコマンドは、ローカル クラスターのnode3上のクラスター サービスを開始します。
例2
Start-ClusterNode node1 -Cluster cluster2
例2:出力結果
Name State —- —– node1 Joining |
例2:説明
このコマンドは、cluster2のnode1上のクラスター サービスを開始します。
例3
Start-ClusterNode -FixQuorum
例3:出力結果
Name State —- —– node1 Joining |
例3:説明
このコマンドは、クォーラムが形成されていない場合でも、ローカル ノードおよびローカル クラスターを強制的に開始します。クォーラムが形成されていない場合、ローカル ノード上のクラスター構成のコピーは正式なコピーとして扱われ、他のすべてのノードに複製されます。クラスター構成の変更内容の一部が失われる可能性があるので、このコマンドは最後の手段として使用してください。
■関連するリンク
- Add-ClusterNode
- Get-ClusterNode
- Remove-ClusterNode
- Resume-ClusterNode
- Stop-ClusterNode
- Suspend-ClusterNode
[参考]
- Start-ClusterNode – Windows Server 2012
http://technet.microsoft.com/en-us/library/hh847296.aspx - Windows PowerShell Support for Windows Server 2012
http://technet.microsoft.com/en-us/library/hh801904.aspx - Failover Clusters Cmdlets in Windows PowerShell – Windows Server 2012
http://technet.microsoft.com/en-us/library/hh847239.aspx - Windows Server 2008 R2のWSFCで使用できるPowerShellコマンドレット (Start-ClusterNode) について « 焦げlog
https://kogelog.com/2012/09/12/20120912-02/
コメント
[…] Start-ClusterNode […]