PowerShell Logo Small

Get-NetIPInterface



This is the built-in help made by Microsoft for the command 'Get-NetIPInterface', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Gets information about the IP interface properties.

SYNTAX


Get-NetIPInterface [[-InterfaceAlias] <String[]>] [-AddressFamily <AddressFamily[]>] [-AdvertiseDefaultRoute <AdvertiseDefaultRoute[]>]
[-AdvertisedRouterLifetime <TimeSpan[]>] [-Advertising <Advertising[]>] [-AsJob [<SwitchParameter>]] [-AutomaticMetric <AutomaticMetric[]>]
[-BaseReachableTimeMs <UInt32[]>] [-CimSession <CimSession[]>] [-ConnectionState <ConnectionState[]>] [-CurrentHopLimit <UInt32[]>]
[-DadTransmits <UInt32[]>] [-Dhcp <Dhcp[]>] [-DirectedMacWolPattern <DirectedMacWolPattern[]>] [-EcnMarking <EcnMarking[]>]
[-ForceArpNdWolPattern <ForceArpNdWolPattern[]>] [-Forwarding <Forwarding[]>] [-IgnoreDefaultRoutes <IgnoreDefaultRoutes[]>] [-InterfaceIndex
<UInt32[]>] [-InterfaceMetric <UInt32[]>] [-ManagedAddressConfiguration <ManagedAddressConfiguration[]>] [-NeighborDiscoverySupported
<NeighborDiscoverySupported[]>] [-NeighborUnreachabilityDetection <NeighborUnreachabilityDetection[]>] [-NlMtuBytes <UInt32[]>]
[-OtherStatefulConfiguration <OtherStatefulConfiguration[]>] [-PolicyStore <String>] [-ReachableTimeMs <UInt32[]>] [-RetransmitTimeMs
<UInt32[]>] [-RouterDiscovery <RouterDiscovery[]>] [-ThrottleLimit <Int32>] [-WeakHostReceive <WeakHostReceive[]>] [-WeakHostSend
<WeakHostSend[]>] [<CommonParameters>]
Get-NetIPInterface [-AsJob [<SwitchParameter>]] [-AssociatedRoute <CimInstance>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-NetIPInterface [-AsJob [<SwitchParameter>]] [-AssociatedNeighbor <CimInstance>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-NetIPInterface [-AsJob [<SwitchParameter>]] [-AssociatedAdapter <CimInstance>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-NetIPInterface [-AsJob [<SwitchParameter>]] [-AssociatedIPAddress <CimInstance>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>]
[<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Get-NetIPInterface cmdlet gets IP interface properties such as IPv4 addresses, IPv6 addresses and the IP interfaces to which these
addresses are associated. Interface properties include properties such as DHCP is enabled or disabled, Wake on LAN (WoL) settings and IPv6
address auto-configuration settings. More information on IPv6 is available here IPv6 Address Autoconfiguration on TechNet.

This cmdlet does not get the gateway as that is a routing concept covered by the Get-NetRoute cmdlet. For IP endpoints, the gateway specifies
the forwarding or next hop IP address over which the set of addresses defined by the network destination and subnet mask are reachable.

Without parameters, this cmdlet gets all of the IP interface properties on the computer, including virtual interfaces and loopback interfaces.



<

RELATED LINKS

Format-List
Format-Table
Sort-Object
Where-Object
Get-NetRoute
Set-NetIPInterface

REMARKS

<

Examples


EXAMPLE 1

Used without parameters gets IP interface information for the computer.
PS C:\>Get-NetIPInterface


The default output omits some properties. Use this cmdlet to display all fields (all properties of the object).
PS C:\>Get-NetIPAddress | Format-List –Property *



This example gets information about IP interface configuration.




EXAMPLE 2

PS C:\>Get-NetIPInterface –AddressFamily IPv6



This example gets information about IP interface configuration for all IP interfaces that have IPv6 addresses configured.




EXAMPLE 3

PS C:\>Get-NetIPInterface | Format-Table



This example gets information about IP interface configuration, and it displays some of that information in a table.

The table format provides a convenient overview for computers with many IP interfaces.




EXAMPLE 4

PS C:\>Get-NetIPInterface –InterfaceIndex 12



This example gets information about IP interface configuration for a specific InterfaceIndex.




EXAMPLE 5

PS C:\>Get-NetIPInterface | Sort-Object –Property InterfaceIndex | Format-Table



This example gets information about IP address configuration, sorts them numerically by the interface index in the cmdlet name, and then
displays them in a table format. This display can help you find IP address information by interface index.




EXAMPLE 6

PS C:\>Get-NetIPInterface | Where-Object -FilterScript { $_.AdvertisedRouterLifetime.TotalSeconds -Eq 1800 }



This example gets information about IP address configuration for all IP interfaces that have a default AdvertisedRouterLifetime.