Updated 04/18/25: Based on customer feedback around challenges with setting up the connector with build 6.2501.2000.5, we have released an updated build with improved functionality and updated our troubleshooting documentation with more guidance on avoiding configuration issues in your environment. The new build 6.2504.2001.8 is available for download in Microsoft Intune.

New in build 6.2504.2001.8:

• The sign in page in the wizard now uses WebView2, built on Microsoft Edge, instead of the previously used WebBrowser.
• Error "MSA account <accountName> is not valid" which some customers reported during sign in has been fixed.
  
  

As part of Microsoft’s Secure Future Initiative, we’re making an important security change which will impact customers deploying Microsoft Entra hybrid joined devices with Windows Autopilot and provide guidance on how to prepare. New capabilities or improvements aren’t planned as part of this security change. Review Microsoft’s recommendations based on your organization’s needs.

Updated connector

Today, Windows Autopilot uses the Intune Connector for Active Directory to deploy devices that are Microsoft Entra hybrid joined. To strengthen security in our customers’ environments, we’ve updated the Intune Connector for Active Directory to use a Managed Service Account (MSA) instead of a SYSTEM account.

The old connector which uses the local SYSTEM account will no longer be available for download in Intune and will stop being supported in late June 2025. At that point, we’ll stop accepting enrollments from the old connector build. Follow the guidance provided below to update your environment to the new connector.

The old connector build will continue to work for existing customers who already have it installed until the end of support date and is available for download in the Microsoft Download Center if needed.

What is a Managed Service Account (MSA)?

MSAs are managed domain accounts that have automatic password management and are generally granted just enough permissions and privileges to perform their duties. Standalone MSAs can only be used on a single domain joined machine and can only access resources within that domain. An MSA can run services on a computer in a secure and easy to maintain manner, while maintaining the capability to connect to network resources as a specific user principal. All these reasons make them a better fit for the Intune Connector for Active Directory than the current SYSTEM account option.

Comparing the account permissions required between the new and old connector

Setting up the connector

Before you begin

First, you need to uninstall the existing connector by:

1. Uninstalling from the Settings app on Windows
2. Then, uninstalling using the ODJConnectorBootstrapper.exe (select Uninstall).

To install and set up the new connector, you need the following minimum requirements:

1. Downloading the connector build from Intune:
   1. Microsoft Entra account with Intune Service Administrator permissions
2. Installation:
   1. .Net 4.7.2
   2. Windows Server with 2008 R2 functional level
   3. Local administrator permissions
3. Setting up the connector:
   1. Microsoft Entra account with an Intune license assigned and Intune Service Administrator permission
   2. Domain account with local administrator privileges
      1. Domain account should have permission to create msDS-ManagedServiceAccount objects
         
         

Downloading the connector

You can download the new connector from the Intune admin center and install in your environment. To set it up, launch the connector wizard and choose Sign In and sign in with a Microsoft Entra account with Intune service admin permissions and you’ll notice a new Configure Managed Service Account option. After signing in, the connector will enroll and only the Configure Managed Service Account option will be available. The account with Intune admin permissions should select that option to complete set up. For more detailed steps on installing the connector, review: Install the Intune Connector.

Intune Connector for Active Directory installation shows the MSA has been configured.

Configuring organizational units (OUs) for domain join

By default, MSAs don’t have access to create computer objects in any OU. If you wish to use a custom OU for domain join, you’ll need to update the ODJConnectorEnrollmentWiazard.exe.config file. This can be done at any time (either before enrollment, or after the connector is enrolled):

2. Update ODJConnectorEnrollmentWizard.exe.config:
   1. Default location is “C:\Program Files\Microsoft Intune\ODJConnector\ODJConnectorEnrollmentWizard”
   2. Add all the OUs required in OrganizationalUnitsUsedForOfflineDomainJoin
   3. OU name should be the distinguished name (see Additional information section)
      
      Note that the MSA is only granted access to the OUs configured in this file (and the default Computers container). If any OUs are removed from this list, completing the rest of the steps will revoke access.
      A screenshot of the connector file with the included organizational units.

       

3. Open ODJConnectorEnrollmentWizard (or restart it if it was open) and select the “Configure Managed Service Account” button.
   A screenshot of the Intune connector for Active directory window with the "Configure Managed Service Account" button highlighted.

    

4. Success! – A pop up will appear showing success.
   A screenshot of the Intune connector for Active directory window with a successful pop-up highlighting that the setup was successful.

Using the Intune Connector with multiple domains

Customers who are already using the connector with more than one domain will be able to use the new connector by setting up a separate server per domain and installing a separate connector build for each domain.

Configuring the connector

1. The Intune Connector for Active Directory needs to be installed on each domain that you plan to use for domain join. If you need to have a second account redundancy, you will need to install the connector on a different server (in the same domain).
2. Follow the steps above to ensure the connector is configured correctly, and that the MSA has appropriate permissions on the desired OUs.
3. Ensure that all connectors are present in the in the Microsoft Intune admin center (Devices > Enrollment > Windows > under Windows Autopilot, select Intune Connector for Active Directory) and that the version is greater than 6.2501.2000.5:
   

   A list of Intune Connectors for Active Directory and their version in the Microsoft Intune admin center.

Configure Domain Join profile:

Follow the steps for configuring a domain join profile:

1. Create a domain join profile for each domain that you want to use for hybrid joining devices during Autopilot.
2. Target the domain join profile to the appropriate device groups.

Example of 2 domain join profiles targeted to different groups, with different domain names configured:

Example 1: Connector in domain F11.F1.com will only join domain F11.F1.com.

Example 1: Connector in domain F12.F1.com will only join domain F12.F1.com.

3. Expected result:
   1. Connector in domain F11.F1.com will only join domain F11.F1.com.
   2. Connector in domain F12.F1.com will only join domain F12.F1.com.

Additional information

Retrieving Organizational Unit Distinguished Name

If you need to customize the OUs that the MSA has access to, here are two easy methods to retrieve the distinguished name for these OUs:

Let’s assume we have the following structure:

Powershell

1. Get-ADOrganizationalUnit (ActiveDirectory) | Microsoft Learn
2. Get “=TestOUWithSpecialChars=”:
   1. PS Cmd: Get-ADOrganizationalUnit -Filter 'Name -like "*TestOUWithSpecialChar*"' | Format-Table Name, DistinguishedName
   2. Output: “OU=\=TestOUWithSpecialChars\=,DC=modesh2,DC=nttest,DC=microsoft,DC=com”
      1. Note, ‘=’ is escaped
3. Get “NestedOU”
   1. PS Cmd: Get-ADOrganizationalUnit -Filter 'Name -like "NestedOU"' | Format-Table Name, DistinguishedName
   2. Output: “OU=NestedOU,OU=\=TestOUWithSpecialChars\=,DC=modesh2,DC=nttest,DC=microsoft,DC=com”
   3. Note, ‘=’ is still escaped
      
      

Active Directory Users and Computers

1. Select “View” from the menu, and enable “Advanced Features”
2. Right click on the specific OU and click “Properties”
3. Navigate to the “Attribute Editor” tab
4. Select “distinguishedName” attribute and click “View”
   
   

Summary

The new connector aims to enhance security by reducing unnecessary privileges and permissions associated with the local SYSTEM account. This blog describes how to set up the new connector and configure it for your organization. Make sure to install the new connector by late June 2025 before the old connector becomes unsupported.

If you have any questions, leave a comment on this post or reach out to us on X @IntuneSuppTeam.

Post updates:
04/18/25: Updated post with a note on our release of our latest build, version 6.2504.2001.8, improving user experience and system performance. Supportability for the old connector has also been updated to June 2025 (previously May).