Manually Register Devices with Windows Autopilot | Microsoft Learn
In brief
The page was updated with revised wording for hardware-hash collection, CSV registration, prerequisites, permissions, and related links. Metadata and documentation links were also refreshed.
What Intune admins need to know
Administrators can use the updated guidance; no required configuration change or deadline is stated.
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.
Manually Register Devices with Windows Autopilot | Microsoft Learn
Within an organization, Windows Autopilot device registration requiredrequires the following actions:
- Manually collecting the hardware identity of devices, known as hardware
hashes.hashes. - Uploading the hardware hash information in a
comma-separated-comma separated values (CSV) file.
Capturing the hardware hash for manual registration requires booting the device into Windows. For this reason, this process is primarily for testing and evaluation scenarios.
UpYou can manually register up to 500 devices can be manually registered viaby using a CSV file uploaded through the portal. Before proceedingyou proceed with additionalmore devices, check that the previous CSV file batch is successfully registered. If transferring devicesTo transfer device hashes from one tenant to another tenant, see Support tip: How to transfer Windows Autopilot devices between tenants for additional guidance.
Device owners can only register their devices withby using a hardware hash. Other methods (PKID, tuple) are available through OEMs or CSP partners.partners provide other methods, such as PKID and tuple.
This article provides step-by-step guidance for manual registration. For more information about registration, see:
- Windows Autopilot registration overview
. - Manual registration overview
. - Windows Autopilot for HoloLens 2
.
Requirements
- Intune subscription
. - Windows automatic enrollment enabled
. - Microsoft Entra ID P1 or P2 subscription
.
Required permissions
Device enrollment requires Intune Administrator or Policy and Profile Manager permissions. AYou can also create a custom Windows Autopilot device manager role can also be created by using role-based access control (RBAC). Windows Autopilot device management only requires only that you enable all permissions under Enrollment programs are enabled,, except for the four token management options.
Note
In both Intune Administrator and role-based access control methods, the administrative user also requiresneeds consent to use the Microsoft Intune PowerShell and Microsoft Graph PowerShell enterprise applications.
Collect the hardware hash
TheUse the following methods are available to harvestcollect a hardware hash from existing devices:
UsingUse Microsoft Configuration Manager.UsingUse Windows PowerShell.- During the out-of-box experience (OOBE)
by using, use the Diagnostics Page (Windows 11 only). - Directly on the
device usingdevice, use the Access work or school pane in the Settings app.
For a description of each method, select the link for the method.
Note
HKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\UserOOBE
To ensure that OOBE hasndidn't restartedrestart too many times, change this registry key value to 1.
Configuration Manager
Microsoft Configuration Manager automatically collects the hardware hashes for existing Windows devices. For more information, see Gather information from Configuration Manager for Windows Autopilot. TheYou can extract the hash information can be extracted from Configuration Manager into a CSV file.
PowerShell
TheYou can access the hardware hash for an existing device is available through Windows Management Instrumentation (WMI). TheUse the PowerShell script Get-WindowsAutopilotInfo.ps1 can be used to get a device's hardware hash and serial number. The serial number is useful forhelps you quickly seeingidentify which device the hardware hash belongs to.
To use the Get-WindowsAutopilotInfo.ps1 script, download it needs to be downloaded and then run it on a device by using either of the following methods:
- Save the hardware hash locally on a
devicesdevice as a CSVfile - thefile. TheGet-WindowsAutopilotInfo.ps1script saves the hardware hash locally on the device as a CSV file.ThisUse this methodis normally usedon devices that alreadyunderwentwent through Windows Setup and OOBE. - Directly upload the hardware hash to a mobile device management (MDM) service such as
Intune - theIntune. TheGet-WindowsAutopilotInfo.ps1script directly uploads the hardware hash to the MDM service. This method is normally used on devices that are undergoing Windows Setup and OOBE.
Note
The Get-WindowsAutopilotInfo script used in this section was updated in July of 2023 to use the Microsoft Graph PowerShell modules instead of the deprecated AzureAD Graph PowerShell modules. Make sure toEnsure you use the latest version of the script. The Microsoft Graph PowerShell modules might require approval of additional permissions in Microsoft Entra ID when you first use the modules are first used.modules. For more information, see AzureAD and Important: Azure AD Graph Retirement and PowerShell Module Deprecation.
Save the hardware hash locally on a device as a CSV file
SavingSave the hardware hash locally on a device as a CSV file is normally done onfor devices that already underwentwent through Windows Setup and OOBE. To capture and save the hardware hash locally on a device:
Sign in to the device.
On the device, open an elevated Windows PowerShell prompt.
On first run, the
Get-WindowsAutopilotInfo.ps1script prompts to approve the required app registration permissions.
The commands save the hardware hash is saved locally on the device in the directory C:\HWID with the filename AutopilotHWID.csv. TheYou can then use the CSV file can then be used to import the device into an MDM service such as Intune.
Instead of running the PowerShell commands directly on devices, theyyou can instead be run them remotely on devices as long as the remote device meets the following requirements are met on the remote device:requirements:
- WMI permissions are in place.
- WMI is accessible through Windows Firewall on the remote device.
Directly upload the hardware hash to an MDM service
Directly uploading the hardware hash to an MDM serviceservice, such as Microsoft IntuneIntune, can be done on any device, but itdevice. It's especially useful for a device currently undergoing Windows Setup and OOBE. To directly upload the hardware hash for a device:
On a device that is:
Currently undergoing Windows Setup and OOBE:
At the sign-in prompt after OOBE starts, open a command prompt window
with the keystrokeby using Shift+F10.In the
command promptCommand Prompt window that opens, start PowerShell by running the following command:powershell.exe
Get-WindowsAutopilotInfo -Online
Ifprompted to do so,prompted, agree to install **NuGet** from the **PSGallery**.When the last command of
Get-WindowsAutopilotInfo -Onlineruns, a Microsoft Entra ID sign-on prompt is displayed. Sign in with an account that is at least an Intune Administrator.Note
On first run, the
Get-WindowsAutopilotInfo.ps1script prompts to approve the required app registration permissions.After the sign-in is successful, the device hash uploads automatically.
Verify that the hardware hash uploaded successfully and the device is showing as a registered Windows Autopilot
device using the instructions in the sectiondevice. See Verify the hardware hash uploaded.For devices undergoing Windows Setup and OOBE, restart the device. The device should pick up the Windows Autopilot profile and OOBE should run through the Windows Autopilot provisioning process.
Note
To confirm the hardware hash for the device was uploaded into Intune and that the device shows as a Windows Autopilot device:
- Sign in to the Microsoft Intune admin center.
- In the Home screen,
selectDevicesin the lefthand pane.pane, select Devices. - In the Devices | Overview screen, under By platform, select Windows.
- In the Windows | Windows devices screen, under Device onboarding, select Enrollment.
- In the Windows | Windows enrollment screen, under Windows Autopilot, select Devices.
- In the Windows Autopilot devices screen, in the toolbar, select Sync
in the toolbar.. - Wait for the sync to finish. The sync might take several minutes.
- After the sync completes and the device appears in the device list in the Windows Autopilot devices screen in Intune, the device is ready for a Windows Autopilot deployment as long as a Windows Autopilot profile is assigned to the device.
Note
Microsoft recommends registering devices through Microsoft Intune viaby using a 4K hardware hash only for testing or other limited scenarios for the following reasons:
- Availability of free and inexpensive accounts in Intune that lack robust vetting.
- 4K hardware hashes contain sensitive information that only device owners should maintain.
Diagnostics page hash export
To export a hardware hash by using the Windows Autopilot Diagnostics Page, the device must be running Windows 11.
Windows Autopilot Diagnostics are available in OOBE.
During OOBE, enter the keystrokeselect CTRL + SHIFT + D to bring upopen the Diagnostics Page. From this page, you can export logs can be exported to a thumban external drive. The logs include a CSV file with the hardware hash.
Desktop hash export
Sign in to the device where you want to export the hardware hash needs to be exported. Once signedhash. After you sign in to the device, open the Accounts > Access work or school pane in the Settings app by selecting the following link:
Or
Or
- Right-click on the Start menu and select Settings.
- In Settings,
selectAccountsin the lefthand pane.pane, select Accounts. - In the Accounts page, select Access work or school.
OnceAfter you open the Access work or school pane is open in the Settings app, export the log files:
- Windows 11: In the Export your management log files section, select
theExportbutton.. - Windows 10: Select the Export your management log files link.
The logs include a CSV file with the hardware hash. LogThe process exports log files are exported to the C:\Users\Public\Documents\MDMDiagnostics directory.
For more information, see Collect MDM logs.
Ensure that the CSV file meets requirements
Device information in theThe hardware hashes CSV file should include:include the following device information:
| Item | Required | Optional |
|---|---|---|
| Group tag | ❌ | ✅ |
| Assigned user | ❌ | ✅ |
TheUse the following methods to collect the required items of serial number and hardware can be collected intohash for an individual device CSV file using the following methods:file:
- The
Get-WindowsAutopilotInfoscript documented in the Save the hardware hash locally on a device as a CSV file section. - The Desktop hash export documented in the Desktop hash export section.
TheYou can use the information from the individual device CSV files can be then used to create a CSV file with multiple devices to import multiple devices at once into an MDM service such as Intune.
The multiple devices CSV file can have up to 500 rows of devices. The header and line format must have the following format:
Keep these other requirements in mind for the CSV file in mind:file:
- Extra columns arenDon't allowed.include extra columns.
- Quotation marks arenDon't allowed.include quotation marks.
- OnlyUse only ANSI-format text files are allowed. Unicode isnfiles. Don't allowed.use Unicode.
- Headers are case-sensitive.
Important
Use a plain-text editor such as Notepad withto edit this CSV file. Don't use Microsoft Excel. Editing and saving the CSV file withby using Microsoft Excel doesn't generate a usable file for importing to Intune.
When you upload a CSV file is uploaded to assign a user, make sure toensure you assign a valid User Principal Names (UPNs)Name (UPN). If you upload an invalid UPN/UPN or incorrect username is uploaded,username, the device might be inaccessible until you remove the invalid assignment is removed.assignment.
During upload of a CSV file, Microsoft only validates that the only validation that Microsoft performs ondomain name in the `Assigned User` column is to check that the domain name is valid. Microsoft doesn't performvalidate individual UPN validationUPNs to ensure that an existing or correct user is being assigned.
## Add devices
OnceAfter you capture the hardware hashes are captured in a CSV file, Windows Autopilot devices can be added by importing the file. To import the file by using Intune:
1. Sign in to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431).
2. In the **Home** screen, select **Devices** in the left hand pane.pane, select **Devices**.
3. In the **Devices | Overview** screen, under **By platform**, select **Windows**.
4. In the **Windows | Windows devices** screen, under **Device onboarding**, select **Enrollment**.
5. In the **Windows | Windows enrollment** screen, under **Windows Autopilot**, select **Devices**.
6. In the **Windows Autopilot devices** screen, in the toolbar, select **Import** in the toolbar..
7. In the **Add Autopilot devices** screen:
1. browseGo to the CSV file that lists the devices that needyou want to be added.add.
2. Select **Import** to start importing the device information. Importing can take several minutes.
8. After the import is complete,finishes, in the **Windows Autopilot devices** screen, select **Sync** in the toolbar.
A message says that the synchronization is in progress. The process might take a few minutes to complete, depending on how many devices are being synchronized.
9. Select **Refresh** in the toolbar until the new devices appear.
## Edit Windows Autopilot device attributes
After you upload a Windows Autopilot device is uploaded,device, you can edit certain attributes of the device can be edited:device:
1. Sign in to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431).
2. In the **Home** screen, select **Devices** in the left hand pane.pane, select **Devices**.
3. In the **Devices | Overview** screen, under **By platform**, select **Windows**.
4. In the **Windows | Windows devices** screen, under **Device onboarding**, select **Enrollment**.
5. In the **Windows | Windows enrollment** screen, under **Windows Autopilot**, select **Devices**.
6. In the **Windows Autopilot devices** screen, select the device that needsyou want to be edited.edit.
7. In the pane on the right of the screen, edit the following items can be edited:items:
- Device name.name
- Group tag.tag
- Username (ifUsername, if a user is assigned).assigned
8. Select **Save**.
Note
DeviceConfigure device names can be configured for all devicesdevices, but are ignored in Hybrid Microsoft Entra deployments.deployments ignore them. The device name still comes from the domain join profile for Hybrid Microsoft Entra devices.
## Delete Windows Autopilot devices
You can delete Windows Autopilot devices that aren't enrolled in Intune can be deleted:Intune:
1. Sign in to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431).
2. In the **Home** screen, select **Devices** in the left hand pane.pane, select **Devices**.
3. In the **Devices | Overview** screen, under **By platform**, select **Windows**.
4. In the **Windows | Windows devices** screen, under **Device onboarding**, select **Enrollment**.
5. In the **Windows | Windows enrollment** screen, under **Windows Autopilot**, select **Devices**.
6. In the **Windows Autopilot devices** screen,, select the devices that need deletion,to delete, and then select **Delete** in the toolbar. The deletion process can take a few minutes to complete.
Completely removingTo completely remove a device from a tenant requirestenant, you need to delete the device records in Intune, Microsoft Entra ID, and Windows Autopilot to all be deleted. TheseAutopilot. You can perform these deletions can all be done from IntuneIntune, but you need to be done in the followingfollow this order. For more information, see [Deregister a device](registration-overview#deregister-a-device).
## Troubleshooting registration failures
1. **StorageError**: This error is a generic error that can occur for various reasons. Most of the time ittime, you can's not possible tot determine the exact cause of the error until further investigation is done.you investigate further. If you encounter this error is encountered, the best course of action is toerror, try again later. If the issue persists, contact support.
2. **ZtdDeviceAssignedToAnotherTenant**: This error occurs when the uploaded hardware hash matches a device that is's already registered to a different tenant. If this error occurs, search for the serial number corresponding to the duplicate in the CSV file. Then, search for the serial number in the **Windows Autopilot devices** pane in Intune. If the device is already registered, don't import it again.
3. **ZtdDeviceAlreadyAssigned**: This error occurs when the uploaded hardware hash matches a device that is's already registered to the tenant. If this error occurs, search for the serial number corresponding to the duplicate in the CSV file. Then, search for the serial number in the **Windows Autopilot devices** pane in Intune. If the device is already registered, don't import it again. If the device isn't registered, ityou can be importedimport it again.
4. **ZtdDeviceDuplicated**: This error occurs when there are duplicate hardware hashes in the CSV file. Only one of the duplicates is processed, and the others result in this error. If this error occurs, look for the other duplicates of the same device to see what the actual result was. If you find a duplicate that was successfully processed is found,processed, you can remove the duplicate row from the CSV file can be removed.file.
5. **InvalidZtdHardwareHash**: This error occurs when one or more fields in the hardware hash are invalid or empty. BothYou need to include both the manufacturer and serial number information need to be included.information. If theyyou don're not, the devicet include them, you can't be registeredregister the device for Windows Autopilot. To check the serial number and manufacturer information, open a PowerShell prompt and run the following command:
```powershell
Get-CimInstance Win32_BaseBoard | Select-Object Manufacturer, SerialNumber
@@ -15,7 +15,7 @@ feedback_system: Standard permissioned-type: public uhfHeaderId: MSDocsHeader-Windows description: Learn how to manually register Windows Autopilot devices. Gather hardware hashes, and import, edit, and delete device records in the Intune admin center.-ms.date: 2025-04-11T00:00:00.0000000Z+ms.date: 2026-10-20T00:00:00.0000000Z ms.topic: how-to ms.collection: - M365-modern-desktop@@ -40,55 +40,55 @@ source_path: autopilot/add-devices.md cmProducts: - https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/4b132a0c-342a-42eb-91ff-8159e1ed413d - https://authoring-docs-microsoft.poolparty.biz/devrel/bcbcbad5-4208-4783-8035-8481272c98b8+- https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/a72e95ff-4b4f-4cc1-90c6-7dcba67ff05f spProducts: - https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/f2b71146-ce8e-46a8-9965-8aa8b3aa8235 - https://authoring-docs-microsoft.poolparty.biz/devrel/43b2e5aa-8a6d-4de2-a252-692232e5edc8+- https://microsoft-devrel.poolparty.biz/DevRelOfferingOntology/24dc3ccd-591a-4415-a1fe-8759afafcb12 platformId: 32da0003-2988-1f67-6d20-903835657dad --- # Manually Register Devices with Windows Autopilot | Microsoft Learn -Within an organization, Windows Autopilot device registration required the following actions:
+Within an organization, Windows Autopilot device registration requires the following actions:
-1. Manually collecting the hardware identity of devices, known as hardware hashes.
-2. Uploading the hardware hash information in a comma-separated-values (CSV) file.
+1. Manually collecting the hardware identity of devices, known as *hardware hashes*.
+2. Uploading the hardware hash information in a comma separated values (CSV) file.
Capturing the hardware hash for manual registration requires booting the device into Windows. For this reason, this process is primarily for testing and evaluation scenarios.
-Up to 500 devices can be manually registered via a CSV file uploaded through the portal. Before proceeding with additional devices, check that the previous CSV file batch is successfully registered. If transferring devices hashes from one tenant to another tenant, see [Support tip: How to transfer Windows Autopilot devices between tenants](https://techcommunity.microsoft.com/t5/intune-customer-success/support-tip-how-to-transfer-windows-autopilot-devices-between/ba-p/3920555) for additional guidance.
+You can manually register up to 500 devices by using a CSV file uploaded through the portal. Before you proceed with more devices, check that the previous CSV file batch is successfully registered. To transfer device hashes to another tenant, see [Support tip: How to transfer Windows Autopilot devices between tenants](https://techcommunity.microsoft.com/t5/intune-customer-success/support-tip-how-to-transfer-windows-autopilot-devices-between/ba-p/3920555) for additional guidance.
-Device owners can only register their devices with a hardware hash. Other methods (PKID, tuple) are available through OEMs or CSP partners.
+Device owners can only register their devices by using a hardware hash. OEMs or CSP partners provide other methods, such as PKID and tuple.
This article provides step-by-step guidance for manual registration. For more information about registration, see:
-- [Windows Autopilot registration overview](registration-overview).
-- [Manual registration overview](manual-registration).
-- [Windows Autopilot for HoloLens 2](/en-us/hololens/hololens2-autopilot#2-register-devices-in-windows-autopilot).
+- [Windows Autopilot registration overview](registration-overview)
+- [Manual registration overview](manual-registration)
+- [Windows Autopilot for HoloLens 2](/en-us/hololens/hololens2-autopilot#2-register-devices-in-windows-autopilot)
## Requirements
-- [Intune subscription](/en-us/intune/fundamentals/licensing).
-- [Windows automatic enrollment enabled](/en-us/intune/intune-service/enrollment/windows-enroll#enable-windows-automatic-enrollment).
-- [Microsoft Entra ID P1 or P2 subscription](/en-us/azure/active-directory/active-directory-get-started-premium).
+- [Intune subscription](/en-us/intune/fundamentals/licensing)
+- [Windows automatic enrollment enabled](/en-us/intune/intune-service/enrollment/windows-enroll#enable-windows-automatic-enrollment)
+- [Microsoft Entra ID P1 or P2 subscription](/en-us/azure/active-directory/active-directory-get-started-premium)
## Required permissions
-Device enrollment requires *Intune Administrator* or *Policy and Profile Manager* permissions. A custom Windows Autopilot device manager role can also be created by using [role-based access control (RBAC)](/en-us/intune/fundamentals/role-based-access-control/overview). Windows Autopilot device management requires only that all permissions under **Enrollment programs** are enabled, except for the four token management options.
+Device enrollment requires *Intune Administrator* or *Policy and Profile Manager* permissions. You can also create a custom Windows Autopilot device manager role by using [role-based access control (RBAC)](/en-us/intune/fundamentals/role-based-access-control/overview). Windows Autopilot device management only requires that you enable all permissions under **Enrollment programs**, except for the four token management options.
Note
-In both Intune Administrator and role-based access control methods, the administrative user also requires consent to use the Microsoft Intune PowerShell and Microsoft Graph PowerShell enterprise applications.
+In both Intune Administrator and role-based access control methods, the administrative user also needs consent to use the Microsoft Intune PowerShell and Microsoft Graph PowerShell enterprise applications.
## Collect the hardware hash
-The following methods are available to harvest a hardware hash from existing devices:
+Use the following methods to collect a hardware hash from existing devices:
-- Using Microsoft Configuration Manager.
-- Using Windows PowerShell.
-- During the out-of-box experience (OOBE) by using the Diagnostics Page (Windows 11 only).
-- Directly on the device using the [Access work or school](ms-settings:workplace) pane in the Settings app.
-
-For a description of each method, select the link for the method.
+- Use Microsoft Configuration Manager.
+- Use Windows PowerShell.
+- During the out-of-box experience (OOBE), use the Diagnostics Page (Windows 11 only).
+- Directly on the device, use the [Access work or school](ms-settings:workplace) pane in the Settings app.
Note
@@ -96,28 +96,28 @@ If OOBE is restarted too many times, it can enter a recovery mode and fail to ru
`HKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\UserOOBE`
-To ensure that OOBE hasn't restarted too many times, change this registry key value to `1`.
+To ensure that OOBE didn't restart too many times, change this registry key value to `1`.
### Configuration Manager
-Microsoft Configuration Manager automatically collects the hardware hashes for existing Windows devices. For more information, see [Gather information from Configuration Manager for Windows Autopilot](/en-us/configmgr/comanage/how-to-prepare-win10#windows-autopilot). The hash information can be extracted from Configuration Manager into a CSV file.
+Microsoft Configuration Manager automatically collects the hardware hashes for existing Windows devices. For more information, see [Gather information from Configuration Manager for Windows Autopilot](/en-us/configmgr/comanage/how-to-prepare-win10#windows-autopilot). You can extract the hash information from Configuration Manager into a CSV file.
### PowerShell
-The hardware hash for an existing device is available through Windows Management Instrumentation (WMI). The PowerShell script [Get-WindowsAutopilotInfo.ps1](https://www.powershellgallery.com/packages/Get-WindowsAutopilotInfo) can be used to get a device's hardware hash and serial number. The serial number is useful for quickly seeing which device the hardware hash belongs to.
+You can access the hardware hash for an existing device through Windows Management Instrumentation (WMI). Use the PowerShell script [Get-WindowsAutopilotInfo.ps1](https://www.powershellgallery.com/packages/Get-WindowsAutopilotInfo) to get a device's hardware hash and serial number. The serial number helps you quickly identify which device the hardware hash belongs to.
-To use the `Get-WindowsAutopilotInfo.ps1` script, it needs to be downloaded and then run on a device using either of the following methods:
+To use the `Get-WindowsAutopilotInfo.ps1` script, download it and then run it on a device by using either of the following methods:
-- Save the hardware hash locally on a devices as a CSV file - the `Get-WindowsAutopilotInfo.ps1` script saves the hardware hash locally on the device as a CSV file. This method is normally used on devices that already underwent Windows Setup and OOBE.
-- Directly upload the hardware hash to a mobile device management (MDM) service such as Intune - the `Get-WindowsAutopilotInfo.ps1` script directly uploads the hardware hash to the MDM service. This method is normally used on devices that are undergoing Windows Setup and OOBE.
+- Save the hardware hash locally on a device as a CSV file. The `Get-WindowsAutopilotInfo.ps1` script saves the hardware hash locally on the device as a CSV file. Use this method on devices that already went through Windows Setup and OOBE.
+- Directly upload the hardware hash to a mobile device management (MDM) service such as Intune. The `Get-WindowsAutopilotInfo.ps1` script directly uploads the hardware hash to the MDM service. This method is normally used on devices that are undergoing Windows Setup and OOBE.
Note
-The `Get-WindowsAutopilotInfo` script used in this section was updated in July of 2023 to use the Microsoft Graph PowerShell modules instead of the deprecated AzureAD Graph PowerShell modules. Make sure to use the latest version of the script. The Microsoft Graph PowerShell modules might require approval of additional permissions in Microsoft Entra ID when the modules are first used. For more information, see [AzureAD](/en-us/powershell/module/azuread/) and [Important: Azure AD Graph Retirement and PowerShell Module Deprecation](https://techcommunity.microsoft.com/t5/microsoft-entra-azure-ad-blog/important-azure-ad-graph-retirement-and-powershell-module/ba-p/3848270).
+The `Get-WindowsAutopilotInfo` script used in this section was updated in July 2023 to use the Microsoft Graph PowerShell modules instead of the deprecated AzureAD Graph PowerShell modules. Ensure you use the latest version of the script. The Microsoft Graph PowerShell modules might require approval of additional permissions in Microsoft Entra ID when you first use the modules. For more information, see [AzureAD](/en-us/powershell/module/azuread/) and [Important: Azure AD Graph Retirement and PowerShell Module Deprecation](https://techcommunity.microsoft.com/t5/microsoft-entra-azure-ad-blog/important-azure-ad-graph-retirement-and-powershell-module/ba-p/3848270).
#### Save the hardware hash locally on a device as a CSV file
-Saving the hardware hash locally on a device as a CSV file is normally done on devices that already underwent Windows Setup and OOBE. To capture and save the hardware hash locally on a device:
+Save the hardware hash locally on a device as a CSV file for devices that already went through Windows Setup and OOBE. To capture and save the hardware hash locally on a device:
1. Sign in to the device.
2. On the device, open an elevated Windows PowerShell prompt.
@@ -137,23 +137,23 @@ Saving the hardware hash locally on a device as a CSV file is normally done on d
On first run, the `Get-WindowsAutopilotInfo.ps1` script prompts to approve the required app registration permissions.
-The hardware hash is saved locally on the device in the directory `C:\HWID` with the filename `AutopilotHWID.csv`. The CSV file can then be used to import the device into an MDM service such as Intune.
+The commands save the hardware hash locally on the device in the directory `C:\HWID` with the filename `AutopilotHWID.csv`. You can then use the CSV file to import the device into an MDM service such as Intune.
-Instead of running the PowerShell commands directly on devices, they can instead be run remotely on devices as long as the following requirements are met on the remote device:
+Instead of running the PowerShell commands directly on devices, you can run them remotely on devices as long as the remote device meets the following requirements:
- WMI permissions are in place.
- WMI is accessible through Windows Firewall on the remote device.
#### Directly upload the hardware hash to an MDM service
-Directly uploading the hardware hash to an MDM service such as Microsoft Intune can be done on any device, but it's especially useful for a device currently undergoing Windows Setup and OOBE. To directly upload the hardware hash for a device:
+Directly uploading the hardware hash to an MDM service, such as Microsoft Intune, can be done on any device. It's especially useful for a device currently undergoing Windows Setup and OOBE. To directly upload the hardware hash for a device:
1. On a device that is:
- Currently undergoing Windows Setup and OOBE:
- 1. At the sign-in prompt after OOBE starts, open a command prompt window with the keystroke Shift+F10.
- 2. In the command prompt window that opens, start PowerShell by running the following command:
+ 1. At the sign-in prompt after OOBE starts, open a command prompt window by using Shift+F10.
+ 2. In the Command Prompt window that opens, start PowerShell by running the following command:
```cmd
powershell.exe
@@ -171,14 +171,14 @@ Directly uploading the hardware hash to an MDM service such as Microsoft Intune Get-WindowsAutopilotInfo -Online
```
- If prompted to do so, agree to install **NuGet** from the **PSGallery**.
+ If prompted, agree to install **NuGet** from the **PSGallery**.
3. When the last command of `Get-WindowsAutopilotInfo -Online` runs, a Microsoft Entra ID sign-on prompt is displayed. Sign in with an account that is at least an Intune Administrator.
Note
On first run, the `Get-WindowsAutopilotInfo.ps1` script prompts to approve the required app registration permissions.
4. After the sign-in is successful, the device hash uploads automatically.
-5. Verify that the hardware hash uploaded successfully and the device is showing as a registered Windows Autopilot device using the instructions in the section Verify the hardware hash uploaded.
+5. Verify that the hardware hash uploaded successfully and the device is showing as a registered Windows Autopilot device. See Verify the hardware hash uploaded.
6. For devices undergoing Windows Setup and OOBE, restart the device. The device should pick up the Windows Autopilot profile and OOBE should run through the Windows Autopilot provisioning process.
Note
@@ -190,17 +190,17 @@ Directly uploading the hardware hash to an MDM service such as Microsoft Intune To confirm the hardware hash for the device was uploaded into Intune and that the device shows as a Windows Autopilot device:
1. Sign in to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431).
-2. In the **Home** screen, select **Devices** in the left hand pane.
+2. In the **Home** screen, in the left pane, select **Devices**.
3. In the **Devices | Overview** screen, under **By platform**, select **Windows**.
4. In the **Windows | Windows devices** screen, under **Device onboarding**, select **Enrollment**.
5. In the **Windows | Windows enrollment** screen, under **Windows Autopilot**, select **Devices**.
-6. In the **Windows Autopilot devices** screen, select **Sync** in the toolbar.
+6. In the **Windows Autopilot devices** screen, in the toolbar, select **Sync**.
7. Wait for the sync to finish. The sync might take several minutes.
8. After the sync completes and the device appears in the device list in the **Windows Autopilot devices** screen in Intune, the device is ready for a Windows Autopilot deployment as long as a Windows Autopilot profile is assigned to the device.
Note
-Microsoft recommends registering devices through Microsoft Intune via a 4K hardware hash only for testing or other limited scenarios for the following reasons:
+Microsoft recommends registering devices through Microsoft Intune by using a 4K hardware hash only for testing or other limited scenarios for the following reasons:
- Availability of free and inexpensive accounts in Intune that lack robust vetting.
- 4K hardware hashes contain sensitive information that only device owners should maintain.
@@ -215,15 +215,15 @@ Get-Help Get-WindowsAutopilotInfo
### Diagnostics page hash export
-To export a hardware hash using the [Windows Autopilot Diagnostics Page](whats-new#windows-autopilot-diagnostics-page), the device must be running Windows 11.
+To export a hardware hash by using the [Windows Autopilot Diagnostics Page](whats-new#windows-autopilot-diagnostics-page), the device must be running Windows 11.
Windows Autopilot Diagnostics are available in OOBE.
-During OOBE, enter the keystroke CTRL + SHIFT + D to bring up the Diagnostics Page. From this page, logs can be exported to a thumb drive. The logs include a CSV file with the hardware hash.
+During OOBE, select CTRL + SHIFT + D to open the Diagnostics Page. From this page, you can export logs to an external drive. The logs include a CSV file with the hardware hash.
### Desktop hash export
-Sign in to the device where the hardware hash needs to be exported. Once signed in to the device, open the **Accounts** > **Access work or school** pane in the **Settings** app by selecting the following link:
+Sign in to the device where you want to export the hardware hash. After you sign in to the device, open the **Accounts** > **Access work or school** pane in the **Settings** app by selecting the following link:
Or
@@ -239,21 +239,21 @@ Or Or
1. Right-click on the **Start** menu and select **Settings**.
-2. In **Settings**, select **Accounts** in the left hand pane.
+2. In **Settings**, in the left pane, select **Accounts**.
3. In the **Accounts** page, select **Access work or school**.
-Once the **Access work or school** pane is open in the **Settings** app, export the log files:
+After you open the **Access work or school** pane in the **Settings** app, export the log files:
-- Windows 11: In the **Export your management log files** section, select the **Export** button.
+- Windows 11: In the **Export your management log files** section, select **Export**.
- Windows 10: Select the **Export your management log files** link.
-The logs include a CSV file with the hardware hash. Log files are exported to the `C:\Users\Public\Documents\MDMDiagnostics` directory.
+The logs include a CSV file with the hardware hash. The process exports log files to the `C:\Users\Public\Documents\MDMDiagnostics` directory.
For more information, see [Collect MDM logs](/en-us/windows/client-management/mdm-collect-logs).
## Ensure that the CSV file meets requirements
-Device information in the hardware hashes CSV file should include:
+The hardware hashes CSV file should include the following device information:
| Item | Required | Optional |
| --- | --- | --- |
@@ -263,12 +263,12 @@ Device information in the hardware hashes CSV file should include: | **Group tag** | ❌ | ✅ |
| **Assigned user** | ❌ | ✅ |
-The required items of serial number and hardware can be collected into an individual device CSV file using the following methods:
+Use the following methods to collect the required serial number and hardware hash for an individual device CSV file:
- The `Get-WindowsAutopilotInfo` script documented in the Save the hardware hash locally on a device as a CSV file section.
- The Desktop hash export documented in the Desktop hash export section.
-The information from the individual device CSV files can be then used to create a CSV file with multiple devices to import multiple devices at once into an MDM service such as Intune.
+You can use the information from individual device CSV files to create a CSV file with multiple devices to import multiple devices at once into an MDM service such as Intune.
The multiple devices CSV file can have up to 500 rows of devices. The header and line format must have the following format:
@@ -277,81 +277,81 @@ Device Serial Number,Windows Product ID,Hardware Hash,Group Tag,Assigned User <serialNumber>,<ProductID>,<hardwareHash>,<optionalGroupTag>,<optionalAssignedUser>
```
-Keep these other requirements for the CSV file in mind:
+Keep these requirements in mind for the CSV file:
-- Extra columns aren't allowed.
-- Quotation marks aren't allowed.
-- Only ANSI-format text files are allowed. Unicode isn't allowed.
+- Don't include extra columns.
+- Don't include quotation marks.
+- Use only ANSI-format text files. Don't use Unicode.
- Headers are case-sensitive.
Important
-Use a plain-text editor such as Notepad with this CSV file. Don't use Microsoft Excel. Editing and saving the CSV file with Microsoft Excel doesn't generate a usable file for importing to Intune.
+Use a plain-text editor such as Notepad to edit this CSV file. Don't use Microsoft Excel. Editing and saving the CSV file by using Microsoft Excel doesn't generate a usable file for importing to Intune.
-When a CSV file is uploaded to assign a user, make sure to assign a valid User Principal Names (UPNs). If an invalid UPN/incorrect username is uploaded, the device might be inaccessible until the invalid assignment is removed.
+When you upload a CSV file to assign a user, ensure you assign a valid User Principal Name (UPN). If you upload an invalid UPN or incorrect username, the device might be inaccessible until you remove the invalid assignment.
-During upload of a CSV file, the only validation that Microsoft performs on the `Assigned User` column is to check that the domain name is valid. Microsoft doesn't perform individual UPN validation to ensure that an existing or correct user is being assigned.
+During upload of a CSV file, Microsoft only validates that the domain name in the `Assigned User` column is valid. Microsoft doesn't validate individual UPNs to ensure that an existing or correct user is being assigned.
## Add devices
-Once the hardware hashes are captured in a CSV file, Windows Autopilot devices can be added by importing the file. To import the file by using Intune:
+After you capture the hardware hashes in a CSV file, Windows Autopilot devices can be added by importing the file. To import the file by using Intune:
1. Sign in to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431).
-2. In the **Home** screen, select **Devices** in the left hand pane.
+2. In the **Home** screen, in the left pane, select **Devices**.
3. In the **Devices | Overview** screen, under **By platform**, select **Windows**.
4. In the **Windows | Windows devices** screen, under **Device onboarding**, select **Enrollment**.
5. In the **Windows | Windows enrollment** screen, under **Windows Autopilot**, select **Devices**.
-6. In the **Windows Autopilot devices** screen, select **Import** in the toolbar.
+6. In the **Windows Autopilot devices** screen, in the toolbar, select **Import**.
7. In the **Add Autopilot devices** screen:
- 1. browse to the CSV file that lists the devices that need to be added.
+ 1. Go to the CSV file that lists the devices you want to add.
2. Select **Import** to start importing the device information. Importing can take several minutes.
-8. After import is complete, in the **Windows Autopilot devices** screen, select **Sync** in the toolbar.
+8. After the import finishes, in the **Windows Autopilot devices** screen, select **Sync** in the toolbar.
A message says that the synchronization is in progress. The process might take a few minutes to complete, depending on how many devices are being synchronized.
9. Select **Refresh** in the toolbar until the new devices appear.
## Edit Windows Autopilot device attributes
-After a Windows Autopilot device is uploaded, certain attributes of the device can be edited:
+After you upload a Windows Autopilot device, you can edit certain attributes of the device:
1. Sign in to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431).
-2. In the **Home** screen, select **Devices** in the left hand pane.
+2. In the **Home** screen, in the left pane, select **Devices**.
3. In the **Devices | Overview** screen, under **By platform**, select **Windows**.
4. In the **Windows | Windows devices** screen, under **Device onboarding**, select **Enrollment**.
5. In the **Windows | Windows enrollment** screen, under **Windows Autopilot**, select **Devices**.
-6. In the **Windows Autopilot devices** screen, select the device that needs to be edited.
-7. In the pane on the right of the screen, the following items can be edited:
+6. In the **Windows Autopilot devices** screen, select the device that you want to edit.
+7. In the pane on the right of the screen, edit the following items:
- - Device name.
- - Group tag.
- - Username (if a user is assigned).
+ - Device name
+ - Group tag
+ - Username, if a user is assigned
8. Select **Save**.
Note
-Device names can be configured for all devices but are ignored in Hybrid Microsoft Entra deployments. The device name still comes from the domain join profile for Hybrid Microsoft Entra devices.
+Configure device names for all devices, but Hybrid Microsoft Entra deployments ignore them. The device name still comes from the domain join profile for Hybrid Microsoft Entra devices.
## Delete Windows Autopilot devices
-Windows Autopilot devices that aren't enrolled in Intune can be deleted:
+You can delete Windows Autopilot devices that aren't enrolled in Intune:
1. Sign in to the [Microsoft Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431).
-2. In the **Home** screen, select **Devices** in the left hand pane.
+2. In the **Home** screen, in the left pane, select **Devices**.
3. In the **Devices | Overview** screen, under **By platform**, select **Windows**.
4. In the **Windows | Windows devices** screen, under **Device onboarding**, select **Enrollment**.
5. In the **Windows | Windows enrollment** screen, under **Windows Autopilot**, select **Devices**.
-6. In the **Windows Autopilot devices** screen, select the devices that need deletion, and then select **Delete** in the toolbar. The deletion process can take a few minutes to complete.
+6. In **Windows Autopilot devices**, select the devices to delete, and then select **Delete** in the toolbar. The deletion process can take a few minutes to complete.
-Completely removing a device from a tenant requires the device records in Intune, Microsoft Entra ID, and Windows Autopilot to all be deleted. These deletions can all be done from Intune but need to be done in the following order. For more information, see [Deregister a device](registration-overview#deregister-a-device).
+To completely remove a device from a tenant, you need to delete the device records in Intune, Microsoft Entra ID, and Windows Autopilot. You can perform these deletions from Intune, but you need to follow this order. For more information, see [Deregister a device](registration-overview#deregister-a-device).
## Troubleshooting registration failures
-1. **StorageError**: This error is a generic error that can occur for various reasons. Most of the time it's not possible to determine the exact cause of the error until further investigation is done. If this error is encountered, the best course of action is to try again later. If the issue persists, contact support.
-2. **ZtdDeviceAssignedToAnotherTenant**: This error occurs when the uploaded hardware hash matches a device that is already registered to a different tenant. If this error occurs, search for the serial number corresponding to the duplicate in the CSV file. Then, search for the serial number in the **Windows Autopilot devices** pane in Intune. If the device is already registered, don't import it again.
-3. **ZtdDeviceAlreadyAssigned**: This error occurs when the uploaded hardware hash matches a device that is already registered to the tenant. If this error occurs, search for the serial number corresponding to the duplicate in the CSV file. Then, search for the serial number in the **Windows Autopilot devices** pane in Intune. If the device is already registered, don't import it again. If the device isn't registered, it can be imported again.
-4. **ZtdDeviceDuplicated**: This error occurs when there are duplicate hardware hashes in the CSV file. Only one of the duplicates is processed, and the others result in this error. If this error occurs, look for the other duplicates of the same device to see what the actual result was. If a duplicate that was successfully processed is found, the duplicate row from the CSV file can be removed.
-5. **InvalidZtdHardwareHash**: This error occurs when one or more fields in the hardware hash are invalid or empty. Both the manufacturer and serial number information need to be included. If they're not, the device can't be registered for Windows Autopilot. To check the serial number and manufacturer information, open a PowerShell prompt and run the following command:
+1. **StorageError**: This error is a generic error that can occur for various reasons. Most of the time, you can't determine the exact cause of the error until you investigate further. If you encounter this error, try again later. If the issue persists, contact support.
+2. **ZtdDeviceAssignedToAnotherTenant**: This error occurs when the uploaded hardware hash matches a device that's already registered to a different tenant. If this error occurs, search for the serial number corresponding to the duplicate in the CSV file. Then, search for the serial number in the **Windows Autopilot devices** pane in Intune. If the device is already registered, don't import it again.
+3. **ZtdDeviceAlreadyAssigned**: This error occurs when the uploaded hardware hash matches a device that's already registered to the tenant. If this error occurs, search for the serial number corresponding to the duplicate in the CSV file. Then, search for the serial number in the **Windows Autopilot devices** pane in Intune. If the device is already registered, don't import it again. If the device isn't registered, you can import it again.
+4. **ZtdDeviceDuplicated**: This error occurs when there are duplicate hardware hashes in the CSV file. Only one of the duplicates is processed, and the others result in this error. If this error occurs, look for the other duplicates of the same device to see what the actual result was. If you find a duplicate that was successfully processed, you can remove the duplicate row from the CSV file.
+5. **InvalidZtdHardwareHash**: This error occurs when one or more fields in the hardware hash are invalid or empty. You need to include both the manufacturer and serial number information. If you don't include them, you can't register the device for Windows Autopilot. To check the serial number and manufacturer information, open a PowerShell prompt and run the following command:
```powershell
Get-CimInstance Win32_BaseBoard | Select-Object Manufacturer, SerialNumber