CodeTwo Base.title

How to manually install or uninstall CodeTwo Exchange Rules Transport Agent

Problem:

CodeTwo Exchange Rules family software processes emails via MS Exchange Transport Service Agent. Normally such agent is installed automatically together with the program. However, rarely the installation of Transport Agent fails and you may face the problem of manual installation. For some other specific reasons you may also need to know how to manually uninstall, disable or re-enable our agent.

Solution:

  1. Agent installation.
  2. Agent removal.
  3. Disabling agent.
  4. Enabling disabled agent.
  5. Checking installed agents and their statuses.
  6. See also.

Before running the commands from the below solution, please ensure that you are logged in as a user who is a direct member of the Organization Management and Domain Admin groups.

Be aware that upon applying any of the changes below a restart of MS Exchange Transport Service will be required.

  1. How to manually install CodeTwo Exchange Rules Transport Agent:

Open ems Exchange Management Shell and execute the following PowerShell Cmdlets:

For CodeTwo Exchange Rules 2007 3.x:

Install-TransportAgent -Name "CodeTwoExchangeRules" -TransportAgentFactory "ExchangeRulesAgent.CAgentFactory" -AssemblyPath "C:\Program Files\CodeTwo\CodeTwo Exchange Rules 2007\ExchangeRulesAgent.dll"
Enable-TransportAgent -Identity "CodeTwoExchangeRules"

For CodeTwo Exchange Rules 2007 4.x:

Install-TransportAgent -Name "CodeTwoExchangeRules" -TransportAgentFactory "Agent.CAgentFactoryRouting" -AssemblyPath "C:\Program Files\CodeTwo\CodeTwo Exchange Rules\CodeTwo.ER.Agent.dll"
Enable-TransportAgent -Identity "CodeTwoExchangeRules"

For CodeTwo Exchange Rules 2010 2.x:

Install-TransportAgent -Name "CodeTwoExchangeRules" -TransportAgentFactory "ExchangeRulesAgent.CAgentFactory" -AssemblyPath "C:\Program Files\CodeTwo\CodeTwo Exchange Rules 2010\ExchangeRulesAgent.dll"
Enable-TransportAgent -Identity "CodeTwoExchangeRules"

For CodeTwo Exchange Rules 2010 3.x:

Install-TransportAgent -Name "CodeTwoExchangeRules" -TransportAgentFactory "Agent.CAgentFactoryRouting" -AssemblyPath "C:\Program Files\CodeTwo\CodeTwo Exchange Rules\CodeTwo.ER.Agent.dll"
Enable-TransportAgent -Identity "CodeTwoExchangeRules"

For CodeTwo Exchange Rules 2013 1.x:

Install-TransportAgent -Name "CodeTwoExchangeRules" -TransportAgentFactory "ExchangeRulesAgent.CAgentFactory" -AssemblyPath "C:\Program Files\CodeTwo\CodeTwo Exchange Rules 2013\ExchangeRulesAgent.dll"
Enable-TransportAgent -Identity "CodeTwoExchangeRules"

For CodeTwo Exchange Rules 2013 2.x:

Install-TransportAgent -Name "CodeTwoExchangeRules" -TransportAgentFactory "Agent.CAgentFactoryRouting" -AssemblyPath "C:\Program Files\CodeTwo\CodeTwo Exchange Rules\CodeTwo.ER.Agent.dll"
Enable-TransportAgent -Identity "CodeTwoExchangeRules"

For CodeTwo Exchange Rules 2016 1.x:

Install-TransportAgent -Name "CodeTwoExchangeRules" -TransportAgentFactory "Agent.CAgentFactoryRouting" -AssemblyPath "C:\Program Files\CodeTwo\CodeTwo Exchange Rules\CodeTwo.ER.Agent.dll"
Enable-TransportAgent -Identity "CodeTwoExchangeRules"

For CodeTwo Exchange Rules PRO 1.x:

Install-TransportAgent -Name "CodeTwoExchangeRulesPro" -TransportAgentFactory "Agent.CAgentFactoryRouting" -AssemblyPath "C:\Program Files\CodeTwo\CodeTwo Exchange Rules Pro\CodeTwo.ER.Agent.dll"
Enable-TransportAgent -Identity "CodeTwoExchangeRulesPro"

For CodeTwo Exchange Rules PRO 2.x:

Install-TransportAgent -Name "CodeTwoExchangeRulesPro" -TransportAgentFactory "Agent.CAgentFactoryRouting" -AssemblyPath "C:\Program Files\CodeTwo\CodeTwo Exchange Rules\CodeTwo.ER.Agent.dll"
Enable-TransportAgent -Identity "CodeTwoExchangeRulesPro"
  1. How to manually remove CodeTwo Exchange Rules Transport Agent:

Open ems Exchange Management Shell and execute the below PowerShell Cmdlet. Instead of <Transport Agent Name> put the appropriate name of the agent:

Uninstall-TransportAgent -Identity "<Transport Agent Name>"
  1. How to manually disable CodeTwo Exchange Rules Transport Agent:

Open ems Exchange Management Shell and execute the below PowerShell Cmdlet. Instead of <Transport Agent Name> put the appropriate name of the agent:

Disable-TransportAgent -Identity "<Transport Agent Name>"
  1. How to manually enable previously disabled CodeTwo Exchange Rules Transport Agent:

Open ems Exchange Management Shell and execute the below PowerShell Cmdlet. Instead of <Transport Agent Name> put the appropriate name of the agent:

Enable-TransportAgent -Identity "<Transport Agent Name>"
  1. How to check what Transport Agents are installed and what are their statuses:

Open ems Exchange Management Shell and execute the below PowerShell Cmdlet:

Get-TransportAgent
  1. See also:

Microsoft Technet articles on the above described PowerShell Cmdlets. Be aware that the linked articles apply to MS Exchange 2013, however the Cmdlets usage is almost identical in previous versions. To get manuals on the Cmdlets usage specific to your Exchange Server version please search MS Technet:

CodeTwo resources:

Our Clients:
Unicef
Facebook
Shell
T-Systems
Loreal
Casio
UPS Israel
Oford University
Mitsubishi Motors
Toshiba TEC UK Imaging Systems Ltd
Illinois Institute of Technology
MAN Diesel
McDonalds India
Skoda Auto
Bank of Israel
Fujifilm
China Mobile
Santander
Samsung SDI
Skanska
Generali
Telmex
Toyota Tsusho
BECHTEL
Ricoh
BAE SYSTEMS
Federação Portuguesa de Futebol
Credit Agricole
HYUNDAI
Rothschild
Toyota Boshoku
Oriflame Romania
ING
Ikea
Nordea