6.5 ORF Online Help
Select your ORF version:

Table of Contents

Managing Transport Agents


This help section describes the process of managing ORF Transport Agents.

Transport Agents used by ORF

For Microsoft® Exchange 2019, Exchange 2016, Exchange 2010 and Exchange 2007

ORF installs two Transport Agents: the Vamsoft ORF SMTP Receive Agent (responsible for Before Arrival filtering and On Arrival filtering) and the Vamsoft ORF Routing Agent (responsible for collecting outbound email data for the Auto Sender Whitelist).

For Microsoft® Exchange 2013

Similarly to previous Exchange versions, ORF may install the Vamsoft ORF SMTP Receive Agent and the Vamsoft ORF Routing Agent, but the local Exchange roles decide which agents are actually installed.

Edge Transport Server installation

Both the Vamsoft ORF SMTP Receive Agent and the Vamsoft ORF Routing Agent are installed.

Client Access Server-only installation

Only the Vamsoft ORF SMTP Receive Agent is installed.

Mailbox Server-only installation

Both the Vamsoft ORF SMTP Receive Agent and the Vamsoft ORF Routing Agent are installed.

Single-server, mixed Client Access Server + Mailbox Server installation

The Vamsoft ORF SMTP Receive Agent is installed twice, once for the Front-End Transport Service of Exchange 2013 Client Access Server and once for the Hub Transport Service of Exchange 2013 Mailbox Server. The Vamsoft ORF Routing Agent is also installed.

For diagnostic purposes, you may want to temporarily disable these agents. This can be done using the Exchange PowerShell console.

Disabling ORF Transport Agents

Exchange 2019/2016


Edge Transport Server installation

On Exchange 2019/2016 Edge Transport servers, start the Exchange Management Shell console and run the

Disable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService Edge

Disable-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Edge

commands, then restart the MSExchangeTransport service to apply the changes:

Restart-Service MSExchangeTransport

Mailbox Server installation

On Exchange 2019/2016 Mailbox servers, start the Exchange Management Shell console and run the

Disable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService FrontEnd

Disable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService Hub

Disable-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Hub

commands, then restart the MSExchangeFrontEndTransport and MSExchangeTransport services to apply the changes:

Restart-Service MSExchangeFrontEndTransport

Restart-Service MSExchangeTransport

Exchange 2013


Edge Transport Server installation

On Exchange 2013 Edge Transport servers, start the Exchange Management Shell console and run the

Disable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService Edge

Disable-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Edge

commands, then restart the MSExchangeTransport service to apply the changes:

Restart-Service MSExchangeTransport

Client Access Server-only installation

If the Client Access server and Mailbox server roles are installed on separate servers, the *-TransportAgent commands issued from the Exchange Management Shell on a Client Access server will always run on the Mailbox server. To manage the Transport Agents of the CAS, you should start a regular PowerShell prompt and install an additional snap-in in order to run the *-TransportAgent commands on the local server. For more information, please consult this article ("TransportAgent cmdlets on Client Access servers require local Windows PowerShell" section).

To disable the Transport agent, run the

Disable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService FrontEnd

command, then restart the MSExchangeFrontEndTransport service to apply the changes:

Restart-Service MSExchangeFrontEndTransport

Mailbox Server-only installation

Start the Exchange Management Shell console and run the

Disable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService Hub

Disable-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Hub

commands, then restart the MSExchangeTransport service to apply the changes:

Restart-Service MSExchangeTransport

Single-server, mixed Client Access Server + Mailbox Server installation

When both roles (Client Access server and Mailbox) are installed on the same server, Transport Agent PowerShell commands require an additional TransportService parameter to specify which role the command should run on (FrontEnd = CAS, Hub = Mailbox).

To disable ORF Transport Agents, start the Exchange PowerShell console and run the

Disable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService FrontEnd

Disable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService Hub

Disable-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Hub

commands respectively. Note that these changes will take effect only after restarting the related Exchange transport service(s):

Restart-Service MSExchangeTransport

Restart-Service MSExchangeFrontEndTransport

Exchange 2010/2007

Start the Exchange Management Shell console and run the

Disable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent"

Disable-TransportAgent -Identity "Vamsoft ORF Routing Agent"

commands. Note that these changes will take effect only after restarting the MSExchangeTransport service:

Restart-Service MSExchangeTransport

Enabling ORF Transport Agents

Exchange 2019/2016


Edge Transport Server installation

On Exchange 2019/2016 Edge Transport servers, start the Exchange Management Shell console and run the

Enable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService Edge

Enable-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Edge

commands, then restart the MSExchangeTransport service to apply the changes:

Restart-Service MSExchangeTransport

Mailbox Server installation

On Exchange 2019/2016 Mailbox servers, start the Exchange Management Shell console and run the

Enable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService FrontEnd

Enable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService Hub

Enable-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Hub

commands, then restart the MSExchangeFrontEndTransport and MSExchangeTransport services to apply the changes:

Restart-Service MSExchangeFrontEndTransport

Restart-Service MSExchangeTransport

Exchange 2013

The simplest way to enable ORF Transport Agents if they get disabled is uninstalling and reinstalling them using the Exchange Helper tool — see the related Help topic for detailed instructions.

Alternatively, you can use Exchange Management Shell commands (see the instructions under Disabling an ORF Transport Agent above: simply use the Enable-TransportAgent command instead of Disable-TransportAgent).

Exchange 2010/2007

Start the Exchange Management Shell console and run the

Enable-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent"

Enable-TransportAgent -Identity "Vamsoft ORF Routing Agent"

commands. Note that these changes will take effect only after restarting the MSExchangeTransport service:

Restart-Service MSExchangeTransport

Installing Transport Agents

If, for any reason, the ORF Transport Agents get uninstalled, follow the instructions described in the related Help topic to install them.

Changing the Agent Priority

Exchange 2019/2016


Edge Transport Server installation

On Exchange 2019/2016 Edge Transport servers, start the Exchange Management Shell console and run the

Set-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService Edge -Priority X

Set-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Edge -Priority X

commands, where X is the new priority. The highest priority is 1. Note that priority values are not absolute—if you have 4 transport agents and you change the priority of an agent from 4 to 3, the agent that previously had priority 3 will have priority 4.

Finally restart the MSExchangeTransport service to apply the changes:

Restart-Service MSExchangeTransport

Mailbox Server installation

On Exchange 2019/2016 Mailbox servers, start the Exchange Management Shell console and run the

Set-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService FrontEnd -Priority X

Set-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService Hub -Priority X

Set-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Hub -Priority X

commands, where X is the new priority. The highest priority is 1. Note that priority values are not absolute—if you have 4 transport agents and you change the priority of an agent from 4 to 3, the agent that previously had priority 3 will have priority 4.

Finally restart the MSExchangeTransport service to apply the changes:

Restart-Service MSExchangeFrontEndTransport

Restart-Service MSExchangeTransport

Exchange 2013


Edge Transport Server installation

On Exchange 2013 Edge Transport servers, start the Exchange Management Shell console and run the

Set-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Edge -Priority X

Set-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService Edge -Priority X

commands, where X is the new priority. The highest priority is 1. Note that priority values are not absolute—if you have 4 transport agents and you change the priority of an agent from 4 to 3, the agent that previously had priority 3 will have priority 4.

Finally restart the MSExchangeTransport service to apply the changes:

Restart-Service MSExchangeTransport

Client Access Server-only installation

If the Client Access server and Mailbox server roles are installed on separate servers, the *-TransportAgent commands issued from the Exchange Management Shell on a Client Access server will always run on the Mailbox server. To manage the Transport Agents of the CAS, you should start a regular PowerShell prompt and install an additional snap-in in order to run the *-TransportAgent commands on the local server. For more information, please consult this article ("TransportAgent cmdlets on Client Access servers require local Windows PowerShell" section).

To change the priority of the ORF Transport agent, run the

Set-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService FrontEnd -Priority X

command, then restart the MSExchangeFrontEndTransport service to apply the changes:

Restart-Service MSExchangeFrontEndTransport

Mailbox Server-only installation

Start the Exchange Management Shell console and run the

Set-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService Hub -Priority X

Set-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Hub -Priority X

commands, then restart the MSExchangeTransport service to apply the changes:

Restart-Service MSExchangeTransport

Single-server, mixed Client Access Server + Mailbox Server installation

When both roles (Client Access server and Mailbox) are installed on the same server, Transport Agent PowerShell commands require an additional TransportService parameter to specify which role the command should run on (FrontEnd = CAS, Hub = Mailbox).

To change the priorities, start the Exchange PowerShell console and run the

Set-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService FrontEnd -Priority X

Set-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -TransportService Hub -Priority X

Set-TransportAgent -Identity "Vamsoft ORF Routing Agent" -TransportService Hub -Priority X

commands respectively. Note that these changes will take effect only after restarting the related Exchange transport service(s):

Restart-Service MSExchangeTransport

Restart-Service MSExchangeFrontEndTransport

Exchange 2010/2007

Start the Exchange Management Shell console and run the

Get-TransportAgent | fl

command to get the list of transport agents installed on your system. To change the priority of the ORF Transport Agents, run the

Set-TransportAgent -Identity "Vamsoft ORF SMTP Receive Agent" -Priority X

Set-TransportAgent -Identity "Vamsoft ORF Routing Agent" -Priority X

commands, where X is the new priority. The highest priority is 1. Note that priority values are not absolute—if you have 4 transport agents and you change the priority of an agent from 4 to 3, the agent that previously had priority 3 will have priority 4.

Note that these changes will take effect only after restarting the MSExchangeTransport service:

Restart-Service MSExchangeTransport

Copyright © Vamsoft Kft. All rights reserved. Document ID ta-manage, version 4.