Home > Commands A-M > Commands Ch-Cz

CLUSTER


Description | Syntax | Parameters | Switches | Related | Notes | Examples | Errorlevels | Availability

You can use cluster commands to administer server clusters from the Windows command prompt. You can also call the program from command scripts to automate many cluster administration tasks. Cluster is provided on all Windows computers.

You can administer clusters from a node of the cluster, from nodes of other clusters, or from other computers running Windows NT 4.0 with Service Pack 3 or later.


Syntax

CLUSTER /LIST[:domain_name]

CLUSTER /HELP | /?

CLUSTER [[/CLUSTER:]cluster_name]
[/LISTNETPRI[ORITY]
| /PRIV[PROPERTIES] [property_list]
| /PRIV[PROPERTIES] [:propname[,propname ...]]
| /PROP[ERTIES] [property_list]
| /PROP[ERTIES] [:propname[,propname ...]]
| /QUORUM[RESOURCE][:resource_name] [/PATH:path] [/MAXLOGSIZE:max_size_kb]
| /[UN]REG[ADMIN]EXT:admin_extension_dll[,admin_extension_dll ...]
| /REN[AME]:cluster_name
| /SETFAIL[UREACTIONS][:node_name[,node_name ...]]
| /SETNETPRI[ORITY]:[node_name[,node_name ...]]
| /VER[SION]
| /WIZ[ARD]]

CLUSTER [/CLUSTER:]cluster_name /ADD[NODES][:node_name[,node_name, ...]] /PASS[WORD]:pass_word [/VERB[OSE]] [/UNATTEND[ED]] [/MIN[IMUM]]

CLUSTER [/CLUSTER:]cluster_name /CHANGEPASS[WORD][:new_password[,old_password]] [/SKIPDC] [/FORCE] [/TEST] [/QUIET] [/VERB[OSE]] [/UNATTEND[ED]] [/HELP]

CLUSTER [/CLUSTER:]cluster_name /CREATE /IPADDR[ESS]:Static_IP_Address[,SubnetMask,NetworkConnectionName] /PASS[WORD]:pass_word /USER:{domain\user_name | user_name@domain} [/NODE:node_name] [/VERB[OSE]] [/UNATTEND[ED]] [/MIN[IMUM]]


Parameters
name=value[,value ...][:format][name=value[,value ...][:format] ...] (NT2000)
:name[,name ...] /userdefault (NT2000)
To revert to the default value of a common property or to delete a private property, use the /usedefault option.

Switches
/HELP | /? (NT2000)
Display cluster syntax. Default.
CHANGEPASS[WORD]: help for change password option only.
/ADD[NODES][:node_name[,node_name, ...]] (NT2003)
Creates a cluster.
/CHANGEPASS[WORD][:new_password[,old_password]] (NT2003)
For one or more clusters, changes the Cluster service account password on the domain controller and all the cluster nodes from old_password to new_password. If not supplied as part of the command, you will be prompted to provide the new_password or the old_password. You can specify a blank password by supplying two double quotes (""). If multiple clusters are specified in one operation, they must all use the same Cluster service account.
/CLUSTER (NT2000)
If you do not specify a cluster, attempts to connect to the cluster running on the node that is running the command.
If the name of your cluster is also a cluster command or its abbreviation, use /cluster: to explicitly specify the cluster name.
/CREATE (NT2003)
Creates a cluster.
/FORCE (NT2003)
Force execution of the password change command on the available nodes in a cluster even if some of the cluster nodes are not available.
/IPADDR[ESS]:Static_IP_Address[,SubnetMask,NetworkConnectionName] (NT2000)
?
/LIST[:domain_name] (NT2000)
Display a list of clusters in the computer's domain or a specified domain. Do not use the cluster name with this option.
/LISTNETPRI[ORITY] (NT2003)
Lists the priority of all internal (private and mixed) networks.
/MAXLOGSIZE:max_size_kb (NT2000)
Change the size of the quorum resource log.
/MIN[IMUM] (NT2003)
Creates a cluster using the Advanced (minimum) Configuration option. Use when creating clusters with complex storage configurations.
/NODE:node_name (NT2003)
The name of the server to be configured as the first cluster node. Will default to use the name of the current computer.
/PASS[WORD]:pass_word (NT2003)
?
/PATH:path (NT2000)
Change the location of the quorum resource.
/PRIV[PROPERTIES] (NT2000)
View or set the cluster private properties.
/PROP[ERTIES] (NT2000)
View or set the cluster common properties.
/QUIET (NT2003)
No output, unless an error occurs.
/QUORUM[RESOURCE][:resource_name] (NT2000)
Change the name of the quorum resource.
/[UN]REG[ADMIN]EXT:admin_extension_dll[,admin_extension_dll ...] (NT2000)
Register/Unregister a Cluster Administrator extension DLL with/from the cluster.
/REN[AME]:cluster_name (NT2000)
Rename a cluster.
/SETFAIL[UREACTIONS][:node_name[,node_name ...]] (NT2000)
Resets the restart actions settings that the Services Microsoft Management Console snap-in uses for the Cluster service to the original values used at setup.
Resets the Cluster service restart settings for one or more nodes to the values:
/SETNETPRI[ORITY]:node_name[,node_name, ...] (NT2003)
Sets the priority order for all internal networks. If you use this option, you must supply all the internal networks in the cluster.
/SKIPDC (NT2003)
Change the Cluster service account password only on the cluster nodes. It will not change the password on the domain controller. Use to complete a previous password update that was only partially completed.
Note If used, you do not have to supply the old_password.
/TEST (NT2003)
Open a connection to the specified cluster(s), verify that an appropriate domain controller is available, check the version of the operating system installed on each node, and verify that all the cluster nodes are online and use the same Cluster service account.
/UNATTEND[ED] (NT2003)
Will not be prompted for passwords not supplied at the command prompt.
/USER:{domain\user_name | user_name@domain} (NT2003)
?
/VERB[OSE] (NT2003)
Writes all event messages to the cluster log. Use for troubleshooting cluster configuration issues.
CHANGEPASS[WORD]: Outputs detailed information about the cluster nodes to the screen. Use for troubleshooting password change issues.
/VER[SION] (NT2000)
Display the Cluster service version number.
/WIZ[ARD] (NT2003)
Starts the Cluster Configuration Wizard. Must be used with either the /create or /add[nodes].
Important You cannot supply the subnet mask or network connection name to create a cluster. The program will use the information from the network connection with the same subnet mask as the cluster to supply the subnet mask, and network connection name.

Related

Cluster Group
Cluster Netinterface
Cluster Network
Cluster Node
Cluster Resource
Cluster ResourceType


Notes

Common cluster property names:


Examples

none.


Errorlevels

none.


Availability
External
DOS
none
Windows
none
Windows NT
NT2000 NT2003