Edit

Share via

Get-NlbClusterNode

  • Reference
Module:
NetworkLoadBalancingClusters

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

Syntax

PowerShell 
Get-NlbClusterNode
   [-HostName <String>]
   [-InterfaceName <String>]
   [[-NodeName] <String>]
   [<CommonParameters>]
PowerShell 
Get-NlbClusterNode
   -InputObject <Cluster[]>
   [-HostName <String>]
   [[-NodeName] <String>]
   [<CommonParameters>]

Description

The Get-NlbClusterNode cmdlet gets information about a node in the Network Load Balancing (NLB) cluster. The information includes the properties, or attributes, that define the node and its status.

Examples

Example 1: List nodes that belong to the local cluster

PowerShell 
PS C:\>Get-NlbClusterNode
Name                State               Interface           HostID 
----                -----               ---------           ------ 
node1               Converged(default)  vlan-3              1 
node2               Converged           vlan-3              2

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

Example 2: Get details about a cluster node

PowerShell 
PS C:\>Get-NlbClusterNode -NodeName "Node01" | Format-List *
Cluster                   : mycluster 
Name                      : Node01 
InterfaceName             : vlan-3 
Host                      :  
State                     : Converged 
HostPriority              : 2 
AdapterGuid               : {} 
InitialHostState          : Started 
PersistSuspendOnReboot    : True 
MaskSourceMac             : True 
FilterIcmp                : 0 
GreDescriptorTimeout      : 10

This command gets details about cluster node named Node01.

Parameters

-HostName

Specifies the name of the cluster host against which this cmdlet is run. If this parameter is omitted or a value of . is entered, then the local cluster is assumed.

Type:String
Aliases:Host, HN, H
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies an array of clusters for which this cmdlet enumerates the nodes.

Type:Cluster[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InterfaceName

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

Type:String
Aliases:Interface, IN, I
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NodeName

Specifies the cluster node name that this cmdlet gets.

Type:String
Aliases:Name, NN
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.NetworkLoadBalancingClusters.PowerShell.Cluster

Outputs

Microsoft.NetworkLoadBalancingClusters.PowerShell.Node