How to: Create Exchange 5.5 Custom Recipients

This example shows how to provision a Microsoft Exchange 5.5 custom recipient object in Forefront Identity Manager Synchronization Service (FIM Synchronization Service).

Note

Microsoft Exchange 5.5 is deprecated.

Attribute Inclusion List

You must select the following attributes from the Select Attributes property page for your Exchange 5.5 management agent to provision an Exchange 5.5 custom recipient:

• uid

• cn

• rdn

• mail

• rfc822Mailbox

• textEncodedORaddress

• MAPI-Recipient

• Target-Address

Provisioning an Exchange Custom Recipient

The following examples show how to use a rules extension to provision an Exchange 5.5 custom recipient. You must add a reference to logging.dll to use the LogException method.

Public Sub Provision(ByVal mventry As MVEntry) Implements IMVSynchronization.Provision

      Dim ex55MA As ConnectedMA
      Dim csentry As CSEntry
      Dim nickName, displayName, smtpAddress, orAddress As String
      Dim dn As ReferenceValue

      Try
         'Provisioning based upon <tla rid="fim_syncdb_short" /> object type person
         If "person" = mventry.ObjectType Then

            ex55MA = mventry.ConnectedMAs("Fabrikam Ex55 MA")

            nickName    = mventry("mailNickname").Value
            displayName = mventry("DisplayName").Value
            smtpAddress = mventry("SMTPAddress").Value
            orAddress   = mventry("ORaddress").Value

            ' Construct the distinguished name.
            dn = ex55MA.EscapeDNComponent("CN=" + mventry("cn").Value).Concat("cn=Recipients,ou=fabrikam,o=com")

            If 0 = ex55MA.Connectors.Count Then
               csentry = ExchangeUtils.Create55CustomRecipient(ex55MA, dn, nickName, displayName, smtpAddress, orAddress)
            End If
         End If

         ' Log and rethrow any exception.
         ' You must include the logging DLL as a dependency.
      Catch ex As Exception
         Microsoft.MetadirectoryServices.Logging.Logging.LogException(ex, "Provision", "Caught exception", False)
         Throw
      End Try
   End Sub

void IMVSynchronization.Provision (MVEntry mventry)
       {
          ConnectedMA ex55MA;
          CSEntry csentry;
          String nickName, displayName, smtpAddress, orAddress;
          ReferenceValue dn;

          try
          {
             if( "person" == mventry.ObjectType )
             {
                ex55MA = mventry.ConnectedMAs["Fabrikam Ex55 MA"];

                nickName    = mventry["mailNickname"].Value;
                displayName = mventry["DisplayName"].Value;
                smtpAddress = mventry["SMTPAddress"].Value;
                orAddress   = mventry["ORaddress"].Value;

                // Construct the distinguished name.
                dn = ex55MA.EscapeDNComponent("CN=" + mventry["cn"].Value).Concat("cn=Recipients,ou=fabrikam,o=com");

                if(0 == ex55MA.Connectors.Count)
                {
                   csentry = ExchangeUtils.Create55CustomRecipient(ex55MA, dn, nickName, displayName, smtpAddress, orAddress);
                }
             }
          }

          // Log and rethrow any exception.
          catch(Exception ex)
          {
             Microsoft.MetadirectoryServices.Logging.Logging.LogException(ex, "Provision", "Caught exception", false);
             throw;
          }
       }

See Also

Reference

Create55CustomRecipient

Concepts

Microsoft Exchange Connected Data Sources