Updated Connector
In brief
The documentation states that Intune Connector for Active Directory versions older than 6.2501.2000.5 are deprecated and can no longer process enrollment requests. It also notes that version 6.2504.2001.8 uses WebView2, removing the need to disable Internet Explorer Enhanced Security Configuration.
What Intune admins need to know
Upgrade connectors older than 6.2501.2000.5 to continue processing enrollments.
This summary was assembled from the tracked documentation change. Verify important details in the full Microsoft Learn article.
Documentation change
The comparison below shows only the changed extract. Use the full-page view for complete context.
Important
The Intune Connector for Active Directory versions older than 6.2501.2000.5 are deprecated and can no longer process enrollment requests. For more information, see the Intune Connector for Active Directory with low-privileged account for Windows Autopilot Hybrid Microsoft Entra join deployments blog post.
To update the connector, you must:
- Manually uninstall the legacy connector. There isn't an automatic option.
- Download and install the updated
connector (describedconnector, as described in thisarticle).article.
Tip
If usingyou use multiple domains to enroll Autopilot devices:
- You
'dneed a separate connector instance for each domain. A connector can only process enrollment requests for the same domain as the server it was installed on. - There can be at most
1one connector perserver (VMserver, whether virtual machine orphysical). Additionalphysical. You can set up more servers per domaincan be set upfor redundancy, each with its own connector installed. In that setup, if one connector fails, the requestswillgo to another connector on another serverwithinin the same domain.
Select the tab that corresponds to the version of the Intune Connector for Active Directory that is being installed:you want to install:
Updated Connector
Before you begin
Before you install,
make sureensure thatall ofyou meet the Intune connector for Active Directory server requirementsare met..Microsoft recommends
(not required)(but doesn't require) that the administratorinstallingwho installs andconfiguringconfigures the Intune Connector for Active Directory has the domain rights listed in Intune Connector for Active Directory requirements. These rights allow the Intune Connector for Active Directory installer and configuration process to set permissions for the Managed Service Account (MSA) on the Computer container or OUs where computer objects are created.If the administrator lacks these permissions, another administrator with the appropriate rights must Increase the computer account limit in the Organizational Unit (OU).
Turn off Internet Explorer Enhanced Security Configuration
Starting with version 6.2504.2001.8, the updated Intune Connector for Active Directory switched to using WebView2, built on Microsoft Edge, instead of WebBrowser, built on Microsoft Internet Explorer. This change means that you no longer need to turn off the Internet Explorer Enhanced Security Configuration setting in Windows Server no longer needs to be turned off.Server. Make sure to install version 6.2504.2001.8 or later of the Intune Connector for Active Directory to avoid issues with the Internet Explorer Enhanced Security Configuration setting.
Download the Intune Connector for Active Directory
- On the server where you're installing the Intune Connector for Active
Directory is being installed,Directory, sign in to the Microsoft Intune admin center. - In the Home screen,
selectDevicesin the lefthand pane.pane, select Devices. - In the Devices | Overview screen, under By platform, select Windows.
- In the Windows | Windows devices screen, under Device onboarding, select Enrollment.
- In the Windows | Windows enrollment screen, under Windows Autopilot, select Intune Connector for Active Directory.
- In the Intune Connector for Active Directory screen, select Add.
- In the Add connector
window that opens,window, under Configuring the Intune Connector for Active Directory, select Download the on-premises Intune Connector for Active Directory. The link downloads a file calledODJConnectorBootstrapper.exe.
Install the Intune Connector for Active Directory on the server
Important
TheYou need to install the Intune Connector for Active Directory installation needs to be done with an account that has the following domain rights:
- Required
-: Create msDs-ManagedServiceAccount objects in the Managed Service Accounts container. - Optional
-: Modify permissions in OUs in ActiveDirectory - ifDirectory. If the administratorinstallingwho installs the updated Intune Connector for Active Directory doesn't have this right,additional configuration steps are required byan administrator who has theserights.rights needs to perform additional configuration steps. For more information, see thestep/section Increase the computer account limit in the Organizational Unit.
Sign in to the server where you're installing the Intune Connector for Active Directory
is being installedwith an account that has local administrator rights.If the previous legacy Intune Connector for Active Directory is installed, uninstall it
firstbeforeinstallingyou install the updated Intune Connector for Active Directory. For more information, see Uninstall the Intune Connector for Active Directory.Important
When
uninstallingyou uninstall the previous legacy Intune Connector for Active Directory,make sure toensure you run the legacy Intune Connector for Active Directory installer as part of the uninstall process. If the legacy Intune Connector for Active Directory installer prompts to Uninstall it when it's run,runs, select to uninstall it. This step ensures that the previous legacy Intune Connector for Active Directory is fully uninstalled.TheYou can download the legacy Intune Connector for Active Directory installercan be downloadedfrom Intune Connector for Active Directory.Tip
In domains with only a single Intune Connector for Active Directory, Microsoft recommends first installing the updated Intune Connector for Active Directory on another server.
InstallingYou should install the updated Intune Connector for Active Directory on another servershould be donebeforeuninstallingyou uninstall the legacy Intune Connector for Active Directory on the current server.InstallingBy installing the Intune Connector for Active Directory on anotherfirst avoidsserver first, you avoid any downtime while the Intune Connector for Active Directory isbeing updatedupdating on the current server.Open the
ODJConnectorBootstrapper.exefile that you downloaded to launch the Intune Connector for Active Directory Setup install.Step through the Intune Connector for Active Directory Setup install.
At the end of the install, select
the checkboxLaunch Intune Connector for Active Directory.Note
If you accidentally close Intune Connector for Active Directory Setup install
is accidentally closedwithout selectingthe checkboxLaunch Intune Connector for Active Directory, you can reopen the Intune Connector for Active Directory configurationcan be reopenedby selecting Intune Connector for Active Directory > Intune Connector for Active Directory from the Start menu.
Sign in to the Intune Connector for Active Directory
In
theIntune Connector for Active Directorywindow,, under the Enrollment tab, select Sign In.UnderIn the Sign In tab, sign in with the Microsoft Entra ID credentials of an Intune administrator role. The user account must have an assigned Intune license. The sign in process might take a few minutes to complete.Note
The account
usedyou use to enroll the Intune Connector for Active Directory is only a temporary requirement at the time of installation. The account isn't used going forward after the server is enrolled.OnceAfter the sign in process completes:- The Intune Connector for Active Directory successfully enrolled confirmation window appears. Select OK to close the window.
- A Managed Service Account with name "<MSA_name>" was successfully set up confirmation window appears. The name of the MSA is in the format
msaODJ#####, where ##### are five random characters.NotateNote the name of the MSA that was created, and then select OK to close the window.TheYou might need the name of the MSAmight be neededlater to configure the MSA to allow creating computer objects in OUs.
The Enrollment tab shows Intune Connector for Active Directory is enrolled. The Sign In button is greyed out and Configure Managed Service Account is enabled.
Close the Intune Connector for Active Directory window.
Verify the Intune Connector for Active Directory is active
After authenticating,you authenticate, the Intune Connector for Active Directory finishes installing. Once it finishes installing,When the installation finishes, verify that it's active in Intune by following these steps:
Go to the Microsoft Intune admin center if it's still open. If the Add connector window is still displayed, close it.
If the Microsoft Intune admin center isn't still open:
- Sign in to the Microsoft Intune admin center.
- In the Home screen,
selectDevicesin the lefthand pane.pane, select Devices. - In the Devices | Overview screen, under By platform, select Windows.
- In the Windows | Windows devices screen, under Device onboarding, select Enrollment.
- In the Windows | Windows enrollment screen, under Windows Autopilot, select Intune Connector for Active Directory.
In the Intune Connector for Active Directory page:
- Confirm that the server is displayed under Connector name and shows as Active under Status.
- For the updated Intune Connector for Active Directory, make sure the version is greater than or equal to 6.2501.2000.5.
If the server isn't displayed, select Refresh or navigate away from the page, and then
navigatego back to the Intune Connector for Active Directory page.
Note
- It can take several minutes for the newly enrolled server to appear in the Intune Connector for Active Directory page of the Microsoft Intune admin center. The enrolled server only appears if it can successfully communicate with the Intune service.
- Inactive Intune Connectors for Active Directory still appear in the Intune Connector for Active Directory page and
willis automaticallybecleaned up after 30 days.
After you install the Intune Connector for Active Directory is installed,Directory, it will startstarts logging in the Event Viewer under the path Applications and Services Logs > Microsoft > Intune > ODJConnectorService. Under this path, you can find Admin and Operational logs can be found.logs.
Configure the MSA to allow creating objects in OUs (optional)
By default, MSAs only have access to create computer objects in the Computers container. MSAs don't have access to create computer objects in Organizational Units (OUs). To allow the MSA to create objects in OUs, the OUsyou need to be addedadd the OUs to the ODJConnectorEnrollmentWizard.exe.config XML file found in ODJConnectorEnrollmentWizard directory where theyou installed Intune Connector for Active Directory was installed,Directory, normally C:\Program Files\Microsoft Intune\ODJConnector\.
To configure the MSA to allow creating objects in OUs, follow these steps:
On the server where the Intune Connector for Active Directory is installed, navigate to the
ODJConnectorEnrollmentWizarddirectory where the Intune Connector for Active Directorywasis installed, normallyC:\Program Files\Microsoft Intune\ODJConnector\.In the
ODJConnectorEnrollmentWizarddirectory, open the existingODJConnectorEnrollmentWizard.exe.configXML file in a text editor,for example,such as Notepad.In the
add keyelement of theODJConnectorEnrollmentWizard.exe.configXML file:- Next to
value=, addinany desired OUs that the MSA should have access to create computer objects in. - The OU name needs to be in the LDAP distinguished name format and if applicable, needs to be escaped.
MultipleSeparate multiple OUsare supported by separating each OUwith a semicolon (;).Make sure to retainRetain the quotes (") next tovalue=. All of the OU values need to bewithinin one pair of quotes.- Don't change the name of the key element
OrganizationalUnitsUsedForOfflineDomainJoin.
The following example is an example XML entry with multiple OUs in LDAP distinguished name format:
Tip
In the following example, replace the example red text next to
value=withtheyour organization's OUs in LDAP distinguished name format. As shown in the example,make sureensure all OU entries are within the quotes (") and that each OU is separated with a semicolon (;).- Next to
OnceAfter you add all desiredOUs are added,OUs, save theODJConnectorEnrollmentWizard.exe.configXML file.As an administrator
that haswith appropriate permissions to modify OU permissions, open the Intune Connector for Active Directory bynavigatinggoing to Intune Connector for Active Directory > Intune Connector for Active Directory from the Start menu.Important
If the administrator installing and configuring the Intune Connector for Active Directory doesn't have permissions to modify OU permissions,
thenan administrator who has permissions to modify OU permissions needs to follow thesection/steps in Increase the computer account limit in the Organizational Unitneed to be followed instead by an administrator that does have permissions to modify OU permissions..UnderIn the Enrollment tab in the Intune Connector for Active Directory window, select Configure Managed Service Account.An A Managed Service Account with name "<MSA_name>" was successfully set up confirmation window appears. Select OK to close the window.
Use a custom Managed Service Account (optional)
- If using sMSA, the account can only be linked to a single machine.
- If using a gMSA, the server you’re installing the gMSA on needs to have access to the password.
- Service account needs to have local Log On as a Service permission which could be set directly or
viaby group membership. For more information, see Enable service logon. - Permission needs to be granted manually for service accounts to create computer objects for hybrid Autopilot flows. For more information, see Increase the computer account limit in the Organizational Unit (OU).
How to set up
Disable OU updates
UsingIf you use your own MSA will disableMSA, the connector from makingdoesn't make any OU updates, regardless of any configured in OrganizationalUnitsUsedForOfflineDomainJoin.even if you configure OrganizationalUnitsUsedForOfflineDomainJoin. To prevent errors, disable OU updates by updating ODJConnectorEnrollmentWizard.exe.config. ItsThe default location is C:\Program Files\Microsoft Intune\ODJConnector\ODJConnectorEnrollmentWizard.
- In the appSettings section of the file, add the following line:
Legacy Connector
Important
The legacy Intune Connector for Active Directory is deprecated. These instructions assume that the legacy Intune Connector for Active Directory is already installed or is already downloaded. If you don't have the legacy Intune Connector for Active Directory installer isn't already downloaded,installer, you can download it can be downloaded from Intune Connector for Active Directory.
However, best practice is to download and install the updated Intune Connector for Active Directory. For more information, select the Updated Connector tab instead.
Before beginningyou begin the installation, make sure that you meet all of the Intune connector for Active Directory server requirements are met..
Disable Internet Explorer Enhanced Security Configuration
By defaultdefault, Windows Server has Internet Explorer Enhanced Security Configuration turned on. Internet Explorer Enhanced Security Configuration might cause problems signing in to the Intune Connector for Active Directory. SinceBecause Internet Explorer is deprecated and in most instances, not even installed on Windows Server, Microsoft recommends turning off Internet Explorer Enhanced Security Configuration. To turn off Internet Explorer Enhanced Security Configuration:
Sign in to the server where you're installing the Intune Connector for Active Directory
is being installedwith an account that has local administrator rights and domain admin rights.DomainYou need domain admin rightsare requiredsothatthe Intune Connector for Active Directory installer can properly create an MSA.Open Server Manager.
In the left pane of Server Manager, select Local Server.
In the right PROPERTIES pane of Server Manager, select the On or Off link next to IE Enhanced Security Configuration.
Note
If
anyou want to install in a location other than the default of C:\Program Files\Microsoft Intune\ODJConnectoris desired,, select Options and specify the desired install location.When the install
completes,finishes, select Configure Now in the Intune Connector for Active Directory Setup installer window.Note
If you accidentally select Close
is accidentally selectedor close the Intune Connector for Active Directory Setup installerwindow is accidentally closed,window, you can access the Intune Connector for Active Directory configurationcan be accessedby selecting Intune Connector for Active Directory > Intune Connector for Active Directory from the Start menu.
Sign in to the legacy Intune Connector
In the Intune Connector for Active Directory window, under
theEnrollmenttab,, select Sign In.UnderIn the Sign In tab, sign in with the credentials of an Intune administrator role. The user account must have an assigned Intune license. The sign in process might take a few minutes to complete.Note
The account used to enroll the Intune Connector for Active Directory is only a temporary requirement at the time of installation. The account isn't used going forward after the server is enrolled.
Once theAfter you signin process is complete,in, a The Intune Connector for Active Directory successfully enrolled confirmation window appears. Select OK to close the window.The Enrollment tab shows Intune Connector for Active Directory is enrolled and the Sign In button is greyed out.
Close the Intune Connector for Active Directory window.
Verify the legacy Intune Connector for Active Directory is active
After authenticating, the Intune Connector for Active Directory finishes installing. OnceAfter it finishes installing, verify that it's active in Intune by following these steps:
Go to the Microsoft Intune admin center if it's still open. If the Add connector window is still displayed, close it.
If the Microsoft Intune admin center isn't still open:
- Sign in to the Microsoft Intune admin center.
- In the Home screen,
selectDevicesin the lefthand pane.pane, select Devices. - In the Devices | Overview screen, under By platform, select Windows.
- In the Windows | Windows devices screen, under Device onboarding, select Enrollment.
- In the Windows | Windows enrollment screen, under Windows Autopilot, select Intune Connector for Active Directory.
In the Intune Connector for Active Directory page, confirm that the server is displayed under Connector name and shows as Active under Status. If the server isn't displayed, select Refresh or navigate away from the page, and then
navigatego back to the Intune Connector for Active Directory page.
Note
- It can take several minutes for the newly enrolled server to appear in the Intune Connector for Active Directory page of the Microsoft Intune admin center. The enrolled server only appears if it can successfully communicate with the Intune service.
- Inactive Intune Connectors for Active Directory still appear in the Intune Connector for Active Directory page and
willare automaticallybecleaned up after 30 days.
After the Intune Connector for Active Directory is installed, it will startstarts logging in the Event Viewer under the path Applications and Services Logs > Microsoft > Intune > ODJConnectorService. Under this path, you can find Admin and Operational logs can be found.logs.
@@ -34,11 +34,13 @@ monikers: [] item_type: Content source_path: autopilot/tutorial/pre-provisioning/hybrid-azure-ad-join-intune-connector.md cmProducts:-- https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/37da4cc9-0cfc-42a9-ba5e-805706b01ef8+- https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/a72e95ff-4b4f-4cc1-90c6-7dcba67ff05f - https://authoring-docs-microsoft.poolparty.biz/devrel/b1cfdec6-b0c3-4209-818c-736879856e0e+- https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/37da4cc9-0cfc-42a9-ba5e-805706b01ef8 spProducts:-- https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/3661fb96-d414-4a4e-b7ad-9370637790dd+- https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/24dc3ccd-591a-4415-a1fe-8759afafcb12 - https://authoring-docs-microsoft.poolparty.biz/devrel/2d0723c1-cf38-4c30-ab3d-5df787b33270+- https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/3661fb96-d414-4a4e-b7ad-9370637790dd platformId: 2fe73af9-1780-197f-a97f-7d6d226aa442 --- @@ -72,127 +74,128 @@ The **Intune Connector for Active Directory**, also known as the Offline Domain
Important
-The Intune Connector for Active Directory versions older than 6.2501.2000.5 are deprecated and can no longer process enrollment requests. For more information, see the [Intune Connector for Active Directory with low-privileged account for Windows Autopilot Hybrid Microsoft Entra join deployments](https://aka.ms/Intune-Connector-blog) blog post.
+Intune Connector for Active Directory versions older than 6.2501.2000.5 are deprecated and can no longer process enrollment requests. For more information, see the [Intune Connector for Active Directory with low-privileged account for Windows Autopilot Hybrid Microsoft Entra join deployments](https://aka.ms/Intune-Connector-blog) blog post.
To update the connector, you must:
1. Manually uninstall the legacy connector. There isn't an automatic option.
-2. Download and install the updated connector (described in this article).
+2. Download and install the updated connector, as described in this article.
Tip
-If using multiple domains to enroll Autopilot devices:
+If you use multiple domains to enroll Autopilot devices:
-- You'd need a separate connector instance for each domain. A connector can only process enrollment requests for the same domain as the server it was installed on.
-- There can be at most 1 connector per server (VM or physical). Additional servers per domain can be set up for redundancy, each with its own connector installed. In that setup, if one connector fails, the requests will go to another connector on another server within the same domain.
+- You need a separate connector instance for each domain. A connector can only process enrollment requests for the same domain as the server it was installed on.
+- There can be at most one connector per server, whether virtual machine or physical. You can set up more servers per domain for redundancy, each with its own connector installed. In that setup, if one connector fails, the requests go to another connector on another server in the same domain.
-Select the tab that corresponds to the version of the Intune Connector for Active Directory that is being installed:
+Select the tab that corresponds to the version of the Intune Connector for Active Directory that you want to install:
# [Updated Connector](#tab/updated-connector)
#### Before you begin
-- Before you install, make sure that all of the [Intune connector for Active Directory server requirements](/en-us/autopilot/windows-autopilot-hybrid?tabs=intune-connector-requirements#requirements) are met.
-- Microsoft recommends (not required) that the administrator installing and configuring the Intune Connector for Active Directory has the domain rights listed in [Intune Connector for Active Directory requirements](../../windows-autopilot-hybrid?tabs=intune-connector-requirements#requirements). These rights allow the Intune Connector for Active Directory installer and configuration process to set permissions for the Managed Service Account (MSA) on the **Computer** container or OUs where computer objects are created.
+- Before you install, ensure that you meet the [Intune connector for Active Directory server requirements](/en-us/autopilot/windows-autopilot-hybrid?tabs=intune-connector-requirements#requirements).
+- Microsoft recommends (but doesn't require) that the administrator who installs and configures the Intune Connector for Active Directory has the domain rights listed in [Intune Connector for Active Directory requirements](../../windows-autopilot-hybrid?tabs=intune-connector-requirements#requirements). These rights allow the Intune Connector for Active Directory installer and configuration process to set permissions for the Managed Service Account (MSA) on the **Computer** container or OUs where computer objects are created.
If the administrator lacks these permissions, another administrator with the appropriate rights must [Increase the computer account limit in the Organizational Unit (OU)](../../windows-autopilot-hybrid?tab=updated-connector#increase-the-computer-account-limit-in-the-organizational-unit).
#### Turn off Internet Explorer Enhanced Security Configuration
-Starting with version **6.2504.2001.8**, the updated Intune Connector for Active Directory switched to using WebView2, built on Microsoft Edge, instead of WebBrowser, built on Microsoft Internet Explorer. This change means that the Internet Explorer Enhanced Security Configuration setting in Windows Server no longer needs to be turned off. Make sure to install version **6.2504.2001.8** or later of the Intune Connector for Active Directory to avoid issues with the Internet Explorer Enhanced Security Configuration setting.
+Starting with version **6.2504.2001.8**, the updated Intune Connector for Active Directory switched to using WebView2, built on Microsoft Edge, instead of WebBrowser, built on Microsoft Internet Explorer. This change means that you no longer need to turn off the Internet Explorer Enhanced Security Configuration setting in Windows Server. Make sure to install version **6.2504.2001.8** or later of the Intune Connector for Active Directory to avoid issues with the Internet Explorer Enhanced Security Configuration setting.
#### Download the Intune Connector for Active Directory
-1. On the server where the Intune Connector for Active Directory is being installed, sign in to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431).
-2. In the **Home** screen, select **Devices** in the left hand pane.
+1. On the server where you're installing the Intune Connector for Active Directory, sign in to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431).
+2. In the **Home** screen, in the left pane, select **Devices**.
3. In the **Devices | Overview** screen, under **By platform**, select **Windows**.
4. In the **Windows | Windows devices** screen, under **Device onboarding**, select **Enrollment**.
5. In the **Windows | Windows enrollment** screen, under **Windows Autopilot**, select **Intune Connector for Active Directory**.
6. In the **Intune Connector for Active Directory** screen, select **Add**.
-7. In the **Add connector** window that opens, under **Configuring the Intune Connector for Active Directory**, select **Download the on-premises Intune Connector for Active Directory**. The link downloads a file called `ODJConnectorBootstrapper.exe`.
+7. In the **Add connector** window, under **Configuring the Intune Connector for Active Directory**, select **Download the on-premises Intune Connector for Active Directory**. The link downloads a file called `ODJConnectorBootstrapper.exe`.
#### Install the Intune Connector for Active Directory on the server
Important
-The Intune Connector for Active Directory installation needs to be done with an account that has the following domain rights:
+You need to install the Intune Connector for Active Directory with an account that has the following domain rights:
-- **Required** - Create **msDs-ManagedServiceAccount** objects in the Managed Service Accounts container.
-- **Optional** - Modify permissions in OUs in Active Directory - if the administrator installing the updated Intune Connector for Active Directory doesn't have this right, additional configuration steps are required by an administrator who has these rights. For more information, see the step/section **Increase the computer account limit in the Organizational Unit**.
+- **Required**: Create **msDs-ManagedServiceAccount** objects in the Managed Service Accounts container.
+- **Optional**: Modify permissions in OUs in Active Directory. If the administrator who installs the updated Intune Connector for Active Directory doesn't have this right, an administrator who has these rights needs to perform additional configuration steps. For more information, see the section **Increase the computer account limit in the Organizational Unit**.
-1. Sign in to the server where the Intune Connector for Active Directory is being installed with an account that has local administrator rights.
-2. If the previous legacy Intune Connector for Active Directory is installed, uninstall it first before installing the updated Intune Connector for Active Directory. For more information, see [Uninstall the Intune Connector for Active Directory](../../windows-autopilot-hybrid#uninstall-the-intune-connector-for-active-directory).
+1. Sign in to the server where you're installing the Intune Connector for Active Directory with an account that has local administrator rights.
+2. If the previous legacy Intune Connector for Active Directory is installed, uninstall it before you install the updated Intune Connector for Active Directory. For more information, see [Uninstall the Intune Connector for Active Directory](../../windows-autopilot-hybrid#uninstall-the-intune-connector-for-active-directory).
Important
- When uninstalling the previous legacy Intune Connector for Active Directory, make sure to run the legacy **Intune Connector for Active Directory** installer as part of the uninstall process. If the legacy Intune Connector for Active Directory installer prompts to **Uninstall** it when it's run, select to uninstall it. This step ensures that the previous legacy Intune Connector for Active Directory is fully uninstalled. The legacy Intune Connector for Active Directory installer can be downloaded from [Intune Connector for Active Directory](https://www.microsoft.com/download/details.aspx?id=105392&msockid=3cb707200c316b2c119712450d8b6a5d).
+ When you uninstall the previous legacy Intune Connector for Active Directory, ensure you run the legacy **Intune Connector for Active Directory** installer as part of the uninstall process. If the legacy Intune Connector for Active Directory installer prompts to **Uninstall** it when it runs, select to uninstall it. This step ensures that the previous legacy Intune Connector for Active Directory is fully uninstalled. You can download the legacy Intune Connector for Active Directory installer from [Intune Connector for Active Directory](https://www.microsoft.com/download/details.aspx?id=105392&msockid=3cb707200c316b2c119712450d8b6a5d).
Tip
- In domains with only a single Intune Connector for Active Directory, Microsoft recommends first installing the updated Intune Connector for Active Directory on another server. Installing the updated Intune Connector for Active Directory on another server should be done before uninstalling the legacy Intune Connector for Active Directory on the current server. Installing the Intune Connector for Active Directory on another first avoids any downtime while the Intune Connector for Active Directory is being updated on the current server.
-3. Open the `ODJConnectorBootstrapper.exe` file that downloaded to launch the **Intune Connector for Active Directory Setup** install.
+ In domains with only a single Intune Connector for Active Directory, Microsoft recommends first installing the updated Intune Connector for Active Directory on another server. You should install the updated Intune Connector for Active Directory on another server before you uninstall the legacy Intune Connector for Active Directory on the current server. By installing the Intune Connector for Active Directory on another server first, you avoid any downtime while the Intune Connector for Active Directory is updating on the current server.
+3. Open the `ODJConnectorBootstrapper.exe` file that you downloaded to launch the **Intune Connector for Active Directory Setup** install.
4. Step through the **Intune Connector for Active Directory Setup** install.
-5. At the end of the install, select the checkbox **Launch Intune Connector for Active Directory**.
+5. At the end of the install, select **Launch Intune Connector for Active Directory**.
Note
- If **Intune Connector for Active Directory Setup** install is accidentally closed without selecting the checkbox **Launch Intune Connector for Active Directory**, the **Intune Connector for Active Directory** configuration can be reopened by selecting **Intune Connector for Active Directory** > **Intune Connector for Active Directory** from the **Start** menu.
+ If you accidentally close **Intune Connector for Active Directory Setup** install without selecting **Launch Intune Connector for Active Directory**, you can reopen the **Intune Connector for Active Directory** configuration by selecting **Intune Connector for Active Directory** > **Intune Connector for Active Directory** from the **Start** menu.
#### Sign in to the Intune Connector for Active Directory
-1. In the **Intune Connector for Active Directory** window, under the **Enrollment** tab, select **Sign In**.
-2. Under the **Sign In** tab, sign in with the Microsoft Entra ID credentials of an Intune administrator role. The user account must have an assigned Intune license. The sign in process might take a few minutes to complete.
+1. In **Intune Connector for Active Directory**, under the **Enrollment** tab, select **Sign In**.
+2. In the **Sign In** tab, sign in with the Microsoft Entra ID credentials of an Intune administrator role. The user account must have an assigned Intune license. The sign in process might take a few minutes to complete.
Note
- The account used to enroll the Intune Connector for Active Directory is only a temporary requirement at the time of installation. The account isn't used going forward after the server is enrolled.
-3. Once the sign in process completes:
+ The account you use to enroll the Intune Connector for Active Directory is only a temporary requirement at the time of installation. The account isn't used going forward after the server is enrolled.
+3. After the sign in process completes:
1. **The Intune Connector for Active Directory successfully enrolled** confirmation window appears. Select **OK** to close the window.
- 2. **A Managed Service Account with name "<MSA\_name>" was successfully set up** confirmation window appears. The name of the MSA is in the format `msaODJ#####` where **#####** are five random characters. Notate the name of the MSA that was created, and then select **OK** to close the window. The name of the MSA might be needed later to configure the MSA to allow creating computer objects in OUs.
-4. The **Enrollment** tab shows **Intune Connector for Active Directory is enrolled**. The **Sign In** button is greyed out and **Configure Managed Service Account** is enabled.
-5. Close the **Intune Connector for Active Directory** window.
+ 2. **A Managed Service Account with name "<MSA\_name>" was successfully set up** confirmation window appears. The name of the MSA is in the format `msaODJ#####`, where **#####** are five random characters. Note the name of the MSA that was created, and then select **OK** to close the window. You might need the name of the MSA later to configure the MSA to allow creating computer objects in OUs.
+
+ The **Enrollment** tab shows **Intune Connector for Active Directory is enrolled**. The **Sign In** button is greyed out and **Configure Managed Service Account** is enabled.
+4. Close the **Intune Connector for Active Directory** window.
#### Verify the Intune Connector for Active Directory is active
-After authenticating, the Intune Connector for Active Directory finishes installing. Once it finishes installing, verify that it's active in Intune by following these steps:
+After you authenticate, the Intune Connector for Active Directory finishes installing. When the installation finishes, verify that it's active in Intune by following these steps:
1. Go to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431) if it's still open. If the **Add connector** window is still displayed, close it.
If the **Microsoft Intune admin center** isn't still open:
1. Sign in to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431).
- 2. In the **Home** screen, select **Devices** in the left hand pane.
+ 2. In the **Home** screen, in the left pane, select **Devices**.
3. In the **Devices | Overview** screen, under **By platform**, select **Windows**.
4. In the **Windows | Windows devices** screen, under **Device onboarding**, select **Enrollment**.
5. In the **Windows | Windows enrollment** screen, under **Windows Autopilot**, select **Intune Connector for Active Directory**.
2. In the **Intune Connector for Active Directory** page:
- - Confirm that the server is displayed under **Connector name** and shows as **Active** under **Status**
+ - Confirm that the server is displayed under **Connector name** and shows as **Active** under **Status**.
- For the updated Intune Connector for Active Directory, make sure the version is greater than or equal to **6.2501.2000.5**.
- If the server isn't displayed, select **Refresh** or navigate away from the page, and then navigate back to the **Intune Connector for Active Directory** page.
+ If the server isn't displayed, select **Refresh** or navigate away from the page, and then go back to the **Intune Connector for Active Directory** page.
Note
- It can take several minutes for the newly enrolled server to appear in the **Intune Connector for Active Directory** page of the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431). The enrolled server only appears if it can successfully communicate with the Intune service.
-- Inactive Intune Connectors for Active Directory still appear in the **Intune Connector for Active Directory** page and will automatically be cleaned up after 30 days.
+- Inactive Intune Connectors for Active Directory still appear in the **Intune Connector for Active Directory** page and is automatically cleaned up after 30 days.
-After the Intune Connector for Active Directory is installed, it will start logging in the **Event Viewer** under the path **Applications and Services Logs** > **Microsoft** > **Intune** > **ODJConnectorService**. Under this path, **Admin** and **Operational** logs can be found.
+After you install the Intune Connector for Active Directory, it starts logging in the **Event Viewer** under the path **Applications and Services Logs** > **Microsoft** > **Intune** > **ODJConnectorService**. Under this path, you can find **Admin** and **Operational** logs.
#### Configure the MSA to allow creating objects in OUs (optional)
-By default, MSAs only have access to create computer objects in the **Computers** container. MSAs don't have access to create computer objects in Organizational Units (OUs). To allow the MSA to create objects in OUs, the OUs need to be added to the `ODJConnectorEnrollmentWizard.exe.config` XML file found in `ODJConnectorEnrollmentWizard` directory where the Intune Connector for Active Directory was installed, normally `C:\Program Files\Microsoft Intune\ODJConnector\`.
+By default, MSAs only have access to create computer objects in the **Computers** container. MSAs don't have access to create computer objects in Organizational Units (OUs). To allow the MSA to create objects in OUs, you need to add the OUs to the `ODJConnectorEnrollmentWizard.exe.config` XML file found in `ODJConnectorEnrollmentWizard` directory where you installed Intune Connector for Active Directory, normally `C:\Program Files\Microsoft Intune\ODJConnector\`.
To configure the MSA to allow creating objects in OUs, follow these steps:
-1. On the server where the Intune Connector for Active Directory is installed, navigate to `ODJConnectorEnrollmentWizard` directory where the Intune Connector for Active Directory was installed, normally `C:\Program Files\Microsoft Intune\ODJConnector\`.
-2. In the `ODJConnectorEnrollmentWizard` directory, open the existing `ODJConnectorEnrollmentWizard.exe.config` XML file in a text editor, for example, **Notepad**.
+1. On the server where the Intune Connector for Active Directory is installed, navigate to the `ODJConnectorEnrollmentWizard` directory where the Intune Connector for Active Directory is installed, normally `C:\Program Files\Microsoft Intune\ODJConnector\`.
+2. In the `ODJConnectorEnrollmentWizard` directory, open the existing `ODJConnectorEnrollmentWizard.exe.config` XML file in a text editor, such as **Notepad**.
3. In the `add key` element of the `ODJConnectorEnrollmentWizard.exe.config` XML file:
- - Next to `value=`, add in any desired OUs that the MSA should have access to create computer objects in.
+ - Next to `value=`, add any desired OUs that the MSA should have access to create computer objects in.
- The OU name needs to be in the [LDAP distinguished name](/en-us/previous-versions/windows/desktop/ldap/distinguished-names) format and if applicable, needs to be escaped.
- - Multiple OUs are supported by separating each OU with a semicolon (;).
- - Make sure to retain the quotes (") next to `value=`. All of the OU values need to be within one pair of quotes.
+ - Separate multiple OUs with a semicolon (;).
+ - Retain the quotes (") next to `value=`. All of the OU values need to be in one pair of quotes.
- Don't change the name of the key element `OrganizationalUnitsUsedForOfflineDomainJoin`.
The following example is an example XML entry with multiple OUs in LDAP distinguished name format:
@@ -217,14 +220,14 @@ To configure the MSA to allow creating objects in OUs, follow these steps:
Tip
- In the example, replace the example red text next to `value=` with the organization's OUs in [LDAP distinguished name format](/en-us/previous-versions/windows/desktop/ldap/distinguished-names). As shown in the example, make sure all OU entries are within the quotes (") and that each OU is separated with a semicolon (;) .
-4. Once all desired OUs are added, save the `ODJConnectorEnrollmentWizard.exe.config` XML file.
-5. As an administrator that has appropriate permissions to modify OU permissions, open the **Intune Connector for Active Directory** by navigating to **Intune Connector for Active Directory** > **Intune Connector for Active Directory** from the **Start** menu.
+ In the following example, replace the example red text next to `value=` with your organization's OUs in [LDAP distinguished name format](/en-us/previous-versions/windows/desktop/ldap/distinguished-names). As shown in the example, ensure all OU entries are within the quotes (") and that each OU is separated with a semicolon (;).
+4. After you add all desired OUs, save the `ODJConnectorEnrollmentWizard.exe.config` XML file.
+5. As an administrator with appropriate permissions to modify OU permissions, open the **Intune Connector for Active Directory** by going to **Intune Connector for Active Directory** > **Intune Connector for Active Directory** from the **Start** menu.
Important
- If the administrator installing and configuring the Intune Connector for Active Directory doesn't have permissions to modify OU permissions, then the section/steps **Increase the computer account limit in the Organizational Unit** need to be followed instead by an administrator that does have permissions to modify OU permissions.
-6. Under the **Enrollment** tab in the **Intune Connector for Active Directory** window, select **Configure Managed Service Account**.
+ If the administrator installing and configuring the Intune Connector for Active Directory doesn't have permissions to modify OU permissions, an administrator who has permissions to modify OU permissions needs to follow the steps in **Increase the computer account limit in the Organizational Unit**.
+6. In the **Enrollment** tab in the **Intune Connector for Active Directory** window, select **Configure Managed Service Account**.
7. An **A Managed Service Account with name "<MSA\_name>" was successfully set up** confirmation window appears. Select **OK** to close the window.
#### Use a custom Managed Service Account (optional)
@@ -245,7 +248,7 @@ This section describes the MSA requirements.
- If using sMSA, the account can only be linked to a single machine.
- If using a gMSA, the server you’re installing the gMSA on needs to have access to the password.
-- Service account needs to have local **Log On as a Service** permission which could be set directly or via group membership. For more information, see [Enable service logon](/en-us/system-center/scsm/enable-service-log-on-sm).
+- Service account needs to have local **Log On as a Service** permission which could be set directly or by group membership. For more information, see [Enable service logon](/en-us/system-center/scsm/enable-service-log-on-sm).
- Permission needs to be granted manually for service accounts to create computer objects for hybrid Autopilot flows. For more information, see [Increase the computer account limit in the Organizational Unit (OU)](/en-us/autopilot/tutorial/user-driven/hybrid-azure-ad-join-computer-account-limit?tabs=updated-connector).
##### How to set up
@@ -259,7 +262,7 @@ Update `ODJConnectorEnrollmentWizard.exe.config`. Its default location is `C:\Pr
##### Disable OU updates
-Using your own MSA will disable the connector from making any OU updates, regardless of any configured in OrganizationalUnitsUsedForOfflineDomainJoin. To prevent errors, disable OU updates by updating `ODJConnectorEnrollmentWizard.exe.config`. Its default location is `C:\Program Files\Microsoft Intune\ODJConnector\ODJConnectorEnrollmentWizard`.
+If you use your own MSA, the connector doesn't make any OU updates, even if you configure `OrganizationalUnitsUsedForOfflineDomainJoin`. To prevent errors, disable OU updates by updating `ODJConnectorEnrollmentWizard.exe.config`. The default location is `C:\Program Files\Microsoft Intune\ODJConnector\ODJConnectorEnrollmentWizard`.
1. In the **appSettings section** of the file, add the following line:
@@ -269,17 +272,17 @@ Using your own MSA will disable the connector from making any OU updates, regard # [Legacy Connector](#tab/legacy-connector)
Important
-The legacy Intune Connector for Active Directory is deprecated. These instructions assume that the legacy Intune Connector for Active Directory is already installed or is already downloaded. If the legacy Intune Connector for Active Directory installer isn't already downloaded, it can be downloaded from [Intune Connector for Active Directory](https://www.microsoft.com/download/details.aspx?id=105392&msockid=3cb707200c316b2c119712450d8b6a5d).
+The legacy Intune Connector for Active Directory is deprecated. These instructions assume that the legacy Intune Connector for Active Directory is already installed or downloaded. If you don't have the legacy Intune Connector for Active Directory installer, you can download it from [Intune Connector for Active Directory](https://www.microsoft.com/download/details.aspx?id=105392&msockid=3cb707200c316b2c119712450d8b6a5d).
-However, best practice is to download and install the updated Intune Connector for Active Directory. For more information, select the **Updated Connector** tab instead.
+However, best practice is to download and install the updated Intune Connector for Active Directory. For more information, select **Updated Connector** instead.
-Before beginning the installation, make sure that all of the [Intune connector for Active Directory server requirements](/en-us/autopilot/windows-autopilot-hybrid?tabs=intune-connector-requirements#requirements) are met.
+Before you begin the installation, make sure that you meet all of the [Intune connector for Active Directory server requirements](/en-us/autopilot/windows-autopilot-hybrid?tabs=intune-connector-requirements#requirements).
#### Disable Internet Explorer Enhanced Security Configuration
-By default Windows Server has Internet Explorer Enhanced Security Configuration turned on. Internet Explorer Enhanced Security Configuration might cause problems signing in to the Intune Connector for Active Directory. Since Internet Explorer is deprecated and in most instances, not even installed on Windows Server, Microsoft recommends turning off Internet Explorer Enhanced Security Configuration. To turn off Internet Explorer Enhanced Security Configuration:
+By default, Windows Server has Internet Explorer Enhanced Security Configuration turned on. Internet Explorer Enhanced Security Configuration might cause problems signing in to the Intune Connector for Active Directory. Because Internet Explorer is deprecated and in most instances, not even installed on Windows Server, Microsoft recommends turning off Internet Explorer Enhanced Security Configuration. To turn off Internet Explorer Enhanced Security Configuration:
-1. Sign in to the server where the Intune Connector for Active Directory is being installed with an account that has local administrator rights and domain admin rights. Domain admin rights are required so that the Intune Connector for Active Directory installer can properly create an MSA.
+1. Sign in to the server where you're installing the Intune Connector for Active Directory with an account that has local administrator rights and domain admin rights. You need domain admin rights so the Intune Connector for Active Directory installer can properly create an MSA.
2. Open **Server Manager**.
3. In the left pane of Server Manager, select **Local Server**.
4. In the right **PROPERTIES** pane of Server Manager, select the **On** or **Off** link next to **IE Enhanced Security Configuration**.
@@ -296,46 +299,47 @@ By default Windows Server has Internet Explorer Enhanced Security Configuration
Note
- If an install location other than the default of **C:\Program Files\Microsoft Intune\ODJConnector** is desired, select **Options** and specify the desired install location.
-3. When the install completes, select **Configure Now** in the **Intune Connector for Active Directory Setup** installer window.
+ If you want to install in a location other than the default of **C:\Program Files\Microsoft Intune\ODJConnector**, select **Options** and specify the desired install location.
+3. When the install finishes, select **Configure Now** in the **Intune Connector for Active Directory Setup** installer window.
Note
- If **Close** is accidentally selected or the **Intune Connector for Active Directory Setup** installer window is accidentally closed, the **Intune Connector for Active Directory** configuration can be accessed by selecting **Intune Connector for Active Directory** > **Intune Connector for Active Directory** from the **Start** menu.
+ If you accidentally select **Close** or close the **Intune Connector for Active Directory Setup** installer window, you can access the **Intune Connector for Active Directory** configuration by selecting **Intune Connector for Active Directory** > **Intune Connector for Active Directory** from the **Start** menu.
#### Sign in to the legacy Intune Connector
-1. In the **Intune Connector for Active Directory** window, under the **Enrollment** tab, select **Sign In**.
-2. Under the **Sign In** tab, sign in with the credentials of an Intune administrator role. The user account must have an assigned Intune license. The sign in process might take a few minutes to complete.
+1. In the **Intune Connector for Active Directory** window, under **Enrollment**, select **Sign In**.
+2. In the **Sign In** tab, sign in with the credentials of an Intune administrator role. The user account must have an assigned Intune license. The sign in process might take a few minutes to complete.
Note
The account used to enroll the Intune Connector for Active Directory is only a temporary requirement at the time of installation. The account isn't used going forward after the server is enrolled.
-3. Once the sign in process is complete, a **The Intune Connector for Active Directory successfully enrolled** confirmation window appears. Select **OK** to close the window.
-4. The **Enrollment** tab shows **Intune Connector for Active Directory is enrolled** and the **Sign In** button is greyed out.
-5. Close the **Intune Connector for Active Directory** window.
+3. After you sign in, a **The Intune Connector for Active Directory successfully enrolled** confirmation window appears. Select **OK** to close the window.
+
+ The **Enrollment** tab shows **Intune Connector for Active Directory is enrolled** and the **Sign In** button is greyed out.
+4. Close the **Intune Connector for Active Directory** window.
#### Verify the legacy Intune Connector for Active Directory is active
-After authenticating, the Intune Connector for Active Directory finishes installing. Once it finishes installing, verify that it's active in Intune by following these steps:
+After authenticating, the Intune Connector for Active Directory finishes installing. After it finishes installing, verify that it's active in Intune by following these steps:
1. Go to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431) if it's still open. If the **Add connector** window is still displayed, close it.
If the **Microsoft Intune admin center** isn't still open:
1. Sign in to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431).
- 2. In the **Home** screen, select **Devices** in the left hand pane.
+ 2. In the **Home** screen, in the left pane, select **Devices**.
3. In the **Devices | Overview** screen, under **By platform**, select **Windows**.
4. In the **Windows | Windows devices** screen, under **Device onboarding**, select **Enrollment**.
5. In the **Windows | Windows enrollment** screen, under **Windows Autopilot**, select **Intune Connector for Active Directory**.
-2. In the **Intune Connector for Active Directory** page, confirm that the server is displayed under **Connector name** and shows as **Active** under **Status**. If the server isn't displayed, select **Refresh** or navigate away from the page, and then navigate back to the **Intune Connector for Active Directory** page.
+2. In the **Intune Connector for Active Directory** page, confirm that the server is displayed under **Connector name** and shows as **Active** under **Status**. If the server isn't displayed, select **Refresh** or navigate away from the page, and then go back to the **Intune Connector for Active Directory** page.
Note
- It can take several minutes for the newly enrolled server to appear in the **Intune Connector for Active Directory** page of the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431). The enrolled server only appears if it can successfully communicate with the Intune service.
-- Inactive Intune Connectors for Active Directory still appear in the **Intune Connector for Active Directory** page and will automatically be cleaned up after 30 days.
+- Inactive Intune Connectors for Active Directory still appear in the **Intune Connector for Active Directory** page and are automatically cleaned up after 30 days.
-After the Intune Connector for Active Directory is installed, it will start logging in the **Event Viewer** under the path **Applications and Services Logs** > **Microsoft** > **Intune** > **ODJConnectorService**. Under this path, **Admin** and **Operational** logs can be found.
+After the Intune Connector for Active Directory is installed, it starts logging in the **Event Viewer** under the path **Applications and Services Logs** > **Microsoft** > **Intune** > **ODJConnectorService**. Under this path, you can find **Admin** and **Operational** logs.
---