After you migrate a batch of local user profiles, migrate the corresponding batch of user workstations. When you migrate a workstation between domains, the SAM database is migrated along with the computer. Accounts located in the local SAM database (such as local groups) that are used to enable access to resources always move with the
computer, and therefore do not need to be migrated.
Note
Use a low value for the RestartDelay parameter to restart workstations immediately after joining them to the target domain, or as soon as possible thereafter. Resources that are not restarted following migration are in an indeterminate state.
You can migrate workstations and member servers by using the AMDT console, ADMT command-line option, or a script.
To migrate workstations by using the ADMT console
1. On the computer in the target domain on which you installed ADMT, log on by using the ADMT resource migration account.
2. Use the Computer Account Migration Wizard by following the steps provided in the following table.
Wizard Page Action
Domain Selection Under Source, in the Domain drop-down list, type or select the NetBIOS or Domain Name System (DNS) name of the source domain. In the Domain controller drop-down list, type or select the name of the domain controller, or select Any domain controller.
Under Target, in the Domain drop-down list, type or select the NetBIOS or DNS name of the target domain. In the Domain controller drop-down list, type or select the name of the domain controller, or select Any domain controller, and then click Next.
Computer Selection Click Select computers from domain, and then click Next. On the Computer Selection page, click Add to select the computers in the source domain that you want to migrate, click OK, and then click Next.
- or -
Click Read objects from an include file, and then click Next. Type the location of the include file, and then click Next.
Organizational Unit Selection Click Browse.
In the Browse for Container dialog box, locate the target domain Computers container or the appropriate OU, and then click OK.
Translate Objects Select the Local groups check box.
Select the User rights check box.
Security Translation Options Click Add.
Computer Options In the Minutes before computer restart after wizard completion box, accept the default value of 5 minutes or type a different value.
Object Property Exclusion To exclude certain object properties from the migration, select the Exclude specific object properties from migration check box, select the object properties that you want to exclude and move them to the Excluded Properties box, and then click Next.
Conflict Management Click Do not migrate source object if a conflict is detected in the target domain.
ADMT Agent Dialog Select Run pre-check and agent operation, and then click Start.
3. Review the results that are displayed on the screen for any errors. After the wizard completes, click View Migration Log to see the list of computers, completion status, and the path to the log file for each computer. If an error is reported for a computer, you will need to refer to the log file on that computer to review any problems with local groups. The log file for each computer is named MigrationTask#_ComputerName.log and is stored in the
Windows\ADMT\Logs\Agents folder.
4. Open Active Directory Users and Computers and verify that the workstations exist in the appropriate OU in the target domain.
To migrate workstations by using the ADMT command-line option
1. On the computer in the target domain on which ADMT is installed, log on by using the ADMT resource migration account.
2. At the command line, type the ADMT Computer command with the appropriate parameters. For example, type:
ADMT COMPUTER /N "computer_name1" "computer_name2"
/SD:"source_domain" /TD:"target_domain" /TO:"target_OU"/RDL:5
Alternatively, you can include parameters in an option file that is specified at the command line as follows:
ADMT COMPUTER /N "computer_name1" "computer_name2"
/O:"option_file.txt"
The following table lists the common parameters used for workstation migration, along with the command-line parameter and option file equivalents.
Parameters Command-Line Syntax Option File Syntax
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"
Restart Delay
3. Review the results that are displayed on the screen for any errors. The migration log lists computers, completion status, and the path to the log file for each computer. If an error is reported for a computer, you will need to refer to the log file for that computer to review any problems with local groups. The log file for each computer is named MigrationTask#_ComputerName.log and is stored in the Windows\ADMT\Logs\Agents folder.
4. Open Active Directory Users and Computers and locate the target OU. Verify that the workstations and member servers exist in the target OU.
To migrate workstations by using a script
• Prepare a script that incorporates ADMT commands and options for migrating workstations by using the sample script shown in the following listing. Copy the script to Notepad, and save the file with a .wsf file name extension in the same folder as the AdmtConstants.vbs file.
<Job id="MigratingWorkstationsBwtweenForest" >
<Script language="VBScript" src="AdmtConstants.vbs" />
<Script language="VBScript" >
Option Explicit
Dim objMigration
Dim objComputerMigration
'
'Create instance of ADMT migration objects.
'
Set objMigration = CreateObject("ADMT.Migration" )
Set objComputerMigration = objMigration.CreateComputerMigration
'
'Specify general migration options.
'
objMigration.SourceDomain = "source domain"
objMigration.SourceOu = "Computers"
objMigration.TargetDomain = "target domain"
objMigration.TargetOu = "Computers"
'
'Specify computer migration specific options.
'
objComputerMigration.RestartDelay = 1
objComputerMigration.TranslationOption = admtTranslateAdd objComputerMigration.TranslateLocalGroups = True
objComputerMigration.TranslateUserRights = True
'
'Migrate computer objects on specified computer objects.
'
objComputerMigration.Migrate admtData, _ Array("computer name1" ,"computer name2" )
Set objComputerMigration = Nothing Set objMigration = Nothing
</Script>
</Job>