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