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 an existing transport agent on a computer that has the 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

To run the Get-TransportAgent 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-TransportAgent cmdlet, the account you use must be delegated the following:

  • Exchange Organization Administrator role

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

Viewing a Summary List of Transport Agents

In the Exchange Management Shell, you can view a summary list of transport agents that are configured on a local computer.

To use the Exchange Management Shell to view a summary list of all transport agents

  • Run the following command:

    Copy Code
    Get-TransportAgent 
    

Viewing Detailed Configuration of a Specific Transport Agent

In the Exchange Management Shell, you can view transport agents that are configured on the local computer by using the following syntax:

Copy Code
Get-TransportAgent <TransportAgentID> | Format-List
Note:
To view the detailed configuration of all transport agents on the local computer, do not specify a TransportAgentID value in the previous command.

For more information about pipelining, see Pipelining.

For more information about how to work with the information that is returned by a command, see Working with Command Output.

To use the Exchange Management Shell to view the detailed configuration of an existing Transport agent

  • Run the following command to view the detailed configuration of the Journaling agent that is configured on a Hub Transport server:

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

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