Get-Cluster Network Interface

Gets information about one or more network adapters in a failover cluster.

Syntax

Get-ClusterNetworkInterface
   [[-Name] <StringCollection>]
   [-Node <StringCollection>]
   [-Network <StringCollection>]
   [-InputObject <PSObject>]
   [-Cluster <String>]
   [<CommonParameters>]

Description

The Get-ClusterNetworkInterface cmdlet gets information about one or more network adapters in a failover cluster. A failover cluster requires network connectivity among nodes and between clients and nodes.

Examples

Example 1

PS C:\> Get-ClusterNetworkInterface
Name                Node                Network                           State 
----                ----                -------                           ----- 
node1 - Local A ...  node1               Cluster Network 1                    Up 
node2 - Local A ...  node2               Cluster Network 1                    Up 
node1 - Local A ...  node1               Cluster Network 2                    Up 
node2 - Local A ...  node2               Cluster Network 2                    Up

This example displays information about the physical network adapters used by the local cluster.

Example 2

PS C:\> Get-ClusterNode -Name node1 | Get-ClusterNetworkInterface
Name                Node                Network                           State 
----                ----                -------                           ----- 
node1 - Local A ...  node1               Cluster Network 1                    Up 
node1 - Local A ...  node1               Cluster Network 2                    Up

This example displays information about the physical network adapters used by node1 in the local cluster. This cmdlet is equivalent to Get-ClusterNetworkInterface -Node node1 .

Optional Parameters

-Cluster

Specifies the name of the cluster on which to run this cmdlet. If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.

Type: String
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject

Specifies the cluster on which to enumerate the cluster network interfaces.

Type: PSObject
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name

Specifies the name of the cluster network interface to get.

Type: StringCollection
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Network

Specifies the name of the cluster network for which to enumerate the network interfaces.

Type: StringCollection
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Node

Specifies the name of the cluster node on which to enumerate the network interfaces.

Type: StringCollection
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Inputs

Microsoft.FailoverClusters.PowerShell.Cluster

Inputs

Microsoft.FailoverClusters.PowerShell.ClusterNetwork

Outputs

Microsoft.FailoverClusters.PowerShell.ClusterNetworkInterface