[INFO-SYNCSERVICE] Export with Exchange Provisioning Enabled
Hello again! Tim Macaulay, SR. Support Escalation Engineer here with the Identity Support team at Microsoft. Today, I wanted to discuss a topic that I spend a lot of time discussing on the phone and thought I would share with the community. That topic is what happens when I run an Export on an Active Directory and/or GalSync Management Agent with Exchange Provisioning Enabled.
First, we must remember that an Export is always a delta. We only export changes. We can find more information on the Export Run Profile here. http://blogs.msdn.com/b/ms-identity-support/archive/2012/05/04/how-to-troubleshoot-and-test-the-export-process.aspx
How can I tell if Exchange Provisioning is enabled?
Exchange provisioning is found on the Configure Extensions Tab of the Active Directory and/or GalSync Management Agent. The Provision for drop-down displays three(3) entries.
- No Provisioning: No Exchange Provisioning is enabled
- Exchange 2007: Use this if you are provisioning Exchange 2007 related objects
- Exchange 2010: Use this if you are provisioning Exchange 2010 and/or Exchange 2013 related objects
What happens if Exchange provisioning is enabled?
The first thing that happens, is that we create the Active Directory object (User or Contact) object. In a GalSync Solution, this would be a mail-enabled contact object. Once the Active Directory Object is created, we call the Exchange PowerShell CMDLET called Update-Recipient. We do this differently depending on the version of Exchange that you are provisioning too.
Exchange 2007
*NOTE: If you are provisioning to Exchange 2007, you must have the Exchange 2007 Management Tools Service Pack 3 or later installed on the Synchronization Service machine.
Provisioning to Exchange 2007, we call the Exchange PowerShell CMDLET Update-Recipient locally on the Synchronization Service machine.
Exchange 2010
We do the same for provisioning to Exchange 2010 and/or Exchange 2013.
Provisioning to Exchange 2010 and/or Exchange 2013, we call the Exchange PowerShell CMDLET Update-Recipient remotely using WinRM. The Exchange PowerShell CMDLET lives on the Exchange Client Access Server (CAS). This is the reason that you need to enter a URI to reference the location of the Powershell vDir on the Exchange CAS server.
Prerequisites for Exchange Provisioning
Exchange 2007: Active Directory and/or GalSync Management Agent Account must be a part of the Exchange Recipient Administrators Security Group
Additional Information for Exchange 2007 Provisioning:
Exchange 2010/2013: Active Directory and/or GalSync Management Agent Account must be a part of the Exchange Organization Management Security Group
Exchange 2010/2013: Must reference the correct URI to the Exchange CAS server
Additional Information for Exchange 2010 Provisioning:
Troubleshooting Exchange Provisioning
In most cases, if we fail with Exchange Provisioning enabled, we will see ma-extension-error or something similar when exporting.
- Application Event Log: The first place you want to go is to the Application Event Log. In the Application Event Log, you should see events that contain information on the failure. These event messages are normally very helpful in resolving the export issue.
- Permissions: Validate Active Directory and/or GalSync Management Agent User Account Permissions
- Exchange CAS: Validate the Exchange CAS URI information
- DNS: Validate DNS Connectivity
- We have seen issues to where the Active Directory and/or GalSync Management Agent has been configured to point to specific domain controllers in the target forest, but the DNS is configured to look at all of the domain controllers in the target forest. This will cause export issues.
Additional Resources
- [INFO] Testing, Troubleshooting and working with the Export Run Profile: http://blogs.msdn.com/b/ms-identity-support/archive/2012/05/04/how-to-troubleshoot-and-test-the-export-process.aspx
- Permissions for the GalSync User Account: http://social.technet.microsoft.com/wiki/contents/articles/4868.permissions-for-galsync-user-ma-user-account.aspx
- Exchange Update-Recipient: https://technet.microsoft.com/en-us/library/bb738148(v=exchg.160).aspx
- [INFO-SYNCSERVICE] Run Profile Optimization: http://blogs.technet.com/b/iamsupport/archive/2015/08/27/info-run-profile-optimization.aspx
- GALSync: Implementing Exchange Remote PowerShell Tools for FIM Galsync between 2 AD Forests: http://social.technet.microsoft.com/wiki/contents/articles/21759.galsync-implementing-exchange-remote-powershell-tools-for-fim-galsync-between-2-ad-forests.aspx
- Troubleshooting the Exchange Management Shell: https://technet.microsoft.com/en-us/library/dd351136(v=exchg.141).aspx