Legacy Connector
In brief
The tutorial received editorial and metadata updates, including clearer wording, corrected grammar, and refined instructions for granting the MSA permission to create computer objects.
What Intune admins need to know
Administrators following the tutorial should find the Intune Connector and Active Directory permission steps easier to understand.
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.
This step is only needed under one of the following conditions:
- The administrator that installed and configured the Intune Connector for Active Directory didn't have appropriate rights as outlined in Intune Connector for Active Directory Requirements.
- The administrator that installed and configured the Intune Connector had appropriate rights as outlined above, but the Managed Service Account (MSA)
could notcouldn't be granted permission to create computer objects in the organizational unit(s) specified during the Intune Connector installation. For more information, see Configure the new Microsoft Intune connector for Active Directory with the least privilege principle. - The
ODJConnectorEnrollmentWizard.exe.configXML file wasn't modified to add OUs that the MSA should have permissions for.
The purpose of Intune Connector for Active Directory is to join computers to a domain and add them to an OU. For this reason, the Managed Service Account being used for the Intune Connector for Active Directory needs to have permissions to create computer accounts in the OU where the computers are joined to the on-premises domain.
With default permissions in Active Directory, domain joins by the Intune Connector for Active Directory might initially work without any permission modifications to the OU in Active Directory. However afterAfter MSA attempts to join more than 10 computers to the on-premises domain, it would stop working becausebecause, by default, Active Directory only allows any single account to join up to 10 computers to the on-premises domain.
The following users aren't restricted by the 10 computer domain join limitation:
- The administrator installing the Intune Connector for Active Directory has the necessary permissions to set permissions on the OUs.
- The administrator configuring the Intune Connector for Active Directory has the necessary permissions to set permissions on the OUs.
If the administrator installingwho installs or configuringconfigures the Intune Connector for Active Directory doesn't have the necessary permissions to set permissions on the OUs, then use the following steps need to be followed:steps:
Sign in to a computer that has access to the Active Directory Users and Computers console with an account that
ashas the necessary permissions to set permissions on OUs.Open the Active Directory Users and Computers console by running DSA.msc.
Expand the desired domain and navigate to the organizational unit (OU) that computers
are joiningjoin to during Windows Autopilot.Note
TheYou specify the OU that computers join during the Windows Autopilot deploymentis specifiedlaterduringin the Configure and assign domain join profile step.Right-click on the OU and select Properties.
Note
If computers are joining the default Computers container instead of an OU, right-click on the Computers container and select Delegate Control.
In the OU Properties
windows that opens,windows, select the Security tab.In the Security tab, select Advanced.
In the Advanced Security Settings window, select Add.
In the Permission Entry windows, next to Principal, select the Select a principal link.
In the Select User, Computer, Service Account, or Group window, select the Object Types... button.
In the Object Types window, select
theService Accountscheck box,, and then select OK.In the Select User, Computer, Service Account, or Group window, under Enter the object name to select, enter the name of the MSA being used for the Intune Connector for Active Directory.
Tip
The MSA was created during the Install the Intune Connector for Active Directory
step/section andsection. It has the name format ofmsaODJ#####, where ##### are five random characters. If you don't know the MSAname isn't known,name, follow these steps to findthe MSA name:it:- On the server
runningthat runs the Intune Connector for Active Directory, right-click on the Start menu and then select Computer Management. - In the Computer Management window, expand Services and Applications and then select Services.
- In the results pane, locate the service with the name Intune ODJConnector for Active Service. The name of the MSA is listed in the Log On As column.
- On the server
Select Check Names to validate the MSA name entry.
OnceAfter the entryis validated,validates, select OK.In the Permission Entry windows, select
theApplies to:drop-down menuand then select This object only.Under Permissions,
unselectclear all items, and thenonlyselecttheonly Create Computer objectscheck box..Select OK to close the Permission Entry window.
In the Advanced Security Settings window, select either Apply or OK to apply the changes.
Legacy Connector
The purpose of Intune Connector for Active Directory is to join computers to a domain and add them to an OU. For this reason, the server running the Intune Connector for Active Directory needs to have permissions to create computer accounts in the OU where the computers are joined to the on-premises domain.
With default permissions in Active Directory, domain joins by the Intune Connector for Active Directory might initially work without any permission modifications to the OU in Active Directory. However afterAfter the server runningthat runs the Intune Connector for Active Directory attempts to join more than 10 computers to the on-premises domain, it would stopstops working because by default, Active Directory only allows any single account to join up to 10 computers to the on-premises domain.
The following users aren't restricted by the 10 computer domain join limitation:
- Users in the Administrators or Domain Administrators
groups -groups: in order to comply with the least privilege principles model, Microsoft doesn't recommend making the computer accountrunningthat runs the Intune Connector for Active Directory an administrator or domain administrator. - Users with delegated permissions on Organizational Unit (OUs) and containers in Active Directory to create computer
accounts -accounts: this method is recommendedsincebecause it follows the least privilege principles model.
To fix this limitation, the server running the Intune Connector for Active Directory needs the Create computer accounts permission in the Organizational Unit (OU) where the computers are joined to in the on-premises domain:domain
To increase the computer account limit in the Organizational Unit (OU) that computers are joining to during Windows Autopilot, follow these steps on a computer that has access to the Active Directory Users and Computers console:
In the Welcome to the Delegation of Control Wizard window of the Delegation of Control Wizard, select Next.
In the Users or Groups window, under Selected users and groups, select Add.
Next to Select this object type: in the Select Users, Computers, or Groups window, select Object Types.
In the Object Types window, select
theComputerscheck box,, and then select OK.TheLeave the other items in this windowcan be leftat their default.In the Select Users, Computers, or Groups window, under
theEnter the object names to selectbox,, enter the name of the computer where you installed the Intune Connector for Active Directorywas installedduring the Install the Intune Connector for Active Directory step.Select Check Names to validate the entry.
OnceAfter the entryis validated,validates, select OK.In the Users or Groups window, verify that the correct computer is shown under Selected users and groups:, and then select Next.
In the Tasks to Delegate window, select Create a custom task to delegate, and then select Next.
In the Active Directory Object Type window:
- Under Only the following objects in the folder, select Computer objects.
- Select the Create selected objects in this folder checkbox.
- Select Next.
In the Permissions window, under Permissions:, select
theFull Controlcheck box,, and then select Next.Note
After selecting the Full Control
check box,checkbox, all other options under Permissions: are automatically selected.TheThis automatic selection of the checkboxes is normal and expected. Don't unselect any of thecheck boxescheckboxes after they're automatically selected.In
theCompleting the Delegation of Control Wizardwindow,, select Finish.
@@ -36,11 +36,11 @@ source_path: autopilot/tutorial/user-driven/hybrid-azure-ad-join-computer-accoun cmProducts: - https://authoring-docs-microsoft.poolparty.biz/devrel/b1cfdec6-b0c3-4209-818c-736879856e0e - https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/37da4cc9-0cfc-42a9-ba5e-805706b01ef8-- https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/4b132a0c-342a-42eb-91ff-8159e1ed413d+- https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/a72e95ff-4b4f-4cc1-90c6-7dcba67ff05f spProducts: - https://authoring-docs-microsoft.poolparty.biz/devrel/2d0723c1-cf38-4c30-ab3d-5df787b33270 - https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/3661fb96-d414-4a4e-b7ad-9370637790dd-- https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/f2b71146-ce8e-46a8-9965-8aa8b3aa8235+- https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/24dc3ccd-591a-4415-a1fe-8759afafcb12 platformId: 4cb575f8-598b-c225-6322-15e41203c409 --- @@ -75,12 +75,12 @@ Important This step is only needed under one of the following conditions:
- The administrator that installed and configured the Intune Connector for Active Directory didn't have appropriate rights as outlined in [Intune Connector for Active Directory Requirements](../../windows-autopilot-hybrid?tabs=intune-connector-requirements#requirements).
-- The administrator that installed and configured the Intune Connector had appropriate rights as outlined above, but the [Managed Service Account (MSA)](/en-us/windows-server/identity/ad-ds/manage/understand-service-accounts#standalone-managed-service-accounts) could not be granted permission to create computer objects in the organizational unit(s) specified during the Intune Connector installation. For more information, see [Configure the new Microsoft Intune connector for Active Directory with the least privilege principle](https://techcommunity.microsoft.com/blog/intunecustomersuccess/configure-the-new-microsoft-intune-connector-for-active-directory-with-the-least/4432478).
+- The administrator that installed and configured the Intune Connector had appropriate rights as outlined above, but the [Managed Service Account (MSA)](/en-us/windows-server/identity/ad-ds/manage/understand-service-accounts#standalone-managed-service-accounts) couldn't be granted permission to create computer objects in the organizational unit(s) specified during the Intune Connector installation. For more information, see [Configure the new Microsoft Intune connector for Active Directory with the least privilege principle](https://techcommunity.microsoft.com/blog/intunecustomersuccess/configure-the-new-microsoft-intune-connector-for-active-directory-with-the-least/4432478).
- The `ODJConnectorEnrollmentWizard.exe.config` XML file wasn't modified to add OUs that the MSA should have permissions for.
The purpose of Intune Connector for Active Directory is to join computers to a domain and add them to an OU. For this reason, the Managed Service Account being used for the Intune Connector for Active Directory needs to have permissions to create computer accounts in the OU where the computers are joined to the on-premises domain.
-With default permissions in Active Directory, domain joins by the Intune Connector for Active Directory might initially work without any permission modifications to the OU in Active Directory. However after MSA attempts to join more than 10 computers to the on-premises domain, it would stop working because by default, Active Directory only allows any single account to join up to 10 computers to the on-premises domain.
+With default permissions in Active Directory, domain joins by the Intune Connector for Active Directory might initially work without any permission modifications to the OU in Active Directory. After MSA attempts to join more than 10 computers to the on-premises domain, it would stop working because, by default, Active Directory only allows any single account to join up to 10 computers to the on-premises domain.
The following users aren't restricted by the 10 computer domain join limitation:
@@ -92,52 +92,52 @@ To fix this limitation, the MSA needs the **Create computer accounts** permissio - The administrator installing the Intune Connector for Active Directory has the necessary permissions to set permissions on the OUs.
- The administrator configuring the Intune Connector for Active Directory has the necessary permissions to set permissions on the OUs.
-If the administrator installing or configuring the Intune Connector for Active Directory doesn't have the necessary permissions to set permissions on the OUs, then the following steps need to be followed:
+If the administrator who installs or configures the Intune Connector for Active Directory doesn't have the necessary permissions to set permissions on the OUs, then use the following steps:
-1. Sign in to a computer that has access to the **Active Directory Users and Computers** console with an account that as the necessary permissions to set permissions on OUs.
+1. Sign in to a computer that has access to the **Active Directory Users and Computers** console with an account that has the necessary permissions to set permissions on OUs.
2. Open the **Active Directory Users and Computers** console by running **DSA.msc**.
-3. Expand the desired domain and navigate to the organizational unit (OU) that computers are joining to during Windows Autopilot.
+3. Expand the desired domain and navigate to the organizational unit (OU) that computers join to during Windows Autopilot.
Note
- The OU that computers join during the Windows Autopilot deployment is specified later during the **Configure and assign domain join profile** step.
+ You specify the OU that computers join during the Windows Autopilot deployment later in the **Configure and assign domain join profile** step.
4. Right-click on the OU and select **Properties**.
Note
If computers are joining the default **Computers** container instead of an OU, right-click on the **Computers** container and select **Delegate Control**.
-5. In the OU **Properties** windows that opens, select the **Security** tab.
+5. In the OU **Properties** windows, select the **Security** tab.
6. In the **Security** tab, select **Advanced**.
7. In the **Advanced Security Settings** window, select **Add**.
8. In the **Permission Entry** windows, next to **Principal**, select the **Select a principal** link.
9. In the **Select User, Computer, Service Account, or Group** window, select the **Object Types...** button.
-10. In the **Object Types** window, select the **Service Accounts** check box, and then select **OK**.
+10. In the **Object Types** window, select **Service Accounts**, and then select **OK**.
11. In the **Select User, Computer, Service Account, or Group** window, under **Enter the object name to select**, enter the name of the MSA being used for the Intune Connector for Active Directory.
Tip
- The MSA was created during the **Install the Intune Connector for Active Directory** step/section and has the name format of `msaODJ#####` where **#####** are five random characters. If the MSA name isn't known, follow these steps to find the MSA name:
+ The MSA was created during the **Install the Intune Connector for Active Directory** section. It has the name format of `msaODJ#####`, where **#####** are five random characters. If you don't know the MSA name, follow these steps to find it:
- 1. On the server running the Intune Connector for Active Directory, right-click on the **Start** menu and then select **Computer Management**.
+ 1. On the server that runs the Intune Connector for Active Directory, right-click on the **Start** menu and then select **Computer Management**.
2. In the **Computer Management** window, expand **Services and Applications** and then select **Services**.
3. In the results pane, locate the service with the name **Intune ODJConnector for Active Service**. The name of the MSA is listed in the **Log On As** column.
-12. Select **Check Names** to validate the MSA name entry. Once the entry is validated, select **OK**.
-13. In the **Permission Entry** windows, select the **Applies to:** drop-down menu and then select **This object only**.
-14. Under **Permissions**, unselect all items, and then only select the **Create Computer objects** check box.
+12. Select **Check Names** to validate the MSA name entry. After the entry validates, select **OK**.
+13. In the **Permission Entry** windows, select **Applies to:** and then select **This object only**.
+14. Under **Permissions**, clear all items, and then select only **Create Computer objects**.
15. Select **OK** to close the **Permission Entry** window.
16. In the **Advanced Security Settings** window, select either **Apply** or **OK** to apply the changes.
# [Legacy Connector](#tab/legacy-connector)
The purpose of Intune Connector for Active Directory is to join computers to a domain and add them to an OU. For this reason, the server running the Intune Connector for Active Directory needs to have permissions to create computer accounts in the OU where the computers are joined to the on-premises domain.
-With default permissions in Active Directory, domain joins by the Intune Connector for Active Directory might initially work without any permission modifications to the OU in Active Directory. However after the server running the Intune Connector for Active Directory attempts to join more than 10 computers to the on-premises domain, it would stop working because by default, Active Directory only allows any single account to join up to 10 computers to the on-premises domain.
+With default permissions in Active Directory, domain joins by the Intune Connector for Active Directory might initially work without any permission modifications to the OU in Active Directory. After the server that runs the Intune Connector for Active Directory attempts to join more than 10 computers to the on-premises domain, it stops working because by default, Active Directory only allows any single account to join up to 10 computers to the on-premises domain.
The following users aren't restricted by the 10 computer domain join limitation:
-- Users in the Administrators or Domain Administrators groups - in order to comply with the least privilege principles model, Microsoft doesn't recommend making the computer account running the Intune Connector for Active Directory an administrator or domain administrator.
-- Users with delegated permissions on Organizational Unit (OUs) and containers in Active Directory to create computer accounts - this method is recommended since it follows the least privilege principles model.
+- Users in the Administrators or Domain Administrators groups: in order to comply with the least privilege principles model, Microsoft doesn't recommend making the computer account that runs the Intune Connector for Active Directory an administrator or domain administrator.
+- Users with delegated permissions on Organizational Unit (OUs) and containers in Active Directory to create computer accounts: this method is recommended because it follows the least privilege principles model.
-To fix this limitation, the server running the Intune Connector for Active Directory needs the **Create computer accounts** permission in the Organizational Unit (OU) where the computers are joined to in the on-premises domain:
+To fix this limitation, the server running the Intune Connector for Active Directory needs the **Create computer accounts** permission in the Organizational Unit (OU) where the computers are joined to in the on-premises domain
To increase the computer account limit in the Organizational Unit (OU) that computers are joining to during Windows Autopilot, follow these steps on a computer that has access to the **Active Directory Users and Computers** console:
@@ -155,9 +155,9 @@ To increase the computer account limit in the Organizational Unit (OU) that comp 4. In the **Welcome to the Delegation of Control Wizard** window of the **Delegation of Control Wizard**, select **Next**.
5. In the **Users or Groups** window, under **Selected users and groups**, select **Add**.
6. Next to **Select this object type:** in the **Select Users, Computers, or Groups** window, select **Object Types**.
-7. In the **Object Types** window, select the **Computers** check box, and then select **OK**. The other items in this window can be left at their default.
-8. In the **Select Users, Computers, or Groups** window, under the **Enter the object names to select** box, enter the name of the computer where the Intune Connector for Active Directory was installed during the **Install the Intune Connector for Active Directory** step.
-9. Select **Check Names** to validate the entry. Once the entry is validated, select **OK**.
+7. In the **Object Types** window, select **Computers**, and then select **OK**. Leave the other items in this window at their default.
+8. In the **Select Users, Computers, or Groups** window, under **Enter the object names to select**, enter the name of the computer where you installed the Intune Connector for Active Directory during the **Install the Intune Connector for Active Directory** step.
+9. Select **Check Names** to validate the entry. After the entry validates, select **OK**.
10. In the **Users or Groups** window, verify that the correct computer is shown under **Selected users and groups:**, and then select **Next**.
11. In the **Tasks to Delegate** window, select **Create a custom task to delegate**, and then select **Next**.
12. In the **Active Directory Object Type** window:
@@ -166,12 +166,12 @@ To increase the computer account limit in the Organizational Unit (OU) that comp 2. Under **Only the following objects in the folder**, select **Computer objects**.
3. Select the **Create selected objects in this folder** checkbox.
4. Select **Next**.
-13. In the **Permissions** window, under **Permissions:**, select the **Full Control** check box, and then select **Next**.
+13. In the **Permissions** window, under **Permissions:**, select **Full Control**, and then select **Next**.
Note
- After selecting the **Full Control** check box, all other options under **Permissions:** are automatically selected. The automatic selection of the checkboxes is normal and expected. Don't unselect any of the check boxes after they're automatically selected.
-14. In the **Completing the Delegation of Control Wizard** window, select **Finish**.
+ After selecting the **Full Control** checkbox, all other options under **Permissions:** are automatically selected. This automatic selection of the checkboxes is normal and expected. Don't unselect any of the checkboxes after they're automatically selected.
+14. In **Completing the Delegation of Control Wizard**, select **Finish**.
---