New-NetVirtualizationCustomerRoute

New-NetVirtualizationCustomerRoute

Creates a virtual network route.

構文

Parameter Set: cim:CreateInstance0
New-NetVirtualizationCustomerRoute -DestinationPrefix <String> -NextHop <String> -RoutingDomainID <String> -VirtualSubnetID <UInt32> [-AsJob] [-CimSession <CimSession[]> ] [-Metric <UInt32> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]




詳細説明

The New-NetVirtualizationCustomerRoute cmdlet creates a virtual network route in 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 uses Customer Routes to manage network traffic on a virtual network. For more information, see Network Virtualization technical details (http://technet.microsoft.com/library/jj134174.aspx) on TechNet.

To create a virtual network route, specify the following values:

-- Destination prefix. A range of IP addresses as an IP prefix.
-- Next hop. A next hop gateway for the specified destionation addresses.
-- Routing domain ID. An ID for a virtual network that can include multiple virtual subnets.
-- Virtual subnet ID. An ID for a virtual subnet.

You can also specify a metric rank. Network Virtualization uses this rank to choose a preferred route from several possible routes. You can use the Set-NetVirtualizationCustomerRoute cmdlet to set or change this value later.

パラメーター

-AsJob

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

false

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

false

-CimSession<CimSession[]>

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


エイリアス

Session

必須?

false

位置は?

named

既定値

なし

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

false

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

false

-DestinationPrefix<String>

Specifies an IP prefix, as a string, for a destination network. You can use a IPv4 or IPv6 address. Use prefix notation: 0.0.0.0/0.


エイリアス

なし

必須?

true

位置は?

named

既定値

なし

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

false

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

false

-Metric<UInt32>

Specifies an integer value for the route. Network Virtualization selects the route with the lowest metric value from a group of usable routes.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

false

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

false

-NextHop<String>

Specifies an IP address for the next hop gateway for this route.


エイリアス

なし

必須?

true

位置は?

named

既定値

なし

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

false

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

false

-RoutingDomainID<String>

Specifies the ID for a routing domain. A routing domain allows routing among its multiple virtual subnets. Routing domains use a GUID style ID: {11111111-2222-3333-4444-000000000000}.


エイリアス

なし

必須?

true

位置は?

named

既定値

なし

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

false

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

false

-ThrottleLimit<Int32>

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


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

false

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

false

-VirtualSubnetID<UInt32>

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


エイリアス

なし

必須?

true

位置は?

named

既定値

なし

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

false

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

false

<CommonParameters>

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

入力

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

出力

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

Example 1: Create a Customer Route

This command creates a Customer Route. The command specifies a destination prefix, a next hop gateway, a routing domain ID, and a virtual subnet ID.


PS C:\> New-NetVirtualizationCustomerRoute -DestinationPrefix "172.16.0.0/16" -NextHop "172.16.0.1" -RoutingDomainID "{11111111-2222-3333-4444-000000000000}" -VirtualSubnetID 8392

関連トピック

コミュニティの追加

追加
表示: