Add-Cluster Group

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

Syntax 

Add-ClusterGroup
   [-Name] <StringCollection>
   [[-GroupType] <GroupType>]
   [-InputObject <PSObject>]
   [-Cluster <String>]
   [<CommonParameters>]

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.

Examples

Example 1: Add a resource group 

PS C:\> Add-ClusterGroup -Name "Group1"
Name                       OwnerNode                                      State 
----                       ---------                                      ----- 
Group1                     node1                                         Online

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

Required Parameters

-Name

Specifies the name of the resource group to add.

Type: StringCollection
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Optional Parameters

-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
Accept pipeline input: False
Accept wildcard characters: False
-GroupType

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

Type: GroupType
Parameter Sets: Cluster, AvailableStorage, Temporary, ClusterSharedVolume, ClusterStoragePool, FileServer, DhcpServer, Dtc, Msmq, Wins, StandAloneDfs, GenericApplication, GenericService, GenericScript, IScsiNameService, VirtualMachine, TsSessionBroker, IScsiTarget, ScaleoutFileServer, VMReplicaBroker, TaskScheduler, Unknown
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject

Specifies the cluster on which to create the resource group.

Type: PSObject
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

Inputs

Microsoft.FailoverClusters.PowerShell.Cluster

Outputs

Microsoft.FailoverClusters.PowerShell.ClusterGroup