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 的值都表示複製作業期間至少有一個失敗。

其他參考