How to Install a Transport Agent

  • Article

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

This topic explains how to use the Exchange Management Shell to install a new transport agent on a computer that has the Hub Transport server role or Edge Transport server role 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

Warning

Transport agents have full access to all e-mail messages that they encounter. Exchange puts no restrictions on a transport agent's behavior. Transport agents that are unstable or contain security flaws may affect the stability and security of Exchange. Therefore, you must only install transport agents that you fully trust and that have been fully tested in a test environment.

To run the Install-TransportAgent cmdlet on a computer running Edge Transport server role, you must be a member of the local Administrators group on that computer.

To run the Install-TransportAgent cmdlet, the account you use must be delegated the following:

  • Exchange Server Administrator role and local Administrators group for the target server

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

Procedure

In the Exchange Management Shell, you can install transport agents by using the following syntax:

Install-TransportAgent -Name <"TransportAgentID"> -TransportAgentFactory <"TransportAgentFactory"> -AssemblyPath <"FilePath">

When you install a transport agent by using the Exchange Management Shell, Exchange 2007 only registers the DLLs that are associated with the transport agent. You must make sure all files, registry keys, and other objects that the transport agent depends on are installed correctly and configured. After Exchange loads the DLLs, it continues to reference the DLLs after the command has completed.

Transport agents are installed in a disabled state to make sure mail flow is not affected by transport agents that have not yet been configured. After a transport agent has been configured correctly, use the following command to enable the Transport agent:

Enable-TransportAgent <TransportAgentID>

To use the Exchange Management Shell to install a new fictitious transport agent that scans messages for viruses

  • Run the following command:

    Install-TransportAgent -Name "Antivirus for Exchange" -TransportAgentFactory "vendor.exchange.avTransportAgentfactory" -AssemblyPath "c:\Program Files\Vendor\TransportAgent\AvTransportAgentFactory.Dll"

  • To enable the newly installed transport agent, use the following command:

    Enable-TransportAgent "Antivirus for Exchange"

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