AB#5080: OOBE FAILS WITH "AN ERROR HAS OCCURRED."

Author: Simonx Xu

support/windows-365/oobe-fails-error-has-occurred.md

@@ -0,0 +1,32 @@
+---
+title: OOBE fails with error "An error has occurred"
+description: Helps resolve the error "An error has occurred" during the Windows Out of Box Experience (OOBE).
+manager: dcscontentpm
+ms.date: 04/01/2025
+ms.topic: troubleshooting
+ms.reviewer: kaushika, erikje
+ms.custom: sap:Managing Devices with Intune, intune-azure, get-started
+ms.collection:
+- M365-identity-device-management
+- tier2
+---
+# OOBE fails with error "An error has occurred"
+
+This article helps resolve the error "An error has occurred" during the Windows Out of Box Experience (OOBE).
+
+When you first turn on Windows 365 Link, the OOBE is loaded to guide you through the process of Joining the device to your Microsoft Entra tenant and Enrolling the device into Intune management. If a failure occurs, you might encounter the following error message:
+
+> Let's add your Microsoft account  
+An error has occurred. Please try again.
+
+This error commonly occurs due to the following reasons:
+
+- Join permissions
+- Join limits
+- Enrollment restrictions
+
+To complete the OOBE, ensure the following items:
+
+- You're allowed to join Windows devices to Microsoft Entra. For more information about the configuration details, see [Allow joining Windows 365 Link to Microsoft Entra](/windows-365/link/join-microsoft-entra).
+- You don't exceed the maximum number of devices allowed to join to Microsoft Entra ID. For more information about the configuration details, see [Allow joining Windows 365 Link to Microsoft Entra](/windows-365/link/join-microsoft-entra).
+- You aren't blocked by platform restrictions that prevent enrolling Windows devices in Intune management. For more information about the configuration details, see [Configure enrollment restrictions for Windows 365 Link devices](/windows-365/link/enrollment-restrictions).

support/windows-365/toc.yml

@@ -9,6 +9,8 @@ items:
   href: ./known-issues.md
 - name: Known issues with Windows 365 Enterprise and Frontline
   href: ./known-issues-enterprise.md
+- name: 'OOBE fails with error "An error has occurred"'
+  href: ./oobe-fails-error-has-occurred.md
 - name: Provisioning errors
   href: ./provisioning-errors.md
 - name: Troubleshoot Azure network connections