New Transport Rule operation

The New Transport Rule process creates the transport rule on a Hub Transport server. The rule rejects all messages sent between the FirstDistributionGroupName and SecondDistributionGroupName distribution groups. An NDR is sent to the sender of the messages that have the text RejectReason.

Note

The New Transport Rule operation supports Microsoft Exchange versions 2007, 2010, 2013, 2016, and 2019.

The adapter request parameters may differ according to the Microsoft Exchange Server version.

For the list of all supported parameters, refer to the New-TransportRule cmdlet in the Microsoft Exchange documentation specific to your version.

The following figure shows a sample adapter request for the New Transport Rule operation on Microsoft Exchange version 2019:

<microsoft-exchange-request>
   <command>
     <command-name>New-TransportRule</command-name>
     <format-option/>
     <verbose-logging/>
     <parameters>
       <parameter>
         <name>from</name>
         <value>KDG234@gmail.com</value>
       </parameter>
       <parameter>
         <name>RedirectMessageTo</name>
         <value>KDG121@gmail.com</value>
       </parameter>
       <parameter>
         <name>Name</name>
         <value>TransportRuleCrud</value>
       </parameter>
     </parameters>
   </command>
</microsoft-exchange-request>

The following figure shows the response for the adapter request:

<microsoft-exchange-response>
<metadata>
   <status>success</status>
</metadata>
<targets-output>
   <target-output host="clm-pun-020413.bmc.com">
     <metadata>
       <os-id>Windows Server 2008</os-id>
       <os-version>6.3.9600</os-version>
       <status>success</status>
     </metadata>
     <commands-output>
       <command-output>
         <metadata>
           <command>New-TransportRule -from:KDG234@gmail.com -RedirectMessageTo:KDG121@gmail.com -Name:TransportRuleCrud</command>
           <line-count>8</line-count>
           <execution-milliseconds>89730</execution-milliseconds>
           <exit-code>0</exit-code>
           <status>success</status>
         </metadata>
         <output>
           <line index="1">Attempting to connect to remote host...</line>
           <line index="2">Initialising rctrlx server component...</line>
           <line index="3">Executing remote application: cmd /c "echo . | powershell -PSConsoleFile "C:\Program Files\Microsoft\Exchange Server\V15\Bin\exshell.psc1" -NonInteractive -Command New-TransportRule -from:KDG234@gmail.com -RedirectMessageTo:KDG121@gmail.com -Name:TransportRuleCrud "</line>
           <line index="4">Stdout:</line>
           <line index="5">Name                     State    Mode        Priority Comments                </line>
           <line index="6">----                     -----    ----        -------- --------                </line>
           <line index="7">TransportRuleCrud        Enabled Enforce     2                                </line>
           <line index="8">Remote application exited with code: 0</line>
         </output>
       </command-output>
     </commands-output>
   </target-output>
</targets-output>
</microsoft-exchange-response>

New Transport Rule operation

On this page