Add-ClusterGroup

Add-ClusterGroup

Adds an empty resource group to the failover cluster configuration, in preparation for adding clustered resources to the group.

Syntax

Parameter Set: InputObject
Add-ClusterGroup [-Name] <StringCollection> [[-GroupType] <GroupType> {Cluster | AvailableStorage | Temporary | ClusterSharedVolume | ClusterStoragePool | FileServer | DhcpServer | Dtc | Msmq | Wins | StandAloneDfs | GenericApplication | GenericService | GenericScript | IScsiNameService | VirtualMachine | TsSessionBroker | IScsiTarget | ScaleoutFileServer | VMReplicaBroker | TaskScheduler | Unknown} ] [-Cluster <String> ] [-InputObject <PSObject> ] [ <CommonParameters>]




Detailed Description

The Add-ClusterGroup cmdlet adds an empty resource group to the failover cluster configuration, in preparation for adding clustered resources to the group. A resource group, or a clustered role, is the unit of failover. During failover, all resources in the resource group move together.

Parameters

-Cluster<String>

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-GroupType<GroupType>

Specifies the type of group to add to the failover cluster configuration.


Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InputObject<PSObject>

Specifies the cluster on which to create the resource group.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Name<StringCollection>

Specifies the name of the resource group to add.


Aliases

none

Required?

true

Position?

1

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

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

  • Microsoft.FailoverClusters.PowerShell.Cluster

Outputs

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

  • Microsoft.FailoverClusters.PowerShell.ClusterGroup

Examples

Example 1: Add a resource group

This example adds an empty resource group called Group1 to the failover cluster.


PS C:\> Add-ClusterGroup –Name "Group1"

Related topics

Community Additions

ADD
Show: