Cluster group
The cluster group command is used to create a new cluster group or administer an existing group. Used without parameters, cluster group defaults to the /status command-line option and displays the status for a group.Syntax
cluster [[/cluster:]ClusterName] group GroupName /Option
Parameters
- /node: NodeName
- Specifies the node that owns the group.
- /stat[us]
- Displays the status of a group (online, offline, or Partially Online).
- /create
- Creates a new group.
- /delete
- Deletes a group.
- /ren[ame]:NewGroupName
- Renames a group.
- /move[to][:NodeName] [/wait[:Timeout_in_Seconds]]
- Moves a group to another node.
- /on[line][:NodeName] [/wait[:Timeout_in_Seconds]]
- Brings a group online.
- /off[line][:NodeName] [/wait[:Timeout_in_Seconds]]
- Takes a group offline.
- /prop[erties] [PropertyList]
- Views or sets the group common properties.
- /priv[properties] [PropertyList]
- Views or sets the group private properties.
- /listowners
- Displays a list of preferred owners.
- /setowners: NodeName[,NodeName ...]
- Specifies a preferred owner.
- /?
- Displays help at the command prompt.
Remarks
-
Using the cluster group command
The cluster name is optional. If the name of your cluster is also a cluster command or its abbreviation, such as "cluster" or "group," use /cluster: to explicitly specify the cluster name. For a list of all the cluster commands, see Related Topics.
With /move[to], /online, and /offline, the command-line option /wait[:Timeout_in_Seconds] specifies how long Cluster.exe waits before canceling the command if it does not successfully complete. If you do not use the /wait option with the /move[to] command, Cluster.exe waits 20 seconds. If you do not use the /wait option with the /offline or /online commands, Cluster.exe waits 10 seconds. For the /move[to], /online, or /offline commands, if you use /wait without specifying a time-out period, Cluster.exe waits indefinitely or until the group state changes.
If a node name is not specified, the Cluster service will automatically select a node following the move and failover logic described in Determining failover and move policies for groups. -
Using the /stat[us] command-line option
The group name is optional. If you do not provide a group name, status for all groups is displayed. -
Using the /prop[erties] [PropertyList] command-line option
The group name is optional. Properties for all groups are displayed if group name is not provided. For more information on property lists, see Related Topics. -
Using the /priv[properties] [PropertyList] command-line option
The group name is optional. Private properties for all groups are displayed if you do not provide a group name. For more information on property lists, see Related Topics. -
Using cluster group common property names
The following table describes the common cluster group property names, their uses, and valid settings: