Install a Transport Agent

 

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

When you install a transport agent, Microsoft Exchange Server 2010 only registers the DLLs 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 isn't affected by transport agents that haven't been configured. Therefore, after a transport agent has been configured correctly, you must enable the transport agent.

You can use the Shell to install a 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 Understanding Transport Agents.

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

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.

Use the Shell to install 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 install a transport agent.

Use the following syntax to install a transport agent.

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

This example installs a fictitious transport agent that scans messages for viruses.

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

This example enables the newly installed transport agent.

Enable-TransportAgent "Antivirus for Exchange"

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

 © 2010 Microsoft Corporation. All rights reserved.