New-NetVirtualizationLookupRecord

New-NetVirtualizationLookupRecord

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

構文

Parameter Set: cim:CreateInstance0
New-NetVirtualizationLookupRecord -CustomerAddress <String> -MACAddress <String> -ProviderAddress <String> -Rule <RuleType> -VirtualSubnetID <UInt32> [-AsJob] [-CimSession <CimSession[]> ] [-Context <String> ] [-CustomerID <String> ] [-ThrottleLimit <Int32> ] [-Type <Type> ] [-UseVmMACAddress <Boolean> ] [-VMName <String> ] [ <CommonParameters>]




詳細説明

The New-NetVirtualizationLookupRecord cmdlet creates a lookup record policy entry for an IP address that belongs to a 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.

パラメーター

-AsJob

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。


エイリアス

Session

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Context<String>

Specifies a comment regarding the policy entry. Administrators can use this comment for any purpose.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-CustomerAddress<String>

Specifies the IP address for a VM. You can use can use either an IPv4 or IPv6 address.


エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-CustomerID<String>

Specifies an ID for a policy entry or VM. Administrators can use this setting for any purpose.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-MACAddress<String>

Specifies a MAC address that corresponds to the Customer Address.


エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-ProviderAddress<String>

Specifies an IP address, either IPv4 or IPv6, for a physical address that corresponds to the Customer Address.


エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Rule<RuleType>

Specifies which type of virtualization mechanism that the policy entry uses. このパラメーターに対して使用できる値:

-- TranslationMethodNat. IP address rewrite.
-- TranslationMethodEncap. Network Virtualization Generic Routing Encapsulation (NVGRE).
-- TranslationMethodNone. None.


エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-ThrottleLimit<Int32>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Type<Type>

Specifies a type. The type determines the address mapping for a record. このパラメーターに対して使用できる値:

-- Static. The Customer Address (CA) specified in this lookup record is the address assigned to the corresponding virtual machine, which is implicitly specified by the MAC address. An administrator or creates this lookup record.
-- Dynamic. The Customer Address specified in this lookup record is the address assigned to the corresponding virtual machine, which is implicitly specified by the MAC address. For example, the Hyper-V Network Virtualization software creates this record for virtual machines that obtain their IP addresses from a DHCP server.
-- L2Only. The Customer Address specified in this lookup record should be set to 0.0.0.0 for IPv4, or :: for IPv6. The corresponding virtual machine, implicitly specified by the MAC address, learns the CA dynamically.
-- GatewayWildcard. The CA address specified in this lookup record should be set to 0.0.0.0 for IPv4, or :: for IPv6. The corresponding virtual machine, implicitly specified by the MAC address, is a Hyper-V Network Virtualization gateway.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-UseVmMACAddress<Boolean>

Indicates whether this entry uses its defined MAC address instead of physical MAC address. Virtual networking can use different MAC addresses for different VMs to balance traffic among multiple CPU cores.

A value of $True is valid only if the Rule parameter has a value of TranslationMethodNat. The default value for this setting is $False.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-VirtualSubnetID<UInt32>

Specifies an ID for the virtual subnet that the Customer address belongs to. このパラメーターに対して使用できる値:integers from 4096 through 16777214.


エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-VMName<String>

Specifies a name for the VM for this policy entry. Administrators can use this name for any purpose.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

Example 1: Create a policy entry

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.


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

関連トピック

コミュニティの追加

追加
表示: