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. |