This topic has not yet been rated - Rate this topic

MSCluster_Node class

The MSCluster_Node class is a dynamic WMI class that represents a cluster node.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties.

Syntax

class MSCluster_Node : CIM_UnitaryComputerSystem
{
  string             Caption;
  string             CreationClassName;
  string             InitialLoadInfo[];
  datetime           InstallDate;
  string             LastLoadInfo;
  string             Name;
  string             NameFormat;
  string             OtherIdentifyingInfo[];
  string             IdentifyingDescriptions[];
  uint16             Dedicated[];
  uint16             PowerManagementCapabilities[];
  boolean            PowerManagementSupported;
  uint16             PowerState;
  string             PrimaryOwnerContact;
  string             PrimaryOwnerName;
  uint16             ResetCapability;
  string             Roles[];
  string             Status;
  string             Description;
  uint32             NodeHighestVersion;
  uint32             NodeLowestVersion;
  uint32             MajorVersion;
  uint32             MinorVersion;
  uint32             BuildNumber;
  uint32             CSDVersion;
  uint32             EnableEventLogReplication;
  string             NodeInstanceID;
  uint32             State;
  uint32             Flags;
  uint32             Characteristics;
  MSCluster_Property PrivateProperties;
};

Members

The MSCluster_Node class has these types of members:

Methods
Properties

Methods

The MSCluster_Node class has these methods.

Method	Description
ExecuteNodeControl	Executes a control code on the node. Windows Server 2003: This method is not supported.
Pause	Pauses the cluster activity on a node.
Resume	Resumes the cluster activity on a node.
SetPowerState	Defines the desired power state for a logical device and when a device should be put into that state. Not implemented by WMI. Inherited from CIM_UnitaryComputerSystem.

Properties

The MSCluster_Node class has these properties.

BuildNumber

Data type: uint32
Access type: Read-only

Provides access to the node's BuildNumber property.

Caption

Data type: string
Access type: Read-only

Provides a short textual description (one-line string) of the node.

Inherited from CIM_UnitaryComputerSystem.

Characteristics

Data type: uint32
Access type: Read/write

Provides access to the characteristics set for the node. For a list of possible characteristics, see CLUSCTL_NODE_GET_CHARACTERISTICS.

CreationClassName

Data type: string
Access type: Read-only

Indicates the name of the class or the subclass used in the creation of an instance. When used with other key properties of the class, this property allows all instances of the class and its subclasses to be uniquely identified.

Inherited from CIM_UnitaryComputerSystem.

CSDVersion

Data type: uint32
Access type: Read-only

Provides access to the node's CSDVersion property, which specifies the most recent service pack installed on the node, if any.

Dedicated

Data type: uint16 array
Access type: Read-only

Indicates whether the node is a special-purpose node.

Inherited from CIM_UnitaryComputerSystem.

"Not Dedicated" (0)
"Unknown" (1)
"Other" (2)
"Storage" (3)
"Router" (4)
"Switch" (5)
"Layer 3 Switch" (6)
"Central Office Switch" (7)
"Hub" (8)
"Access Server" (9)
"Firewall" (10)
"Print" (11)
"I/O" (12)
"Web Caching" (13)

Description

Data type: string
Access type: Read/write

Provides access to the node's Description property, which has comments about the node.

Inherited from CIM_UnitaryComputerSystem.

EnableEventLogReplication

Data type: uint32
Access type: Read/write

This property is not supported.

Windows Server 2003:
Provides access to the node's EnableEventLogReplication property.

Flags

Data type: uint32
Access type: Read/write

Provides access to the flags set for the node. For a list of possible characteristics, see CLUSCTL_NODE_GET_FLAGS.

IdentifyingDescriptions

Data type: string array
Access type: Read-only
Qualifiers: ArrayType ("Indexed") , ModelCorrespondence { "CIM_ComputerSystem.OtherIdentifyingInfo" }

Provides explanations and details of the entries in the OtherIdentifyingInfo array. Each entry of this array is related to the entry in OtherIdentifyingInfo is located at the same index.

Inherited from CIM_UnitaryComputerSystem.

InitialLoadInfo

Data type: string array
Access type: Read-only

Contains the data needed to find either the initial load device (its key) or the boot service to request the operating system to start up. In addition, the load parameters (a path and parameters) may also be specified.

Inherited from CIM_UnitaryComputerSystem.

InstallDate

Data type: datetime
Access type: Read-only

Indicates when the node was installed. The lack of a value does not indicate that the node is not installed.

Inherited from CIM_UnitaryComputerSystem.

LastLoadInfo

Data type: string
Access type: Read-only

Contains the data identifying either the initial load device (its key) or the boot service that requested the last operating system load. In addition, the load parameters (a path and parameters) may also be specified.

Inherited from CIM_UnitaryComputerSystem.

MajorVersion

Data type: uint32
Access type: Read-only

Provides access to the node's MajorVersion property, which specifies the major portion of the Windows version installed.

MinorVersion

Data type: uint32
Access type: Read-only

Provides access to the node's MinorVersion property, which specifies the minor portion of the Windows version installed.

Name

Data type: string
Access type: Read-only

Defines the label by which the node is known.

Inherited from CIM_UnitaryComputerSystem.

NameFormat

Data type: string
Access type: Read-only

Identifies how the node Name property is generated, using a heuristic. This property identifies how the system name was generated by using the subclass heuristic. The heuristic is outlined in the CIM V2 Common Model specification and assumes that the documented rules are traversed to determine and assign a name. The NameFormat values list defines the precedence order for assigning the system name with several rules mapping to the same value.

Inherited from CIM_UnitaryComputerSystem.

Values include the following:

"IP"

"Dial"

"HID"

"NWA"

"HWA"

"X25"

"ISDN"

"IPX"

"DCC"

"ICD"

"E.164"

"SNA"

"OID/OSI"

"Other"

NodeHighestVersion

Data type: uint32
Access type: Read-only

Provides access to the node's NodeHighestVersion property, which specifies the highest possible version of the cluster service with which the node can join or communicate.

NodeInstanceID

Data type: string
Access type: Read-only

Specifies the instance of the node.

NodeLowestVersion

Data type: uint32
Access type: Read-only

Provides access to the node's NodeLowestVersion property, which specifies the lowest possible version of the cluster service with which the node can join or communicate.

OtherIdentifyingInfo

Data type: string array
Access type: Read-only
Qualifiers: MaxLen (256) , ArrayType ("Indexed") , ModelCorrespondence { "CIM_ComputerSystem.IdentifyingDescriptions" }

Contains additional data, beyond the Name property, that can be used to identify a node.

Inherited from CIM_UnitaryComputerSystem.

PowerManagementCapabilities

Data type: uint16 array
Access type: Read-only

Indicates the specific power-related capabilities of a node and its associated running operating system.

Inherited from CIM_UnitaryComputerSystem.

Value	Meaning
Unknown 0	The power management features are currently unknown.
Not Supported 1	The power management features are currently not supported.
Disabled 2	The power management features are currently disabled.
Enabled 3	The power management features are currently enabled but the exact feature set is unknown or the information is unavailable.
Power Saving Modes Entered Automatically 4	The device can change its power state based on usage or other criteria.
Power State Settable 5	The SetPowerState method is supported. This method is found on the parent CIM_LogicalDevice class and can be implemented. For more information, see Designing Managed Object Format (MOF) Classes.
Power Cycling Supported 6	The SetPowerState method can be invoked with the PowerState parameter set to 5 (Power Cycle).
Timed Power On Supported 7	The SetPowerState method can be invoked with the PowerState parameter set to 5 (Power Cycle) and Time set to a specific date and time, or interval, for power-on.

PowerManagementSupported

Data type: boolean
Access type: Read-only

If TRUE, the node, with its running operating system, supports power management. If FALSE, the integer value 1 ("Not Supported") should be the only entry in the PowerManagementCapabilities array. This boolean does not indicate that power management features are currently enabled, or if enabled, what features are supported. For more information, see the PowerManagementCapabilities array.

Inherited from CIM_UnitaryComputerSystem.

PowerState

Data type: uint16
Access type: Read-only

Indicates the current power state of the node and its associated operating system.

Inherited from CIM_UnitaryComputerSystem.

Value	Meaning
Unknown 0	System power state is unknown.
Full power 1	System is in a full power state.
Power Save - Low Power Mode 2	System is in a power-save state and still functioning but may exhibit degraded performance.
Power Save - Standby 3	System is not functioning but could be brought to full power quickly.
Power Save - Unknown 4	System is known to be in a power-save mode but its exact status is unknown.
Power Cycle 5	System power is being cycled.
Power Off 6	System power is off.
Power Save - Warning 7	System is in a warning state and also in a power-save mode.
Power Save - Hibernate 8	System is in a hibernate state and also in a power-save mode.
Power Save - Soft Off 9	System is in a soft off power state and also in a power-save mode.

PrimaryOwnerContact

Data type: string
Access type: Read-only

Provides information on how the primary system owner can be reached.

Inherited from CIM_UnitaryComputerSystem.

PrimaryOwnerName

Data type: string
Access type: Read-only

Contains the name of the primary node owner.

Inherited from CIM_UnitaryComputerSystem.

PrivateProperties

Data type: MSCluster_Property
Access type: Read/write

An instance of the MSCluster_Property class representing the private properties of the node.

ResetCapability

Data type: uint16
Access type: Read-only

Determines whether the node can be reset with the power and reset buttons.

Inherited from CIM_UnitaryComputerSystem.

Other (1)
Unknown (2)
Disabled (3)
Enabled (4)
Not Implemented (5)

Roles

Data type: string array
Access type: Read/write

An array of strings that specify the roles this node plays in the IT-environment.

Inherited from CIM_UnitaryComputerSystem.

State

Data type: uint32
Access type: Read-only

Returns the current state of a node. For a list of possible state values, see GetClusterNodeState or the CLUSTER_NODE_STATE enumeration.

StateUnknown (-1)
Up (0)
Down (1)
Paused (2)
Joining (3)

Status

Data type: string
Access type: Read-only

Inherited from CIM_UnitaryComputerSystem.

Values include the following:

"OK"

"Error"

"Degraded"

"Unknown"

"Pred Fail"

"Starting"

"Stopping"

"Service"

"Stressed"

"NonRecover"

"No Contact"

"Lost Comm"

Remarks

The MSCluster_Node class is derived from the CIM_UnitaryComputerSystem class.

Requirements

Minimum supported client	None supported [desktop apps only]
Minimum supported server	Windows Server 2003 Datacenter, Windows Server 2003 Enterprise [desktop apps only]
Namespace	\\.\Root\MSCluster
MOF	ClusWmi.mof

Send comments about this topic to Microsoft

Build date: 11/28/2012

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD