Rediger

Del via

Troubleshooting overview

Windows Autopilot is designed to simplify all parts of the Windows device lifecycle, but there are always situations where issues might arise. When troubleshooting an issue, it's helpful to understand:

Windows Autopilot diagnostics page

On Windows 11, the Autopilot diagnostic page can be opened to view additional detailed troubleshooting information about the Autopilot provisioning process. To enable the Autopilot diagnostics page:

  1. Go to the ESP profile where the Autopilot diagnostics page needs to be enabled.

  2. Make sure that Show app and profile configuration progress is selected to Yes.

  3. Make sure that Turn on log collection and diagnostics page for end users is selected to Yes.

Once the diagnostic page is enabled, select the View Diagnostics button or enter the keystroke CTRL + SHIFT + D to access any diagnostic information. The Autopilot diagnostics page is currently supported for commercial OOBE, and Autopilot user-driven mode.

Note

By default diagnostics are automatically collected upon an Autopilot failure. For more information, see Collect diagnostics from a Windows device.

Note

For diagnostics to be able to upload successfully from the client, make sure that the URL lgmsapeweu.blob.core.windows.net isn't blocked on the network.

Windows Autopilot flow

Whether performing user-driven or self-deploying device deployments, the troubleshooting process is about the same. It's useful to understand the flow for a specific device:

  1. A network connection is established. The connection can be a wireless (Wi-fi) or wired (Ethernet) connection.

  2. The Windows Autopilot profile is downloaded. When a wired connection is used, or a wireless connection is established, the profile downloads from the Autopilot deployment service as soon as the network connection is in place.

  3. User authentication occurs. During a user-driven deployment, the user enters their Microsoft Entra credentials, which is then validated.

  4. Microsoft Entra join occurs. For user-driven deployments, the device is joined to Microsoft Entra ID using the specified user credentials. For self-deploying scenarios, the device is joined without specifying any user credentials.

  5. Automatic mobile device management (MDM) enrollment occurs. As part of the Microsoft Entra join process, the device enrolls in the MDM service configured in Microsoft Entra ID (for example, Microsoft Intune).

  6. Settings are applied. If the enrollment status page is configured, most settings are applied while the enrollment status page is displayed. If not configured or available, settings will be applied after the user is signed in.

Profile download

When an Internet-connected Windows device boots up, it attempts to connect to the Autopilot service and download an Autopilot profile. The Autopilot profile is downloaded as soon as possible, and again after each reboot.

Note

At this stage, it's important that an Autopilot profile exists in the tenant so that a blank profile isn't cached locally on the device. If necessary, a new Autopilot profile can be retrieved by rebooting the device.

If a computer needs to be rebooted during OOBE to retrieve a new Autopilot profile:

  1. Select Shift-F10 to open a command prompt window.

  2. In the command prompt window, enter one of the following two commands:

    • shutdown.exe /r /t 0 to restart immediately.

    • shutdown.exe /s /t 0 to shut down immediately.

For more information, see Windows Setup Command-Line Options.

Key troubleshooting activities

Key activities to perform when troubleshooting are:

Next steps

See the following articles for help with troubleshooting specific issues:

Related content