Edit

Share via

Get-NlbClusterNodeDip

  • Reference
Module:
NetworkLoadBalancingClusters

Retrieves the dedicated IP address that is queried by the caller.

Syntax

PowerShell 
Get-NlbClusterNodeDip
   [-HostName <String>]
   [-InterfaceName <String>]
   [-NodeName <String>]
   [[-IP] <IPAddress>]
   [<CommonParameters>]
PowerShell 
Get-NlbClusterNodeDip
   -InputObject <Node[]>
   [[-IP] <IPAddress>]
   [<CommonParameters>]

Description

The Get-NlbClusterNodeDIP cmdlet retrieves the dedicated IP address that is requested by the caller. This IP address is the unique IP address of the local host that is used for dedicated traffic to the host or network traffic that is not associated with the cluster. Network Load Balancing (NLB) never load balances traffic for the dedicated IP address. Instead, NLB load balances incoming traffic from all IP addresses other than the dedicated IP address.

Examples

EXAMPLE 1

PowerShell 
PS C:\>Get-NlbClusterNodeDip
Node                       IPAddress                  SubnetMask 
----                       ---------                  ---------- 
node1                      3.53.4.1                   255.0.0.0 
node1                      fe80::a9cb:eafb:e841:d8cf 
node2                      3.53.4.2                   255.0.0.0

This example lists all the dedicated IP addresses on the local cluster node.

EXAMPLE 2

PowerShell 
PS C:\>Get-NlbClusterNodeDip -NodeName node2
Node                       IPAddress                  SubnetMask 
----                       ---------                  ---------- 
node2                      3.53.4.2                   255.0.0.0

This example lists all the dedicated IP addresses on cluster node node2.

EXAMPLE 3

PowerShell 
PS C:\>Get-NlbClusterNodeDip -IP 3.53.4.2
Node                       IPAddress                  SubnetMask 
----                       ---------                  ---------- 
node2                      3.53.4.2                   255.0.0.0

This example lists the dedicated IP address specified.

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 node of the cluster for which the dedicated IP address is retrieved.

Type:Node[]
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

-IP

Specifies the IP address of the cluster node for which the dedicated IP address is retrieved.

Type:IPAddress
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NodeName

Specifies the name of the cluster node for which the dedicated IP address is retrieved.

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

Inputs

Microsoft.NetworkLoadBalancingClusters.PowerShell.Node

Outputs

Microsoft.NetworkLoadBalancingClusters.PowerShell.ClusterNodeDip