All transport agents must be registered with Exchange Server to be invoked when email is processed. When the Email Signature Manager Transport Agent is installed, it is automatically registered with Exchange Server (and when uninstalled, it is automatically unregistered).
If you need to review or manage the registration of the Email Signature Manager Transport Agent, you can do so in the Exchange Management Shell.
Note
The commands in this article are correct for Exchange Server 2013 and later.
Verifying 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 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
Restarting the Exchange Transport Service
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
Registering 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:
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 the above command assumes 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.
Enabling the transport agent
Once registered, the Transport Agent must be enabled by executing the following command:
Enable-TransportAgent "Symprex Email Signature Manager Agent" -TransportService Hub
There is no output from this cmdlet.
You can verify the Transport Agent is registered and enabled using the Get-TransportAgent cmdlet as detailed in the previous section.
Disabling the transport agent
The Transport Agent can be disabled by executing the following command:
Disable-TransportAgent "Symprex Email Signature Manager Agent" -TransportService Hub
There is no output from this cmdlet.
You can verify the Transport Agent has been disabled using the Get-TransportAgent cmdlet as detailed in the previous section.
Unregistering the transport agent
The Transport Agent can be unregistered by executing the following command:
Uninstall-TransportAgent "Symprex Email Signature Manager Agent" -TransportService Hub
You can verify the Transport Agent has been unregistered using 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.