PowerShell Logo Small

New-NetNeighbor



This is the built-in help made by Microsoft for the command 'New-NetNeighbor', in PowerShell version 4 - as retrieved from Windows version 'Microsoft Windows 8.1 Enterprise' 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

Creates a neighbor cache entry.

SYNTAX


New-NetNeighbor [-IPAddress] <String> [-AddressFamily <AddressFamily>] [-AsJob] [-CimSession <CimSession[]>] [-LinkLayerAddress <String>] [-PolicyStore <String>] [-St
ate <State>] [-ThrottleLimit <Int32>] -InterfaceAlias <String> [-Confirm] [-WhatIf] [<CommonParameters>]
New-NetNeighbor [-IPAddress] <String> [-AddressFamily <AddressFamily>] [-AsJob] [-CimSession <CimSession[]>] [-LinkLayerAddress <String>] [-PolicyStore <String>] [-St
ate <State>] [-ThrottleLimit <Int32>] -InterfaceIndex <UInt32> [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The New-NetNeighbor cmdlet creates a neighbor cache entry. The neighbor cache maintains information for each on-link neighbor, including the IP address and the associ
ated link-layer address. The address family that you specify for the neighbor cache entry must match the address family of the IP interface.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=288395
Remove-NetNeighbor
Set-NetNeighbor
Get-NetAdapter
Get-NetNeighbor

REMARKS

<

Examples


Example 1: Create an IPv4 neighbor cache entry

PS C:\>New-NetNeighbor –InterfaceIndex 12 –IPAddress "192.168.0.5" –LinkLayerAddress "00-00-12-00-00-ff"



This command creates a neighbor cache entry that has the IP address 192.168.0.5. The command specifies that the neighbor is connected to the interface that has the in
dex 12. The command specifies that the link-layer address of the neighbor cache entry is 00-00-12-00-00-ff.




Example 2: Create an IPv6 neighbor cache entry

PS C:\>New-NetNeighbor –InterfaceIndex 13 –IPAddress "fe80::5efe:192.168.0.5"



This command creates a neighbor cache entry on a virtual ISATAP interface that has the IP address fe80::5efe:192.168.0.5. The command specifies that the neighbor is c
onnected to the interface that has the index 13.