Edit

Share via

Get-ClusterNetworkInterface

  • Reference
Module:
FailoverClusters

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.

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
Required:False
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifies the name of the cluster network interface to get.

Type:StringCollection
Position:0
Default value:None
Required:False
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.FailoverClusters.PowerShell.Cluster

Microsoft.FailoverClusters.PowerShell.ClusterNetwork

Outputs

Microsoft.FailoverClusters.PowerShell.ClusterNetworkInterface