Microsoft Intune
Device enrollment

Bulk Enrollment for Windows Devices - Microsoft Intune | Microsoft Learn

In brief

The article updates its title, description, wording, metadata date, and screenshot formatting. It also adds clearer visual guidance for device naming, product keys, and Wi-Fi setup.

What Intune admins need to know

Administrators using the guide get clearer instructions for creating Windows bulk-enrollment provisioning packages; no action is required.

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.

Bulk enrollmentEnrollment for Windows devicesDevices - Microsoft Intune | Microsoft Learn

Join new Windows devices to Microsoft Entra ID and Intune. To bulk enroll devices for your Microsoft Entra tenant, you create a provisioning package withby using the Windows Configuration Designer (WCD) app. ApplyingWhen you apply the provisioning package to corporate-owned devices joinsdevices, you join the devices to your Microsoft Entra tenant and enrollsenroll them for Intune management. OnceAfter you apply the package is applied, it'spackage, the devices are ready for your Microsoft Entra users to sign in.

Microsoft Entra users are standard users on these devices and receive assigned Intune policies and required apps. Windows devices that are enrolled into Intune by using Windows bulk enrollment can use the Company Portal app to install available apps.

Requirements

  • Enable Windows automatic enrollment.

  • Make sure thatEnsure the service principal for Microsoft.Azure.SyncFabric (AppID 00000014-0000-0000-c000-000000000000) is present in your Microsoft Entra tenant. In a command line, use the Get-MgServicePrincipal -Filter "AppId eq '00000014-0000-0000-c000-000000000000'" command to check for the service principal. Without the service principal, Windows Configuration Designer can't retrieve the bulk enrollment token, which results in an error.

    To register the service principal, use the New-MgServicePrincipal -AppId "00000014-0000-0000-c000-000000000000" command. To learn more about this command, see New-MgServicePrincipal.

  • Password Administrator

For more information about these roles,information, see Microsoft Entra built-in roles.

Important

Create a provisioning package

  1. Install Windows Configuration Designer (WCD) from the Microsoft Store.

  2. Open the Windows Configuration Designer app and select Provision desktop devices.

    Screenshot of selecting Provision desktop devices in the Windows Configuration Designer app.

  3. A New project window opens where you specify the following information:

    • Name - A name for your project
    • Project folder - Save location for the project
    • Description - An optional description of the project Screenshot of specifying name, project folder, and description in the Windows Configuration Designer app

    Screenshot of specifying name, project folder, and description in the Windows Configuration Designer app.

  4. Enter a unique name for your devices. Names can include a serial number (%SERIAL%) or a random set of characters. Optionally, you can also enter a product key if you are're upgrading the edition of Windows,Windows. You can also configure the device for shared use,use and remove pre-installedpreinstalled software.

    Screenshot of specifying name and product key in the Windows Configuration Designer app.

  5. Optionally, you can configure the Wi-Fi network devices connect to when they first start. If the network devices aren't configured, a wired network connection is required when the device is first started.

    Screenshot of enabling Wi-Fi including Network SSID and Network type options in the Windows Configuration Designer app.

  6. Select Enroll in Azure AD, enter a Bulk Token Expiry date, and then select Get Bulk Token. The token validity period is 90 days.

    Note

    OnceAfter you create a provisioning package is created,package, you can revoke it can be revoked before its expirationit expires by removing the associated package_{GUID} user account from Microsoft Entra ID.

    Due to the use of the package_{GUID} user account inBecause the bulk enrollment process,process uses the package_{GUID} user account, tenants that use Conditional Access policies with MFA must set an exclusion or disable MFA for this process, becauseprocess. MFA is notisn't supported for this scenario.

  7. Provide your Microsoft Entra credentials to get a bulk token. Make sureEnsure you authenticate by way ofusing password or CBA authentication, since the app doesn't support other methods of authentication aren't supported by the app for this operation.

    Screenshot of signing in to the Windows Configuration Designer app.

    Note

    • The account usedyou use to request the bulk enrollment token in the Windows Configuration Designer app must be included in the MDM user scope in Microsoft Entra ID. If you remove this account from a group that's tied to the MDM user scope, bulk enrollment will stopstops working.
    • Bulk token retrieval does notdoesn't work for federated user accounts enabled for staged rollouts.
  8. In the Stay signed in to all your apps page, select No, sign in to this app only. If you keep the check boxcheckbox selected and press OK,select OK, the device you are're using will becomebecomes managed by your organization. If you do notdon't intend for your device to be managed, make sure to select No, sign in to this app only.

  9. ClickSelect Next when Bulk Token is fetched successfully.

  10. Optionally, you can Add applications and Add certificates. These appsThe app and certificates are provisioned on the device.

  11. Optionally, you can password protect your provisioning package. ClickSelect Create.

    Screenshot of package protection in the Windows Configuration Designer app.

Provision devices

  1. Access the provisioning package in the location specified in Project folder specified in the app.

  2. Choose how you're going to apply the provisioning package to the device. AYou can apply a provisioning package can be applied to a device in one of the following ways:

    • Place the provisioning package on a USB drive, insert the USB drive into the device you'd like want to bulk enroll, and apply it during initial setupsetup.
    • Place the provisioning package on a network folder, and apply it after initial setupsetup.

    For step-by-step instructioninstructions on applying a provisioning package, see Apply a provisioning package.

  3. After you apply the package, the device will automatically restartrestarts in one minute.

    Screenshot of project folder, specifying name, and description in the Windows Configuration Designer app.

  4. When the device restarts, it connects to the Microsoft Entra ID and enrolls in Microsoft Intune.

Troubleshooting Windows bulk enrollment

Provisioning issues

Provisioning is intended to be usedUse provisioning on new Windows devices. Provisioning failures might require a wipe of the device or device recovery from a boot image. These examples describe some reasons for provisioning failures:

  • A provisioning package that attempts to join an Active Directory domain or Microsoft Entra tenant that does notbut doesn't create a local account could make the device unreachable if the domain-join process fails due to lack of network connectivity.
  • Scripts run by the provisioning package are run in system context. The scripts are able tocan make arbitrary changes to the device file system and configurations. A malicious or bad script could put the device in a state that can only be recovered by reimaging or wiping the device.

You can checkCheck for success/success or failure of the settings in your package in the Provisioning-Diagnostics-Provider Admin log in Event Viewer.

Note

Bulk enrollment is considered a userless enrollment method, and becausemethod. Because of it,this characteristic, only the "Default" enrollment restriction in Intune would applyapplies during enrollment. Make sureEnsure Windows platform is allowed in the default restriction,restriction; otherwise, the enrollment will fail.fails. To check the capabilities alongside other Windows enrollment methods, see Intune enrollment method capabilities for Windows devices.

Bulk enrollment with Wi-Fi

When not usingyou don't use an open network, you must use device-level certificates to initiate connections. Bulk enrolled devices are unable tocan't use to user-targeted certificates for network access.

Conditional Access

Conditional Access is available for devices enrolled viaby using bulk enrollment running Windows 11 or Windows 10, version 1803 and later.

Important

Daily Intune.Admin.News

Get daily email updates

Get a concise summary of the latest Microsoft Intune updates delivered straight to your inbox.

Loading the secure signup form…