Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Add-ClusterGroup

Brian Lich|Last Updated: 3/28/2017

SYNOPSIS

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.

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
Parameter Sets: (All)
Aliases: 

Required: False
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: (All)
Aliases: 
Accepted values: Cluster, AvailableStorage, Temporary, ClusterSharedVolume, ClusterStoragePool, FileServer, DhcpServer, Dtc, Msmq, Wins, StandAloneDfs, GenericApplication, GenericService, GenericScript, IScsiNameService, VirtualMachine, TsSessionBroker, IScsiTarget, ScaleoutFileServer, VMReplicaBroker, TaskScheduler, Unknown

Required: False
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
Parameter Sets: (All)
Aliases: 

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

-Name

Specifies the name of the resource group to add.

Type: StringCollection
Parameter Sets: (All)
Aliases: 

Required: True
Position: 0
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

Microsoft.FailoverClusters.PowerShell.Cluster

OUTPUTS

Microsoft.FailoverClusters.PowerShell.ClusterGroup

NOTES

Get-ClusterGroup

Move-ClusterGroup

Remove-ClusterGroup

Start-ClusterGroup

Stop-ClusterGroup

© 2017 Microsoft