Migrate Accounts

  • Article

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

You can migrate each batch of user accounts by using the ADMT console, by using the ADMT command-line option, or by using a script.

To migrate user accounts by using the ADMT console

  • Complete the User Account Migration Wizard by using the information provided in Table 12.11.

    Table 12.11   Using the User Account Migration Wizard to Move User Accounts

    Wizard Page Action

    Test or Make Changes

    Click Migrate Now?

    Domain Selection

    In the Source domain box, type or select the name of the source domain.

    In the Target domain box, type or select the name of the target domain.

    User Selection

    Click Add.

    In the Select Users dialog box, select the user accounts that you want to migrate in the current batch, and then click Add.

    Click OK.

    Organizational Unit Selection

    Ensure that ADMT lists the correct target OU. If it is not correct, type the correct OU, or click Browse.

    In the Browse for Container dialog box, locate the target domain and OU, and then click OK.

    User Options

    Click the Translate roaming profiles check box.

    Click the Update user rights check box.

    Clear the Migrate associated user groups check box. A warning box appears that states that if the global groups to which the user accounts belong are not also migrated, users will lose access to resources. Click OK to continue with the migration.

    Naming Conflicts

    Click Ignore conflicting accounts and don’t migrate.

After you click Finish in the User Account Migration Wizard, the Migration Progress dialog box appears. After the status changes to Completed, view the migration log to determine whether any errors occurred in the migration process. In the Migration Progress dialog box, click Close.

To migrate the user accounts by using the ADMT command-line option

  1. On the member server in the target domain where ADMT is installed, log on by using a user account that is a member of the ADMT account migration group.

  2. At the command line, type:

    ADMT USER /N “user_name1” “user_name2” /IF:YES /SD:”source_domain” /TD:”target_domain” /TO:”target_OU” [parameters]

    You can append parameters to the command as follows:

    ADMT USER /N “user_name1” “user_name2” /IF:YES /SD:”source_domain” /TD:”target_domain” /TO:”target_OU” TRP:YES /UUR:YES

    Alternatively, you can include parameters in an option file that is specified on the command line as follows:

    ADMT USER /N “user_name1” “user_name2” /O “option_file.txt”

    Table 12.12 lists the parameters that are required for migrating user accounts, the command-line parameters, and option file equivalents.

    Table 12.12   Parameters Required for Migrating User Accounts

    Parameters Command Line Syntax Option File Syntax

    Intra-Forest

    /IF:YES

    IntraForest=YES

    Source domain

    /SD:"source_domain"

    SourceDomain="source_domain"

    Source OU location

    /SO:"source_OU"

    SourceOU="source_OU"

    Target domain

    /TD:"target_domain"

    TargetDomain="target_domain"

    Target OU location

    /TO:"target_OU"

    TargetOU="target_OU"

    Do not rename accts

    /RO:DONT (default)

    RenameOption=DONT

    Ignore conflicting accts and not migrate them

    /CO:IGNORE (default)

    ConflictOptions=IGNORE

    Translate Roaming Profile

    /TRP:YES (default)

    TranslateRoamingProfile=YES

    Update User Rights

    /UUR:YES

    UpdateUserRights=YES

  3. Review the results that are displayed on the screen for any errors.

  4. Open Active Directory Users and Computers, and then locate the target domain OU. Verify that the users exist in the target domain OU.

To migrate user accounts by using a script

  • Use Listing 12.5 to prepare a script that incorporates ADMT commands and options for migrating user accounts within a forest.

    Listing 12.5   Migrating User Accounts Within a Forest

    <Job id=" MigratingUserAccountsWithinForest" >
<Script language=" VBScript"  src=" AdmtConstants.vbs" />
<Script language=" VBScript" >
   Option Explicit

   Dim objMigration
   Dim objUserMigration

   '
   'Create instance of ADMT migration objects.
   '

   Set objMigration = CreateObject(" ADMT.Migration" )
   Set objUserMigration = objMigration.CreateUserMigration

   '
   'Specify general migration options.
   '

   objMigration.IntraForest = True
   objMigration.SourceDomain = " source domain"
   objMigration.SourceOu = " source container"
   objMigration.TargetDomain = " target domain"
   objMigration.TargetOu = " target container"

   '
   'Specify user migration specific options.
   '

   objUserMigration.TranslateRoamingProfile = True
   objUserMigration.UpdateUserRights = True
   objUserMigration.FixGroupMembership = True
   objUserMigration.MigrateServiceAccounts = False

   '
   'Migrate specified user objects.
   '

   objUserMigration.Migrate admtData, Array(" user name1" ," user name2" )

   Set objUserMigration = Nothing
   Set objMigration = Nothing
</Script>
</Job>

    For a sample script file to assist you in migrating user accounts, see "Migrating User Accounts Within a Forest" (DSSRERA_4.wsf) on the Windows Server 2003 Deployment Kit companion CD (or see "Migrating User Accounts Within a Forest" on the Web at https://www.microsoft.com/reskit).