Share via

Movetree Syntax

  • Article

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

MoveTree Syntax

MoveTree uses the following syntax:

Art Imagemovetree {/start | /continue | /check} /s SrcDSA /d DstDSA /sdn SrcDN /ddn DstDN [/u [Domain\]UserName /p Password] [/verbose]

Parameters

  • /start
    Starts a MoveTree operation. This command includes a /check operation by default. MoveTree tries to continue the operation until it is complete. 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, it can be continued by using the /continue command.
  • /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 sufficient 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 can then take remedial action before performing the actual move. The /check command returns an error if any of the following conditions are met:

    • The user does not have the necessary permissions to create objects in the destination container.

    • The destination server does not have sufficient disk space to continue the operation.

    • A relative distinguished name conflict exists on the destination server.

    • There is a samAccountName conflict for any object that would be moved.

    • Any objects cannot be moved because they are built-in accounts, or they are either a Domain Local or a Global group.

    • Any computer objects would be moved. To move computer accounts and join the computers to the domain, use Netdom Overview, a Windows Support Tool.

  • /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 subtree (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 subtree (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 an alternate user name and password. Optionally, 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.

See Also

Concepts

Movetree.exe
Movetree Remarks
Movetree Examples
Alphabetical List of Tools
Search Overview
Replmon Overview
Repadmin Overview
Ldp Overview
Dsastat Overview
Clonepr Overview
ADSI Edit (adsiedit.msc)
Acldiag Overview
Spcheck Overview
Nltest Overview
Netdom Overview
Netdiag Overview
Netcap Overview
Httpcfg Overview
Dnslint Overview
Dnscmd Overview
Dhcploc Overview
Dcdiag Overview
Browstat Overview