On Demand Migration Current - Active Directory User Guide

What is a Migration Profile?

A Migration Profile is a collection of common settings used to manage the domain join process during Device Cutover which can be defined once and then applied to multiple Devices. Migration Profiles are used for AD and Hybrid Microsoft Entra ID device migrations.

How are Migration Profiles created?

To create a Migration Profile:

1. On the Migration section of the Profiles page, click the Add button. The Add Your Migration Profile window appears.
2. Enter values for the following fields, then click Next:
   • Profile Name - A name to identify this profile (for example, "10 Second Reboot Delay").
   • Domain Join Delay - The delay time a Device agent processing a Cutover job applies before attempting to change the computer's domain to join the new domain.
   • Reboot Delay - The time for a Device agent processing a Cutover job to delay after joining the new domain before rebooting the computer. If set to any value other than zero (0), the user will receive a pop-up notification informing them that the workstation will be rebooted when the Cutover is performed. If set to zero, no notification will appear.
3. Select desired Microsoft Entra ID Device Options, then click Next:
   • Perform Microsoft Entra Hybrid Leave – This will unjoin the Device from the source Microsoft Entra ID if it is currently hybrid Microsoft Entra ID joined.
4. Enter values for the following fields, then click Next:
   • Empty Recycle Bin? - How to handle the Recycle Bin during Cutover, either Empty or Don't Empty. End users may get an error message that their Recycle Bin has been corrupted after migration if the Recycle Bin is not empty. See Troubleshooting for more information about this issue.
   • Specify Target OU - The target OU where the Device will be created. If this field is left blank, they will default to the Computers container.
   • Join to Existing Computer Account - Select Yes if you expect to join the Device to the existing target Computer during Cutover. Select No if you want the Device to be created in the target by the Cutover job.
5. Click Save Profile. The new migration profile is added to the list.

What is a Network Profile?

A Network Profile is a collection of common network adapter settings that need to be updated during a Device’s migration to the new domain which can be defined once and then applied to multiple Devices.

How are Network Profiles created?

To create a network Profile:

1. On the Network section of the Profiles page, click the Add button. The Add Your Network Profile window appears.
2. Enter values in the following fields, then click Next:
   • Profile Name - The name to identify this Network Profile
   • Set DNS Servers For the Computer? - Options include: Don't Change This Setting, Use DHCP For DNS Server, or Manually Assign DNS Servers.
   • DNS Suffix For the Network Adapter - The primary DNS suffix that will be set on the network adapter that is connected to the target domain.
3. Enter values in the following fields:
   • Append DNS Suffixes to the Network Adapter - Options include Don't Change This Setting, Preserve Current DNS Suffixes From the Network Adapter, or Set the Following DNS Suffixes.
   • DNS Suffixes (Enabled if Set the Following DNS Suffixes is selected above) - Enter each suffix and then press Enter.
   • .Register the Network Adapter's Addresses in DNS - Options include Don't Change This Setting, No, or Yes.
   • Register the Network Adapter's Addresses in DNS (Enabled if Yes is selected above) – select from Don't Change This Setting, Include the Manual DNS Suffix, or Don't Include the Manual Suffix.
   • Enter the WINS Servers: Primary WINS Server - The preferred WINS server and Secondary Wins Server - The alternate WINS server.
4. Click Save Profile. The new Network Profile is added to the list.

What is a Device ReACL Profile?

A Device ReACL Profile is a collection of ReACL related settings which can be defined once and then applied to multiple Devices.

What is the default Device ReACL Profile used for?

The default Device ReACL Profile is used if a different profile is not defined and set on a Device. The default Device ReACL Profile can be edited.

How are Device ReACL Profiles created?

To create a Device ReACL profile:

1. On the Device ReACL section of the Profiles page, click the Add button. The Add Your Device ReACL Profile window appears.
2. In the Profile Name field, enter a name to identify this Device ReACL Profile.
3. Select a Logging Level, either Informational (default) or Debugging.
4. Select the desired components to process.
   • Local Files/Folders: Selected by default.
   • Registry Permissions: Selected by default.
   • User Profiles: Selected by default.
   • Local Group Memberships: Selected by default.
   • Local Printer Permissions: Selected by default.
   • Network Share Permissions: Selected by default.
   • Printer Share Permissions: Selected by default.
   • Roaming Profiles: Unselected by default.
   • Note: If you select Roaming Profiles, users must be logged out of their roaming profiles during the ReACL process.
   • Windows Services: Selected by default. The Windows Services option will ensure that any source domain accounts that were given permission to a service will include the corresponding matched target domain account after a ReACL process.
   • Windows Service Accounts: Unselected by default. We recommend that the Windows Service Accounts box is left UNCHECKED. A change in the ACL of the service accounts of the target may have an impact on the applications currently running. Although the ReACL process can usually be rolled back in case of issues, there could be a temporary disruption in service until that can be resolved. Selecting the Windows Service Accounts box will switch the domain account that Windows services are running under to the corresponding matched target domain account after a completed ReACL process.
   • User Rights Assignments: Unselected by default.
   • System ACLs: Selected by default. The System ACLs option allows for the proper translation of accounts within the security audit logs.
   • Preserve the "Archive" Bit: Unselected by default. If the Preserve the "Archive" Bit box is left unchecked, the archive bit will be reset. If checked, the archive bit will not be reset.
5. Click Next.
6. Normally all files and folders are included in the ReACL process. If it is preferred to provide a specific list, enter the list in the Only Process the Following and Their Subfolders box. Separate each entry by pressing Enter. You may use just a file path starting with backslashes, or provide an exact drive letter. If a drive letter is provided, the ReACL is limited to that exact path.
7. Note that if you choose to list folders here, these are the ONLY folders that will be included in the ReACL process. (The exception is if you selected the User Profiles component on the previous screen: those profiles would then always be included automatically in addition to your list specified here.)
8. In the Exclude These Paths From Processing box, enter folder paths that will not be included in the ReACL process. Wild card characters (‘*’ matches zero or more characters and ‘?’ matches any single character) can be used when specifying excluded folders. Separate the paths by pressing Enter. By default, the following folders are excluded:
   • \Windows
   • \WINNT
   • \I386
   • \Windows\I386
   • \Program Files
   • \PROGRAM FILES (x86)
   • \MSOCACHE
   • \System Volume Information
   • \Recycler
   • \$RECYCLE.BIN
   • \CONFIG.MSI
   • \RECOVERY
   • \OEM
   • \Quarantine
   • \BOOT
   • \ProgramData\Microsoft\Windows Defender
9. In the Exclude These Files From Processing box, enter files that will not be included in the ReACL process. A leading '\' is not necessary. Wild card characters (‘*’ matches zero or more characters and ‘?’ matches any single character) can be used when specifying excluded files. Separate the files by pressing Enter. The following wild card characters are permitted when specifying files:
   • * matches zero or more characters in a file name, but not the '\' path delimiter.
   • ? matches any single character.
   • ** matches zero or more parent directories.
10. Examples:
    • FileToSkip.dat – a single file in the root directory
    • \FolderToProcess\ExcludedFIle.sys – a single file in the FolderToProcess directory
    • \FolderToProcess\**\*.dat – all .dat files anywhere under the FolderToProcess directory
11. In the Exclude These Registry Keys From Processing box, enter registry keys that will not be included in the ReACL process. A leading '\' is not necessary. Separate the keys by pressing Enter. The following wild card characters are permitted when specifying registry keys:
    • * matches zero or more characters in a key name, but not the '\' path delimiter.
    • ? matches any single character.
    • ** matches zero or more parent keys.
12. Examples:
    • HKEY_LOCAL_MACHINE\SOFTWARE\XYZ – a single key
    • HKEY_LOCAL_MACHINE\SOFTWARE\XY* – all keys starting with "XY" in HKEY_LOCAL_MACHINE\SOFTWARE
    • HKEY_LOCAL_MACHINE\SOFTWARE\?YZ – all 3-character keys ending with "YZ" in HKEY_LOCAL_MACHINE\SOFTWARE
    • HKEY_LOCAL_MACHINE\**\XYZ – all keys named "XYZ" anywhere under HKEY_LOCAL_MACHINE
    • **\XYZ – all keys named "XYZ" in any registry hive
13. In the Exclude These Security Identifiers From Processing box, enter SIDS that will not be included in the ReACL process. Separate the SIDs by pressing Enter.
14. Click Next.
15. The Reparse Point Processing Rules page appears. Reparse Points like Symbolic Links, Mount Points, and OneDrive folders will be processed by ReACL. Additional Reparse Tags can be added to the rules list in the Advanced view to change how ReACL will process those items. Click the Show Advanced button to edit the rules list.
16. When Show Advanced is clicked the rules list is displayed. Additional Reparse Points can added to the list in the "ReparseTag:Action" format. Skip, Recurse, Update, and Full are the available actions. Separate rules by pressing Enter.
17. Click Next.
18. Select an option from the Elevated Permissions Failure Action drop-down list to choose the action that should be taken if the ReACL process encounters permissions elevation errors.
19. In order to successfully adjust permissions, Active Directory must create a process with a security token that has been assigned additional permissions. The token is said to have elevated rights/permissions. If this process fails, it is likely that the ReACL will be largely unsuccessful in updating the operating system for use by target user accounts.
    • The default is Terminate processing with fatal error, this means the ReACL job for a Device is stopped if a permissions elevation error occurs. This is a time-saving option. The ReACL Status will be Failed in the Devices + Servers table. A Device cannot be Cutover if the ReACL Status is Failed. This is the recommended setting.
    • If you choose Log informational entry, an info entry will be logged if a permissions elevation error occurs. If no other errors are encountered the ReACL job will complete as successful and the ReACL Status will be Completed in the Devices + Servers table. This choice allows experienced migration architects to analyze the logs and choose to proceed with Cutover based on their analysis of the results. We suggest choosing “Log warning entry” rather than “Log informational entry” as that will make the entries easier to locate in the log.
    • If you choose Log warning entry, a warning entry will be logged if a permissions elevation error occurs. If no other errors are encountered the ReACL job will complete as successful and the ReACL Status will be Completed in the Devices + Servers table. This choice allows experienced migration architects to analyze the logs and choose to proceed with Cutover based on their analysis of the results.
    • If you choose Log error entry, an error entry will be logged if a permissions elevation error occurs. The ReACL job will continue, but the ReACL Status will be Failed in the Devices + Servers table. This selection may take significantly more time than "Terminate processing with fatal error" because the entire process will attempt to finish before reporting as Failed.
20. Select an option from the Profile Failure Action drop-down list to choose the action that should be taken when an invalid or duplicate profile exists in the target.
    • The default is Terminate processing with fatal error, this means the ReACL process for a Device is stopped if an invalid or duplicate profile error occurs. This is a time-saving option. The ReACL Status will be Failed in the Devices + Servers table. A Device cannot be Cutover if the ReACL Status is Failed. This is the recommended setting.
    • If you choose Log informational entry, an info entry will be logged if an invalid or duplicate profile error occurs. If no other errors are encountered the ReACL job will complete as successful and the ReACL Status will be Completed in the Devices + Servers table. This choice allows experienced migration architects to analyze the logs and choose to proceed with Cutover based on their analysis of the results. We suggest choosing “Log warning entry” rather than “Log informational entry” as that will make the entries easier to locate in the log.
    • If you choose Log warning entry, a warning entry will be logged if an invalid or duplicate profile error occurs. If no other errors are encountered the ReACL job will complete as successful and the ReACL Status will be Completed in the Devices + Servers table. This choice allows experienced migration architects to analyze the logs and choose to Cutover based on their analysis of the results.
    • If you choose Log error entry, an error entry will be logged if an invalid or duplicate profile error occurs. The ReACL job will continue and then complete as Failed and the ReACL Status on the Devices + Servers table will be Failed. This selection may take significantly more time than "Terminate processing with fatal error" because the entire process will attempt to finish before reporting as Failed.
21. Select an option from the Preserve Rollback Metadata in ACLs drop-down list.
22. Active Directory can leave behind metadata during the ReACL process to allow seamless rollback of the process if needed. This setting controls the creation of this metadata which is later removed during the Cleanup process.
    • The default is Always - Keep source security principles and does not affect performance. We recommend this setting. This is the only setting where the changes performed by the ReACL process can be rolled back, or undone, in all scenarios.
    • If you choose Only If Ambiguous - Keep source security principles when necessary, metadata will only be included when the rollback settings would be ambiguous. “Only If Ambiguous” results in the inclusion of less metadata, preserving usage for times when it may be impossible to determine the original file or folder permissions. For example, when users have accounts in multiple domains that will be consolidated into a single domain.
    • Note that Only If Ambiguous guarantees that a ReACL can be rolled back to the original state only when the file system permissions remained unchanged. Modification of ACLs on the file system could create a state where a rollback cannot complete with 100% success. To ensure the ability to perform a ReACL Rollback in all scenarios, Always should be selected.
    • If you are an experienced migration architect, you may choose Never - Replace source security principles to never include metadata.
    • Note: If Never is selected, a complete ReACL Rollback may not be possible.
23. Select Yes under Run Processing in Simulation Mode to simulate the results of the ReACL process without actually making any changes to the ACLs. Visit the logs/reports to determine if there are any potential issues and correct them before changing this setting to No and running an actual ReACL process. Alternatively, you might use this setting to create a separate Device ReACL Profile specifically for testing purposes.
24. Click Save Profile. The new Device ReACL Profile is added to the list.