Windows Tools

MoveTree Syntax

Overview | Notes | Syntax | Examples | Related Tools Open Command Prompt

One Step movetree {/start | /startnocheck | /continue | /check} /s SrcDSA /d DstDSA /sdn SrcDN /ddn DstDN [/u [Domain\]Username /p Password] [/verbose] [{/? | /help}]

Parameters

/start
Starts a MoveTree operation. This command includes a /check operation by default (to start a MoveTree operation with no check, use /startnocheck). MoveTree tries to continue the operation until it completes; if there is a network fault or if the destination domain controller becomes unavailable, then MoveTree pauses the operation. If an operation has been paused, then it may be continued using the /continue command.
/startnocheck
Starts a MoveTree operation with no /check.
/continue
Continues the execution of a previously paused or failed MoveTree operation. This allows the MoveTree operation to continue even if a network fault or a domain controller error has interrupted the initial operation. Specifying /sdn SrcDN is optional for this command.
/check
Performs a test run of the MoveTree operation, checking the whole tree without moving any objects. This enables the administrator to determine if there is sufficent disk space on the destination server, if there are any conflicts with object names or if there are any objects that could not be moved (such as Domain Local or Global groups). The administrator may then take remedial action before performing the actual move.

The /check command returns an error if any of the following conditions are met:

/s SrcDSA
Specifies the fully qualified primary DNS name of the source server in the domain from which the objects are being moved (for example, Server1.Marketing.Microsoft.Com). Required for all MoveTree commands.
/d DstDSA
Specifies the fully qualified primary DNS name of the destination server in the domain to which the objects are being moved (for example, Server2.Sales.Microsoft.Com). Required for all MoveTree commands.
/sdn SrcDN
Specifies the distinguished name of the source sub-tree (the object being moved) (for example, OU=Promotions,DC=Marketing,DC=Microsoft,DC=Com). Required for the /start, /startnocheck, and /check commands; optional for /continue.
/ddn DstDN
Specifies the distinguished name of the destination sub-tree (to which the object is being moved) (for example, OU=Promotions,DC=Sales,DC=Microsoft,DC=Com). Required for all MoveTree commands.
/u [Domain\]Username /p Password
Runs MoveTree under the credentials of a valid Username and Password. Optionally, a Domain can be specified as well. If these optional arguments are not provided, MoveTree uses the credentials of the currently logged-on user.
/verbose
Runs MoveTree in verbose mode, which displays more details about the operation as it runs. Optional.
/? or /help
Displays this information on a command-line syntax screen.