Edit

Share via

Get-NlbClusterNode

  • Reference
Module:
NetworkLoadBalancingClusters

Retrieves information about a node object or the Network Load Balancing (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 retrieves 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

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

This example 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

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

This example gets details about cluster node named node1.

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 the cluster for which the nodes are enumerated.

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 to retrieve.

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