Test-Cluster

Test-Cluster

Runs validation tests for failover cluster hardware and settings.

구문

Parameter Set: InputObject
Test-Cluster [[-Node] <StringCollection> ] [-Cluster <String> ] [-Disk <Object[]> ] [-Force] [-Ignore <StringCollection> ] [-Include <StringCollection> ] [-InputObject <PSObject> ] [-List] [-Pool <Object[]> ] [-ReportName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

자세한 설명

The Test-Cluster cmdlet runs validation tests for failover cluster hardware and settings. Tests can be run both before and after a cluster is set up.

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, System, and other types of tests. Storage tests will not test online disks or storage pools that are in use by a clustered role. To test such disks, first run Stop-ClusterGroup to stop the clustered role, and then run Test-Cluster. After the tests are done, start the clustered roles, also known as resource groups, again.

매개 변수

-Cluster<String>

Specifies the name of the cluster on which to run this cmdlet. If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.

-Disk<Object[]>

Specifies the disk number or disks for which to run the cmdlet. If the specified disk is online and is assigned to a clustered role or Cluster Shared Volume, you must also specify the Force parameter to take the disk offline for the duration of the storage tests. Otherwise, the specified disk must be offline before the cmdlet is run. If the Disk parameter is not specified, storage tests run on all disks that are available for use in the cluster or that are in the cluster resource offline or failed state. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- Int32, Int64, Uint32, Uint64: A number that represents a master boot record (MBR) signature of the disk.
-- System.String: A string that represents a master boot record (MBR) signature of the disk, hexadecimal format is supported.
-- System.String: A string that represents the GUID of a GPT disk.
-- ClusterResource: A cluster resource object that represents a clustered disk.
-- CimInstance#MSFT_Disk: An object returned from Get-Disk, from the Windows PowerShell® storage module.

-Force

Runs the cmdlet without prompting for confirmation. By default the cmdlet will ask for confirmation from the user before proceeding.

-Ignore<StringCollection>

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

-Include<StringCollection>

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.

-InputObject<PSObject>

Specifies the cluster on which to run the validation tests.

-List

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

-Node<StringCollection>

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

-Pool<Object[]>

Specifies the clustered storage pool or pools for which to run the cmdlet. When the specified storage pool is online and a virtual disk in the storage pool is assigned to a clustered role or Cluster Shared Volume, you must also specify the Force parameter to take the storage pool offline for the duration of the storage tests. Otherwise, the specified storage pool must be taken offline before the storage tests. If the Pool parameter is not specified, storage tests run on all storage pools that are available for use in the cluster or that are in the cluster resource offline or failed state. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- System.String: A string that represents the name of the clustered storage pool or pools.
-- ClusterResource: A cluster resource object that represents a clustered storage pool.
-- CimInstance#MSFT_StoragePool: An object returned from Get-StoragePool, from the Windows PowerShell storage module.

-ReportName<String>

Specifies the name of the test report to generate.

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

-WhatIf

cmdlet이 실행되는 경우 발생할 결과를 보여 줍니다. cmdlet은 실행되지 않습니다.

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)

입력

입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.

• Microsoft.FailoverClusters.PowerShell.Cluster

출력

출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.

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

예

Example 1

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

PS C:\> Test-Cluster

Example 2

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

PS C:\> Test-Cluster -Node node1,node2

Example 3

This example lists the names of all tests and categories in cluster validation. Specify these test names with Ignore or Include parameters to run specific tests.

PS C:\> Test-Cluster -List

Example 4

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

PS C:\> Test-Cluster -Node node1,node2 -Include Storage

Example 5

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

PS C:\> Test-Cluster -Node node1,node2 -Ignore Inventory

Example 6

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

PS C:\> Test-Cluster -Include "List Potential Cluster Disks"

Example 7

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

PS C:\> Test-Cluster -Include "List System Drivers","List Unsigned Drivers"

관련 항목

Get-Cluster

New-Cluster

Remove-Cluster

Start-Cluster

Stop-Cluster