Set-ClusterQuorum
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