Copies file data.

Syntax

robocopy <Source> <Destination> [<File>[ ...]] [<Options>]

Parameters

Parameter Description

<Source>

Specifies the path to the source directory.

<Destination>

Specifies the path to the destination directory.

<File>

Specifies the file or files to be copied. You can use wildcard characters (* or ?), if you want. If the File parameter is not specified, *.* is used as the default value.

<Options>

Specifies options to be used with the robocopy command.

Copy options

Option Description

/s

Copies subdirectories. Note that this option excludes empty directories.

/e

Copies subdirectories. Note that this option includes empty directories.

/lev:<N>

Copies only the top N levels of the source directory tree.

/z

Copies files in Restart mode.

/b

Copies files in Backup mode.

/zb

Uses Restart mode. If access is denied, this option uses Backup mode.

/efsraw

Copies all encrypted files in EFS RAW mode.

/copy:<CopyFlags>

Specifies the file properties to be copied. The following are the valid values for this option:

D Data

A Attributes

T Time stamps

S NTFS access control list (ACL)

O Owner information

U Auditing information

The default value for CopyFlags is DAT (data, attributes, and time stamps).

/dcopy:T

Copies directory time stamps.

/sec

Copies files with security (equivalent to /copy:DAT).

/copyall

Copies all file information (equivalent to /copy:DATSOU).

/nocopy

Copies no file information (useful with /purge).

/secfix

Fixes file security on all files, even skipped ones.

/timfix

Fixes file times on all files, even skipped ones.

/purge

Deletes destination files and directories that no longer exist in the source.

/mir

Mirrors a directory tree (equivalent to /e plus /purge).

/mov

Moves files, and deletes them from the source after they are copied.

/move

Moves files and directories, and deletes them from the source after they are copied.

/a+:[RASHCNET]

Adds the specified attributes to copied files.

/a-:[RASHCNET]

Removes the specified attributes from copied files.

/create

Creates a directory tree and zero-length files only.

/fat

Creates destination files by using 8.3 character-length FAT file names only.

/256

Turns off support for very long paths (longer than 256 characters).

/mon:<N>

Monitors the source, and runs again when more than N changes are detected.

/mot:<M>

Monitors source, and runs again in M minutes if changes are detected.

/rh:hhmm-hhmm

Specifies run times when new copies may be started.

/pf

Checks run times on a per-file (not per-pass) basis.

/ipg:n

Specifies the inter-packet gap to free bandwidth on slow lines.

/sl

Copies the symbolic link instead of the target.

File selection options

Option Description

/a

Copies only files for which the Archive attribute is set.

/m

Copies only files for which the Archive attribute is set, and resets the Archive attribute.

/ia:[RASHCNETO]

Includes only files for which any of the specified attributes are set.

/xa:[RASHCNETO]

Excludes files for which any of the specified attributes are set.

/xf <FileName>[ ...]

Excludes files that match the specified names or paths. Note that FileName can include wildcard characters (* and ?).

/xd <Directory>[ ...]

Excludes directories that match the specified names and paths.

/xct

Excludes changed files.

/xn

Excludes newer files.

/xo

Excludes older files.

/xx

Excludes extra files and directories.

/xl

Excludes "lonely" files and directories.

/is

Includes the same files.

/it

Includes "tweaked" files.

/max:<N>

Specifies the maximum file size (to exclude files bigger than N bytes).

/min:<N>

Specifies the minimum file size (to exclude files smaller than N bytes).

/maxage:<N>

Specifies the maximum file age (to exclude files older than N days or date).

/minage:<N>

Specifies the minimum file age (exclude files newer than N days or date).

/maxlad:<N>

Specifies the maximum last access date (excludes files unused since N).

/minlad:<N>

Specifies the minimum last access date (excludes files used since N) If N is less than 1900, N specifies the number of days. Otherwise, N specifies a date in the format YYYYMMDD.

/xj

Excludes junction points, which are normally included by default.

/fft

Assumes FAT file times (two-second granularity).

/dst

Compensates for one-hour DST time differences.

/xjd

Excludes junction points for directories.

/xjf

Excludes junction points for files.

Retry options

Option Description

/r:<N>

Specifies the number of retries on failed copies. The default value of N is 1,000,000 (one million retries).

/w:<N>

Specifies the wait time between retries, in seconds. The default value of N is 30 (wait time 30 seconds).

/reg

Saves the values specified in the /r and /w options as default settings in the registry.

/tbd

Specifies that the system will wait for share names to be defined (retry error 67).

Logging options

Option Description

/l

Specifies that files are to be listed only (and not copied, deleted, or time stamped).

/x

Reports all extra files, not just those that are selected.

/v

Produces verbose output, and shows all skipped files.

/ts

Includes source file time stamps in the output.

/fp

Includes the full path names of the files in the output.

/bytes

Prints sizes, as bytes.

/ns

Specifies that file sizes are not to be logged.

/nc

Specifies that file classes are not to be logged.

/nfl

Specifies that file names are not to be logged.

/ndl

Specifies that directory names are not to be logged.

/np

Specifies that the progress of the copying operation (the number of files or directories copied so far) will not be displayed.

/eta

Shows the estimated time of arrival (ETA) of the copied files.

/log:<LogFile>

Writes the status output to the log file (overwrites the existing log file).

/log+:<LogFile>

Writes the status output to the log file (appends the output to the existing log file).

/unicode

Displays the status output as Unicode text.

/unilog:<LogFile>

Writes the status output to the log file as Unicode text (overwrites the existing log file).

/unilog+:<LogFile>

Writes the status output to the log file as Unicode text (appends the output to the existing log file).

/tee

Writes the status output to the console window, as well as to the log file.

/njh

Specifies that there is no job header.

/njs

Specifies that there is no job summary.

Job options

Option Description

/job:<JobName>

Specifies that parameters are to be derived from the named job file.

/save:<JobName>

Specifies that parameters are to be saved to the named job file.

/quit

Quits after processing command line (to view parameters)./nosd:

/nodd

Indicates that no destination directory is specified.

/if

Includes the specified files.

Additional references