How to manually install, uninstall or temporarily disable CodeTwo Exchange Rules Transport Agent

Problem:

Software products from the CodeTwo Exchange Rules family process emails via a dedicated Exchange transport agent: CodeTwo Exchange Rules Transport Agent. Normally, the agent is installed automatically together with the program. On rare occasions, the installation of the Transport Agent might fail and you need to install it manually. This article also shows how to manually uninstall, disable or re-enable the agent.

Solution:

• Installing the agent
• Removing the agent
• Disabling the agent
• Enabling a disabled agent
• Checking the installed agents and their statuses

How to manually install CodeTwo Exchange Rules Transport Agent

Open  Exchange Management Shell and execute the following PowerShell cmdlets:

• If you use CodeTwo Exchange Rules 2007 3.x (deprecated):

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

• If you use CodeTwo Exchange Rules 2007 4.x (deprecated):

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

• If you use CodeTwo Exchange Rules 2010 2.x (deprecated):

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

• If you use CodeTwo Exchange Rules 2010 3.x (deprecated):

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

• If you use CodeTwo Exchange Rules 2013 1.x (deprecated):

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

• If you use CodeTwo Exchange Rules 2013 2.x (deprecated):

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

• If you use CodeTwo Exchange Rules 2016 1.x:

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

• If you use CodeTwo Exchange Rules 2019 1.x:

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

• If you use 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"

• If you use CodeTwo Exchange Rules Pro 2.x:

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

How to manually remove CodeTwo Exchange Rules Transport Agent

Open  Exchange Management Shell and execute the PowerShell cmdlet below (type in the appropriate name of the agent instead of <Transport Agent Name>):

Uninstall-TransportAgent -Identity "<Transport Agent Name>"

How to manually disable CodeTwo Exchange Rules Transport Agent

Open  Exchange Management Shell and execute the PowerShell cmdlet below (provide the appropriate name of the agent instead of <Transport Agent Name>):

Disable-TransportAgent -Identity "<Transport Agent Name>"

How to manually enable a previously disabled CodeTwo Exchange Rules Transport Agent:

Open  Exchange Management Shell and execute the PowerShell Cmdlet below (type in the appropriate name of the agent instead of <Transport Agent Name>):

Enable-TransportAgent -Identity "<Transport Agent Name>"

How to check what transport agents are installed and what are their statuses

Open  Exchange Management Shell and execute the following PowerShell cmdlet:

Get-TransportAgent

See also:

Microsoft articles on the PowerShell cmdlets described above:

• Install-TransportAgent
• Uninstall-TransportAgent
• Disable-TransportAgent
• Enable-TransportAgent
• Get-TransportAgent

CodeTwo resources:

• Invalid agent assembly path error
• CodeTwo and Exchange 2013 SP1
• Transport Service does not start after installing CodeTwo Exchange Rules family software