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

Topic Last Modified: 2012-07-23

You can use the Shell to view or modify an existing transport agent on a computer that has the Microsoft Exchange Server 2010 Hub Transport server role or Edge Transport server role installed. 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 summary list of transport agents

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 summary list of transport agents.

This example provides a summary list of transport agents configured on a local computer.

Copy Code
Get-TransportAgent

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

Use the Shell to view detailed configuration of a specific transport agent

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 detailed configuration of a specific transport agent.

This example provides detailed configuration of the Journaling agent configured on a Hub Transport server.

Copy Code
Get-TransportAgent "Journaling agent" | Format-List

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

Use the Shell to configure a transport agent

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 configure a transport agent.

To modify the priority of an existing transport agent, use the following syntax.

Copy Code
Set-TransportAgent <TransportAgentID> [-Priority <Priority>]

This example modifies the priority of the existing transport agent Antivirus for Exchange.

Copy Code
Set-TransportAgent "Antivirus for Exchange" -Priority 3

For detailed syntax and parameter information, see Set-TransportAgent.