Moving Users Between Domains

Description

The DOMAIN and INCLUDEUSER commands allow you to take user state data extracted for a user in one domain and redirect that to a user in a different domain. If the username is the same between domains the DOMAIN is recommended, and if the username is different use INCLUDEUSER to specify both the domain and username redirections. This is useful when users are being moved between domains as part of a migration.

Note
Migration Manager does not create domain user accounts. When migrating a user between domains the user’s account must already exist in the target domain otherwise the injection will fail. The user profile on the computer does not need to exist and will be created during Migration Manager injection if necessary.

Process Examples

Using environment variables and command-line switches a technician can log in to a given workstation and perform an automated extraction and injection of all the users that exist on the computer. For extraction, the technician can use the ALLUSERS command-line switch to extract all of the users on the computer. On injection the batch file will combine the ALLUSERS switch and the SOURCE switch to specify the name of the computer the user state data was extracted from.

The Computer Name is specified when the batch file is invoked. In addition, the DOMAIN switch will be used to redirect the users in the specified personality to be created with association to the specified target domain.

The advantage of using this process is the user does not have to be present during the extraction or the injection, and the technician performing the migration does not have to obtain the user name and password for any of the users that have profiles on the computer.

Note
To extract or inject a personality containing multiple users, the user that is performing the extraction or injection must have Local Administrator Rights. Migration Manager also requires UAC elevation on Windows if enabled.

Extraction Example (Invoking the Extract.bat file)

This example assumes that Migration Manager is available from \\MyServer\MigrationManager. The technician can invoke the Extract.bat file from an elevated command-prompt by entering the path to where the Extract.bat file resides, or by simply double clicking on the Extract.bat file:

C:\> \\MyServer\MigrationManager\extract.bat

Extract.bat File Example for Moving Users between Domains

This example Extract.bat file performs an automated extraction for all users on the computer. To build this script, simply take the script from Extract.bat File Example, and replace line 3 with the following:

3. START /w \\MyServer\MigrationManager\MigrationManager.EXE /autoextract /AllUsers
/config \\MyServer\MigrationManager\configuration.xml

Extract.bat File Definition (By Line)
Line 3 - Performs an extraction for all users on the computer.

Injection Example (Invoking the Inject.bat file)

In this example, the inject.bat file is located on the file share \\MyServer\MigrationManager. The technician can invoke the Inject.bat file from an elevated command-prompt by entering the path to where the Inject.bat file resides. The name of the computer where the extraction was performed is specified after the batch file:

C:\> \\MyServer\MigrationManager\inject.bat mycomputer

Inject.bat File Example for Moving Users between Domains with the same User Name

This example assumes that Migration Manager is available from \\MyServer\MigrationManager. This example Inject.bat file performs an automated injection of all the users extracted from the specified computer.

To build this script, simply take the script from Inject.bat File Example, and replace line 3 with the following:

3. START /w \\MyServer\MigrationManager\MigrationManager.EXE /autoinject /Source %1 /AllUsers
/Domain OldDomain:NewDomain /config \\MyServer\MigrationManager\configuration.xml

Inject.bat File Definition (By Line)
Line 3 - Injects the users extracted from the specified computer, mapping any user from the domain “OldDomain” to the domain “NewDomain”

Inject.bat File Example for Moving Users between Domains and redirecting to new User Names

To build this script, simply take the script from Inject.bat File Example, and replace line 3 with the following:

3. START /w \\MyServer\MigrationManager\MigrationManager.EXE /autoinject /Source %1 /AllUsers
/Includeuser OldDomain\OldUsername:NewDomain\NewUsername /config \\MyServer\MigrationManager\configuration.xml

Inject.bat File Definition (By Line)
Line 3 - Injects the users extracted from the specified computer, mapping the specified user "OldUsername" from the domain “OldDomain” to the user "NewUsername" on the domain “NewDomain”