Test-Cluster

Test-Cluster

Run validation tests for failover cluster hardware and settings. Tests can be run both before and after a cluster is set up.

Syntax

Test-Cluster [-InputObject <psobject>] [[-Node] <StringCollection>] [-Cluster <string>] [-Ignore <StringCollection>] [-Include <StringCollection>] [-List] [-ReportName <string>] [<CommonParameters>]
  • InputObject

  • Node

  • Cluster

  • Ignore

  • Include

  • List

  • ReportName

Detailed Description

Test results are captured in a file with the file name that you specify. By running the validation tests, you can confirm that your hardware and settings are compatible with failover clustering. There are multiple types of tests, including Cluster, Inventory, Network, Storage, and System tests. Storage tests will not test online disks that are in use by a clustered service or application. To test such disks, first run Stop-ClusterGroup to bring the clustered service or application offline, and then run Test-Cluster. After the tests are done, bring the clustered services or applications (resource groups) online again.

Parameters

Cluster

Specifies the name of the cluster to run this cmdlet on. If you type "-Cluster ." or omit the parameter, the cmdlet runs on the local cluster.

Default Value: **

Data Type: string

Attributes

Name Value PSMAML Attribute

Required?

false

required

Variable Length?

false

variableLength

Accept wildcard characters?

false

globbing

Accept Pipeline Input?

false

pipelineInput

Position?

named

position

Value Attributes

Name Value PSMAML Attribute

Required?

true

required

Variable Length?

false

variableLength

Ignore

Specifies which tests or category of tests to ignore during the validation test run. All others tests or category of tests will run.

Default Value: **

Data Type: StringCollection

Attributes

Name Value PSMAML Attribute

Required?

false

required

Variable Length?

false

variableLength

Accept wildcard characters?

false

globbing

Accept Pipeline Input?

false

pipelineInput

Position?

named

position

Value Attributes

Name Value PSMAML Attribute

Required?

true

required

Variable Length?

false

variableLength

Include

Specifies which tests or category of tests to include during the validation test run. Only the tests or category of tests specified here will run.

Default Value: **

Data Type: StringCollection

Attributes

Name Value PSMAML Attribute

Required?

false

required

Variable Length?

false

variableLength

Accept wildcard characters?

false

globbing

Accept Pipeline Input?

false

pipelineInput

Position?

named

position

Value Attributes

Name Value PSMAML Attribute

Required?

true

required

Variable Length?

false

variableLength

InputObject

Specifies the cluster to run validation tests on.

Default Value: **

Data Type: psobject

Attributes

Name Value PSMAML Attribute

Required?

false

required

Variable Length?

false

variableLength

Accept wildcard characters?

false

globbing

Accept Pipeline Input?

true (ByValue)

pipelineInput

Position?

named

position

Value Attributes

Name Value PSMAML Attribute

Required?

true

required

Variable Length?

false

variableLength

List

Causes the cmdlet to list the tests and test categories. No tests will run on the servers or cluster nodes.

Default Value: **

Data Type: SwitchParameter

Attributes

Name Value PSMAML Attribute

Required?

false

required

Variable Length?

false

variableLength

Accept wildcard characters?

false

globbing

Accept Pipeline Input?

false

pipelineInput

Position?

named

position

Value Attributes

Name Value PSMAML Attribute

Required?

false

required

Variable Length?

false

variableLength

Node

Specifies a comma-separated list of server names to run cluster validation tests on.

Default Value: **

Data Type: StringCollection

Attributes

Name Value PSMAML Attribute

Required?

false

required

Variable Length?

false

variableLength

Accept wildcard characters?

false

globbing

Accept Pipeline Input?

false

pipelineInput

Position?

1

position

Value Attributes

Name Value PSMAML Attribute

Required?

true

required

Variable Length?

false

variableLength

ReportName

Specifies the name of the test report to generate.

Default Value: **

Data Type: string

Attributes

Name Value PSMAML Attribute

Required?

false

required

Variable Length?

false

variableLength

Accept wildcard characters?

false

globbing

Accept Pipeline Input?

false

pipelineInput

Position?

named

position

Value Attributes

Name Value PSMAML Attribute

Required?

true

required

Variable Length?

false

variableLength

Input Type

Microsoft.FailoverClusters.PowerShell.Cluster

Return Type

System.IO.FileInfo, Microsoft.FailoverClusters.PowerShell.ClusterTestInfo

Examples

-------------------------- EXAMPLE 1 --------------------------

Command Prompt: C:\PS>

 
Test-Cluster 
 
Mode                LastWriteTime     Length Name 
----                -------------     ------ ---- 
-a---        10/10/2008   6:31 PM    1132255 Test-Cluster on 2008.10.10 At 18.22.53.mht

Description

-----------

This command runs all applicable cluster validation tests on the local cluster.

 

-------------------------- EXAMPLE 2 --------------------------

Command Prompt: C:\PS>

 
Test-Cluster -Node node1,node2 
 
Mode                LastWriteTime     Length Name 
----                -------------     ------ ---- 
-a---        10/10/2008   6:18 PM     998032 Test-Cluster on 2008.10.10 At 18.08.24.mht

Description

-----------

This command runs all cluster validation tests on node1 and node2. If either node1 or node2 is already a member of a cluster, the tests will include all nodes in that cluster.

 

-------------------------- EXAMPLE 3 --------------------------

Command Prompt: C:\PS>

 
Test-Cluster -List 
 
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...

Description

-----------

This command lists the names of all tests and categories in cluster validation. You can then specify these test names with -Ignore or -Include to run specific tests.

 

-------------------------- EXAMPLE 4 --------------------------

Command Prompt: C:\PS>

 
Test-Cluster -Node node1,node2 -Include Storage 
 
Mode                LastWriteTime     Length Name 
----                -------------     ------ ---- 
-a---        10/10/2008   6:20 PM      37818 Test-Cluster on 2008.10.10 At 18.20.52.mht

Description

-----------

This command runs the storage validation tests on node1 and node2. If either node1 or node2 is already a member of a cluster, the tests will include all nodes in that cluster.

 

-------------------------- EXAMPLE 5 --------------------------

Command Prompt: C:\PS>

 
Test-Cluster -Node node1,node2 -Ignore Inventory 
 
Mode                LastWriteTime     Length Name 
----                -------------     ------ ---- 
-a---        10/10/2008   6:20 PM     732889 Test-Cluster on 2008.10.10 At 18.19.47.mht

Description

-----------

This command runs all validation tests except the Inventory tests on node1 and node2. If either node1 or node2 is already a member of a cluster, the tests will include all nodes in that cluster.

 

-------------------------- EXAMPLE 6 --------------------------

Command Prompt: C:\PS>

 
Test-Cluster -Include "List Potential Cluster Disks" 
 
Mode                LastWriteTime     Length Name 
----                -------------     ------ ---- 
-a---        10/15/2008   2:58 PM      36119 Test-Cluster on 2008.10.15 At 14.58.44.mht

Description

-----------

This command runs the test called "List Potential Cluster Disks" on the local cluster.

 

-------------------------- EXAMPLE 7 --------------------------

Command Prompt: C:\PS>

 
Test-Cluster -Include "List System Drivers","List Unsigned Drivers" 
 
Mode                LastWriteTime     Length Name 
----                -------------     ------ ---- 
-a---        10/15/2008   3:00 PM     266571 Test-Cluster on 2008.10.15 At 15.00.08.mht

Description

-----------

This command runs the tests called "List System Drivers" and "List Unsigned Drivers" on the local cluster.

See Also

Reference

Get-Cluster
New-Cluster
Remove-Cluster
Start-Cluster
Stop-Cluster

Other Resources

Online version: