Set-ClusterQuorum

  • Reference
Module:
FailoverClusters

Configures quorum options for a failover cluster.

Syntax

Set-ClusterQuorum
   [-DiskOnly <String>]
   [-NoWitness]
   [-DiskWitness <String>]
   [-FileShareWitness <String>]
   [-CloudWitness]
   [-AccountName <String>]
   [-Endpoint <String>]
   [-AccessKey <String>]
   [-InputObject <PSObject>]
   [-Cluster <String>]
   [<CommonParameters>]

Description

The Set-ClusterQuorum cmdlet configures quorum options for a failover cluster. The quorum configuration in a failover cluster determines the number of failures that the cluster can sustain. If an additional failure occurs, the cluster must stop running. The relevant failures in this context are failures of nodes or, in some cases, of a disk witness (which contains a copy of the cluster configuration) or file share witness.

Examples

Example 1

Set-ClusterQuorum -NodeMajority

This example changes the quorum configuration to Node Majority on the local cluster.

Example 2

Set-ClusterQuorum -DiskWitness "Cluster Disk 7"

This example changes the quorum configuration to Node and Disk Majority on the local cluster, using the disk resource named Cluster Disk 7 for the disk witness.

Example 3

Set-ClusterQuorum -NodeAndFileShareMajority \\fileserver\fsw

This example changes the quorum configuration to Node and File Share Majority on the local cluster, using the disk resource at \\fileserver\fsw for the file share witness.

Example 4

$parameters = @{
    CloudWitness = $true
    AccountName  = '<AzureStorageAccountName>'
    AccessKey    = '<AzureStorageAccountAccessKey>'
}
Set-ClusterQuorum @parameters

This example changes the quorum configuration to use an Azure Storage Account to use as a Cloud Witness.

The example uses splatting to pass parameter values from the $Parameters variable to the command. Learn more about Splatting.

Parameters

-AccessKey

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

-AccountName

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

-CloudWitness

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

-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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskOnly

Causes the cluster quorum to be set to disk only type. This isn't recommended as it creates a single point of failure for the cluster.

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

-DiskWitness

Specifies the name of the disk resource that the cluster quorum uses as the disk witness. Specifying this parameter sets the cluster quorum to the Node and Disk Majority type.

Type:String
Aliases:NodeAndDiskMajority
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Endpoint

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

-FileShareWitness

Specifies the path of the file share that the cluster quorum uses as the file witness. Specifying this parameter sets the cluster quorum to the Node and File Share Majority type.

Type:String
Aliases:NodeAndFileShareMajority
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies the cluster on which to change the quorum type.

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

-NoWitness

Indicates that the cmdlet sets the cluster quorum to the Node Majority type.

Type:SwitchParameter
Aliases:NodeMajority
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.FailoverClusters.PowerShell.Cluster

Outputs

Microsoft.FailoverClusters.PowerShell.ClusterQuorumSettings