Automatic Device Group
In brief
The tutorial updates wording, punctuation, formatting, and descriptions for navigating Groups, selecting the service principal, authenticating with Microsoft Graph, and responding to permission prompts.
What Intune admins need to know
Administrators following the tutorial get clearer step-by-step guidance, including the accepted service principal name and AppID.
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.
To create an assigned security device group for use with Windows Autopilot device preparation, follow these steps:
Sign in to the Microsoft Intune admin center.
In the Home screen,
selectGroupsin the lefthand pane.pane, select Groups.In
theGroups | All groupsscreen,, make sure All groups is selected, and then select New group.In the New Group
screen that opens:screen:For Group type, select Security.
For Group name, enter a name for the device group, such as Windows Autopilot device preparation device group.
For Group description, enter a description for the device group.
For Microsoft Entra roles can be assigned to the group, select No.
For Membership type, select Assigned.
Note - In some tenants, the service principal might have the nameof**Intune Autopilot ConfidentialClient** instead of **Intune Provisioning Client**. As long as the AppID of the service principal is **f1346770-5b25-470b-88bd-d5744ab7952c**, it's the correct service principal. - If the **Intune Provisioning Client** or **Intune Autopilot ConfidentialClient** service principal with AppId of **f1346770-5b25-470b-88bd-d5744ab7952c** isn't available either in the list of objects or when searching, see Adding the Intune Provisioning Client service principal.OnceAfter you select Intune Provisioning Clientis selectedas the owner, select Select.
Select Create to finish creating the assigned device group.
Important
Adding the Intune Provisioning Client service principal
If the Intune Provisioning Client service principal with AppId f1346770-5b25-470b-88bd-d5744ab7952c isn't available when selecting the owner of the device group, then follow these steps to add the service principal:
On a device where you normally administer Microsoft Intune or Microsoft Entra
ID is normally administered,ID, open an elevated Windows PowerShell command prompt.In the Windows PowerShell command prompt window:
Install the Microsoft.Graph.Authentication module by entering the following command: Install-Module Microsoft.Graph.Authentication
Ifprompted toprompted, doso:the following: - Agree to install **NuGet** by entering **Y** or **Yes**, or selecting the **Yes** button. - Agree to install from the **PSGallery** untrusted repository by entering **Y** or **Yes**, or selecting the **Yes** button. Install-Module Microsoft.Graph.ApplicationsIf
prompted to do so,prompted, agree to install from the PSGallery untrusted repository by entering Y or Yes, or selecting the Yes button.For more information, see Microsoft.Graph.Applications and Set-PSRepository -InstallationPolicy.
OnceAfter the Microsoft.Graph.Authentication and Microsoft.Graph.Applications modules are installed, connect to Microsoft Entra ID by entering the following command:Connect-MgGraph -Scopes "Application.ReadWrite.All"For more information, see Connect-MgGraph.
If you're not already authenticated to Microsoft Entra ID, the Sign in to your account window appears. Enter the credentials of a Microsoft Entra ID administrator that has permissions to add service principals.
If the Permissions requested window appears, select
theConsent on behalf of your organizationcheckbox,, and then selecttheAcceptbutton..Once authenticatedAfter you authenticate to Microsoft Entra ID and proper permissions are granted, add the Intune Provisioning Client service principal by entering the following command:New-MgServicePrincipal -AppID f1346770-5b25-470b-88bd-d5744ab7952c ``` - The following error message is displayed if one of the following conditions is true: - The account you used to sign inwithby using the `Connect-MgGraph` command doesn't have permissions to add a service principal to the tenant. - The `-Scopes "Application.ReadWrite.All"` argument isn't added to the `Connect-MgGraph` command. -TheYou didn't accept the **Permissions requested**window isnwindow. - You didn'taccepted. - Theselect **Consent on behalf of your organization**checkbox isn't selectedin the **Permissions requested** window. ```powershell New-MgServicePrincipal : Insufficient privileges to complete the operation.
@@ -82,12 +82,12 @@ Although the same assigned device group can be used for multiple Windows Autopil To create an assigned security device group for use with Windows Autopilot device preparation, follow these steps:
1. Sign in to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431).
-2. In the **Home** screen, select **Groups** in the left hand pane.
-3. In the **Groups | All groups** screen, make sure **All groups** is selected, and then select **New group**.
-4. In the **New Group** screen that opens:
+2. In the **Home** screen, in the left pane, select **Groups**.
+3. In **Groups | All groups**, make sure **All groups** is selected, and then select **New group**.
+4. In the **New Group** screen:
1. For **Group type**, select **Security**.
- 2. For **Group name**, enter a name for the device group, such as **Windows Autopilot device preparation device group**.
+ 2. For **Group name**, enter a name for the device group, such as *Windows Autopilot device preparation device group*.
3. For **Group description**, enter a description for the device group.
4. For **Microsoft Entra roles can be assigned to the group**, select **No**.
5. For **Membership type**, select **Assigned**.
@@ -98,9 +98,9 @@ To create an assigned security device group for use with Windows Autopilot devic
Note
- - In some tenants, the service principal might have the name of **Intune Autopilot ConfidentialClient** instead of **Intune Provisioning Client**. As long as the AppID of the service principal is **f1346770-5b25-470b-88bd-d5744ab7952c**, it's the correct service principal.
+ - In some tenants, the service principal might have the name **Intune Autopilot ConfidentialClient** instead of **Intune Provisioning Client**. As long as the AppID of the service principal is **f1346770-5b25-470b-88bd-d5744ab7952c**, it's the correct service principal.
- If the **Intune Provisioning Client** or **Intune Autopilot ConfidentialClient** service principal with AppId of **f1346770-5b25-470b-88bd-d5744ab7952c** isn't available either in the list of objects or when searching, see Adding the Intune Provisioning Client service principal.
- 2. Once **Intune Provisioning Client** is selected as the owner, select **Select**.
+ 2. After you select **Intune Provisioning Client** as the owner, select **Select**.
8. Select **Create** to finish creating the assigned device group.
Important
@@ -109,9 +109,9 @@ To create an assigned security device group for use with Windows Autopilot devic
### Adding the Intune Provisioning Client service principal
-If the **Intune Provisioning Client** service principal with AppId **f1346770-5b25-470b-88bd-d5744ab7952c** isn't available when selecting the owner of the device group, then follow these steps to add the service principal:
+If the **Intune Provisioning Client** service principal with AppId **f1346770-5b25-470b-88bd-d5744ab7952c** isn't available when selecting the owner of the device group, follow these steps to add the service principal:
-1. On a device where Microsoft Intune or Microsoft Entra ID is normally administered, open an elevated **Windows PowerShell** command prompt.
+1. On a device where you normally administer Microsoft Intune or Microsoft Entra ID, open an elevated **Windows PowerShell** command prompt.
2. In the **Windows PowerShell** command prompt window:
1. Install the **Microsoft.Graph.Authentication** module by entering the following command:
@@ -120,7 +120,7 @@ If the **Intune Provisioning Client** service principal with AppId **f1346770-5b Install-Module Microsoft.Graph.Authentication
```
- If prompted to do so:
+ If prompted, do the following:
- Agree to install **NuGet** by entering **Y** or **Yes**, or selecting the **Yes** button.
- Agree to install from the **PSGallery** untrusted repository by entering **Y** or **Yes**, or selecting the **Yes** button.
@@ -132,19 +132,19 @@ If the **Intune Provisioning Client** service principal with AppId **f1346770-5b Install-Module Microsoft.Graph.Applications
```
- If prompted to do so, agree to install from the **PSGallery** untrusted repository by entering **Y** or **Yes**, or selecting the **Yes** button.
+ If prompted, agree to install from the **PSGallery** untrusted repository by entering **Y** or **Yes**, or selecting the **Yes** button.
For more information, see [Microsoft.Graph.Applications](/en-us/powershell/module/microsoft.graph.applications/) and [Set-PSRepository -InstallationPolicy](/en-us/powershell/module/powershellget/set-psrepository#-installationpolicy).
- 3. Once the **Microsoft.Graph.Authentication** and **Microsoft.Graph.Applications** modules are installed, connect to Microsoft Entra ID by entering the following command:
+ 3. After the **Microsoft.Graph.Authentication** and **Microsoft.Graph.Applications** modules are installed, connect to Microsoft Entra ID by entering the following command:
```powershell
Connect-MgGraph -Scopes "Application.ReadWrite.All"
```
For more information, see [Connect-MgGraph](/en-us/powershell/module/microsoft.graph.authentication/connect-mggraph).
- 4. If not already authenticated to Microsoft Entra ID, the **Sign in to your account** window appears. Enter the credentials of a Microsoft Entra ID administrator that has permissions to add service principals.
- 5. If the **Permissions requested** window appears, select the **Consent on behalf of your organization** checkbox, and then select the **Accept** button.
- 6. Once authenticated to Microsoft Entra ID and proper permissions are granted, add the **Intune Provisioning Client** service principal by entering the following command:
+ 4. If you're not already authenticated to Microsoft Entra ID, the **Sign in to your account** window appears. Enter the credentials of a Microsoft Entra ID administrator that has permissions to add service principals.
+ 5. If the **Permissions requested** window appears, select **Consent on behalf of your organization**, and then select **Accept**.
+ 6. After you authenticate to Microsoft Entra ID and proper permissions are granted, add the **Intune Provisioning Client** service principal by entering the following command:
```powershell
New-MgServicePrincipal -AppID f1346770-5b25-470b-88bd-d5744ab7952c
@@ -164,10 +164,10 @@ If the **Intune Provisioning Client** service principal with AppId **f1346770-5b ```
- The following error message is displayed if one of the following conditions is true:
- - The account used to sign in with the `Connect-MgGraph` command doesn't have permissions to add a service principal to the tenant.
+ - The account you used to sign in by using the `Connect-MgGraph` command doesn't have permissions to add a service principal to the tenant.
- The `-Scopes "Application.ReadWrite.All"` argument isn't added to the `Connect-MgGraph` command.
- - The **Permissions requested** window isn't accepted.
- - The **Consent on behalf of your organization** checkbox isn't selected in the **Permissions requested** window.
+ - You didn't accept the **Permissions requested** window.
+ - You didn't select **Consent on behalf of your organization** in the **Permissions requested** window.
```powershell
New-MgServicePrincipal : Insufficient privileges to complete the operation.