Get-NlbClusterNodeDip

Article
03/11/2010

Get-NlbClusterNodeDip

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

Syntax

Get-NlbClusterNodeDIP [-HostName <string>] [-InterfaceName <string>] [-NodeName <string>] [[-Ip] <IPAddress>] [<CommonParameters>]


Get-NlbClusterNodeDIP -InputObject <Node[]> [[-Ip] <IPAddress>] [<CommonParameters>]

Detailed Description

The Get-NlbClusterNodeDIP cmdlet retrieves the dedicated IP address that is requested by the caller. This IP address is the local host's unique IP address that is used for dedicated traffic to the host or network traffic that is not associated with the cluster. 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.

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

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

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

-Ip <IPAddress>

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

Attributes

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

-NodeName <string>

Specifies the name of the cluster node for which the dedicated IP address is retrieved. [Alias: nn]

Attributes

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

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

Description

-----------

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

EXAMPLE 2

C:\PS>

Get-NlbClusterNodeDip -NodeName node2



Node                       IPAddress                  SubnetMask

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

node2                      3.53.4.2                   255.0.0.0

Description

-----------

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

EXAMPLE 3

C:\PS>

Get-NlbClusterNodeDip 3.53.4.2



Node                       IPAddress                  SubnetMask

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

node2                      3.53.4.2                   255.0.0.0

Description

-----------

This command lists the dedicated IP address specified.

Get-NlbClusterNodeDip