Edit

Share via

Set-ClusterQuorum

Module:
FailoverClusters Module

Configures quorum options for a failover cluster.

Syntax

Default (Default) 

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

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AccountName

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CloudWitness

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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:NodeAndDiskMajority

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Endpoint

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:NodeAndFileShareMajority

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

Specifies the cluster on which to change the quorum type.

Parameter properties

Type:PSObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-NoWitness

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:NodeMajority

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

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

Inputs

Microsoft.FailoverClusters.PowerShell.Cluster

Outputs

Microsoft.FailoverClusters.PowerShell.ClusterQuorumSettings