This help section describes the process of managing ORF Transport Agents.
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).
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.
Both the Vamsoft ORF SMTP Receive Agent and the Vamsoft ORF Routing Agent are installed.
Only the Vamsoft ORF SMTP Receive Agent is installed.
Both the Vamsoft ORF SMTP Receive Agent and the Vamsoft ORF Routing Agent are installed.
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.
Start the Exchange Managment Shell console and run the
and/or the
command. Note that this change will take effect only after restarting the related Exchange transport service. To restart these services manually, use the
command.
On Exchange 2013 Edge Transport servers, start the Exchange Management Shell console and run the
and/or the
commands, then restart the MSExchangeTransport service to apply the changes:
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
command, then restart the MSExchangeFrontEndTransport service to apply the changes:
Start the Exchange Management Shell console and run the
and/or the
commands, then restart the MSExchangeTransport service to apply the changes:
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
Start the Exchange Management Shell console and run the
or the
command. Note that this change will take effect only after restarting the Exchange transport:
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).
If, for any reason, the ORF Transport Agents get uninstalled, follow the instructions described in the related Help topic to install them.
Start the Exchange Management Shell console and run the
command to get the list of transport agents installed on your system. To change the priority of the ORF Transport Agents, run the
or the
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.
On Exchange 2013 Edge Transport servers, start the Exchange Management Shell console and run the
and/or the
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:
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
command, then restart the MSExchangeFrontEndTransport service to apply the changes:
Start the Exchange Management Shell console and run the
and/or the
commands, then restart the MSExchangeTransport service to apply the changes:
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