robocopy

將檔案資料從某個位置複製到另一個位置。

Syntax

robocopy <source> <destination> [<file>[ ...]] [<options>]

例如,若要使用/mt參數) 將名為yearly-report.mov的檔案從c:\reports複製到檔案共用\\marketing\videos,同時啟用多執行緒 (,以及以/z參數) 中斷 (時重新開機傳輸的能力,請輸入:

robocopy c:\reports '\\marketing\videos' yearly-report.mov /mt /z

參數

參數 描述
<source> 指定來源目錄的路徑。
<destination> 指定目的地目錄的路徑。
<file> 指定要複製的檔案或檔案。 支援萬用字元 (*) 。 如果您未指定此參數, *.* 則會做為預設值。
<options> 指定與 robocopy 命令搭配使用的選項,包括 複製檔案重試記錄作業 選項。

複製選項

選項 描述
/s 複製子目錄。 此選項會自動排除空白目錄。
/e 複製子目錄。 此選項會自動包含空白目錄。
/lev:<n> 只複製來原始目錄樹狀結構的前 n 個層級。
/z 以可重新開機模式複製檔案。 在可重新開機模式中,如果檔案複本中斷,Robocopy 可以挑選離開的位置,而不是重新複製整個檔案。
/b 複本備份模式中的檔案。 備份模式可讓 Robocopy 覆寫 (ACL) 的檔案和資料夾許可權設定。 這可讓您複製您可能沒有存取權的檔案,假設檔案是在具有足夠許可權的帳戶下執行。
/zb 以可重新開機模式複製檔案。 如果檔案存取遭到拒絕,請切換至備份模式。
/j 針對大型檔案) 建議使用未緩衝的 I/O 複製 (。
/efsraw 複製 EFS RAW 模式中的所有加密檔案。
/copy:<copyflags> 指定要複製的檔案屬性。 此選項的有效值為:
  • D - 資料
  • A - 屬性
  • T - 時間戳記
  • S - NTFS 存取控制清單 (ACL)
  • O - 擁有者資訊
  • U - 稽核資訊
此選項的預設值是 DAT (資料、屬性和時間戳記) 。
/dcopy:<copyflags> 指定要在目錄中複製的內容。 此選項的有效值為:
  • D - 資料
  • A - 屬性
  • T - 時間戳記
此選項的預設值是 DA (資料和屬性) 。
/秒 複製安全性 (相當於 /copy:DATS) 的檔案。
/copyall 複製所有檔案資訊, (相當於 /copy:DATSOU) 。
/nocopy (/purge) 時,不會複製任何檔案資訊。
/secfix 修正所有檔案的檔案安全性,甚至略過檔案。
/timfix 修正所有檔案的檔案時間,甚至略過檔案的時間。
/purge 刪除來源中已不存在的目的地檔案和目錄。 使用此選項搭配 /e 選項和目的地目錄,允許不會覆寫目的地目錄安全性設定。
/mir 鏡像目錄樹狀目錄 (相當於 /e 加上 /purge) 。 使用此選項搭配 /e 選項和目的地目錄,會覆寫目的地目錄安全性設定。
/mov 移動檔案,並在複製檔案之後從來源刪除。
/move 移動檔案和目錄,並在複製檔案和目錄之後從來源刪除它們。
/a+:[TIMECNET] 將指定的屬性加入至複製的檔案。 此選項的有效值為:
  • R - 唯讀
  • A - 封存
  • S - 系統
  • H - 隱藏
  • C - 壓縮
  • N - 未編制索引的內容
  • E - 加密
  • T - 暫存
/a-:[TIMECNET] 從複製的檔案中移除指定的屬性。 此選項的有效值為:
  • R - 唯讀
  • A - 封存
  • S - 系統
  • H - 隱藏
  • C - 壓縮
  • N - 未編制索引的內容
  • E - 加密
  • T - 暫存
/create 僅建立目錄樹狀目錄和零長度檔案。
/fat 僅使用 8.3 個字元長度的 FAT 檔案名來建立目的地檔案。
/256 關閉超過 256 個字元的路徑支援。
/mon:<n> 監視來源,並在偵測到超過 n 個變更時再次執行。
/mot:<m> 監視來源,並在偵測到變更時以 m 分鐘為單位再次執行。
/MT[:n] 使用 n 個執行緒建立多執行緒複本。 n 必須是介於 1 到 128 之間的整數。 n的預設值為 8。 若要提升效能,請使用 /log 選項重新導向您的輸出。

/mt參數不能與/ipg/efsraw參數搭配使用。

/rh:hhmm-hhmm 指定可能啟動新複本的執行時間。
/pf 檢查每個檔案的執行時間, (不是個別) 。
/ipg:n 指定封包間間距,以釋放慢速線路上的頻寬。
/sl 請勿遵循符號連結,而是建立連結的複本。
/nodcopy (預設 /dcopy:DA 完成) ,則不會複製任何目錄資訊。
/nooffload 不使用Windows複製卸載機制來複製檔案。
/compress 如果適用,請在檔案傳輸期間要求網路壓縮。

重要

使用 /secfix 複製選項時,請使用下列其中一個額外的複製選項,指定您要複製的安全性資訊類型:

  • /copyall
  • /copy:o
  • /copy:s
  • /copy:u
  • /sec

檔案選取選項

選項 描述
/a 僅複製已設定 Archive 屬性的檔案。
/m 只複製已設定 Archive 屬性的檔案,並重設 Archive 屬性。
/ia:[RASHCNETO] 只包含已設定任何指定屬性的檔案。 此選項的有效值為:
  • R - 唯讀
  • A - 封存
  • S - 系統
  • H - 隱藏
  • C - 壓縮
  • N - 未編制索引的內容
  • E - 加密
  • T - 暫存
  • O - 離線
/xa:[RASHCNETO] 排除已設定任何指定屬性的檔案。 此選項的有效值為:
  • R - 唯讀
  • A - 封存
  • S - 系統
  • H - 隱藏
  • C - 壓縮
  • N - 未編制索引的內容
  • E - 加密
  • T - 暫存
  • O - 離線
/xf <filename>[ ...] 排除符合指定名稱或路徑的檔案。 支援通 * 配符 (和 ) 。
/xd <directory>[ ...] 排除符合指定名稱和路徑的目錄。
/xc 排除變更的檔案。
/xn 排除較新的檔案。
/xo 排除較舊的檔案。
/xx 排除額外的檔案和目錄。
/xl 排除 「lonely」 檔案和目錄。
/im 包含已修改的檔案, () 變更時間不同。
/is 包含相同的檔案。
/it 包含已調整的檔案。
/xc 排除具有相同時間戳記但不同檔案大小的現有檔案。
/xn 排除比來原始目錄中複本還新的現有檔案。
/xo 排除早于來原始目錄中複本的現有檔案。
/xx 排除目的地中存在的額外檔案和目錄,但不會排除來源。 排除額外的檔案不會從目的地刪除檔案。
/xl 排除來源中存在的「lonely」檔案和目錄,但不包含目的地。 排除單一檔案可防止任何新檔案新增至目的地。
/is 包含相同的檔案。 相同檔案的名稱、大小、時間和所有屬性都相同。
/it 包含「已調整」檔案。 調整過的檔案具有相同的名稱、大小和時間,但有不同的屬性。
/max:<n> 指定 (檔案大小上限,以排除大於 n 個位元組的檔案) 。
/min:<n> 指定 (的最小檔案大小,以排除小於 n 個位元組的檔案) 。
/maxage:<n> 指定檔案存留期上限 (,以排除超過 n 天或日期) 的檔案。
/minage:<n> 指定 (排除比 n 天或日期) 新檔案的最小檔案存留期。
/maxlad:<n> 指定上次存取日期上限, (排除自 n) 以來未使用的檔案。
/minlad:<n> 指定上次存取日期下限, (排除自 n) 如果 n 小於 1900, n 會指定天數。 否則, n 會以 YYYYMMDD 格式指定日期。
/xj 排除預設通常會包含的連接點。
/fft 假設 FAT 檔案時間 (兩秒精確度)。
/dst 補償一小時的 DST 時間差異。
/xjd 排除目錄的連接點。
/xjf 排除檔案的連接點。

重試選項

選項 描述
/r:<n> 指定失敗複製的重試次數。 n的預設值為 1,000,000 (一百萬次重試) 。
/w:<n> 指定重試之間的等待時間 (以秒為單位)。 n的預設值為 30 (等候時間 30 秒) 。
/reg /r/w 選項中指定的值儲存為登錄中的預設設定。
/tbd 指定系統會等候共用名稱稱定義, (重試錯誤 67) 。

記錄選項

選項 描述
/l 指定只列出檔案 (,而不會複製、刪除或時間戳記) 。
/x 報告所有額外的檔案,而不只是選取的檔案。
/v 產生詳細資訊輸出,並顯示所有略過的檔案。
/ts 在輸出中包含原始程式檔時間戳記。
/fp 在輸出中包含檔案的完整路徑名稱。
/bytes 列印大小,以位元組為單位。
/ns 指定要記錄的檔案大小。
/nc 指定不會記錄檔案類別。
/nfl 指定不會記錄檔案名稱。
/ndl 指定不會記錄目錄名稱。
/np 指定將不會顯示複製作業的進度 (到目前為止複製的檔案或目錄數目)。
/eta 顯示所複製檔案 (ETA) 的預估抵達時間。
/log:<logfile> 將狀態輸出寫入至記錄檔 (覆寫現有記錄檔)。
/log+:<logfile> 將狀態輸出寫入記錄檔, (將輸出附加至現有的記錄檔) 。
/unicode 將狀態輸出顯示為 Unicode 文字。
/unilog:<logfile> 以 Unicode 文字的形式將狀態輸出寫入記錄檔, (覆寫現有的記錄檔) 。
/unilog+:<logfile> 將狀態輸出以 Unicode 文字的形式寫入記錄檔, (將輸出附加至現有的記錄檔) 。
/tee 將狀態輸出寫入主控台視窗,以及記錄檔。
/njh 指定沒有作業標頭。
/njs 指定沒有作業摘要。

作業選項

選項 描述
/job:<jobname> 指定要衍生自具名作業檔案的參數。
/save:<jobname> 指定要將參數儲存至具名作業檔案。
/quit 在處理命令列之後結束 (,以檢視參數) 。
/nosd 表示未指定任何來原始目錄。
/nodd 表示未指定目的地目錄。
/if 包含指定的檔案。

結束 (傳回) 代碼

描述
0 未複製任何檔案。 未發生任何失敗。 沒有檔案不符。 檔案已存在於目的地目錄中;因此,已略過複製作業。
1 已成功複製所有檔案。
2 目的地目錄中有一些其他檔案不存在於來原始目錄中。 未複製任何檔案。
3 某些檔案已複製。 其他檔案已存在。 未發生任何失敗。
5 某些檔案已複製。 某些檔案不符。 未發生任何失敗。
6 其他檔案和不相符的檔案存在。 未複製任何檔案,也不會發生任何失敗。 這表示檔案已存在於目的地目錄中。
7 檔案已複製、檔案不符存在,而且有其他檔案存在。
8 數個檔案並未複製。

注意

任何大於 8 的值都表示複製作業期間至少有一個失敗。

其他參考