Migration playbook · Microsoft 365

How to move Intune-managed devices to a new tenant

A device enrolled in one Intune tenant cannot simply be pointed at another. This guide covers the documented path for each platform: rebuild the target configuration, move Autopilot and Apple registrations, back up BitLocker keys, then wipe or retire and re-enrol on cutover day.

Updated 4 Nov 20266 phases38 detailed steps16 official sources
Start here

Your migration plan

This moves PCs, Macs, phones and tablets managed by Intune (Microsoft's device management service) from one Microsoft 365 tenant (your organisation's own Microsoft 365 setup) to another, as part of a Microsoft 365 tenant-to-tenant move. A device cannot just be pointed at the new tenant. Company devices are removed from the old tenant, registered in the new one and wiped (reset to factory settings), so they set themselves up again with the new settings. Personal devices are retired (Intune removes only work apps, data and management) and their users enrol them again. Microsoft has no tool that copies Intune policies between tenants, so the new tenant is built first. The time is set by your user waves and by Intune's daily limits of 500 wipes and 1,000 retires per tenant.

Recommended routeWipe and re-enrol per device type (Autopilot, Apple Business Manager, Company Portal)

It is the path Microsoft documents for every platform, and devices arrive with the new tenant's settings and apps.

Other options and when to use them
  • Third-party in-place device migration tool: A wipe and rebuild of Windows PCs is not acceptable. Not a path Microsoft documents, so pilot it carefully.
  • Ask your OEM or reseller to move Autopilot registrations: Your devices were registered by a partner, so nobody needs to collect hardware hashes at each PC.
Order to migrate in, and why

Get people and their data into the new tenant first, build and test everything a device will need there, and only then wipe devices, one wave at a time. A wipe is the step that cannot be undone, so everything that protects the user comes before it.

  1. User accounts, licences, mailboxes and OneDrive in the new tenantA device enrols as its user, and after a wipe the user needs their mail and files waiting in the new tenant.
  2. New tenant built: enrolment settings, policies, Wi-Fi, VPN, certificates, apps, Autopilot profiles, Apple and Android enrolmentA device that enrols into an empty tenant gets no network settings or apps, and Conditional Access may block its user.
  3. Exports from the old tenant: device list, group tags, BitLocker keys, hardware hashesThese live on records you are about to delete, and a locked disk with no key loses its data.
  4. Pilot: a few devices of each type through every stepShows how long a device takes and what breaks, and tests the new configuration on site and at home.
  5. Windows PCs in waves, with each userOld Autopilot registration must be removed before the new import works, so each PC follows a fixed order on its wave day.
  6. Apple and Android devices in waves, with each userApple devices need reassigning in Apple Business Manager first, and personal devices need their users to enrol again.
  7. Clean-up in the old tenant: leftover records, then the ADE tokenRemoving the Apple token too early stops devices still waiting to move from enrolling anywhere.
Settings checklist: decide these before you copy

Built-in and third-party tools treat these differently. Tick each one off once you have decided.

Download this checklist (Excel)
  • How each tool handles it
    Built-in methodWipe resets a device to factory settings and removes all data. Retire removes only company apps, data and management, and is the option for personal devices. Wipe is not available for personal Android work profiles.
    Quest On Demand MigrationMoves Entra joined Windows PCs to the new tenant, switches Intune enrolment and keeps user profiles. Not Microsoft supported, so pilot first.

    Tip: Record the path for each device in your device list before setting wave dates.

    Microsoft Learn: Remove devices by using wipe, retire or manual unenrolment
  • How each tool handles it
    Built-in methodIntune allows each tenant 500 Wipe and 1,000 Retire actions a day, counting single, bulk and Graph requests together. If Multiple Administrative Approval (a setting that makes a second admin approve chosen actions) covers wipes, each one waits for approval.

    Tip: Plan waves well below the limits so failed devices can be re-run the same day.

    Microsoft Learn: Wipe action in Intune
  • How each tool handles it
    Built-in methodAutopilot Reset keeps the PC joined and enrolled in the old tenant, so it cannot move a PC. A full Wipe with no options ticked, or Reset this PC, can, once the PC is removed from the old Autopilot.

    Tip: Write the exact wipe options into your runbook, with every option box left unticked.

    Microsoft Learn: Autopilot Reset
  • How each tool handles it
    Built-in methodA wipe removes all local data and Microsoft says it cannot be recovered. Only folders backed up by OneDrive Known Folder Move (Desktop, Documents, Pictures) are safe, and only once they have reached the new tenant.
    Quest On Demand MigrationMoves Entra joined Windows PCs to the new tenant, switches Intune enrolment and keeps user profiles. Not Microsoft supported, so pilot first.
    ForensiT User Profile WizardMoves a Windows profile to the new tenant account. It does not handle Intune enrolment.

    Tip: Check Known Folder Move status on each device the day before its wave.

    Microsoft Learn: Wipe action in Intune
  • How each tool handles it
    Built-in methodKeys are stored against the device record in the old tenant. Deleting or retiring the Intune record suspends BitLocker on the PC. The new tenant only gets a key once the PC is encrypted again there.

    Tip: Export keys before the first wave to a folder with restricted access, and delete the export once each PC shows a key in the new tenant.

    Microsoft Learn: Encrypt Windows devices with BitLocker in Intune (view recovery keys)
  • How each tool handles it
    Built-in methodIntune has no tenant-to-tenant copy. Every profile and Conditional Access policy is rebuilt by hand in the new tenant.
    IntuneManagement (open source)Exports and imports Intune objects with assignments between tenants and maps groups. Check certificates, Wi-Fi keys and app content in the target afterwards.

    Tip: Document each source profile, rebuild it, and test it on pilot devices on site and at home.

    Microsoft Learn: Configure and assign the Enrollment Status Page
  • How each tool handles it
    Built-in methodApps do not move between tenants. Each app is added again in the new tenant and assigned to the matching groups, and the Enrollment Status Page (setup progress screen) decides which apps must install before the user reaches the desktop.
    IntuneManagement (open source)Exports and imports Intune objects with assignments between tenants. Check that app content arrived in the target.

    Tip: Keep the Enrollment Status Page list short so setup does not time out.

    Microsoft Learn: Configure and assign the Enrollment Status Page
  • How each tool handles it
    Built-in methodThe import takes CSV files of up to 500 rows with an exact header, saved as ANSI, with no quotes or extra columns. It fails with ZtdDeviceAssignedToAnotherTenant while the PC is still registered to the old tenant. Dynamic groups only pick up devices whose group tags match.

    Tip: Export group tags from the old Autopilot, put them in the Group Tag column, and create matching dynamic groups before importing.

    Microsoft Learn: Manually register devices with Windows Autopilot
  • How each tool handles it
    Built-in methodMicrosoft recommends Partner Center registration by your reseller for most devices. Partners can deregister and register devices for you, so nobody needs to visit each PC.

    Tip: Send your reseller the serial number list and the new tenant ID, and collect hashes only for devices they cannot cover.

    Microsoft Learn: Windows Autopilot registration overview
  • How each tool handles it
    Built-in methodIn one organisation, devices are reassigned from the old MDM server to the new one. Between organisations, the old one must release them, and Microsoft says Release from Organization cannot be undone. An Apple device that syncs with no enrolment policy fails enrolment.

    Tip: Set a default enrolment policy on the new ADE token first, and get your Apple reseller's written plan before releasing anything.

    Microsoft Learn: Manage Apple ADE devices and tokens
  • How each tool handles it
    Built-in methodCorporate devices are wiped and enrolled with the new token or QR code. Personal work profiles are retired, because Wipe is not available for them. Zebra wipes skip the factory reset, and some Samsung devices lose contact.

    Tip: Write a manual reset method for each Zebra and Samsung model and test it in the pilot.

    Microsoft Learn: Set up enrolment for Android Enterprise fully managed devices
  • How each tool handles it
    Built-in methodMicrosoft says to delete the on-premises AD computer object of a hybrid joined PC (joined to both AD and Entra ID) so it does not sync back. For Entra joined PCs, Microsoft says no extra step is needed and not to delete the Entra device record by hand during the move.

    Tip: Delete the computer object on the wave day, after the wipe and Autopilot deregistration and before the new import.

    Microsoft Learn: Manually register devices with Windows Autopilot
  • How each tool handles it
    Built-in methodIntune cleanup rules remove stale Intune records but not Microsoft Entra device records, which stay until deleted by hand.

    Tip: After the last wave, delete leftover Intune and Autopilot records, review the old Entra device records, then delete the old ADE token.

    Microsoft Learn: Remove devices by using wipe, retire or manual unenrolment
The plan, phase by phase
  1. 1

    Plan the waves

    After user accounts exist in the new tenant

    Watch out: Each tenant can send only 500 Wipe and 1,000 Retire actions a day, counting single, bulk and Graph requests.

    Ways around it

    • Size waves below those numbers, and check whether Multiple Administrative Approval (an Intune setting that makes a second admin approve chosen actions) applies to wipes.

    Watch out: Autopilot Reset keeps the device in the old tenant, so it cannot be used to move.

    Ways around it

    • Use a full Wipe with no options ticked, or Reset this PC, after removing the device from the old Autopilot.
    Show the detailed steps (3) →
  2. 2

    Build the new tenant

    Watch out: Intune has no tenant-to-tenant copy of policies, so every profile must be rebuilt.

    Ways around it

    • Document each source profile and recreate it by hand, then test with pilot devices on site and at home.

    Tools that can do it

    • IntuneManagement (open source)Exports and imports Intune objects with assignments between tenants and maps groups. Check certificates, Wi-Fi keys and app content in the target afterwards.

    Watch out: An Apple device that syncs with no enrolment policy fails enrolment.

    Ways around it

    • Set a default enrolment policy on the new ADE token before any device is assigned.
    Show the detailed steps (6) →
  3. 3

    Back up before any wipe

    Before the first wave

    Watch out: A wipe removes all local data, and it cannot be recovered.

    Ways around it

    • Ask users to move anything outside OneDrive-backed folders into OneDrive before their wave.

    Tools that can do it

    • Quest On Demand MigrationMoves Entra joined Windows PCs to the new tenant, switches Intune enrolment and keeps user profiles. Not Microsoft supported, so pilot first.
    • ForensiT User Profile WizardMoves a Windows profile to the new tenant account. It does not handle Intune enrolment.

    Watch out: The Autopilot import rejects files saved from Excel, with quotes or extra columns, or over 500 rows.

    Ways around it

    • Use the exact header in Notepad and save with ANSI encoding.
    Show the detailed steps (4) →
  4. 4

    Move Windows PCs

    On each wave day

    Watch out: The import fails with ZtdDeviceAssignedToAnotherTenant while the PC is still registered to the old tenant.

    Ways around it

    • Follow the order strictly, and leave the PC at the setup screen until the new profile is assigned.

    Watch out: Deleting or retiring the Intune record suspends BitLocker on the PC.

    Ways around it

    • Wipe soon after, and keep the key export until the PC is encrypted again in the new tenant.
    Show the detailed steps (6) →
  5. 5

    Move Apple and Android

    On each wave day

    Watch out: If the new tenant uses a different Apple Business Manager organisation, Release from Organization cannot be undone.

    Ways around it

    • Share one Apple Business Manager organisation if you can, or get your reseller's written plan before releasing anything.

    Watch out: Wipe is not available for personal Android work profiles, Zebra wipes skip the factory reset, and some Samsung devices lose contact.

    Ways around it

    • Retire personal devices, and write a manual reset method for each Zebra and Samsung model.
    Show the detailed steps (6) →
  6. 6

    Check and clean up

    Watch out: Intune cleanup rules remove stale Intune records but not Microsoft Entra device records.

    Ways around it

    • Review the old tenant's device records by hand after the last wave.
    Show the detailed steps (3) →
You are finished when
  • Every device in each wave is enrolled in the new tenant with the right primary user, and shows Compliant.
  • Windows PCs show AzureAdJoined YES with the new tenant name, and have a recovery key escrowed.
  • Required apps show Installed, and users reach mail, Teams and their OneDrive files.
  • No migrated device remains in the old tenant's Intune, Autopilot or ADE token lists.

Tools named in this plan are independent third-party products, not endorsed by the platform vendor and not paid placements. Check the tool's own documentation and run a pilot first.

Click by click

Detailed steps

Open a part when you reach it in the plan. Each step says where to go, what to do and what you should see.

About this migrationWhat it covers, limits at a glance

Every enrolment path in Intune ties a device to one tenant: Autopilot registrations, Apple automated device enrolment (ADE) tokens, Android Enterprise enrolment and the Microsoft Entra join itself. The documented way to move a device is to remove it from the source, register it in the target and reset or re-enrol it. Corporate devices are usually wiped; personal devices are retired and enrolled again by the user.

Device moves happen near the end of a Microsoft 365 tenant-to-tenant migration, after mailboxes and OneDrive have moved, because users sign in to the reset device with their target account and expect their data to be there.

Windows Autopilot devicesDelete in source Intune, deregister, import hash in target, reset
Autopilot CSV importUp to 500 devices per file
Apple ADE devicesUnassign from source MDM server, assign to target token, wipe
Personal devicesRetire in source; user re-enrols with Company Portal
Daily action limitsUp to 500 Wipe and 1,000 Retire actions per tenant per day
1What you need before step one
NeedDetailsWhere to get it
Intune Administrator in both tenantsTo wipe, retire, delete and import devices, and build policies in the target.Microsoft Intune admin center, https://intune.microsoft.com
Cloud Device Administrator (or Helpdesk Administrator)To read BitLocker recovery keys in the source.Microsoft Entra admin center, https://entra.microsoft.com
Licences in the targetIntune and Microsoft Entra ID P1 or P2 for each user, as Microsoft lists for Autopilot.Microsoft or your partner; check current pricing with them
Microsoft Graph PowerShellFor the inventory and BitLocker exports.Install Microsoft Graph PowerShell
Get-WindowsAutopilotInfo scriptCollects Windows hardware hashes on each device.Export an Autopilot hardware hash
Apple Business Manager accessAdministrator or Device Enrollment Manager role, for ADE devices.https://business.apple.com
Target user accountsCreated, licensed and with mailbox and OneDrive in place.Microsoft 365 tenant-to-tenant guide
2Choose the path for each device type
Device typeLeave the sourceJoin the target
Windows, Autopilot registeredWipe, delete the Intune record, deregister from AutopilotImport hardware hash, assign Autopilot profile, user completes setup
Windows, Entra joined without AutopilotWipeUser joins the target at setup, or register in target Autopilot first
Windows, hybrid joinedWipe; delete the computer object from on-premises ADAutopilot or join to the target domain and Entra ID
macOS and iOS/iPadOS, ADEUnassign from the source MDM server in Apple Business Manager, wipeAssign to the target Intune MDM server; Setup Assistant enrols
iOS/iPadOS and macOS, user enrolledRetireUser enrols again with Company Portal
Android Enterprise fully managed, dedicated, corporate work profileWipeRe-enrol with the target enrolment token or QR code
Android personally owned work profileRetire (wipe is not supported)User signs in to Company Portal with the target account
Autopilot Reset does not move tenants. Microsoft says Autopilot Reset keeps the device's Microsoft Entra ID and Intune enrolment. Use a full wipe or Reset this PC instead.
3Inventory devices and enrolment types3 steps
  1. 1

    Export managed devices

    Where: PowerShell 7 on your admin PC, connected with Connect-MgGraph to the SOURCE tenant

    Record each device's platform, serial number, owner type, primary user and join type so you can assign it to a wave. Install the module first if needed (install Microsoft Graph PowerShell) and consent to the scopes when the browser asks.

    Install-Module Microsoft.Graph -Scope CurrentUser
    Connect-MgGraph -Scopes "DeviceManagementManagedDevices.Read.All","DeviceManagementServiceConfig.Read.All"
    Get-MgDeviceManagementManagedDevice -All |
      Select-Object DeviceName,OperatingSystem,OSVersion,SerialNumber,ManagedDeviceOwnerType,DeviceEnrollmentType,UserPrincipalName,AzureAdDeviceId |
      Export-Csv C:\migration\intune-devices.csv -NoTypeInformation
    You should see: C:\migration\intune-devices.csv has one row per managed device.
  2. 2

    Export Autopilot registrations

    Where: The same PowerShell session

    List Autopilot devices with their group tags. You will need the serial numbers to deregister them and the group tags to recreate targeting in the target.

    Get-MgDeviceManagementWindowsAutopilotDeviceIdentity -All |
      Select-Object SerialNumber,Model,GroupTag,EnrollmentState |
      Export-Csv C:\migration\autopilot-devices.csv -NoTypeInformation
    You should see: C:\migration\autopilot-devices.csv lists every registered serial number with its group tag.
  3. 3

    Map devices to users and waves

    Where: Your Migration wave plan (add the two CSVs as tabs)

    Pair each device with its user's migration wave. A device should move on the same day its user starts signing in with the target account. Keep each day under the Wipe and Retire limits in Step 9.

    You should see: Every device row has a wave number and date.
4Rebuild Intune configuration in the target6 steps

Plan to recreate every enrolment setting, policy and app in the target before the first device moves. Document each one from the source as you go.

  1. 1

    Enrolment prerequisites

    Where: TARGET tenant Azure portal (portal.azure.com) > Microsoft Entra ID > Mobility (MDM and WIP) > Microsoft Intune

    Microsoft lists an Intune subscription, Windows automatic enrolment and a Microsoft Entra ID P1 or P2 subscription as requirements for Autopilot. Under MDM user scope select All, or Some and pick the migrating user groups, then select Save. Set enrolment restrictions in the target Intune admin center so the platforms you are moving are allowed.

    You should see: MDM user scope shows All or your groups, and the change is saved.
  2. 2

    Autopilot profiles and Enrollment Status Page

    Where: TARGET tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > By platform: Windows > Device onboarding: Enrollment > Windows Autopilot

    Select Deployment Profiles > Create Profile > Windows PC, name it, set Deployment mode to User-driven and Join to Microsoft Entra ID as to Microsoft Entra joined, assign it to your device groups under Included groups and select Create. Then select Enrollment Status Page > Create, set Show app and profile configuration progress to Yes and assign it. If you use group tags, create dynamic device groups in the Entra admin center that match the same tags (rule shown below) so imported devices pick up the right profile.

    (device.devicePhysicalIds -any (_ -eq "[OrderID]:Sales"))
    You should see: The profile and ESP are listed with your groups assigned.
  3. 3

    Compliance, configuration and security policies

    Where: TARGET tenant Microsoft Intune admin center (intune.microsoft.com): Devices (compliance policies and configuration profiles) and Endpoint security (disk encryption and other security policies); Conditional Access in the Microsoft Entra admin center

    Recreate compliance policies, configuration profiles, endpoint security policies (including BitLocker and FileVault), update rings and Conditional Access, using your source documentation. Assign them to the same groups. Point Conditional Access at the target device compliance state.

    You should see: Each source policy has a matching target policy with assignments, recorded in your wave plan.
  4. 4

    Apps

    Where: TARGET tenant Microsoft Intune admin center (intune.microsoft.com) > Apps

    Re-upload Win32 and line-of-business packages, and add Microsoft Store, Apple VPP and managed Google Play apps in the target. Assign them to the same groups. Mark the apps users need at first sign-in as blocking apps in the Enrollment Status Page.

    You should see: Every app in the source inventory is listed in the target with assignments.
  5. 5

    Apple ADE token and default enrolment policy

    Where: TARGET tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > Enrollment > Apple tab, then Apple Business Manager (business.apple.com)

    Create the Apple MDM push certificate on the Apple tab, then the ADE token under Enrollment program tokens, following Microsoft's linked set-up pages. Then select the token > Enrollment policies > Create policy > iOS/iPadOS (and macOS if needed). Return to Enrollment program tokens, select the token and choose Set Default Policy, pick the policy and select Save. Create the default early: Microsoft says a synced Apple device with no enrolment policy fails enrolment.

    You should see: The token is listed as active and a default enrolment policy is set.
  6. 6

    Android Enterprise connection and enrolment profiles

    Where: TARGET tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > Enrollment > Android tab

    Connect the target tenant to managed Google Play (Microsoft's "Connect your Intune account to your Android Enterprise account" page). Under Android Enterprise > Enrollment Profiles choose Corporate-owned, fully managed user devices (or dedicated, or corporate-owned work profile) and select Create policy. Select the profile, then Token, to see the token and export it.

    You should see: Each corporate Android enrolment type you use has a profile with an active token.
5Back up data, BitLocker keys and local admin passwords4 steps
  1. 1

    Move user data first

    Where: Each user's device: the OneDrive icon in the taskbar notification area > Settings > Sync and back up > Manage back up

    A wipe removes all local data and Microsoft says it cannot be recovered. Confirm Known Folder Move is redirecting Desktop, Documents and Pictures to OneDrive and that OneDrive content has been migrated to the target. See OneDrive cross-tenant migration.

    You should see: Desktop, Documents and Pictures show as backed up, and the user's files are visible in the target OneDrive.
  2. 2

    Export BitLocker recovery keys

    Where: PowerShell 7 on your admin PC, connected with Connect-MgGraph to the SOURCE tenant, as a Cloud Device Administrator or Helpdesk Administrator

    Microsoft says to back up the BitLocker recovery key and local administrator credentials before retiring or deleting an Entra-joined device. Export keys from the source Entra ID while the device records still exist. Save to a folder only you can read.

    Connect-MgGraph -Scopes "BitlockerKey.Read.All"
    Get-MgInformationProtectionBitlockerRecoveryKey -All |
      ForEach-Object {
        $k = Get-MgInformationProtectionBitlockerRecoveryKey -BitlockerRecoveryKeyId $_.Id -Property key
        [pscustomobject]@{ DeviceId = $_.DeviceId; KeyId = $_.Id; Created = $_.CreatedDateTime; Key = $k.Key }
      } | Export-Csv C:\secure\bitlocker-keys.csv -NoTypeInformation
    You should see: C:\secure\bitlocker-keys.csv has one row per key, with a 48-digit recovery password in the Key column.
  3. 3

    Check protectors on a device

    Where: Command Prompt run as administrator on the Windows device

    List the key protectors to match the key ID with your export.

    manage-bde.exe -protectors -get C:
    You should see: A Numerical Password protector whose ID matches a KeyId in your export.
  4. 4

    Protect the export

    Where: Your organisation's secured file share or password vault

    Store the key file in a secured location with restricted access and delete it once devices are re-encrypted in the target. Record where it is and who can open it.

    You should see: The file is in the secured location and removed from your PC.
Deleting or retiring suspends BitLocker. Microsoft says that when you delete or retire the Intune object for a BitLocker-protected Entra-joined device, Intune removes key protectors and suspends BitLocker on the OS volume. Plan the wipe soon after.
6Collect Windows hardware hashes3 steps
  1. 1

    Run Get-WindowsAutopilotInfo

    Where: Each Windows device: Start > type PowerShell > right-click Windows PowerShell > Run as administrator (or a script deployed from the source Intune)

    The script comes from the PowerShell Gallery; the commands below install and run it. The output CSV holds the serial number, product ID and hardware hash. Full steps, including the direct upload option: export an Autopilot hardware hash. Type Y if asked to install NuGet.

    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
    New-Item -Type Directory -Path "C:\HWID"
    Set-Location -Path "C:\HWID"
    $env:Path += ";C:\Program Files\WindowsPowerShell\Scripts"
    Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned
    Install-Script -Name Get-WindowsAutopilotInfo
    Get-WindowsAutopilotInfo -OutputFile AutopilotHWID.csv
    You should see: C:\HWID\AutopilotHWID.csv exists with a header line and one device line.
  2. 2

    Prepare import files

    Where: Notepad on your admin PC

    Combine hashes into files of up to 500 rows. Microsoft requires the exact header, no extra columns, no quotation marks and ANSI text. Edit in Notepad, not Excel, because Excel produces a file that cannot be imported. Add the group tag in the Group Tag column if you use one. Save with Encoding: ANSI.

    Device Serial Number,Windows Product ID,Hardware Hash,Group Tag,Assigned User
    <serialNumber>,<ProductID>,<hardwareHash>,<optionalGroupTag>,<optionalAssignedUser>
    You should see: One or more ANSI CSV files, each with the exact header and no more than 500 device lines.
  3. 3

    Ask your hardware partner

    Where: Email to your reseller or OEM, with the serial number list and the target tenant ID

    Microsoft recommends Partner Center for most Autopilot registrations. If your reseller or OEM registers devices for you, ask them to move registrations to the target tenant instead of collecting hashes yourself.

    You should see: The partner confirms which serial numbers they will move and when.
7Move Windows devices on cutover day6 steps

A device cannot be registered in the target while it is still registered to the source; the import fails with ZtdDeviceAssignedToAnotherTenant. Work through each batch in this order.

  1. 1

    Wipe the device from the source

    Where: SOURCE tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > All devices > select the device

    In the action row select Remove data > Wipe, leave both options unticked (No options selected) so all data, accounts and enrolment are removed, and select Wipe to confirm. Tell the user to leave the device at the first setup screen once it restarts. Users can also run Reset this PC from Settings.

    You should see: The device shows a pending wipe, then restarts to the Windows setup screen.
  2. 2

    Delete the source Intune record

    Where: SOURCE tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > By platform: Windows > select the device

    Note the device's Serial number, then select Delete in the toolbar and Yes to confirm.

    You should see: The device no longer appears in the Windows devices list.
  3. 3

    Deregister from source Autopilot

    Where: SOURCE tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > By platform: Windows > Device onboarding: Enrollment > Windows Autopilot: Devices

    Search by serial number and tick the device. Select ... at the end of the row and choose Unassign user if it is available, then OK. With the device still ticked, select Delete and Yes. Select Sync, then Refresh every few minutes until the device disappears.

    You should see: The serial number is no longer listed in Windows Autopilot devices.
  4. 4

    Handle the Entra and AD records

    Where: Active Directory Users and Computers on a domain controller (hybrid-joined devices only)

    For Entra-joined devices, Microsoft says no extra steps are needed and to avoid manually deleting the device from Microsoft Entra ID. For hybrid-joined devices, delete the computer object from on-premises AD DS so it does not resync.

    You should see: Hybrid devices are gone from AD; Entra-joined device objects are left alone.
  5. 5

    Import into target Autopilot

    Where: TARGET tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > By platform: Windows > Device onboarding: Enrollment > Windows Autopilot: Devices

    Select Import in the toolbar, browse to the CSV and select Import. When the import finishes, select Sync and Refresh until the devices appear. Confirm each batch registered before importing the next.

    You should see: The devices appear by serial number in the target list.
  6. 6

    Confirm the profile, then let the user sign in

    Where: TARGET tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > By platform: Windows > Device onboarding: Enrollment > Windows Autopilot: Devices (Profile status column), then the device's setup screen

    Wait until each device shows Profile status Assigned. Then the user restarts or continues setup, signs in with the target account and the Enrollment Status Page applies policies and apps.

    You should see: Setup shows the target organisation's sign-in page and the Enrollment Status Page completes to the desktop.
Keep the gap short and the order strict. Microsoft warns that skipping steps or removing records out of order can leave orphaned records or unrecoverable devices. A device that reaches setup while still registered to the source will pick up the source Autopilot profile.
8Move macOS, iOS and iPadOS devices6 steps
  1. 1

    ADE devices: switch the MDM server in Apple Business Manager

    Where: Apple Business Manager (business.apple.com) > Devices, then TARGET tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > Enrollment > Apple tab > Enrollment program tokens

    Microsoft says a device deleted from Intune but still assigned to the ADE token reappears on the next full sync. In Apple Business Manager, sign in as an Administrator or Device Enrollment Manager, select Devices, search for the serial numbers and select them, choose Edit next to Edit MDM Server, choose Assign to Server and pick the MDM server linked to the target token, then Continue twice. In the target Intune, select the token, then Devices > Sync.

    You should see: The devices appear under the token's Devices list in the target Intune.
  2. 2

    Check the enrolment policy

    Where: TARGET tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > Enrollment > Apple tab > Enrollment program tokens > the token > Devices

    Confirm the devices show in the target with an enrolment policy assigned. Microsoft notes that changes to an ADE enrolment policy only take effect after the device is reset.

    You should see: Each device lists the default (or chosen) enrolment policy.
  3. 3

    Wipe and re-enrol

    Where: SOURCE tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > All devices > select the device > Remove data > Wipe (or the device's Settings app or Apple Configurator)

    Wipe the device from the source Intune, or retire it and reset it with the Settings app or Apple Configurator. Setup Assistant then enrols it into the target. With Await final configuration set to Yes, the user sees a locked screen until Intune applies configuration policies.

    You should see: Setup Assistant shows the target organisation's Remote Management screen and the device appears in the target Devices list.
  4. 4

    Different Apple organisation

    Where: Apple Business Manager of the source organisation, agreed with your Apple reseller

    If the target uses a different Apple Business Manager organisation, the source must release the device. Microsoft says Release from Organization cannot be undone. Agree with your Apple reseller how each device will be added to the target organisation before you release it.

    You should see: The reseller confirms in writing how each released serial number will be added to the target organisation.
  5. 5

    User-enrolled devices

    Where: SOURCE tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > All devices > select the device > Remove data > Retire, then the Company Portal app on the device

    Select Retire and Yes. The user removes the management profile if it remains (Settings > General > VPN & Device Management on iOS), then enrols with Company Portal signed in with the target account.

    You should see: The device shows in the target Intune with the user as primary user.
  6. 6

    Clean up the source token

    Where: SOURCE tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > Enrollment > Apple tab > Enrollment program tokens

    Microsoft lets you delete an ADE token only when no devices or enrolment policies are assigned to it. After the last device has moved, select the token > Devices and delete any remaining devices, then Enrollment policies and delete them (including the default), then return, select the token and select Delete.

    You should see: The token is no longer listed in the source tenant.
9Move Android devices3 steps
  1. 1

    Corporate-owned devices

    Where: SOURCE tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > All devices > Bulk device actions (or the single device > Remove data > Wipe), then the device's setup screen

    Fully managed, dedicated and corporate-owned work profile devices are wiped from the source, then enrolled with the target enrolment profile token or QR code from Step 3. Intune supports bulk wipe of up to 100 of these devices per action: on Basics choose Android and Wipe.

    You should see: After reset and enrolment with the target token, the device appears in the target Intune.
  2. 2

    Personally owned work profile

    Where: SOURCE tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > All devices > select the device > Remove data > Retire, then Company Portal on the device

    Wipe is not supported for personally owned work profile devices. Retire them, which removes the work profile data, apps and settings, then ask the user to sign in to Company Portal with the target account.

    You should see: The work profile is removed, then recreated under the target tenant.
  3. 3

    Zebra and Samsung devices

    Where: Your device inventory (filter by manufacturer)

    Microsoft says Wipe on Zebra Android devices removes only corporate data and does not factory reset, and that Samsung fully managed devices with Factory Reset blocked lose contact with Intune during a wipe. Check these models before you start and plan a manual factory reset where needed.

    You should see: Each Zebra or Samsung model has a written reset method in the wave plan.
10Plan cutover-day timing and batch sizes4 steps
  1. 1

    Respect the daily action limits

    Where: Your Migration wave plan

    Microsoft says a tenant can submit up to 500 Wipe actions and 1,000 Retire actions per day, counting individual, bulk and Graph requests. Size device waves within these limits.

    You should see: No day in the plan exceeds 500 wipes or 1,000 retires.
  2. 2

    Align with identity cutover

    Where: Your Cutover runsheet

    Move devices after the user's target account is active, licensed and has its mailbox and OneDrive in place. Before that, the user has nothing to sign in to.

    You should see: Each device wave date falls on or after the matching user wave.
  3. 3

    Run a pilot

    Where: Your Pilot test plan

    Move a handful of devices for each platform and enrolment type through the full sequence before the first production wave. Record how long each step took.

    You should see: Every pilot device reaches a working desktop or home screen in the target, with the timings recorded.
  4. 4

    Check the join on each device

    Where: Command Prompt on the Windows device, signed in as the user

    After setup, confirm the device is joined to the target tenant.

    dsregcmd /status
    You should see: AzureAdJoined : YES, and TenantName and TenantId show the target tenant.
What to look for in dsregcmd. AzureAdJoined should be YES and TenantName and TenantId should show the target tenant. Run the command in the user's context to see AzureAdPrt for single sign-on.
11Validate and clean up3 steps
  1. 1

    Confirm compliance and key escrow

    Where: TARGET tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > All devices > select the device > Monitor: Recovery keys

    Check the device's Compliance column shows Compliant, then open Recovery keys and confirm a BitLocker recovery key is listed for the device.

    You should see: The device is Compliant and a recovery key is listed.
  2. 2

    Delete the BitLocker key export

    Where: The secured location from Step 4

    Once target keys are escrowed, delete the exported source keys according to your security policy, and record the date.

    You should see: The export file no longer exists and the deletion is logged.
  3. 3

    Remove stale source records

    Where: SOURCE tenant Microsoft Intune admin center (intune.microsoft.com) > Devices (and Devices > By platform: Windows > Device onboarding: Enrollment > Windows Autopilot: Devices)

    Delete any remaining source Intune and Autopilot records. Intune cleanup rules can remove device records that have not checked in for a set period, but Microsoft says they do not remove Entra device records.

    You should see: The source device and Autopilot lists contain no migrated devices.
Worth knowing

Expert notes

The detail behind the plan: options compared, and what experienced engineers check first. Tap any item.

Compare all the ways to do this4 options

Wipe and re-provision with Autopilot (corporate Windows)

Medium effort

Best for: Company-owned Windows devices you can register in the target Autopilot service

  • The documented path: deregister in the source, import the hardware hash in the target, reset
  • Devices arrive with the target configuration, apps and Enrollment Status Page
  • Up to 500 devices per Autopilot CSV import
  • Local data is erased, so back up first
  • Tenant daily limits apply to Wipe actions
  • Users lose their device for the reset and setup time
Read more →

Reassign Apple ADE or re-enrol Android corporate devices

Medium effort

Best for: macOS, iOS, iPadOS and Android Enterprise corporate devices

  • Apple devices move by changing the MDM server assignment in Apple Business Manager
  • Setup Assistant or the target enrolment token brings the device under target management
  • Devices are wiped as part of the move
  • Needs the target ADE token or Android enrolment profile ready first

Retire and let users re-enrol (personal devices)

Low effort

Best for: Personally owned phones and tablets with user enrolment or a work profile

  • Personal data stays on the device
  • Users re-enrol themselves with Company Portal and the target account
  • Relies on each user completing enrolment
  • Retire removes work data, apps and settings from the device

Third-party in-place device migration tool

High effort

Best for: Windows estates where a wipe and rebuild is not acceptable

  • Can avoid a full reset for some devices, depending on the vendor
  • Not a path Microsoft documents for Intune
  • Behaviour and support vary by vendor, so pilot carefully
Our advice

Pick the path per device type, not per project: wipe and Autopilot for corporate Windows, ABM reassignment for Apple ADE, and retire plus Company Portal for personal devices. Consider an in-place tool only if a wipe is truly unacceptable, and test it on a pilot group first. Do not use Autopilot Reset, because Microsoft says it keeps the existing tenant enrolment.

Size waves to the daily Wipe and Retire limitsSaves time

Microsoft caps each tenant at 500 Wipe and 1,000 Retire actions a day, counting single, bulk and Graph requests together. A large fleet planned for one weekend will stall half way.

What to do

Plan device waves below those numbers per day, and leave headroom for re-runs. Check whether your tenant uses Multiple Administrative Approval for wipe, because a second admin must then approve each action.

Microsoft Learn: Wipe action in Intune
Get user data off the device before anyone presses WipeUser impact

A wipe removes all local data and Microsoft says it cannot be recovered. Files saved outside OneDrive-redirected folders, browser profiles and local app data are the usual losses.

What to do

Check Known Folder Move status in the OneDrive sync client on pilot devices, ask users to move anything in other folders into OneDrive, and confirm OneDrive content has reached the target tenant before the device wave.

Tools that can get around this

Instead of wiping, these tools move a Windows device to the target tenant and keep the user's profile, so local data stays on the device. Microsoft's supported path is still a wipe and re-enrolment, so test them on pilot devices first.

  • Quest On Demand MigrationMoves Entra joined Windows devices to another tenant, switches Intune enrolment to the new tenant and updates user profiles.
  • ForensiT User Profile WizardMigrates a profile from an existing Azure AD (Entra ID) tenant account to the new tenant account. It does not handle Intune enrolment.
Third-party tools, not endorsed by the platform vendor. Confirm in the tool's documentation and run a pilot first.
Microsoft Learn: Wipe action in Intune
Export BitLocker keys while the source records still existReduces risk

Recovery keys are stored against the device object in the source tenant. Deleting or retiring the Intune record suspends BitLocker and removes protectors, and once the device record is gone the key is hard to find if a device locks during the move.

What to do

Export keys with Graph (Step 4) before the first wave, store the file with restricted access, and delete it once target keys show under Devices > All devices > device > Recovery keys.

Microsoft Learn: Encrypt Windows devices with BitLocker in Intune
Do not use Autopilot Reset to change tenantsReduces risk

Autopilot Reset keeps the device's Microsoft Entra ID join and Intune enrolment, so the device comes back in the source tenant. It looks like a shortcut and is not one.

What to do

Use a full Wipe with no options ticked, or Reset this PC, after deregistering the device from source Autopilot.

Microsoft Learn: Autopilot Reset
Build and test the target configuration before the first device movesUser impact

A device that enrols into an empty target tenant gets no Wi-Fi, VPN, certificates or apps. Users then cannot reach the network to finish setup, and Conditional Access may block them.

What to do

Recreate compliance, configuration, Wi-Fi, VPN and certificate profiles, apps and the Enrollment Status Page first. Run the pilot devices through a full reset and check the user reaches a working desktop on site and at home.

Tools that can get around this

Intune has no tenant-to-tenant copy of policies. This tool exports configuration, compliance, endpoint security, app and script objects from the source tenant and import them into the target, so you review and adjust instead of rebuilding every profile by hand. Certificates, Wi-Fi keys and app content still need checking in the target.

  • IntuneManagement (open source)Exports and imports Intune objects with assignments between tenants, using a migration table to map groups and creating missing groups in the target. It uses the Graph beta API.
Third-party tools, not endorsed by the platform vendor. Confirm in the tool's documentation and run a pilot first.
Microsoft Learn: User-driven Microsoft Entra join: Configure the Enrollment Status Page
Agree Apple device release with your reseller before you release anythingReduces risk

If the target uses a different Apple Business Manager organisation, the source must release devices, and Microsoft says Release from Organization cannot be undone. Released devices lose automated enrolment until they are added to the new organisation.

What to do

Where both tenants can share one Apple Business Manager organisation, reassign devices between MDM servers instead of releasing them. Otherwise get written agreement from your Apple reseller on how they will add each serial number to the target organisation first.

Microsoft Learn: Manage Apple ADE devices and tokens
Keep group tags so devices land in the right profileSaves time

Dynamic device groups in the target only pick up imported devices if the group tags match. Without them, devices get no Autopilot profile, or the wrong one.

What to do

Export group tags from source Autopilot (Step 2), include them in the Group Tag column of the import CSV, and create matching dynamic groups in the target before you import.

Microsoft Learn: Manually register devices with Windows Autopilot
Ask your OEM or reseller to move registrationsCost lever

Collecting hardware hashes by hand needs someone at each device. Microsoft recommends Partner Center for most Autopilot registrations, and partners can deregister and register devices for you.

What to do

Send your reseller the serial number list and the target tenant ID and ask whether they can move the registrations. Collect hashes yourself only for devices they cannot cover.

Microsoft Learn: Windows Autopilot registration overview
Finish safely

Check it worked, or roll back

Full validation checklist8 checks

Run these before you declare the migration complete. Record the results in the data validation report.

CheckHow to checkWhat good looks like
Every device in the wave is enrolled in the target

Connected to the TARGET tenant with Connect-MgGraph, run Get-MgDeviceManagementManagedDevice -All | Select-Object DeviceName,SerialNumber,OperatingSystem,UserPrincipalName | Export-Csv C:\migration\target-devices.csv -NoTypeInformation and compare serial numbers with the wave rows in C:\migration\intune-devices.csv.

Every serial number in the wave is in the target export, with the right primary user.
Autopilot registrations moved with group tags

In the target run Get-MgDeviceManagementWindowsAutopilotDeviceIdentity -All | Select-Object SerialNumber,GroupTag,EnrollmentState and compare with C:\migration\autopilot-devices.csv. In the source, search Devices > Windows > Windows enrollment > Devices for the same serial numbers.

Each Windows device is registered in the target with its group tag and profile status Assigned, and none remain in source Autopilot.
Windows devices are joined to the target tenant

On sample devices run dsregcmd /status in Command Prompt signed in as the user.

AzureAdJoined is YES and TenantName and TenantId show the target tenant.
Devices are compliant and policies applied

In the TARGET Microsoft Intune admin center > Devices > All devices, check the Compliance column, then open a device > Device configuration to see profile status.

Devices show Compliant, and configuration and endpoint security profiles show Succeeded with no Error or Conflict.
BitLocker keys are escrowed in the target

In the TARGET Microsoft Intune admin center open each Windows device > Recovery keys, or run Get-MgInformationProtectionBitlockerRecoveryKey -All connected to the target.

Every encrypted Windows device has a recovery key in the target before you delete the source key export.
Apps install and users can work

In the TARGET Intune admin center > Apps > select each required app > Device install status. Ask pilot users to open Outlook, Teams and OneDrive and check OneDrive shows their target files.

Required apps show Installed, and users reach their mail, Teams and restored OneDrive folders.
Apple and Android devices are under the target

In Apple Business Manager > Devices, check each ADE serial number's MDM server. In the TARGET Intune admin center > Devices > iOS/iPadOS, macOS and Android, check each device is listed with the right enrolment type.

ADE devices are assigned to the target MDM server and enrolled, and Android devices are enrolled with the target profiles.
The source no longer manages any migrated device

In the SOURCE Microsoft Intune admin center > Devices > All devices, search for the wave's serial numbers, and check the ADE token's Devices list.

No migrated device is listed in the source, and the source ADE token has no migrated devices assigned.
Rollback planIf it goes wrong

Roll back if

  • Pilot devices fail the Enrollment Status Page or cannot reach a working desktop in the target
  • Target compliance or Conditional Access blocks migrated devices from mail and files
  • A required app or line-of-business package will not install from the target
  • Users' OneDrive data is not available in the target when their device is wiped
  • Autopilot import fails because the device is still registered to the source

Point of no return

For each device the point of no return is the Wipe. Before it, nothing has changed on the device and you can stop. After it, Microsoft says local data cannot be recovered, and the device is no longer managed by the source. You can still enrol it back into the source, but only by deregistering it from the target and repeating the enrolment. Data that was not in OneDrive before the wipe is lost. Retiring or deleting a BitLocker-protected device suspends BitLocker, so keep the key export until the device is re-encrypted wherever it ends up.

  1. 1

    Stop the wave before the next wipe

    Where: Your Cutover runsheet and Migration wave plan

    Hold every device that has not been wiped. Leave its source Intune and Autopilot records untouched, and tell its users to keep working.

    You should see: No more devices are wiped, and held devices stay compliant in the source.
  2. 2

    Remove the device from target Autopilot

    Where: TARGET tenant Microsoft Intune admin center (intune.microsoft.com) > Devices > By platform > Windows > Windows enrollment > Devices

    Delete the device from target Intune first (Devices > All devices > select it > Delete), then search Autopilot devices by serial number, unassign the user if needed and select Delete.

    You should see: The serial number no longer appears in the target Autopilot list.
  3. 3

    Re-register Windows devices in the source

    Where: SOURCE tenant Microsoft Intune admin center > Devices > By platform > Windows > Windows enrollment > Devices > Import

    Import the same hardware hash CSV you collected earlier (or ask your partner to register it again), then select Sync and wait for Profile status Assigned. Wipe the device from the target, then let the user sign in with their source account.

    You should see: Setup shows the source organisation's sign-in page and the device enrols in the source.
  4. 4

    Reassign Apple ADE devices back

    Where: Apple Business Manager (business.apple.com) > Devices, then SOURCE tenant Microsoft Intune admin center > Devices > Enrollment > Apple > Enrollment program tokens

    Change the MDM server of the affected serial numbers back to the source server, select Sync on the source token, then wipe and re-enrol the device from Setup Assistant.

    You should see: The device appears under the source token and enrols with the source enrolment policy.
  5. 5

    Re-enrol Android devices with source profiles

    Where: Each Android device, and SOURCE tenant Microsoft Intune admin center > Devices > Enrollment > Android

    Factory reset corporate-owned devices and enrol them with the source enrolment token, or have the user add the work profile again for personally owned devices.

    You should see: The device shows in the source Intune with its user as primary user.
  6. 6

    Restore BitLocker and record the outcome

    Where: Command Prompt run as administrator on each device, then your Rollback plan

    Run manage-bde.exe -status C: to confirm protection is on and check a key is escrowed in the tenant now managing the device. Record which devices were rolled back and why.

    You should see: Protection Status shows Protection On, a recovery key is listed, and the Rollback plan has a dated entry.

Agree the triggers and who decides before the go / no-go meeting. Use the rollback plan template.

Common problems and fixes7 errors
ZtdDeviceAssignedToAnotherTenant

Cause: The hardware hash matches a device still registered to a different tenant.

Fix: Delete the device from source Intune, deregister it from source Autopilot, sync, then import again in the target.

ZtdDeviceAlreadyAssigned

Cause: The device is already registered in this tenant.

Fix: Search for the serial number in Windows Autopilot devices. If it is not listed, import it again.

Autopilot CSV import fails

Cause: The file was saved from Excel, uses Unicode, has quotation marks or extra columns, or has more than 500 rows.

Fix: Rebuild the file in Notepad with the exact header, ANSI encoding and up to 500 rows.

Device shows the old organisation's sign-in page after reset

Cause: The device was reset before it was deregistered from the source Autopilot service.

Fix: Leave it at setup, complete the deregistration and target import, wait for the profile to assign, then restart setup.

iOS device reappears in the source Intune after deletion

Cause: The device is still assigned to the source ADE token in Apple Business Manager.

Fix: Unassign it from the source MDM server in Apple Business Manager, then delete it again.

iOS enrolment fails with Invalid Profile

Cause: The All Users device type restriction in the target blocks iOS/iPadOS.

Fix: Allow iOS/iPadOS in the target enrolment restrictions and reset the device.

Wipe is unavailable for an Android device

Cause: The device is a personally owned work profile device, where wipe is not supported.

Fix: Use Retire and have the user re-enrol with the target account.

Search the full error library →

FAQ

Frequently asked questions

Can I move a device to a new Intune tenant without wiping it?

Microsoft's documented paths reset corporate devices or retire and re-enrol personal ones. Third-party tools that move Windows devices in place exist; test them carefully in a pilot.

Do I need to collect hardware hashes again?

Yes, unless your OEM or reseller moves the registration for you. The target tenant needs each device's hash, imported in files of up to 500 devices.

Does Intune Wipe remove the Autopilot registration?

No. Microsoft says to deregister the device from Windows Autopilot separately after the wipe.

Should I delete the device from Microsoft Entra ID?

For Entra-joined Autopilot devices, Microsoft says to avoid manually deleting the device from Entra ID after deregistering. For hybrid-joined devices, delete the on-premises AD computer object.

What happens to BitLocker keys?

Keys escrowed in the source stay with the source device records. Export them before you delete or retire devices, and confirm new keys are escrowed in the target after re-encryption.

How many devices can I move in a day?

Microsoft limits each tenant to 500 Wipe and 1,000 Retire actions per day, and Autopilot imports to 500 devices per CSV.

Sources

Official sources

16 official pages this guide is based on