Export (0) Print
Expand All
Expand Minimize

Get-Cluster

Windows Server 2012 R2 and Windows 8.1

Updated: October 17, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Get-Cluster

Gets information about one or more failover clusters in a given domain.

Syntax

Parameter Set: Name
Get-Cluster [[-Name] <String> ] [-Domain <String> ] [ <CommonParameters>]




Detailed Description

The Get-Cluster cmdlet gets information about one or more failover clusters in a given domain.

This cmdlet can obtain a variety of configuration and state information about a failover cluster, including the following items:
-- State information about whether a backup is in progress.
-- State information about whether the cluster is in a forced quorum state.
-- Cross-network settings that are especially relevant for multi-site clusters.

To set a common property for the cluster, use this cmdlet to get the cluster object and then set the appropriate property on that cluster object directly.

Parameters

-Domain<String>

Specifies the name of the domain in which to enumerate clusters.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of the cluster to get.


Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

true

<CommonParameters>

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

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.FailoverClusters.PowerShell.Cluster

Examples

EXAMPLE 1

This example displays state and property information for the local cluster in the form of a list.


PS C:\> Get-Cluster | Format-List –Property *
Domain                                  : contoso.com 
Name                                    : cluster1 
AddEvictDelay                           : 60 
BackupInProgress                        : 0 
ClusSvcHangTimeout                      : 60 
ClusSvcRegroupOpeningTimeout            : 5 
ClusSvcRegroupPruningTimeout            : 5 
ClusSvcRegroupStageTimeout              : 5 
ClusSvcRegroupTickInMilliseconds        : 300 
ClusterGroupWaitDelay                   : 120 
MinimumNeverPreemptPriority             : 3000 
MinimumPreemptorPriority                : 1 
ClusterEnforcedAntiAffinity             : 0 
ClusterLogLevel                         : 3 
ClusterLogSize                          : 300 
CrossSubnetDelay                        : 1000 
CrossSubnetThreshold                    : 5 
DefaultNetworkRole                      : 2 
Description                             : 
FixQuorum                               : 0 
HangRecoveryAction                      : 3 
IgnorePersistentStateOnStartup          : 0 
LogResourceControls                     : 0 
PlumbAllCrossSubnetRoutes               : 0 
PreventQuorum                           : 0 
QuorumArbitrationTimeMax                : 20 
RequestReplyTimeout                     : 60 
RootMemoryReserved                      : 4294967295 
RouteHistoryLength                      : 0 
SameSubnetDelay                         : 1000 
SameSubnetThreshold                     : 5 
SecurityLevel                           : 1 
SharedVolumeCompatibleFilters           : {} 
SharedVolumeIncompatibleFilters         : {} 
SharedVolumesRoot                       : C:\ClusterStorage 
SharedVolumeSecurityDescriptor          : {1, 0, 4, 128...} 
ShutdownTimeoutInMinutes                : 20 
UseNetftForSharedVolumes                : 1 
UseClientAccessNetworksForSharedVolumes : 0 
SharedVolumeBlockCacheSizeInMB          : 0 
WitnessDatabaseWriteTimeout             : 300 
WitnessRestartInterval                  : 15 
EnableSharedVolumes                     : Enabled 
DynamicQuorum                           : 1 
Id                                      : af5881ef-0ff7-4b5c-bfed-098decbbf762 

EXAMPLE 2

This example gets information about a cluster named cluster1.


PS C:\> Get-Cluster –Name cluster1
Name 
---- 
cluster1 

EXAMPLE 3

This example gets information about each of the clusters in the contoso.com domain.


PS C:\> Get-Cluster -Domain contoso.com
Name 
---- 
cluster1 
cluster2 
cluster3 

EXAMPLE 4

This example sets the common property called CrossSubnetDelay for the local cluster to 1500.


PS C:\>  Get-Cluster | ForEach-Object –Process {$_.CrossSubnetDelay = 1500}

EXAMPLE 5

This example enables the Dynamic Quorum feature for the cluster.


PS C:\> (Get-Cluster).DynamicQuorum = 1

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft