View Transport Agents in the Transport Pipeline

  • Article

 

Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

You can use the Shell to view a list of transport agents in the transport pipeline on a computer that has the Microsoft Exchange Server 2010 Hub Transport server role or Edge Transport server role installed. You can view a list of all the enabled transport agents that have encountered messages in the transport pipeline and the SMTP events they are registered on.

For more information about transport agents, see Understanding Transport Agents.

Looking for other management tasks related to transport agents? Check out Managing Transport Agents.

Use the Shell to view a list of transport agents in the transport pipeline

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Transport agents" entry in the Transport Permissions topic.

Note

You can't use the EMC to view a list of transport agents in the transport pipeline.

This example lists transport agents in the transport pipeline.

Get-TransportPipeline

Important

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 Get-TransportPipeline cmdlet was run are displayed by the cmdlet. A transport agent that hasn't encountered a message in the transport pipeline won't appear in the results displayed by the Get-TransportPipeline cmdlet, even if that transport agent is enabled.

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's registered on the SMTP event and has encountered a message. This example shows 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
                                         Agent}
OnDataCommand                           {}
OnEndOfHeaders                          {Connection Filtering Agent, Address Re
                                        writing Inbound Agent, Sender Id Agent,
                                         Sender Filter Agent, Protocol Analysis
                                         Agent}
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.

 © 2010 Microsoft Corporation. All rights reserved.