Get-NlbClusterNode

Article
03/11/2010

Get-NlbClusterNode

Retrieves information about a node object that is queried by the caller. Retrieves information about the NLB cluster object that is queried by the caller.

Syntax

Get-NlbClusterNode [-InterfaceName <string>] [[-NodeName] <string>] [-HostName <string>] [<CommonParameters>]


Get-NlbClusterNode -InputObject <Cluster[]> [[-NodeName] <string>] [-HostName <string>] [<CommonParameters>]

Detailed Description

The Get-NlbClusterNode cmdlet retrieves information about a node in the NLB cluster. The information includes the properties, or attributes, that define the node and its status.

Parameters

-HostName <string>

Specifies the name of the cluster host against which this cmdlet is run. If this parameter is omitted or if "-HostName ." is used, the local cluster is assumed. [Alias: hn]

Attributes

Name	Value
Required?	false
Accept wildcard characters?	false
Accept Pipeline Input?	false
Position?	named

-InputObject <Cluster[]>

Specifies the cluster for which the nodes are enumerated.

Attributes

Name	Value
Required?	true
Accept wildcard characters?	false
Accept Pipeline Input?	true (ByValue, ByPropertyName)
Position?	named

-InterfaceName <string>

Specifies the interface to which NLB is bound. This is the interface of the cluster against which this cmdlet is run.

Attributes

Name	Value
Required?	false
Accept wildcard characters?	false
Accept Pipeline Input?	false
Position?	named

-NodeName <string>

Specifies the cluster node name to retrieve. [Alias: nn]

Attributes

Name	Value
Required?	false
Accept wildcard characters?	false
Accept Pipeline Input?	false
Position?	1

-CommonParameter

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. For more information, see about_CommonParameters.

Input and Return Types

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.

Examples

EXAMPLE 1

C:\PS>

Get-NlbClusterNode



Name                State               Interface           HostID

----                -----               ---------           ------

node1               Converged(default)  vlan-3              1

node2               Converged           vlan-3              2

Description

-----------

This command lists nodes that are part of the local cluster. It also shows their state and the interface which NLB is bound to on each node.

EXAMPLE 2

C:\PS>

Get-NlbClusterNode node1 | fl *



Cluster                   : mycluster

Name                      : node1

InterfaceName             : vlan-3

Host                      : E3C2N4X64N1.ctdev.nttest.microsoft.com

State                     : Converged

HostPriority              : 2

AdapterGuid               : {99757561-22EC-44DA-B6D3-82E16B387D6C}

InitialHostState          : Started

PersistSuspendOnReboot    : True

MaskSourceMac             : True

FilterIcmp                : 0

GreDescriptorTimeout      : 10

Description

-----------

This command gets details about cluster node node1.

Get-NlbClusterNode