How to View Transport Agents in the Transport Pipeline

Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.


Applies to: Exchange Server 2007, Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Topic Last Modified: 2007-01-02

This topic explains how to use the Exchange Management Shell to view a list of transport agents in the transport pipeline on a computer that has the Microsoft Exchange Server 2007 Hub Transport server role or Edge Transport server installed.

For more information about transport agents, see Overview of Transport Agents.

You cannot administer transport agents by using the Exchange Management Console. To administer transport agents, you must use the Exchange Management Shell. For more information about how to use the Exchange Management Shell, see Using the Exchange Management Shell.

Only transport agents that have encountered messages in the transport pipeline between the time when the Exchange Transport service was started and the time when the cmdlet was run are displayed by the Get-TransportPipeline cmdlet. A transport agent that has not encountered a message in the transport pipeline will not appear in the results that are displayed by the Get-TransportPipeline cmdlet, even if that transport agent is enabled.

To run the Get-TransportPipeline cmdlet on a computer that has the Edge Transport server role installed, you must be a member of the local Administrators group on that computer.

To run the Get-TransportPipeline cmdlet, the account you use must be delegated the following:

  • Exchange View-Only Administrators role

For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

In the Exchange Management Shell, you can view a list of all the enabled transport agents that have encountered messages in the transport pipeline and the Simple Mail Transfer Protocol (SMTP) events they are registered on.

The Get-TransportPipeline cmdlet lists each SMTP event in the order that the SMTP events encounter messages in the transport pipeline. Listed next to each SMTP event is each transport agent that is registered on the SMTP event and has encountered a message. The following shows example output from the Get-TransportPipeline cmdlet run on an Edge Transport server:

Event                                   TransportAgents
-----                                   ---------------
OnConnectEvent                          {Connection Filtering Agent}
OnHeloCommand                           {}
OnEhloCommand                           {}
OnAuthCommand                           {}
OnEndOfAuthentication                   {}
OnMailCommand                           {Connection Filtering Agent, Sender Fil
                                        ter Agent}
OnRcptCommand                           {Connection Filtering Agent, Address Re
                                        writing Inbound Agent, Recipient Filter
OnDataCommand                           {}
OnEndOfHeaders                          {Connection Filtering Agent, Address Re
                                        writing Inbound Agent, Sender Id Agent,
                                         Sender Filter Agent, Protocol Analysis
OnEndOfData                             {Edge Rule Agent, Content Filter Agent,
                                         Protocol Analysis Agent, Attachment Fi
                                        ltering Agent}
OnHelpCommand                           {}
OnNoopCommand                           {}
OnReject                                {Protocol Analysis Agent}
OnRsetCommand                           {Protocol Analysis Agent}
OnDisconnectEvent                       {Protocol Analysis Agent}

For detailed syntax and parameter information, see Get-TransportPipeline.