New Receive Connector operation


The New Receive Connector process creates a new Receive connector on a computer that has the Hub Transport server role or the Edge Transport server role installed. 

Note

The New Receive Connector 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 Receive Connector cmdlet in the Microsoft Exchange documentation
specific to your version.

The following figure shows a sample adapter request for the New Receive Connector operation for Microsoft Exchange version 2019:

<microsoft-exchange-request>
   <command>
     <command-name>New-ReceiveConnector</command-name>
     <format-option />
     <verbose-logging />
     <parameters>
       <parameter>
         <name>Name</name>
         <value>newTeRecieveconnector1</value>
       </parameter>
       <parameter>
         <name>RemoteIpRanges</name>
         <value>20.149.0.0-20.161.0.0</value>
       </parameter>
       <parameter>
         <name>Bindings</name>
         <value>0.0.0.0:25</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-ReceiveConnector -Name:newTeRecieveconnector1 -RemoteIpRanges:20.149.0.0-20.161.0.0 -Bindings:0.0.0.0:25 -confirm:$false</command>
           <line-count>8</line-count>
           <execution-milliseconds>50034</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-ReceiveConnector -Name:newTeRecieveconnector1 -RemoteIpRanges:20.149.0.0-20.161.0.0 -Bindings:0.0.0.0:25 -confirm:$false "</line>
           <line index="4">Stdout:</line>
           <line index="5">Identity                              Bindings     Enabled</line>
           <line index="6">--------                              --------     -------</line>
           <line index="7">CLM-PUN-020413\newTeRecieveconnector1 {0.0.0.0:25} True   </line>
           <line index="8">Remote application exited with code: 0</line>
         </output>
       </command-output>
     </commands-output>
   </target-output>
 </targets-output>
</microsoft-exchange-response>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*