PowerShell Logo Small

New-NetVirtualizationLookupRecord



This is the built-in help made by Microsoft for the command 'New-NetVirtualizationLookupRecord', 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

Creates a policy entry for an IP address in a virtual network.

SYNTAX


New-NetVirtualizationLookupRecord [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>] [-Context <String>] [-CustomerID <String>]
[-ThrottleLimit <Int32>] [-UseVmMACAddress <Boolean>] [-VMName <String>] -CustomerAddress <String> -MACAddress <String> -ProviderAddress
<String> -Rule <RuleType> -VirtualSubnetID <UInt32> [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The New-NetVirtualizationLookupRecord cmdlet creates a lookup record policy entry for an IP address that belongs to a Microsoft® Hyper-V®
Server 2012 virtual network. Network Virtualization allows more than one virtual network to exist on the same physical network. Computers can
exchange network traffic with a virtual machine (VM) by using a Customer Address within the virtual network. Network Virtualization manages
the Provider Addresses that are the physical network addresses. This cmdlet creates a record that maps a Customer Address to a Provider
Address. For more information, see Network Virtualization technical details (http://technet.microsoft.com/library/jj134174.aspx) on TechNet.


To create a policy entry, you must specify a Customer Address, a VM media access control (MAC) address, a Provider Address, a rule type, and a
virtual subnet ID. You can also specify a context, a customer ID, and a VM name, as well as whether to use a VM virtual MAC address.



<

RELATED LINKS

Get-NetVirtualizationLookupRecord
Remove-NetVirtualizationLookupRecord
Set-NetVirtualizationLookupRecord

REMARKS

<

Examples


Example 1: Create a policy entry

PS C:\> New-NetVirtualizationLookupRecord -CustomerAddress "10.0.0.5" -MACAddress "101010101105" -ProviderAddress "192.168.1.101" -Rule
"TranslationMethodEncap" -VirtualSubnetID "6000" -VMName "BlueS1-VM1"



This command creates a policy entry for a Customer Address 10.0.0.5. The command specifies the required values: a MAC address for the VM, the
physical Provider Address, a rule type (TranslationMethodEncap, which means the entry uses NVGRE), and a virtual subnet ID. The command also
specifies a name for the VM.