On Demand Migration Current - Microsoft Entra ID Device Join Quick Start Guide

On Demand Migration Active Directory Project

This section provides a step-by-step guide on how to configure Active Directory Migration configurations and migrating the source device to target Microsoft Entra ID only tenant. 

Install the local agent on the workstation

Install the local agent on the workstation

1. Log in to On Demand.

2. Navigate to Migration, select the project, and click on Active Directory.

3. Click on the Active Directory icon.

4. Via the hamburger menu, click on Configurations.

5. Download the latest device agent and note the Service URL and Auth Key for later use.

6. Copy the agent installation file onto the workstation and run the installer.  The installer will prompt you to enter the Service URL and Auth Key noted in the previous step. Follow the installer wizard to complete the installation process.

   

   

7. After the agent installation completes, you should see the device under the Ready Devices tab via Devices + Servers in the Hamburger Menu.

Note: by default, when the agent is first installed, it may take up to 4 hours for the agent to be registered and show up in On Demand Migration Active Directory “Ready Devices” view.

Setup the Microsoft Entra ID Bulk Enrollment Repository and Microsoft Entra ID Join Migration Profile

Setup the Microsoft Entra Bulk Enrollment Repository and Microsoft Entra ID Join Migration Profile

1. Log in to On Demand.

2. Navigate to Migration, select the project, and click on Active Directory.

3. Click on the Active Directory icon.

   

4. Via the hamburger menu, click on Configurations.

   

5. Click on Repositories and fill in the Provisioning Package Local Path or Shared Folder’s UNC Path under Microsoft Entra Bulk Enrollment.  Click Save.

   

6. Via the hamburger menu, click on Profiles.

   

7. Click on Microsoft Entra Join tab, and click on Add to create a new Microsoft Entra Join Profile.

8. Enter the following information in the profile and click Save.

   1. Name of the Profile

   2. Provisioning Package File Name

   3. Source Domain Credential

   4. Specify the target Microsoft Entra tenant

   5. Choose an option to either preserve the computer name or use the name defined in the provisioning package.

      

   6. Click Next

   7. Enter the Source Domain Credential information including the Domain FQDN.  Note, if the source device is an Microsoft Entra Join Cloud Only device, you may uncheck the “Active Directory Joined or Microsoft Entra Hybrid Joined” option.

      For Preflight check validation, choose this option if the source device is a remote workstation that does not have access to Local On-Premise Active Directory.

      

   8. Click Save Profile

Perform Device Migration

This section provides a step-by-step guide on how to perform the Device Migration to Microsoft Entra ID Join including Device ReACLing, and Device Cutover.

1. Log in to On Demand.

2. Navigate to Migration, select the project, and click on Active Directory.

3. Click on the Active Directory icon.

4. Via the hamburger menu, click on Devices + Servers.

5. First, we will define the target environment for the device. 

Select the device, select Set Target Environment from the drop-down action menu, click Apply Action. In the pop-up window, select the target Microsoft Entra tenant and click Apply.

6. Next, we will perform the Device ReACL in preparation for Microsoft Entra ID Join cutover.

Select ReACL via the drop-down action menu, click Apply Action. In the pop-up window, click Apply.

7. The Device will receive the ReACL job shortly and complete the processing.  You may check the job status via the ReACL Status or select View Jobs action from the drop-down menu.

8. Next, we will perform the Microsoft Entra ID Join device cutover.

Select Microsoft Entra ID Cutover via the drop-down action menu, click Apply Action. In the pop-up window, select the Microsoft Entra ID Profile configured earlier and click Apply.

9. The Device will receive the Microsoft Entra ID Cutover job request shortly and perform the reboot to complete the Microsoft Entra ID device join.  You may check the job status via the Microsoft Entra ID Cutover Status or select View Jobs action from the drop-down menu.