robocopy <source> <destination> [<file>[ ...]] [<options>]
例如,若要将名为 yearly-report.mov 的文件从 c:\reports 复制到文件共享 \\marketing\videos,同时启用多线程以提高性能(使用 /mt 参数)并在传输中断时重新开始传输(使用 /z 参数),请键入:
robocopy c:\reports "\\marketing\videos" yearly-report.mov /mt /z
如果从设备的根 根 复制任何数据,则目标目录在复制过程中采用“隐藏”和“系统”属性。
这些限制选项可用于指定 Robocopy 允许使用的最大 I/O 带宽(以“字节/秒”为单位)。 如果未以“字节/秒”为单位进行指定,则可在已指定 k、m 或 g 的情况下使用整数。 即使指定了较小值,受限的最小 I/O 带宽依然为 524288 字节。
文件选择选项
/minlad:<n>
指定最小上次访问日期(排除有 n 天/自 n 日期以来已使用的文件)。如果 n 小于 1900,则 n 指定天数。 否则,n 指定 YYYYMMDD 格式的日期。
排除交接点(通常默认会包含)。
采用 FAT 文件时间(精度为两秒)。
补偿一小时 DST 时差。
排除目录的交接点。
排除文件的交接点。
在卷的根目录上使用 /PURGE 或 /MIR 以前会导致 robocopy 也对系统卷信息目录中的文件应用请求的操作。 这不再如此,就像指定了任一类型一样,robocopy 会跳过复制会话的顶级源目录和目标目录中具有该名称的任何文件或目录。
仅当源和目标文件系统支持更改时间戳(例如 NTFS)并且源和目标文件具有不同的更改时间但其他方面都相同时,修改的文件分类才适用。 默认不会复制这些文件。 指定 /IM 以包含它们。
/DCOPY:E 标志请求应尝试为目录复制扩展属性。 Robocopy 继续执行复制作,即使无法复制目录的 EA。
/COPYALL 中不包含此标志。
如果指定了 /IoMaxSize 或 /IoRate,robocopy 将启用复制文件限制以减少系统负载。 可以对两者进行调整来优化值和复制参数,但允许系统和 robocopy 根据需要将它们调整为允许的值。
如果使用了 /Threshold,它将指定用于参与限制的最小文件大小。 低于该大小的文件不受限制。 所有三个参数的值均可后跟一个可选后缀字符,例如 [KMG](千字节、兆字节、千兆字节)。
使用 /LFSM 请求 robocopy 在“低可用空间模式”下运行。 在此模式下,每当文件副本会导致目标卷的可用空间低于“floor”值时,robocopy 都会暂停。 可以使用 /LFSM:n[KMG] 标志显式指定此值。
如果指定的 /LFSM 没有显式的下限值,则下限将设置为目标卷大小的 10%。 低可用空间模式与 /MT 和 /EFSRAW 不兼容。
退出(返回)代码
强烈建议在运行 robocopy
命令时创建一个日志文件,该日志文件可在进程完成验证其完整性后查看。 在以下示例中,每一个都使用 /LOG:
参数。 若要将任何日志信息追加到同一日志文件,请改用 /LOG+:
参数。
若要将所有文件和子目录(包括空目录)从驱动器“D”上的“记录”文件夹复制到“备份”文件夹,请键入:
robocopy C:\Users\Admin\Records D:\Backup /E /ZB /LOG:C:\Logs\Backup.log
若要将“记录”文件夹的内容镜像到驱动器“D”上的“备份”文件夹,请删除源中不存在的任何文件,并在每次重试之间等待 5 秒,键入:
robocopy C:\Users\Admin\Records D:\Backup /MIR /R:2 /W:5 /LOG:C:\Logs\Backup.log
要将所有不为空的文件和子目录从驱动器“D”上的“备份”文件夹复制到驱动器“D”上的“备份”文件夹,请保留具有 16 个多线程复制作的文件数据、属性和时间戳,请键入:
robocopy C:\Users\Admin\Records D:\Backup /S /E /COPY:DAT /MT:16 /LOG:C:\Logs\Backup.log
若要将文件和子目录(不包括空目录)从“记录”文件夹移动到驱动器“D”上的“备份”文件夹,并排除超过 7 天的文件,请键入:
robocopy C:\Users\Admin\Records D:\Backup /S /MAXAGE:7 /MOV /LOG:C:\Logs\Backup.log
若要将所有文件和子目录(包括空目录)从驱动器“D”上的“记录”文件夹复制到驱动器“D”上的“备份”文件夹,显示每个文件的估计时间,并删除源中不存在的任何文件和目录,请键入:
robocopy C:\Users\Admin\Records D:\Backup /ETA /PURGE /LOG:C:\Logs\Backup.log
若要将“C”驱动器上名为“Records”的文件夹中的所有文件和子目录复制到“D”驱动器上的名为“Backup”的文件夹,同时在复制作期间将 I/O 速率限制为每秒 1 兆字节,请键入:
robocopy C:\Records D:\Backup /iorate:1m
若要在目标文件夹中已存在文件时跳过将文件从源文件夹复制到目标文件夹,无论这些文件是较新、较旧还是已修改,请键入:
robocopy C:\Source C:\Destination /XC /XN /XO
命令行语法项