Using Passwords in Migrations

Description

The PASSWORD parameter allows you to assign a password when extracting user state data to encrypt the data using AES256. This password then needs to be provided for any future operations with the extracted data, the data cannot be accessed without the password.

The password can both be entered and saved in the extraction and injection batch files you use, or for more security the password can be specified when either batch files are invoked with the use of simple batch file parameters.

Note
Passwords are case-sensitive, must be between 7 to 15 characters in length and may only contain characters, digits and underscores.

Process Examples

Using batch file parameters and command-line switches a technician can specify a password to be assigned when extracting the personality and then called when injecting the password protected personality. In these examples, the password is provided as a parameter to the batch files.

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 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, specifying the password that should be used as a parameter to the batch file:

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

Extract.bat File Example USING A PASSWORD

This example Extract.bat file performs an automated extraction for all users on the computer, assigning a password through a batch file parameter. 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 /PASSWORD %1
/config \\MyServer\MigrationManager\configuration.xml

Extract.bat File Definition (By Line)
Line 3 - Performs an extraction of all users from the computer, assigning the specified password to the extracted user state data.

Injection Example (Invoking the Inject.bat file) Using a Password

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 as is the password specified when the extraction was performed:

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

Inject.bat File Example Using a Password

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 and using the provided password to get access to the user state data.

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 /PASSWORD %2
/config \\MyServer\MigrationManager\configuration.xml

Inject.bat File Definition (By Line)
Line 3 - Injects the user state extracted from the specified computer using the provided password.