Add-ClusterGroup

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

Syntax

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

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

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:1
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
-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