When you have many Windows devices to enroll, entering credentials on each one is slow. A provisioning package (a .ppkg file) lets you enroll a device into Appaloosa in a few seconds, without the user having to type anything.
You build the package once with Windows Configuration Designer, then apply the same file to every device you want to enroll.
If you only need to enroll a single device, use the per-user method described in How to enroll your Windows devices instead.
If your users sign in with a Microsoft Entra ID work account, PCs can also enroll automatically when they join your Entra tenant, see Microsoft Entra ID Enrollment for Windows Devices. For new PCs, Windows Autopilot enrolls them from their first startup, see Autopilot Enrollment for Windows Devices.
Before you begin
A Windows machine with Windows Configuration Designer installed. It is available for free from the Microsoft Store, and is also included in the Windows Assessment and Deployment Kit (ADK).
Administrator rights on the devices you want to enroll.
A USB drive, if you plan to enroll devices during their initial setup.
The devices must not already be enrolled in another MDM solution.
Retrieve your bulk enrollment credentials
On your Appaloosa dashboard, go to Inventory, click on New Device, select Windows, then open the Batch tab.
Four values are displayed. Use the copy icon next to each one, as the longer values are shortened on screen.
UPN: the enrollment account that identifies your Appaloosa environment.
AuthPolicy: always
On-Premise.DiscoveryServiceFullURL: the Appaloosa enrollment endpoint the device contacts.
Secret: the password that authenticates the enrollment request.
These credentials belong to your environment, not to a single device or user. The same package can therefore enroll all of your Windows devices. Treat the Secret as a password: anyone who has it can enroll a device into your environment, so share the package only with the people who need it.
Build the provisioning package
Open Windows Configuration Designer and select Advanced provisioning.
[SCREENSHOT]
Enter a Name for your project, then click Next.
Select All Windows desktop editions, then click Next.
Leave the option to import an existing package unselected, and click Finish.
In the settings tree on the left, go to Runtime settings > Workplace > Enrollments.
[SCREENSHOT]
In the UPN field, paste the UPN from your Appaloosa dashboard and click Add. A new node appears under Enrollments, named after the UPN.
Expand that node and fill in the remaining fields with the values from your dashboard:
AuthPolicy: select
On-Premise.DiscoveryServiceFullURL: paste the discovery URL.
Secret: paste the secret.
[SCREENSHOT]
You can add other settings to the same package if you need to, for example a Wi-Fi profile so the device can reach the network during its initial setup.
When you are done, click Export > Provisioning package:
Set the Owner to IT Admin and click Next.
Choose whether to encrypt and sign the package, then click Next. Because the package contains your enrollment secret, encrypting it is recommended.
Select the folder where the package will be saved, click Next, then Build.
Windows Configuration Designer generates a .ppkg file in the folder you selected. This is the file you distribute to your devices.
Apply the package to a device
There are three ways to apply the package, depending on the state of the device.
During the initial setup (OOBE)
This is the fastest option for new or freshly reset devices.
Copy the
.ppkgfile to the root of a USB drive.Turn on the device. On the very first setup screen, plug in the USB drive.
Windows detects the package and asks whether you want to install it. Select the package and confirm.
The package is applied and the device continues its setup, already enrolled.
From the Windows settings
Use this option on a device that is already set up.
Copy the
.ppkgfile to the device.Open Settings > Accounts > Access work or school.
Click on Add or remove a provisioning package, then Add a package.
Select the
.ppkgfile and confirm when Windows asks you to trust the package.
By running the file
On a device that is already set up, you can also double-click the .ppkg file directly from the file explorer. Windows asks you to confirm that the package comes from a trusted source, then applies it. Administrator rights are required.
Verify the enrollment
Once the package has been applied, the device contacts Appaloosa and completes its enrollment.
On the device, open Settings > Accounts > Access work or school. The connection to Appaloosa is listed there.
On your Appaloosa dashboard, the device appears in Inventory. Your configurations and applications are then deployed to it.
Notes
The same package can be reused on as many devices as you need. You do not have to build a new one for each device.
If a device fails to enroll, check that it has an internet connection

