Share via

How to Uninstall 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 uninstall an existing transport agent on a computer that has the Microsoft Exchange Server 2007 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

To run the Uninstall-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 Uninstall-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 Exchange Server 2007, see Permission Considerations.

Procedure

You can use the Exchange Management Shell to uninstall transport agents that are configured on the local computer. When you use the Exchange Management Shell to uninstall a transport agent, Exchange unregisters the DLL files that are used with the agent. It does not remove any files, registry keys, or other objects that are added by the installation of the transport agent. Use the following syntax to uninstall an existing transport agent:

Uninstall-TransportAgent <TransportAgentID>

To use the Exchange Management Shell to uninstall an existing transport agent

  • Run the following command:

    Uninstall-TransportAgent "Antivirus for Exchange"

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