Remove-BgpCustomRoute

Remove-BgpCustomRoute

Removes custom routes from the BGP router.

構文

Parameter Set: Remove2
Remove-BgpCustomRoute [-AsJob] [-CimSession <CimSession[]> ] [-Force] [-Interface <String[]> ] [-Network <String[]> ] [-RoutingDomain <String> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Remove-BgpCustomRoute cmdlet removes Classless InterDomain Routing (CIDR) prefixes or interfaces for custom routes from the Border Gateway Protocol (BGP) routing table. When you remove a custom route, the BGP router can no longer use the information from the CIDR network or interface to distribute routing information between autonomous systems (AS). In addition, the BGP router sends route withdrawal messages to peers to remove the previously advertised custom routes that you remove.

You must specify at least one of the Interface or Network parameters.

パラメーター

-AsJob

-CimSession<CimSession[]>

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

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

-Interface<String[]>

Specifies an array of names of router interfaces. The cmdlet removes the static routes for these interfaces from the BGP routing table.

-Network<String[]>

Specifies an array of network prefixes, in Classless InterDomain Routing (CIDR) notation. For IPv4 networks, you must specify the network prefix and its network mask. The cmdlet removes the routing information for the network prefixes from the BGP routing table.

-RoutingDomain<String>

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

-ThrottleLimit<Int32>

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

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

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

入力

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

出力

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

例

Example 1: Remove a network prefix

This command removes the network prefix of a custom network from the BGP routing table.

PS C:\> Remove-BgpCustomRoute -Network "172.23.90.0/29"

Example 2: Remove the interface for a routing domain

This command removes the router interface named VS01 from the BGP routing table for the routing domain named Rd_002.

PS C:\> Remove-BgpCustomRoute -Interface "VS01" -RoutingDomain Rd_002

関連トピック

Add-BgpCustomRoute

Add-BgpCustomRoute