Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Test-ClusterResourceFailure

Brian Lich|Last Updated: 3/28/2017

SYNOPSIS

Simulates a failure of a cluster resource.

SYNTAX

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

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.

EXAMPLES

Example 1: Simulate a failure

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

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

PARAMETERS

-Cluster

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.

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Specifies the cluster resource of which to simulate failure.

Type: PSObject
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

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

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

Move-ClusterGroup

Start-ClusterResource

© 2017 Microsoft