Enable Mail Contact operation

The Enable Mail Contact process enables an existing contact in Active Directory through mail.

Note

The Enable Mail Contact operation supports Microsoft Exchange versions 2007, 2010, 2013 and 2016. 

The following figure shows a sample adapter request for the Enable Mail Contact operation on Microsoft Exchange version 2016:

<microsoft-exchange-request>
   <command>
     <command-name>Enable-MailContact</command-name>
     <format-option/>
     <verbose-logging />
     <parameters>
       <parameter>
         <name>Identity</name>
         <value>Allen</value>
       </parameter>
       <parameter>
         <name>ExternalEmailAddress</name>
         <value>allen@gmail.com</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>Enable-MailContact -Identity:Allen -ExternalEmailAddress:allen@gmail.com -confirm:$false</command>
           <line-count>8</line-count>
           <execution-milliseconds>67548</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 Enable-MailContact -Identity:Allen -ExternalEmailAddress:allen@gmail.com -confirm:$false "</line>
           <line index="4">Stdout:</line>
           <line index="5">Name                      Alias                      RecipientType             </line>
           <line index="6">----                      -----                      -------------             </line>
           <line index="7">Allen                     Allen                      MailContact               </line>
           <line index="8">Remote application exited with code: 0</line>
         </output>
       </command-output>
     </commands-output>
   </target-output>
 </targets-output>
</microsoft-exchange-response>

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

 

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