Windows Server 2008 R2では、Active Directory (AD) やフェールオーバー クラスタリング (WSFC)、グループ ポリシーといった役割および機能がインストールされたサーバーの管理、もしくは管理したい役割および機能についてリモート サーバー管理ツールをインストールしたサーバー上で、PowerShellコマンドレットを用いて管理することが可能です。
各役割および機能に関するPowerShellコマンドレットのヘルプについて、オンライン上で公開されていますが、主に英語のみで日本語の情報はあまり公開されていないようです。
ここでは、WSFCに関するPowerShellコマンドレットの情報について、日本語としてオンライン上で備忘録として確認したいと思い、本ブログ上で纏めてみることにしました (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集したものとなります)。
この記事では、「Test-Cluster」コマンドレットについて記載します (他のコマンドレットについては、「Windows Server 2008 R2のWSFCで使用できるPowerShellコマンドレットについて」を参照)。
■名前
Test-Cluster
■概要
フェールオーバー クラスターのハードウェアおよび設定に対して検証テストを実行します。テストは、クラスターの設定前にも設定後にも実行できます。
■構文
| Test-Cluster [-InputObject <psobject>] [[-Node] <StringCollection>] [-Cluster <string>] [-Ignore <StringCollection>] [-Include <StringCollection>] [-List] [-ReportName <string>] [<CommonParameters>] |
■説明
テスト結果は、指定したファイル名でファイルに保存されます。検証テストを実行することにより、ハードウェアおよび設定がフェールオーバー クラスタリングと互換性があることを確認できます。Cluster、Inventory、Network、Storage、Systemなど、複数の種類のテストがあります。Storage テストでは、クラスター化されたサービスまたはアプリケーションによって使用されているオンライン ディスクのテストは行われません。それらのディスクをテストするには、まずStop-ClusterGroupを実行してクラスター化されたサービスまたはアプリケーションをオフラインに移行し、次に Test-Clusterを実行します。テストが完了すると、クラスター化されたサービスまたはアプリケーション (リソース グループ) は再度オンラインに移行します。
■パラメーター
-Cluster <string>
このコマンドレットを実行するクラスターの名前を指定します。「-Cluster .」と入力するか、パラメーターを省略した場合、コマンドレットはローカル クラスターで実行されます。
| 必須 | false |
| 位置 | named |
| 既定値 | |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-Ignore <StringCollection>
検証テストの実行時に無視するテストまたはテストのカテゴリを指定します。その他のテストおよびテストのカテゴリはすべて実行されます。
| 必須 | false |
| 位置 | named |
| 既定値 | |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-Include <StringCollection>
検証テストの実行時に対象とするテストまたはテストのカテゴリを指定します。ここで指定したテストおよびテストのカテゴリのみが実行されます。
| 必須 | false |
| 位置 | named |
| 既定値 | |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-InputObject <psobject>
検証テストを実行するクラスターを指定します。
| 必須 | false |
| 位置 | named |
| 既定値 | |
| パイプライン入力を許可する | true (ByValue) |
| ワイルドカード文字を許可する | false |
-List [<SwitchParameter>]
コマンドレットにより、テストおよびテストのカテゴリが一覧表示されます。サーバーおよびクラスター ノードで、テストは実行されません。
| 必須 | false |
| 位置 | named |
| 既定値 | |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-Node <StringCollection>
クラスター検証テストを実行するサーバー名のコンマ区切り一覧を指定します。
| 必須 | false |
| 位置 | 1 |
| 既定値 | |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-ReportName <string>
生成するテスト レポートの名前を指定します。
| 必須 | false |
| 位置 | named |
| 既定値 | |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。
■入力
Microsoft.FailoverClusters.PowerShell.Cluster
■出力
System.IO.FileInfo, Microsoft.FailoverClusters.PowerShell.ClusterTestInfo
■メモ
■例
例1
Test-Cluster
例1:出力結果
| Mode LastWriteTime Length Name —- ————- —— —- -a— 10/10/2008 6:31 PM 1132255 Test-Cluster on 2008.10.10 At 18.22.53.mht |
例1:説明
このコマンドは、ローカル クラスターに適用可能なすべてのクラスター検証テストを実行します。
例2
Test-Cluster -Node node1,node2
例2:出力結果
| Mode LastWriteTime Length Name —- ————- —— —- -a— 10/10/2008 6:18 PM 998032 Test-Cluster on 2008.10.10 At 18.08.24.mht |
例2:説明
このコマンドは、node1およびnode2に対してすべてのクラスター検証テストを実行します。node1またはnode2がクラスターのメンバーである場合、クラスター内のすべてのノードがテスト対象になります。
例3
Test-Cluster -List
例3:出力結果
| Category DisplayName Description ——– ———– ———– Cluster Configuration List Cluster Core Groups List information about… Cluster Configuration List Cluster Network In… List cluster-specific … Cluster Configuration List Cluster Resources List the resources tha… Cluster Configuration List Cluster Volumes List information for t… Cluster Configuration List Clustered Services… List information about… Cluster Configuration Validate Quorum Configu… Validate that the curr… Cluster Configuration Validate Resource Status Validate that cluster … Cluster Configuration Validate Service Princi… Validate that a Servic… Cluster Configuration Validate Volume Consist… If any volumes are fla… Inventory List BIOS Information List BIOS information … Inventory List Environment Variables List environment varia… Inventory List Fibre Channel Host… List Fibre Channel hos… Inventory List iSCSI Host Bus Ada… List iSCSI host bus ad… Inventory List Memory Information List memory informatio… Inventory List Operating System I… List information about… Inventory List Plug and Play Devices List Plug and Play dev… Inventory List Running Processes List the running proce… Inventory List SAS Host Bus Adapters List Serial Attached S… Inventory List Services Information List information about… Inventory List Software Updates List software updates … Inventory List System Drivers List the system driver… Inventory List System Information List system informatio… Inventory List Unsigned Drivers List the unsigned driv… Network List Network Binding Order List the order in whic… Network Validate Cluster Networ… Validate the cluster n… Network Validate IP Configuration Validate that IP addre… Network Validate Multiple Subne… For clusters using mul… Network Validate Network Commun… Validate that servers … Network Validate Windows Firewa… Validate that the Wind… Storage List All Disks List all disks visible… Storage List Potential Cluster … List disks visible to … Storage Validate Disk Access La… Validate acceptable la… Storage Validate Disk Arbitration Validate that a node t… Storage Validate Disk Failover Validate that a disk c… Storage Validate File System Validate that the file… Storage Validate Microsoft MPIO… Validate that Microsof… Storage Validate Multiple Arbit… Validate that in a mul… Storage Validate SCSI device Vi… Validate that storage … Storage Validate SCSI-3 Persist… Validate that storage … Storage Validate Simultaneous F… Validate that disks ca… System Configuration Validate Active Directo… Validate that all the … System Configuration Validate All Drivers Si… Validate that tested s… System Configuration Validate Cluster Servic… Validate startup setti… System Configuration Validate Memory Dump Se… Validate that none of … System Configuration Validate Operating Syst… Validate that the oper… System Configuration Validate Required Services Validate that services… System Configuration Validate Same Processor… Validate that all serv… System Configuration Validate Service Pack L… Validate that all serv… System Configuration Validate Software Updat… Validate that all test… System Configuration Validate System Drive V… Validate that all node… |
例3:説明
このコマンドは、クラスター検証のすべてのテストおよびカテゴリの名前を一覧表示します。各テスト名と共に-Ignoreまたは-Includeを指定することで、特定のテストを実行できます。
例4
Test-Cluster -Node node1,node2 -Include Storage
例4:出力結果
| Mode LastWriteTime Length Name —- ————- —— —- -a— 10/10/2008 6:20 PM 37818 Test-Cluster on 2008.10.10 At 18.20.52.mht |
例4:説明
このコマンドは、node1およびnode2に対してStorage検証テストを実行します。node1またはnode2がクラスターのメンバーである場合、クラスター内のすべてのノードがテスト対象になります。
例5
Test-Cluster -Node node1,node2 -Ignore Inventory
例5:出力結果
| Mode LastWriteTime Length Name —- ————- —— —- -a— 10/10/2008 6:20 PM 732889 Test-Cluster on 2008.10.10 At 18.19.47.mht |
例5:説明
このコマンドは、node1およびnode2に対してInventoryテストを除くすべての検証テストを実行します。node1またはnode2がクラスターのメンバーである場合、クラスター内のすべてのノードがテスト対象になります。
例6
Test-Cluster -Include "List Potential Cluster Disks"
例6:出力結果
| Mode LastWriteTime Length Name —- ————- —— —- -a— 10/15/2008 2:58 PM 36119 Test-Cluster on 2008.10.15 At 14.58.44.mht |
例6:説明
このコマンドは、ローカル クラスターに対して”List Potential Cluster Disks”テストを実行します。
例7
Test-Cluster -Include "List System Drivers","List Unsigned Drivers"
例7:出力結果
| Mode LastWriteTime Length Name —- ————- —— —- -a— 10/15/2008 3:00 PM 266571 Test-Cluster on 2008.10.15 At 15.00.08.mht |
例7:説明
このコマンドは、ローカル クラスターに対して”List System Drivers”および”List Unsigned Drivers”テストを実行します。
■関連するリンク
- Get-Cluster
- New-Cluster
- Remove-Cluster
- Start-Cluster
- Stop-Cluster
[参考]
- Test-Cluster
http://technet.microsoft.com/en-us/library/ee461026.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
コメント
[…] Test-Cluster […]
[…] Windows Server 2008 R2のWSFCで使用できるPowerShellコマンドレット (Test-Cluster) について « 焦げloghttps://kogelog.com/2012/09/16/20120916-02/ […]