Public/Get-Networks.ps1
|
<#
.SYNOPSIS Gets the network ip configuration. .DESCRIPTION Gets the network ip configuration. The supported Operating Systems are Window Server 2012, Windows Server 2012R2, Windows Server 2016. .NOTES This function is pulled directly from the real Microsoft Windows Admin Center PowerShell scripts use rights (according to Microsoft): We grant you a non-exclusive, royalty-free right to use, modify, reproduce, and distribute the scripts provided herein. ANY SCRIPTS PROVIDED BY MICROSOFT ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS OR A PARTICULAR PURPOSE. .ROLE Readers .EXAMPLE # Open an elevated PowerShell Session, import the module, and - PS C:\Users\zeroadmin> Get-Certificates -path "Cert:\" -nearlyExpiredThresholdInDays 60 #> function Get-Networks { Import-Module NetAdapter Import-Module NetTCPIP Import-Module DnsClient Set-StrictMode -Version 5.0 $ErrorActionPreference = 'SilentlyContinue' # Get all net information $netAdapter = Get-NetAdapter # conditions used to select the proper ip address for that object modeled after ibiza method. # We only want manual (set by user manually), dhcp (set up automatically with dhcp), or link (set from link address) # fe80 is the prefix for link local addresses, so that is the format want if the suffix origin is link # SkipAsSource -eq zero only grabs ip addresses with skipassource set to false so we only get the preffered ip address $ipAddress = Get-NetIPAddress | Where-Object { ($_.SuffixOrigin -eq 'Manual') -or ($_.SuffixOrigin -eq 'Dhcp') -or (($_.SuffixOrigin -eq 'Link') -and (($_.IPAddress.StartsWith('fe80:')) -or ($_.IPAddress.StartsWith('2001:')))) } $netIPInterface = Get-NetIPInterface $netRoute = Get-NetRoute -PolicyStore ActiveStore $dnsServer = Get-DnsClientServerAddress # Load in relevant net information by name Foreach ($currentNetAdapter in $netAdapter) { $result = New-Object PSObject # Net Adapter information $result | Add-Member -MemberType NoteProperty -Name 'InterfaceAlias' -Value $currentNetAdapter.InterfaceAlias $result | Add-Member -MemberType NoteProperty -Name 'InterfaceIndex' -Value $currentNetAdapter.InterfaceIndex $result | Add-Member -MemberType NoteProperty -Name 'InterfaceDescription' -Value $currentNetAdapter.InterfaceDescription $result | Add-Member -MemberType NoteProperty -Name 'Status' -Value $currentNetAdapter.Status $result | Add-Member -MemberType NoteProperty -Name 'MacAddress' -Value $currentNetAdapter.MacAddress $result | Add-Member -MemberType NoteProperty -Name 'LinkSpeed' -Value $currentNetAdapter.LinkSpeed # Net IP Address information # Primary addresses are used for outgoing calls so SkipAsSource is false (0) # Should only return one if properly configured, but it is possible to set multiple, so collect all $primaryIPv6Addresses = $ipAddress | Where-Object {($_.InterfaceAlias -eq $currentNetAdapter.Name) -and ($_.AddressFamily -eq 'IPv6') -and ($_.SkipAsSource -eq 0)} if ($primaryIPv6Addresses) { $ipArray = New-Object System.Collections.ArrayList $linkLocalArray = New-Object System.Collections.ArrayList Foreach ($address in $primaryIPv6Addresses) { if ($address -ne $null -and $address.IPAddress -ne $null -and $address.IPAddress.StartsWith('fe80')) { $linkLocalArray.Add(($address.IPAddress, $address.PrefixLength)) > $null } else { $ipArray.Add(($address.IPAddress, $address.PrefixLength)) > $null } } $result | Add-Member -MemberType NoteProperty -Name 'PrimaryIPv6Address' -Value $ipArray $result | Add-Member -MemberType NoteProperty -Name 'LinkLocalIPv6Address' -Value $linkLocalArray } $primaryIPv4Addresses = $ipAddress | Where-Object {($_.InterfaceAlias -eq $currentNetAdapter.Name) -and ($_.AddressFamily -eq 'IPv4') -and ($_.SkipAsSource -eq 0)} if ($primaryIPv4Addresses) { $ipArray = New-Object System.Collections.ArrayList Foreach ($address in $primaryIPv4Addresses) { $ipArray.Add(($address.IPAddress, $address.PrefixLength)) > $null } $result | Add-Member -MemberType NoteProperty -Name 'PrimaryIPv4Address' -Value $ipArray } # Secondary addresses are not used for outgoing calls so SkipAsSource is true (1) # There will usually not be secondary addresses, but collect them just in case $secondaryIPv6Adresses = $ipAddress | Where-Object {($_.InterfaceAlias -eq $currentNetAdapter.Name) -and ($_.AddressFamily -eq 'IPv6') -and ($_.SkipAsSource -eq 1)} if ($secondaryIPv6Adresses) { $ipArray = New-Object System.Collections.ArrayList Foreach ($address in $secondaryIPv6Adresses) { $ipArray.Add(($address.IPAddress, $address.PrefixLength)) > $null } $result | Add-Member -MemberType NoteProperty -Name 'SecondaryIPv6Address' -Value $ipArray } $secondaryIPv4Addresses = $ipAddress | Where-Object {($_.InterfaceAlias -eq $currentNetAdapter.Name) -and ($_.AddressFamily -eq 'IPv4') -and ($_.SkipAsSource -eq 1)} if ($secondaryIPv4Addresses) { $ipArray = New-Object System.Collections.ArrayList Foreach ($address in $secondaryIPv4Addresses) { $ipArray.Add(($address.IPAddress, $address.PrefixLength)) > $null } $result | Add-Member -MemberType NoteProperty -Name 'SecondaryIPv4Address' -Value $ipArray } # Net IP Interface information $currentDhcpIPv4 = $netIPInterface | Where-Object {($_.InterfaceAlias -eq $currentNetAdapter.Name) -and ($_.AddressFamily -eq 'IPv4')} if ($currentDhcpIPv4) { $result | Add-Member -MemberType NoteProperty -Name 'DhcpIPv4' -Value $currentDhcpIPv4.Dhcp $result | Add-Member -MemberType NoteProperty -Name 'IPv4Enabled' -Value $true } else { $result | Add-Member -MemberType NoteProperty -Name 'IPv4Enabled' -Value $false } $currentDhcpIPv6 = $netIPInterface | Where-Object {($_.InterfaceAlias -eq $currentNetAdapter.Name) -and ($_.AddressFamily -eq 'IPv6')} if ($currentDhcpIPv6) { $result | Add-Member -MemberType NoteProperty -Name 'DhcpIPv6' -Value $currentDhcpIPv6.Dhcp $result | Add-Member -MemberType NoteProperty -Name 'IPv6Enabled' -Value $true } else { $result | Add-Member -MemberType NoteProperty -Name 'IPv6Enabled' -Value $false } # Net Route information # destination prefix for selected ipv6 address is always ::/0 $currentIPv6DefaultGateway = $netRoute | Where-Object {($_.InterfaceAlias -eq $currentNetAdapter.Name) -and ($_.DestinationPrefix -eq '::/0')} if ($currentIPv6DefaultGateway) { $ipArray = New-Object System.Collections.ArrayList Foreach ($address in $currentIPv6DefaultGateway) { if ($address.NextHop) { $ipArray.Add($address.NextHop) > $null } } $result | Add-Member -MemberType NoteProperty -Name 'IPv6DefaultGateway' -Value $ipArray } # destination prefix for selected ipv4 address is always 0.0.0.0/0 $currentIPv4DefaultGateway = $netRoute | Where-Object {($_.InterfaceAlias -eq $currentNetAdapter.Name) -and ($_.DestinationPrefix -eq '0.0.0.0/0')} if ($currentIPv4DefaultGateway) { $ipArray = New-Object System.Collections.ArrayList Foreach ($address in $currentIPv4DefaultGateway) { if ($address.NextHop) { $ipArray.Add($address.NextHop) > $null } } $result | Add-Member -MemberType NoteProperty -Name 'IPv4DefaultGateway' -Value $ipArray } # DNS information # dns server util code for ipv4 is 2 $currentIPv4DnsServer = $dnsServer | Where-Object {($_.InterfaceAlias -eq $currentNetAdapter.Name) -and ($_.AddressFamily -eq 2)} if ($currentIPv4DnsServer) { $ipArray = New-Object System.Collections.ArrayList Foreach ($address in $currentIPv4DnsServer) { if ($address.ServerAddresses) { $ipArray.Add($address.ServerAddresses) > $null } } $result | Add-Member -MemberType NoteProperty -Name 'IPv4DNSServer' -Value $ipArray } # dns server util code for ipv6 is 23 $currentIPv6DnsServer = $dnsServer | Where-Object {($_.InterfaceAlias -eq $currentNetAdapter.Name) -and ($_.AddressFamily -eq 23)} if ($currentIPv6DnsServer) { $ipArray = New-Object System.Collections.ArrayList Foreach ($address in $currentIPv6DnsServer) { if ($address.ServerAddresses) { $ipArray.Add($address.ServerAddresses) > $null } } $result | Add-Member -MemberType NoteProperty -Name 'IPv6DNSServer' -Value $ipArray } $adapterGuid = $currentNetAdapter.InterfaceGuid if ($adapterGuid) { $regPath = "Registry::HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\Interfaces\$($adapterGuid)" $ipv4Properties = Get-ItemProperty $regPath if ($ipv4Properties -and $ipv4Properties.NameServer) { $result | Add-Member -MemberType NoteProperty -Name 'IPv4DnsManuallyConfigured' -Value $true } else { $result | Add-Member -MemberType NoteProperty -Name 'IPv4DnsManuallyConfigured' -Value $false } $regPath = "Registry::HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip6\Parameters\Interfaces\$($adapterGuid)" $ipv6Properties = Get-ItemProperty $regPath if ($ipv6Properties -and $ipv6Properties.NameServer) { $result | Add-Member -MemberType NoteProperty -Name 'IPv6DnsManuallyConfigured' -Value $true } else { $result | Add-Member -MemberType NoteProperty -Name 'IPv6DnsManuallyConfigured' -Value $false } } $result } } |