Get-BgpStatistics

Reference

Module:: RemoteAccess

Retrieves BGP peering-related message and route advertisement statistics.

Syntax

Get-BgpStatistics
   [-RoutingDomain <String>]
   [-PeerName <String[]>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Get-BgpStatistics
   [-AllRoutingDomains]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

The Get-BgpStatistics cmdlet retrieves Border Gateway Protocol (BGP) peering-related message and route advertisement statistics.

Examples

Example 1: Retrieve all BPG message and route statistics

PS C:\> Get-BgpStatistics




PeerName                 : Tenant-01
TcpConnectionEstablished : 14-03-2013 02:57:04
TcpConnectionClosed      : 14-03-2013 02:56:34
OpenMessage: 
          LastSent                 : 14-03-2013 02:57:04
          LastReceived             : 14-03-2013 02:57:04
          SentCount                : 4
          ReceivedCount            : 4
UpdateMessage:           
          LastSent                 : 14-03-2013 02:57:04
          LastReceived             : 14-03-2013 02:57:04
          SentCount                : 4
          ReceivedCount            : 4
NotificationMessage: 
          LastSent                 : 01-01-0001 00:00:00
          LastReceived             : 13-03-2013 08:24:46
          SentCount                : 0
          ReceivedCount            : 2
KeepAliveMessage: 
          LastSent                 : 14-03-2013 03:00:31
          LastReceived             : 14-03-2013 03:00:32
          SentCount                : 1277
          ReceivedCount            : 1273
RouteRefreshMessage: 
          LastSent                 : 01-01-0001 00:00:00
          LastReceived             : 01-01-0001 00:00:00
          SentCount                : 0
          ReceivedCount            : 0
IPv4Route: 
          UpdateSentCount          : 4
          UpdateReceivedCount      : 4
          WithdrawalSentCount      : 0
          WithdrawalReceivedCount  : 0
IPv6Route: 
          UpdateSentCount          : 0
          UpdateReceivedCount      : 0
          WithdrawalSentCount      : 0
          WithdrawalReceivedCount  : 0

This command retrieves the BGP message and route statistics.

Example 2: Retrieve BGP message and route statistics for a routing domain

PS C:\> Get-BgpStatistics -RoutingDomain Rd_02
PeerName                 : Tenant-01
TcpConnectionEstablished : 14-03-2013 02:57:04
TcpConnectionClosed      : 14-03-2013 02:56:34
OpenMessage: 
          LastSent      : 14-03-2013 02:57:04
          LastReceived  : 14-03-2013 02:57:04
          SentCount     : 4
          ReceivedCount : 4
UpdateMessage: 
          LastSent      : 14-03-2013 02:57:04
          LastReceived  : 14-03-2013 02:57:04
          SentCount     : 4
          ReceivedCount : 4
NotificationMessage: 
          LastSent      : 01-01-0001 00:00:00
          LastReceived  : 13-03-2013 08:24:46
          SentCount     : 0
          ReceivedCount : 2
KeepAliveMessage: 
          LastSent      : 14-03-2013 03:00:31
          LastReceived  : 14-03-2013 03:00:32
          SentCount     : 1277
          ReceivedCount : 1273
RouteRefreshMessage: 
          LastSent      : 01-01-0001 00:00:00
          LastReceived  : 01-01-0001 00:00:00
          SentCount     : 0
          ReceivedCount : 0
IPv4Route: 
          UpdateSentCount         : 4
          UpdateReceivedCount     : 4
          WithdrawalSentCount     : 0
          WithdrawalReceivedCount : 0
IPv6Route: 
          UpdateSentCount         : 0
          UpdateReceivedCount     : 0
          WithdrawalSentCount     : 0
          WithdrawalReceivedCount : 0

This command retrieves the BGP message and route statistics for a routing domain named Rd_02.

Parameters

-AllRoutingDomains

Use this command to retrieve details about all routing domains.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CimSession

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

Type:	CimSession[]
Aliases:	Session
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PeerName

Specifies an array of peer names for which to retrieve the BGP message and route statistics.

Type:	String[]
Aliases:	PeerId, PeerList
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-RoutingDomain

Specifies an ID, as a string, for a routing domain. The ID of a routing domain is a unique user-defined alphanumeric string.

Type:	String
Aliases:	RoutingDomainName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ThrottleLimit

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.