APPLIES TO


Email Signature Manager version 5.x

Email Signature Manager version 6.x

Email Signature Manager version 7.x


SUMMARY


This article describes how to manually manage the registration of the Email Signature Manager Transport Agent with Exchange Server.


INFORMATION


All transport agents have to be registered with Exchange Server in order to be invoked when email is processed. When the Email Signature Manager Transport Agent is installed, it is automatically registered with Exchange Server during the installation process (and unregistered when uninstalled).


If you need or wish to manually investigate or manage the registration of the Email Signature Manager Transport Agent you can do so in the Exchange Management Shell.


VERIFY THE TRANSPORT AGENT REGISTRATION


To determine if the Email Signature Manager Transport Agent is registered with Exchange Server, start an instance of Exchange Management Shell and execute the following command:


Get-TransportAgent "Symprex Email Signature Manager Agent"


If the Transport Agent is registered, its details will be listed and should appear to be similar to the following:


Identity                                Enabled   Priority

--------                                -------   --------

Symprex Email Signature Manager Agent   True      4


To view the full details of the registration, execute the following command:


Get-TransportAgent "Symprex Email Signature Manager Agent" | fl


To view all of the registered transport agents, execute the following command:


Get-TransportAgent


REQUIREMENT TO RESTART THE EXCHANGE TRANSPORT SERVICE


Note that after executing any of the commands below, the Microsoft Exchange Transport Service must be restarted.


To restart the Microsoft Exchange Transport Service, execute the following command:


Restart-Service MSExchangeTransport


REGISTER THE TRANSPORT AGENT


To manually register the Email Signature Manager Transport Agent with Exchange Server, start an instance of Exchange Management Shell and execute the following command:


Exchange Server 2007 and 2010


Install-TransportAgent -Name "Symprex Email Signature Manager Agent" -AssemblyPath "C:\Program Files\Symprex\Email Signature Manager Transport Agent\signta.dll" -TransportAgentFactory "Symprex.EmailSignatureManager.TransportAgent.ESMRoutingAgentFactory"


Exchange Server 2013 and 2016


Install-TransportAgent -Name "Symprex Email Signature Manager Agent" -AssemblyPath "C:\Program Files\Symprex\Email Signature Manager Transport Agent\signta.dll" -TransportAgentFactory "Symprex.EmailSignatureManager.TransportAgent.ESMRoutingAgentFactory" -TransportService Hub


Note that the above commands assume that the Transport Agent has been installed to the default location "C:\Program Files\Symprex\Email Signature Manager Transport Agent". If this is not the case, adjust the -AssemblyPath parameter as required.


The output should be similar to the following:


Identity                                Enabled   Priority

--------                                -------   --------

Symprex Email Signature Manager Agent   False     4


If an error occurs, verify that the Transport Agent is installed. If you are running Exchange Server 2013 SP1 (equivalent to CU4), upgrade to CU5 or higher.


ENABLE THE TRANSPORT AGENT


Once registered, the Transport Agent must be enabled by executing the following command:


Exchange Server 2007 and 2010


Enable-TransportAgent "Symprex Email Signature Manager Agent"


Exchange Server 2013 and 2016


Enable-TransportAgent "Symprex Email Signature Manager Agent" -TransportService Hub


There is no output from this cmdlet.


You can verify that the Transport Agent is now registered and enabled by executing the Get-TransportAgent cmdlet as detailed in the previous section.


DISABLE THE TRANSPORT AGENT


The Transport Agent can be disabled by executing the following command:


Exchange Server 2007 and 2010


Disable-TransportAgent "Symprex Email Signature Manager Agent"


Exchange Server 2013 and 2016


Disable-TransportAgent "Symprex Email Signature Manager Agent" -TransportService Hub


There is no output from this cmdlet.


You can verify that the Transport Agent has been disabled by executing the Get-TransportAgent cmdlet as detailed in the previous section.


UNREGISTER THE TRANSPORT AGENT


The Transport Agent can be unregistered by executing the following command:


Exchange Server 2007 and 2010


Uninstall-TransportAgent "Symprex Email Signature Manager Agent"


Exchange Server 2013 and 2016


Uninstall-TransportAgent "Symprex Email Signature Manager Agent" -TransportService Hub


You can verify that the Transport Agent has been unregistered by executing the Get-TransportAgent cmdlet as detailed in the previous section.


If you want to manually remove the Email Signature Manager Transport Agent, it is important to unregister it first, or the Microsoft Exchange Transport Service may fail to start.