How to manually install, uninstall, or temporarily disable the CodeTwo transport agent

Problem:

CodeTwo email signature software for on-prem Exchange processes emails via a dedicated Exchange transport agent. In most cases, the agent is installed automatically together with the program. On rare occasions, however, the installation of the transport agent might fail and you might need to install it manually. This article shows how to manually install the agent, as well as how to uninstall, disable, or re-enable it.

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 the CodeTwo transport agent

Open Exchange Management Shell and execute the following PowerShell cmdlets:

• If you use CodeTwo Email Signatures On-prem:

  Install-TransportAgent -Name "CodeTwo Exchange Transport Agent" -TransportAgentFactory "Agent.CAgentFactoryRouting" -AssemblyPath "C:\Program Files\CodeTwo\CodeTwo Email Signatures On-prem\CodeTwo.ER.Agent.dll"
  Enable-TransportAgent -Identity "CodeTwo Exchange Transport Agent"

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

  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 (discontinued):

  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 (discontinued):

  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 2.x (discontinued):

  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 the CodeTwo 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 the CodeTwo 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 the previously disabled CodeTwo 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 their statuses are

Open Exchange Management Shell and execute the following PowerShell cmdlet:

Get-TransportAgent

CodeTwo transport agent name

The name of the CodeTwo transport agent depends on the product that you use:

• CodeTwo Email Signatures On-prem: CodeTwo Exchange Transport Agent
• CodeTwo Exchange Rules 2013/2016/2019/Pro (discontinued): CodeTwo Exchange Rules

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