Thank to http://social.technet.microsoft.com/wiki/contents/articles/1073.robocopy-and-a-few-examples.aspx
Robocopy Syntax
ROBOCOPY <source> <destination> [file…] [options]
Examples of Microsoft’s Robocopy Syntax
#1
To copy contents of C:\UserFolder to C:\FolderBackup:
#2
#3
#4
/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
/FFT uses fat file timing instead of NTFS. This means the granularity is a bit less precise. For across-network share operations this seems to be much more reliable – just don’t rely on the file timings to be completely precise to the second.
/Z ensures Robocopy can resume the transfer of a large file in mid-file instead of restarting.
/XA:H makes Robocopy ignore hidden files, usually these will be system files that we’re not interested in.
/W:5 reduces the wait time between failures to 5 seconds instead of the 30 second default.
#7
#8
#9
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).
/IT – Includes “tweaked” files.
Sidenote: ROBOCOPY c:\sourcefolder d:\targetfolder /zb /sec /e /nocopy may give you similar results but useful ONLY when more permissions are added. it will not consider or update the target for permissions removed at the source.
Multi-threaded support allows Robocopy to open multiple threads simultaneously, allowing many files to be copied in parallel. With multi-threaded copying, total time required to complete the operation will be drastically reduced and cut, when comparing with with typical copying one file at time in serial sequential order.
As Robocopy is generally a command-line only utility (although a GUI add-on is available for Robocopy), the new multi-threaded operation capability has to be called via a new switch supported by Robocopy. The new multi-threaded copy feature can be enabled and turned on with the following parameter:
For example,
To copy a directory tree along with the source timestamps for folders
Robocopy C:\Folder1 C:\Folder2 /MIR /dcopy:T
#11
To copy a directory using /IPG to limit bandwidth usage. General rule of thumb /IPG:750 will use roughly 1Mbps.
Robocopy /ipg:750 /z /r:3 /w:3 /tee /LOG+:c:\robolog.txt //server1/share //server2/share
More Information
Robocopy Options and Switches: http://technet.microsoft.com/en-us/library/cc733145(WS.10).aspx
Robocopy 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.
|
Important
|
When using the /SECFIX copy option, specify the type of security information you want to copy by also using one of these additional copy options:
· /COPYALL
· /COPY:O
· /COPY:S
· /COPY:U
· /SEC
|
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. Extra files are files that exist in the destination directory.
|
/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 precision).
|
/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.
|