Set up the on-premises Intune Exchange connector

To help protect access to Exchange, Intune relies on an on-premises component that's known as the Microsoft Intune Exchange connector. This connector is also called the Exchange ActiveSync on-premises connector in some locations of the Intune console.

The information in this article can help you install and monitor the Intune Exchange connector. You can use the connector with your conditional access policies to allow or block access to your Exchange on-premises mailboxes.

The connector is installed and runs on your on-premises hardware. It discovers devices that connect to Exchange, communicating device information to the Intune service. The connector allows or blocks devices based on whether the devices are enrolled and compliant. These communications use the HTTPS protocol.

When a device tries to access your on-premises Exchange server, the Exchange connector maps Exchange ActiveSync (EAS) records in Exchange Server to Intune records to make sure the device is enrolled with Intune and complies with your device's policies. Depending on your conditional access policies, the device can be allowed or blocked. For more information, see What are common ways to use conditional access with Intune?

Both discovery and allow and block operations are done by using standard Exchange PowerShell cmdlets. These operations use the service account that's provided when the Exchange connector is initially installed.

Intune supports the installation of multiple Intune Exchange connectors per subscription. If you have more than one on-premises Exchange organization, you can set up a separate connector for each. However, only one connector can be installed for each Exchange organization.

Follow these general steps to set up a connection that enables Intune to communicate with the on-premises Exchange server:

  1. Download the on-premises connector from the Intune portal.
  2. Install and configure the Exchange connector on a computer in the on-premises Exchange organization.
  3. Validate the Exchange connection.
  4. Repeat these steps for each additional Exchange organization you want to connect to Intune.

Intune Exchange connector requirements

To connect to Exchange, you need an account that has an Intune license that the connector can use. You specify the account when you install the connector.

The following table lists the requirements for the computer on which you install the Intune Exchange connector.

Requirement More information
Operating systems Intune supports the Intune Exchange connector on a computer that runs any edition of Windows Server 2008 SP2 64-bit, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, or Windows Server 2016.

The connector isn't supported on any Server Core installation.
Microsoft Exchange On-premises connectors require Microsoft Exchange 2010 SP3 or later or legacy Exchange Online Dedicated. To determine if your Exchange Online Dedicated environment is in the new or legacy configuration, contact your account manager.
Mobile device management authority Set the mobile device management authority to Intune.
Hardware The computer on which you install the connector requires a 1.6 GHz CPU with 2 GB of RAM and 10 GB of free disk space.
Active Directory synchronization Before you use the connector to connect Intune to your Exchange server, set up Active Directory synchronization. Your local users and security groups must be synced with your instance of Azure Active Directory.
Additional software The computer that hosts the connector must have a full installation of Microsoft .NET Framework 4.5 and Windows PowerShell 2.0.
Network The computer on which you install the connector must be in a domain that has a trust relationship with the domain that hosts your Exchange server.

Configure the computer to allow it to access the Intune service through firewalls and proxy servers over ports 80 and 443. Intune uses these domains:
- manage.microsoft.com
- *manage.microsoft.com
- *.manage.microsoft.com

The Intune Exchange connector communicates with the following services:
- Intune service: HTTPS port 443
- Exchange Client Access server (CAS): WinRM service port 443
- Exchange Autodiscover 443
- Exchange Web Services (EWS) 443

Exchange cmdlet requirements

Create an Active Directory user account for the Intune Exchange connector. The account must have permission to run the following Windows PowerShell Exchange cmdlets:

  • Get-ActiveSyncOrganizationSettings, Set-ActiveSyncOrganizationSettings
  • Get-CasMailbox, Set-CasMailbox
  • Get-ActiveSyncMailboxPolicy, Set-ActiveSyncMailboxPolicy, New-ActiveSyncMailboxPolicy, Remove-ActiveSyncMailboxPolicy
  • Get-ActiveSyncDeviceAccessRule, Set-ActiveSyncDeviceAccessRule, New-ActiveSyncDeviceAccessRule, Remove-ActiveSyncDeviceAccessRule
  • Get-ActiveSyncDeviceStatistics
  • Get-ActiveSyncDevice
  • Get-ExchangeServer
  • Get-ActiveSyncDeviceClass
  • Get-Recipient
  • Clear-ActiveSyncDevice, Remove-ActiveSyncDevice
  • Set-ADServerSettings
  • Get-Command

Download the installation package

On a Windows server that can support the Intune Exchange connector:

  1. Sign in to the Microsoft Endpoint Manager Admin Center. Use an account that's an administrator in the on-premises Exchange server and that has a license to use Exchange Server.

  2. Select Tenant administration > Exchange access.

  3. Under Setup, choose Exchange ActiveSync on-premises connector and then select Add.

  4. On the Add Connector page, select Download the on-premises connector. The Intune Exchange connector is in a compressed (.zip) folder that can be opened or saved. In the File Download dialog box, choose Save to store the compressed folder in a secure location.

Install and configure the Intune Exchange connector

Follow these steps to install the Intune Exchange connector. If you have multiple Exchange organizations, repeat the steps for each Exchange connector you want to set up.

  1. On a supported operating system for the Intune Exchange connector, extract the files in Exchange_Connector_Setup.zip to a secure location.

    Important

    Don't rename or move the files that are in the Exchange_Connector_Setup folder. These changes would cause the connector installation to fail.

  2. After the files are extracted, open the extracted folder and double-click Exchange_Connector_Setup.exe to install the connector.

    Important

    If the destination folder isn't a secure location, delete the certificate file MicrosoftIntune.accountcert when you finish installing your on-premises connectors.

  3. In the Microsoft Intune Exchange Connector dialog box, select either On-premises Microsoft Exchange Server or Hosted Microsoft Exchange Server.

    Image showing where to choose your Exchange Server type

    For an on-premises Exchange server, provide either the server name or the fully qualified domain name of the Exchange server that hosts the Client Access Server role.

    For a hosted Exchange server, provide the Exchange server address. To find the hosted Exchange server URL:

    1. Open Outlook for Office 365.

    2. Choose the ? icon in the upper-left corner, and then select About.

    3. Locate the POP External Server value.

    4. Choose Proxy Server to specify proxy server settings for your hosted Exchange server.

      1. Select Use a proxy server when synchronizing mobile device information.

      2. Enter the proxy server name and the port number to be used to access the server.

      3. If user credentials are required to access the proxy server, select Use credentials to connect to the proxy server. Then enter the domain\user and the password.

      4. Choose OK.

  4. In the User (domain\user) and Password fields, enter credentials to connect to your Exchange server. The account you specify must have a license to use Intune.

  5. Provide credentials to send notifications to a user's Exchange Server mailbox. This user can be dedicated to just notifications. The notifications user needs an Exchange mailbox to send notifications by email. You can configure these notifications by using conditional access policies in Intune.

    Make sure the Autodiscover service and Exchange Web Services are configured on the Exchange CAS. For more information, see Client Access server.

  6. In the Password field, provide the password for this account to enable Intune to access the Exchange server.

    Note

    The account you use to sign in to the tenant needs to be at least an Intune service administrator. Without this administrator account, you'll get a failed connection with the error "The remote server returned an error: (400) Bad Request".

  7. Choose Connect.

    Note

    It might take a few minutes to configure the connection.

During configuration, the Exchange connector stores your proxy settings to enable access to the internet. If your proxy settings change, reconfigure the Exchange connector to apply the updated proxy settings to the Exchange connector.

After the Exchange connector sets up the connection, mobile devices that are associated with Exchange-managed users are automatically synchronized and added to the Exchange connector. This synchronization might take some time to finish.

Note

If you install the Intune Exchange connector and later need to delete the Exchange connection, you must uninstall the connector from the computer where it was installed.

Install connectors for multiple Exchange organizations

Intune supports multiple Intune Exchange connectors per subscription. For a tenant that has multiple Exchange organizations, you can set up only one connector for each Exchange organization.

To install connectors to connect to multiple Exchange organizations, download the .zip folder one time. Reuse that same download for each connector you install. For each additional connector, follow the steps in the previous section to extract and run the setup program on a server in the Exchange organization.

Each Exchange organization that connects to Intune supports high availability, monitoring, and manual sync. The following sections describe these features.

On-premises Intune Exchange connector high availability support

For the on-premises connector, high availability means that if the Exchange CAS that the connector uses becomes unavailable, the connector can switch to a different CAS for that Exchange organization. The Exchange connector itself doesn't support high availability. If the connector fails, there's no automatic failover. You must install a new connector to replace the failed connector.

To fail over, the connector uses the specified CAS to create a successful connection to Exchange. It then discovers additional CASs for that Exchange organization. This discovery enables the connector to fail over to another CAS if one is available, until the primary CAS becomes available.

By default, discovery of additional CASs is enabled. If you need to turn off failover:

  1. On the server where the Exchange connector is installed, go to %ProgramData%\Microsoft\Windows Intune Exchange Connector.

  2. Using a text editor, open OnPremisesExchangeConnectorServiceConfiguration.xml.

  3. Change <IsCasFailoverEnabled>true</IsCasFailoverEnabled> to <IsCasFailoverEnabled>false</IsCasFailoverEnabled>.

Performance-tune the Exchange connector (optional)

When Exchange ActiveSync supports 5,000 or more devices, you can configure an optional setting to improve the performance of the connector. You improve performance by enabling Exchange to use multiple instances of a PowerShell command run space.

Before you make this change, ensure the account you use to run the Exchange connector isn't used for other Exchange management purposes. An Exchange account has a limited number of run spaces, and the connector will use most of them.

Performance tuning isn't suitable for connectors that run on older or slower hardware.

To improve the Exchange connector performance:

  1. On the server where the connector installed, open the connector's installation directory. The default location is C:\ProgramData\Microsoft\Windows Intune Exchange Connector.

  2. Edit the file OnPremisesExchangeConnectorServiceConfiguration.xml.

  3. Locate EnableParallelCommandSupport and set the value to true:

    <EnableParallelCommandSupport>true</EnableParallelCommandSupport>

  4. Save the file, and then restart the Microsoft Intune Exchange connector service.

Reinstall the Intune Exchange connector

You might need to reinstall an Intune Exchange connector. Because only a single connector can connect to each Exchange organization, if you install a second connector for the organization, the new connector you install replaces the original connector.

  1. To install the new connector, follow the steps in the Install and configure the Exchange connector section.

  2. When prompted, select Replace to install the new connector. Configuration warning to replace a connector

  3. Continue the steps from the Install and configure the Intune Exchange connector section, and sign in to Intune again.

  4. In the final window, select Close to finish the installation. Finish setup

Monitor an Exchange connector

After you successfully configure the Exchange connector, you can view the status of the connections and the last successful synchronization attempt.

To validate the Exchange connector connection:

  1. On the Intune dashboard, choose Exchange access.

  2. Select Exchange on-premises access to verify the connection status for each Exchange connector.

You can also check the time and date of the last successful synchronization attempt.

Beginning with the Intune 1710 release, you can use the System Center Operations Manager management pack for Exchange connector and Intune. The management pack offers different ways to monitor the Exchange connector when you need to troubleshoot issues.

Manually force a quick sync or full sync

An Intune Exchange connector automatically synchronizes EAS and Intune device records regularly. If the compliance status of a device changes, the automatic sync process regularly updates records so that device access can be blocked or allowed.

  • A quick sync occurs regularly, several times a day. A quick sync retrieves device information for Intune-licensed and on-premises Exchange users that are targeted for conditional access and that have changed since the last sync.

  • A full sync occurs once daily by default. A full sync retrieves device information for all Intune-licensed and on-premises Exchange users that are targeted for conditional access. A full sync also retrieves Exchange Server information and ensures that the configuration that Intune specifies in the Azure portal is updated on the Exchange server.

You can force a connector to run a sync by using the Quick Sync or Full Sync options on the Intune dashboard:

  1. On the Intune dashboard, choose Exchange access.

  2. Select Exchange on-premises access.

  3. Select the connector you want to sync, and then choose Quick Sync or Full Sync.

Next steps

Create a conditional access policy for on-premises Exchange servers.