Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
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.

Note:
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.

Before You Begin

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 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.

Procedure

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:

Copy Code
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}

To use the Exchange Management Shell to view a list of transport agents in the transport pipeline

  • Run the following command:

    Copy Code
    Get-TransportPipeline 
    

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