Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Test-ClusterResourceFailure

Test-ClusterResourceFailure

microsoft.failoverclusters.powershell.dll

Synopsis

Simulates a failure of a cluster resource.

Syntax

Test-ClusterResourceFailure [-Name] [-Cluster] [-InputObject] [<CommonParameters>]

Detailed Description

The Test-ClusterResourceFailure cmdlet simulates a failure of a cluster resource.

Based on the failover and failback policies, when this cmdlet runs, the Cluster service moves the clustered role, or resource group, and attempts to bring the clustered resource online. This cmdlet can be used to simulate what actions the Cluster service will take when a resource fails.

Parameters

-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.

Aliases

None

Required?

false

Position

named

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

-InputObject <PSObject>

Specifies the cluster resource of which to simulate failure.

Aliases

None

Required?

false

Position

named

Default value

Accept pipeline input?

true (ByValue)

Accept wildcard characters?

false

-Name <String>

Specifies the name of the cluster resource of which to simulate failure.

Aliases

None

Required?

false

Position

1

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type


Return Type


Notes

None

Examples

Example 1

This example simulates a failure in cluster resource named Cluster Disk 4.

PS C:\>Test-ClusterResourceFailure –Name "Cluster Disk 4"
Name                State               Group               ResourceType 
----                -----               -----               ------------ 
Cluster Disk 4      Failed              cluster12FS         Physical Disk 

Online Version
Move-ClusterGroup
Start-ClusterResource