MicrosoftNLB_Node class

The MicrosoftNLB_Node WMI class represents an instance of a node within a Network Load Balancing cluster.

The following syntax is simplified from MOF code and includes all inherited properties.

Syntax

[Dynamic, Provider("Microsoft|NLB_Provider|V1.0"), AMENDMENT]
class MicrosoftNLB_Node : CIM_UnitaryComputerSystem
{
  string   Caption;
  string   ComputerName;
  string   CreationClassName;
  string   DedicatedIPAddress;
  string   Description;
  uint32   HostPriority;
  datetime InstallDate;
  string   LastLoadInfo;
  string   Name;
  string   NameFormat;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  uint16   PowerState;
  string   PrimaryOwnerContact;
  string   PrimaryOwnerName;
  uint16   ResetCapability;
  string   Roles[];
  string   Status;
  uint32   StatusCode;
};

Members

The MicrosoftNLB_Node class has these types of members:

Methods

The MicrosoftNLB_Node class has these methods.

MethodDescription
Disable

Disables a range of ports on the node.

DisableEx

Disables ports specified by virtual IP address and range.

Drain

Drains a range of ports on the node.

DrainEx

Drains ports specified by virtual IP address and range.

DrainStop

Drains all ports, then stops cluster operations on the node.

Enable

Enables ports that have been disabled on the node.

EnableEx

Enables ports specified by virtual IP address and range.

Resume

Resumes all suspended ports on the node.

SetPowerState

Not used. Inherited from CIM_UnitaryComputerSystem.

Start

Starts cluster operations on the node.

Stop

Stops cluster operations on the node.

Suspend

Suspends cluster operations on the node.

 

Properties

The MicrosoftNLB_Node class has these properties.

Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen (64)

The Caption property is a short textual description (one-line string) of the object.

This property is inherited from CIM_ManagedSystemElement.

ComputerName
Data type: string
Access type: Read-only

Returns the computer name in the form of a Fully Qualified Domain Name (FQDN), unless the FQDN exceeds 100 characters, in which case only the host name is returned. An empty string will be returned in the case of a failure.

CreationClassName
Data type: string
Access type: Read-only
Qualifiers: CIM_Key, MaxLen (256)

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

This property is inherited from CIM_System.

DedicatedIPAddress
Data type: string
Access type: Read-only

Specifies this node's unique IP address used for network traffic not associated with the cluster (for example, Telnet access to a specific node within the cluster).

Description
Data type: string
Access type: Read-only

The Description property provides a textual description of the object.

This property is inherited from CIM_ManagedSystemElement.

HostPriority
Data type: uint32
Access type: Read-only

Specifies the host priority of the node. Each node within the cluster must specify a unique host priority, ranging from 1 (indicates the highest priority) to n (lowest priority), where n is the number of nodes in the cluster. The node with the highest priority receives all network traffic not handled by port rules.

InstallDate
Data type: datetime
Access type: Read-only
Qualifiers: MappingStrings ("MIF.DMTF|ComponentID|001.5")

The InstallDate property is a datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.

This property is inherited from CIM_ManagedSystemElement.

LastLoadInfo
Data type: string
Access type: Read-only
Qualifiers: MappingStrings ("MIB.IETF|HOST-RESOURCES-MIB.hrSystemInitialLoadDevice", "MIB.IETF|HOST-RESOURCES-MIB.hrSystemInitialLoadParameters")

The array entry of the InitialLoadInfo property, that holds the data corresponding to booting the currently loaded operating system.

This property is inherited from CIM_UnitaryComputerSystem.

Name
Data type: string
Access type: Read-only
Qualifiers: Override ("Name")

Identifies the node by a combination of the cluster IP address and the node's host priority. The name is formatted as (cluster IP address)(colon)(host priority). For example: "172.150.35.12:1".

Note  When configuring new clusters, all of the cluster IP addresses may initially be set to zero (0.0.0.0). In this case the name format changes to "0.0.0.x:id" where x is a unique index and id is the host priority of the node.
 
NameFormat
Data type: string
Access type: Read-only
Qualifiers: Override ("NameFormat")

Specifies the process by which the Name property is generated.

("Other")

("IP")

("Dial")

("HID")

("NWA")

("HWA")

("X25")

("ISDN")

("IPX")

("DCC")

("ICD")

("E.164")

("SNA")

("OID/OSI")

PowerManagementCapabilities
Data type: uint16 array
Access type: Read-only

Indicates the specific power management capabilities of the node as an array of any of the following values that apply.

For more information, see SetPowerState.

This property inherits from CIM_UnitaryComputerSystem.

Unknown (0)

The power management capabilities of the node cannot be determined.

Not Supported (1)

If the PowerManagementSupported property is FALSE, this should be the only value in the array.

Disabled (2)

The power management capabilities of the node are turned off.

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 node can change its power state based on usage or other criteria.

Power State Settable (5)

The SetPowerState method is supported.

Power Cycling Supported (6)

The SetPowerState method can be invoked with the PowerState input variable set to 5 (Power Cycle).

Timed Power On Supported (7)

As 6 (Power Cycling Supported), but also allows the Time parameter to specify a power-on time.

PowerManagementSupported
Data type: boolean
Access type: Read-only

Boolean indicating that the computer system, with its running operating system, support power management. This boolean does not indicate that power management features are currently enabled, only that the system is capable of power management.

This property is inherited from CIM_UnitaryComputerSystem.

PowerState
Data type: uint16
Access type: Read-only

Indicates the current power state of the node as one of the following values.

This property inherits from CIM_UnitaryComputerSystem.

Unknown (0)

The node's power state cannot be determined.

Full Power (1)

The node is operating at full power.

Power Save - Low Power Mode (2)

The node is in a power save state and is available, but its performance may be degraded.

Power Save - Standby (3)

The node is in a power save state and is unavailable but can be powered up quickly.

Power Save - Unknown (4)

The node is in an unrecognized power save state.

Power Cycle (5)

The node is changing power states.

Power Off (6)

The node is powered off and unavailable.

Power Save - Warning (7)

The node is in a low power state and is generating a warning (for example, a low battery warning from a laptop).

PrimaryOwnerContact
Data type: string
Access type: Read-only
Qualifiers: MaxLen (256), MappingStrings ("MIF.DMTF|General Information|001.3")

A string that provides information on how the primary system owner can be reached (e.g. phone number, email address, ...).

This property is inherited from CIM_System.

PrimaryOwnerName
Data type: string
Access type: Read-only
Qualifiers: MaxLen (64), MappingStrings ("MIF.DMTF|General Information|001.4")

The name of the primary system owner.

This property is inherited from CIM_System.

ResetCapability
Data type: uint16
Access type: Read-only
Qualifiers: MappingStrings ("MIF.DMTF|System Hardware Security|001.4")

Describes the ability of the node to be reset.

This property inherits from CIM_UnitaryComputerSystem.

Other (1)

The node has some other reset capability.

Unknown (2)

Reset capacity is unknown.

Disabled (3)

Hardware reset is not allowed.

Enabled (4)

The unitary computer system can be reset via hardware (e.g. the power and reset buttons).

Not Implemented (5)

Reset capability has not been implemented.

Roles
Data type: string array
Access type: Read-only

A collection of strings that specify the roles this system plays in the IT-environment.

This property is inherited from CIM_System.

Status
Data type: string
Access type: Read-only
Qualifiers: MaxLen (10)

Indicates the current status of the node as one of the following values.

This property inherits from CIM_UnitaryComputerSystem.

OK

The node is operational.

Error

No status information is available due to an unknown error.

Unknown

The node returned unrecognized state information.

StatusCode
Data type: uint32
Access type: Read-only

Indicates the current status of the node as one of the following values.

For an example that demonstrates the StatusCode property, see Enumerating Remote Nodes.

0

Node is remote. The StatusCode value cannot be retrieved.

WLBS_STOPPED (1005)

Cluster operations have stopped on at least one node.

WLBS_CONVERGING (1006)

The cluster is converging.

WLBS_CONVERGED (1007)

The cluster has converged successfully.

WLBS_DEFAULT (1008)

The specified node has converged as the default host.

WLBS_DRAINING (1009)

One or more nodes are draining.

WLBS_SUSPENDED (1013)

Cluster operations have been suspended on one or more nodes.

Remarks

The MicrosoftNLB_Node class is derived from the CIM_UnitaryComputerSystem class.

All methods except SetPowerState (which is not used) will fail if called on an instance of a MicrosoftNLB_Node object that represents a remote node.

Examples

For an example that demonstrates the MicrosoftNLB_Node class, see Enumerating Remote Nodes.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008

Namespace

Root\MicrosoftNLB

MOF

WlbsProv.mof

DLL

WlbsProv.dll

See also

CIM_UnitaryComputerSystem
Network Load Balancing WMI Classes
CIM_UnitaryComputerSystem

 

 

Show: