Add-BgpRouter

Add-BgpRouter

Adds a BGP router.

構文

Parameter Set: Add0
Add-BgpRouter -BgpIdentifier <IPAddress> -LocalASN <UInt32> [-AsJob] [-CimSession <CimSession[]> ] [-CompareMEDAcrossASN <Boolean> ] [-DefaultGatewayRouting <Boolean> ] [-IPv6Routing <IPv6RoutingState> ] [-LocalIPv6Address <IPAddress> ] [-PassThru] [-RoutingDomain <String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

詳細説明

The Add-BgpRouter cmdlet adds a Border Gateway Protocol (BGP) router. In a multitenant deployment, the cmdlet adds a BGP router for the routing domain or a tenant. In a non-multitenant deployment, the cmdlet configures the BGP router for the local computer. In a multitenant deployment, you must specify the RoutingDomain parameter. In a non-multitenant deployment, do not specify the RoutingDomain parameter.

パラメーター

-AsJob

-BgpIdentifier<IPAddress>

Specifies the Internet IPv4 address of a local BGP router.

-CimSession<CimSession[]>

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

-CompareMEDAcrossASN<Boolean>

Indicates whether the BGP router compares Multi-Exit Discriminator (MED) values across different autonomous systems (AS).

-DefaultGatewayRouting<Boolean>

Indicates whether the cmdlet enables routing of the unresolvable routes to the default gateway.

-IPv6Routing<IPv6RoutingState>

Specifies the state of IPv6 routing for the BGP router. このパラメーターに対して使用できる値:

-- Enabled
-- Disabled

-LocalASN<UInt32>

Specifies the local autonomous system number (ASN) for the local router.

-LocalIPv6Address<IPAddress>

Specifies the Internet IPv6 address of a local BGP router. This parameter specifies the global or site-local Internet IPv6 address for the local BGP router. The BGP router uses this IP address as the next hop value in the IPv6 route advertisements.

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットによる出力はありません。

-RoutingDomain<String>

Specifies the name, as a string, of a tenant. The ID of a routing domain is a user-defined alphanumeric string. A routing domain ID must be unique.

-ThrottleLimit<Int32>

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

<CommonParameters>

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

入力

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

出力

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

• Microsoft.Management.Infrastructure.CimInstance#BgpRouterConfig

例

Example 1: Add a local BGP router

This command adds a local BGP router for a tenant. The command specifies the IP address and ASN of the local router.

PS C:\> Add-BgpRouter -BgpIdentifier "192.168.1.10" -LocalASN 64522 -PassThru

Example 2: Add a local BGP router for a routing domain

This command adds a local BGP router in a multi-tenant environment for the routing domain named Rd_001. The command specifies a local BGP router that has the IP address 14.1.1.10, and specifies the BGP router instance that has the local autonomous system number 64522.

PS C:\> Add-BgpRouter -RoutingDomain "Rd_001" -BgpIdentifier "10.1.1.10" -LocalASN 64522 -PassThru

関連トピック

Get-BgpRouter

Set-BgpRouter

Remove-BgpRouter