Runbook 02 · 34 scenarios
Autopilot deployment
Registration, profiles, OOBE, TPM, ESP, pre-provisioning and reset failures.
Worked guide · reviewed 10 September 2026
Autopilot stuck at device setup: find the blocking item
The Enrollment Status Page (ESP) reports progress while Windows prepares a managed device. A stalled progress indicator is a starting point for investigation; the failed stage and its evidence determine the next action.
Before you start: this walkthrough concerns classic Windows Autopilot and ESP. Windows Autopilot device preparation has a different deployment design; use its own troubleshooting guidance if that is your deployment method. Confirm the device serial, tenant and authorised support role.
1. Write down the stage, not just “stuck”
Record the displayed stage, error code, time and the last item that completed. Compare with a known-good pilot device using the same profile and network.
| Screen or stage | Start your investigation here |
|---|---|
| No organisation setup appears | Device registration, tenant, profile assignment and network discovery. |
| Device preparation | Join and management setup, including TPM where the chosen mode requires it. |
| Device setup | The device-targeted apps and configuration being tracked. |
| Account setup | The signed-in user's assignments and dependencies. |
In the Intune admin centre, open Enrollment Status Page within Windows enrolment and inspect the assigned ESP profile. Record the timeout and blocking-app settings before considering a change. Microsoft: ESP configuration.
2. Collect evidence before retrying
Where enabled and supported, use View Diagnostics or Ctrl + Shift + D. Microsoft limits this diagnostic page to supported Windows 11 user-driven deployments with a work or school account. At an ESP timeout, use the available log-collection option and your approved transfer location. Microsoft: diagnostics availability.
For an authorised technician collecting a classic user-driven Autopilot bundle from Command Prompt, Microsoft's documented pattern is:
mdmdiagnosticstool.exe -area Autopilot -cab "<approved-output-path>\Autopilot.cab"Replace the placeholder with an existing, approved folder. This creates a diagnostic file; it does not repair the device. Logs can contain device and user identifiers. Keep the original in the restricted incident record and sanitise any copy shared outside the support team.
The bundle can include MDMDiagReport_RegistryDump.Reg. Open it as text to inspect tracking information; do not double-click it to import registry settings. The EnrollmentStatusTracking records can help identify a tracked Win32 app and its state. An error state identifies what to investigate, not the cause by itself. Microsoft: interpreting ESP evidence.
3. Match the evidence to the application
In Intune, open Apps → All apps, select the identified Win32 app and inspect its device installation status. Compare the application identifier, device and timestamps. Inspect the install command, detection rules, requirements, dependencies, install context and return-code handling.
On the device, Intune Management Extension logs are normally under C:\ProgramData\Microsoft\IntuneManagementExtension\Logs. Use the app-processing and installation records to distinguish a download, execution, detection or dependency problem. Record the original settings and ask the app owner to approve any correction. Microsoft: Win32 troubleshooting and logs.
Illustrative example · invented training data
The installer finishes, but detection fails
Three pilot laptops stop at the same application. The installation log records completion, but the package now installs version 4.2 and the detection rule still checks a 4.1 path. A working desktop alone would not establish the cause; the mismatch between the installed files and the rule is the useful evidence.
- Record the application identifier, rule and installed version.
- Have the application owner correct and review the detection rule in a controlled pilot.
- Repeat the intended deployment on authorised test hardware and confirm that the application is both detected and usable.
- Keep the previous rule and package available for the agreed rollback.
Extending every device's timeout or removing all blocking apps would leave this particular mismatch unresolved.
5. Verify the school handover
Confirm that setup completes, the intended user can sign in, essential teaching apps work, and required management and access checks pass. Desktop access alone does not prove that every policy has finished applying.
If unresolved, hand over: deployment method, device and tenant references, exact stage and error, relevant app identifier, timestamps, log location, comparison with the working pilot, and changes already attempted. Do not delete registration or wipe devices merely because the screen stopped progressing.
The “start here” text identifies the first control plane and evidence to inspect. It does not replace change approval, safeguarding requirements, backup or a tested rollback route.
Device does not display the school Autopilot experience
Start hereCheck registration, tenant, assigned profile and network discovery.
Autopilot / IntuneHardware hash has not been imported
Start hereUse OEM registration or Microsoft’s supported collection method.
Autopilot / IntuneHardware-hash import reports a duplicate
Start hereDetermine which tenant already owns the registration.
Autopilot / IntuneManufacturer or reseller has not registered the device
Start hereVerify purchase data, tenant consent and OEM registration status.
Autopilot / IntuneImported device remains profile pending
Start hereCheck group membership, profile assignment and processing time.
Autopilot / IntuneWrong Autopilot profile is assigned
Start hereReview included groups, exclusions, group tags and assignment filters.
Autopilot / IntuneDynamic device group has not populated
Start hereValidate the rule, attributes and membership-processing status.
Entra groupsClassic Autopilot and device-preparation policies conflict
Start hereConfirm the intended service and remove the unintended registration or assignment.
Autopilot / IntuneDevice-preparation service principal is not group owner
Start hereVerify the Intune Provisioning Client ownership requirement.
Autopilot / IntuneUser is not permitted to join devices to Entra
Start hereCheck Entra device settings and the permitted user scope.
EntraUser has exceeded the Entra device-join limit
Start hereReview registered and joined devices before increasing limits.
EntraUser receives licence or MDM-scope error during OOBE
Start hereCheck licence, service plans and automatic enrolment scope.
Autopilot / IntuneOOBE cannot reach Microsoft services
Start hereCheck wired or Wi-Fi access, captive portal, DNS, proxy, TLS and time.
Network / AutopilotOrganisation branding or sign-in page is missing
Start hereConfirm internet access, tenant discovery and device registration.
Autopilot / IntuneTPM attestation fails
Start hereCheck TPM 2.0 state, readiness, ownership and manufacturer firmware.
Device / OEMSelf-deploying mode times out
Start hereConfirm a supported physical TPM 2.0; virtual TPMs do not satisfy this scenario.
Autopilot / IntunePre-provisioning option is unavailable
Start hereCheck TPM, network, assigned profile and device-targeted ESP.
Autopilot / IntuneTechnician phase completes but user phase fails
Start hereSeparate device-context configuration from user-context apps and policies.
Autopilot / IntuneESP remains at Device preparation
Start hereCheck Entra join, MDM enrolment and device-targeted policy.
Autopilot / IntuneESP remains at Device setup
Start hereUse diagnostics to identify the exact blocking app or configuration profile.
Autopilot / IntuneESP remains at Account setup
Start hereCheck user-targeted apps, policies, identity and group membership.
Autopilot / IntuneRequired Win32 application fails during ESP
Start hereCheck detection, command line, return code, dependency and install context.
Autopilot / IntuneApplication waits indefinitely for a reboot
Start hereCorrect return-code handling and restart behaviour.
Autopilot / IntuneToo many applications are configured as blocking
Start hereLimit blocking items to genuine first-sign-in requirements.
Autopilot / IntuneESP targets a user group when device targeting is required
Start hereMove the relevant ESP assignment to the intended device group.
Autopilot / IntuneApplication works after enrolment but fails during ESP
Start hereCheck context, user dependency, sequencing and network availability.
Autopilot / IntuneStandard user unexpectedly becomes local administrator
Start hereCheck profile user-account type and Entra local-administrator settings.
Autopilot / IntuneExpected administrator cannot administer the device
Start hereReview authorised Entra roles and account-protection policy.
Autopilot / IntuneAutopilot Reset does not start or remains pending
Start hereCheck connectivity, supported edition, management state and action status.
Autopilot / IntuneReset device does not return to Autopilot
Start hereConfirm the registration and assigned profile were retained.
Autopilot / IntuneDevice preparation unexpectedly displays classic ESP
Start hereCheck for a classic Autopilot registration or profile assignment.
Autopilot / IntuneDevice is assigned to the wrong school or department
Start hereCorrect group rules, group tag or order-identifier mapping.
Autopilot / IntuneDeployment fails only on one hardware model
Start hereCompare BIOS, TPM, drivers, storage image and OEM firmware.
Device / OEMDeployment diagnostics are unavailable
Start hereEnable the Windows Autopilot diagnostics page and retain MDM diagnostic logs.
Autopilot / Intune