Skip to main content

Microsoft Entra ID Enrollment for Windows Devices

Enroll Windows PCs automatically when users join them to Microsoft Entra ID, with or without Autopilot.

Written by Jeremy Bodokh

Connect Appaloosa to Microsoft Entra ID so that Windows PCs enroll automatically when they join your Entra tenant. Users sign in with their work account, either during the first setup of the PC or later from the Windows settings, and the PC appears in Appaloosa with no enrollment link to share.

Entra enrollment works on its own: you do not need Windows Autopilot or Microsoft Intune. If you also want PCs to go straight from the box to your setup, add Autopilot on top, see Autopilot Enrollment for Windows Devices.

Prerequisites

  • A Microsoft Entra ID P1 or P2 licence (included in Microsoft 365 Business Premium, E3 and E5) for every user who enrolls a PC.

  • A Global Administrator account on your Entra tenant.

  • An administrator account on Appaloosa.

  • PCs on Windows 10 or 11 Pro, Enterprise or Education. Windows Home is not supported.

  • Users allowed to join devices: in Entra, Devices > Device settings > Users may join devices to Microsoft Entra must be set to All or Selected.

Step 1: Get the Appaloosa values

In Appaloosa, go to Settings > Windows. The Microsoft Entra ID card shows three values you will paste in Entra, each with a copy button:

  • MDM discovery URL

  • MDM terms of use URL

  • Application ID URI

Keep this page open.

Step 2: Create the MDM application in Entra

  1. In the Microsoft Entra admin center, search for Mobility and open Mobility (MDM and WIP). Depending on your tenant, it can be named Mobility (MDM and MAM).

  2. Click Add application, then Create your own application. In the Custom MDM application panel, enter a name, for example Appaloosa, and click Create.

  3. Open the new application and set MDM user scope:

    • All: every user's PC enrolls in Appaloosa.

    • Some: only members of the groups you select. Useful to start with a pilot group.

  4. Paste the MDM terms of use URL and the MDM discovery URL from Appaloosa. Leave Disable MDM enrollment when adding work or school account on Windows on No, then click Save.

Watch out if you also have Microsoft Intune: in the same Mobility page, open Microsoft Intune and set its MDM user scope to None. A user cannot be in the scope of two MDM applications.

Step 3: Configure the application tokens

Still in the Appaloosa application, click Custom MDM application settings. This opens the app registration.

  1. In Token configuration, click Add optional claim, choose the Access token type, select ztdid and click Add.

  2. In Manifest:

    • Replace the content of identifierUris with the Application ID URI from Appaloosa.

    • In optionalClaims, add the following entry to the accessToken list:

{
"additionalProperties": [],
"essential": false,
"name": "deviceid",
"source": null
}

Click Save. Without the deviceid claim, PCs cannot enroll. Once saved, deviceid and ztdid both appear in Token configuration with the Access token type (a warning icon next to deviceid is expected).

Step 4: Fill in the identifiers in Appaloosa

  1. In the app registration Overview, copy the Application (client) ID and the Directory (tenant) ID.

  2. In Appaloosa, on Settings > Windows, click Edit, paste both values and click Save.

The setup is complete. PCs that join your Entra tenant from now on enroll in Appaloosa.

Enroll a PC

On a new or reset PC: during the first setup, choose Set up for work or school (on Windows Pro) and sign in with the user's work account.

On a PC already in use: go to Settings > Accounts > Access work or school, click Connect, then Join this device to Microsoft Entra ID, and sign in with the user's work account.

In both cases, Windows shows a page "<your environment name> manages this device" explaining that the organization will be able to install applications, apply security settings and wipe the PC remotely. The user clicks Accept and the PC enrolls.

In Appaloosa

  • The PC appears in the device list.

  • If the work account email matches a user of your environment, the PC is assigned to that user. Otherwise, it has no user and you can assign one later.

  • If the PC was already enrolled in Appaloosa, the new enrollment replaces the previous one, so you do not get duplicates.

Troubleshooting

  • "This device cannot be enrolled. Contact your administrator." on the terms page: the Directory (tenant) ID or the Application (client) ID in Appaloosa does not match the Entra application, or the identifierUris value in the manifest is not the Appaloosa Application ID URI.

  • The user accepts the terms but the PC does not appear in Appaloosa: check that the deviceid optional claim is in the accessToken list of the manifest.

  • The PC joins Entra but is not enrolled: the user is outside the MDM user scope, or the MDM user scope is set to None.

  • "Can't connect to the URL for your organization's MDM terms of use": the MDM terms of use URL is missing or wrong in the Entra application.

  • Error 8018000a: the PC is already joined or enrolled by another user. Remove that work account first.

  • Error 80180018: the user has no Entra ID P1 or P2 licence.

  • Error 801c0003: the user is not allowed to join devices to Entra (see Prerequisites).

  • Error 8018002b: the MDM user scope is None, or the user's sign-in name uses a domain that is not routable (for example .local).

  • "Your device is already being managed by an organization": the PC is still enrolled in another MDM. Unenroll it there first, or reset the PC.

Watch out before disconnecting a PC from Entra: create a local administrator account first. If the work account is the only account on the PC, disconnecting it can leave you with no way to sign in, and a reset is required.

Did this answer your question?