Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Add-ClusterGroup

Add-ClusterGroup

microsoft.failoverclusters.powershell.dll

Synopsis

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

Syntax

Add-ClusterGroup [-Name] [-GroupType] [-Cluster] [-InputObject] [<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

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

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

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

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type

Microsoft.FailoverClusters.PowerShell.Cluster

Return Type

Microsoft.FailoverClusters.PowerShell.ClusterGroup

Notes

None

Examples

EXAMPLE 1

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

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

Online Version
Get-ClusterGroup
Move-ClusterGroup
Remove-ClusterGroup
Start-ClusterGroup
Stop-ClusterGroup