Add-BgpPeer

Add-BgpPeer

Adds a BGP peer to the current router.

構文

Parameter Set: Add0
Add-BgpPeer [-Name] <String> -LocalIPAddress <IPAddress> -PeerASN <UInt32> -PeerIPAddress <IPAddress> [-AsJob] [-CimSession <CimSession[]> ] [-HoldTimeSec <UInt16> ] [-IdleHoldTimeSec <UInt16> ] [-LocalASN <UInt32> ] [-MaxAllowedPrefix <UInt32> ] [-OperationMode <OperationMode> ] [-PassThru] [-PeeringMode <PeeringMode> ] [-RoutingDomain <String> ] [-ThrottleLimit <Int32> ] [-Weight <UInt16> ] [ <CommonParameters>]

詳細説明

The Add-BgpPeer cmdlet adds a Border Gateway Protocol (BGP) peer to the current router. Specify the following values for the peer:

-- A name for the peer router
-- IP address that the router uses with the peer
-- Autonomous system number (ASN) for the peer router

You can also specify the following values:

-- ASN for the local router
-- Maximum number of network prefixes that the local router instance can learn from this peer
-- Preference assigned to routes received from this peer
-- Operation mode and peering mode
-- Hold time, in seconds

Exchange of route information begins when the peering session begins. If the peering mode is Automatic, the session begins when you add the peer. If you specify a value of Manual for the PeeringMode parameter, use the Start-BgpPeer cmdlet to start the peer session.

パラメーター

-AsJob

-CimSession<CimSession[]>

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

-HoldTimeSec<UInt16>

Specifies the hold time, in seconds. If this computer does not receive any messages from the peer within this period, the session expires.

-IdleHoldTimeSec<UInt16>

Specifies the time in seconds for which the BGP Peer stays in an idle state after an unsuccessful peer connection attempt.

-LocalASN<UInt32>

Specifies the ASN for the local router.

-LocalIPAddress<IPAddress>

Specifies the IP address that the local router uses for the peer connection.

-MaxAllowedPrefix<UInt32>

Specifies the maximum number of network prefixes that this router learns from its peer.

-Name<String>

Specifies a name. Provide a unique name for this peer within the routing domain.

-OperationMode<OperationMode>

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

-- Mixed. The peer both initiates and accepts requests.
-- Server. The peer only accepts requests.

The default value is Mixed.

-PassThru

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

-PeerASN<UInt32>

Specifies the ASN for the peer.

-PeeringMode<PeeringMode>

Specifies the peering mode for the peer. このパラメーターに対して使用できる値:

-- Automatic. Starts peering attempts automatically when added.
-- Manual. Starts peering attempts after you start the session by using the Start-BgpPeer cmdlet.

The default value is Automatic.

-PeerIPAddress<IPAddress>

Specifies the IP address of the peer.

-RoutingDomain<String>

Specifies the name of the routing domain as a string. The name is a unique, for the multi-tenant gateway, user-defined alphanumeric string.

-ThrottleLimit<Int32>

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

-Weight<UInt16>

Specifies the preference, as an integer, assigned to routes received from this peer. Higher values have higher priority. The default value is 32768.

<CommonParameters>

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

入力

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

出力

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

• Microsoft.Management.Infrastructure.CimInstance#BgpPeerConfig

例

Example 1: Add a peer

This command adds a BGP peer, named TenantSite22, to the router. The command specifies the IP addresses for the router and the peer, and the peer ASN. The command selects the default value of Automatic for the peering mode. The command includes the PassThru parameter, so it passes the new object to the console.

PS C:\> Add-BgpPeer -Name "TenantSite22" -LocalIPAddress 192.168.1.10 -PeerASN 64512 -PeerIPAddress 10.1.1.10 -PassThru

Example 2: Add a peer that uses manual peering mode

This command adds a BGP peer, named TenantSite24, to the router. The command specifies the IP addresses for the router and the peer, and the peer ASN. The command specifies the PeeringMode and OperationsMode parameters. Because the command specifies a value of Manual for the PeeringMode parameter, the router drops incoming connections until you start the peering. The command includes the PassThru parameter, so it passes the new object to the console.

PS C:\> Add-BgpPeer -Name "TenantSite23" -LocalIPAddress 192.168.1.10 -PeerASN 64512 -PeerIPAddress 10.1.1.10 -OperationMode Server -PassThru -PeeringMode Manual 

Example 3: Add a peer and specify a routing domain

This command adds a BGP peer, named Tenant19, to the router. The command specifies the IP addresses for the router and the peer, and the peer ASN. The command also specifies the routing domain as RD001. The command includes the PassThru parameter, so it passes the new object to the console.

PS C:\> Add-BgpPeer -Name "Tenant19" -LocalIPAddress 10.1.1.10 -PeerASN 64513 -PeerIPAddress 192.168.1.2 -PassThru -RoutingDomain "RD001"

関連トピック

Get-BgpPeer

Remove-BgpPeer

Set-BgpPeer

Start-BgpPeer

Stop-BgpPeer