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 模式中的所有加密檔案。
/複製：<copyflags> 指定要複製的檔案屬性。 此選項的有效值為：
  • D - 資料
  • A - 屬性
  • T - 時間戳記
  • X - 略過替換資料流程
  • S - NTFS 存取控制清單 (ACL)
  • O - 擁有者資訊
  • U - 稽核資訊
/COPY選項的預設值是DAT (資料、屬性和時間戳記) 。 如果使用/B或/ZB，則會忽略X旗標。
/dcopy：<copyflags> 指定要在目錄中複製的內容。 此選項的有效值為：
  • D - 資料
  • A - 屬性
  • T - 時間戳記
  • E - 擴充屬性
  • X - 略過替換資料流程
此選項的預設值是 DA (資料和屬性) 。
/秒 複製安全性 (相當於 /copy：DATS) 的 檔案。
/copyall 複製所有檔案資訊， (相當於 /copy：DATSOU) 。
/nocopy (/purge) 時複製任何檔案資訊。
/secfix 修正所有檔案上的檔案安全性，甚至略過檔案。
/timfix 修正所有檔案上的檔案時間，甚至略過檔案的時間。
/清除 刪除來源中已不存在的目的地檔案和目錄。 使用此選項搭配 /e 選項和目的地目錄，可不允許覆寫目的地目錄安全性設定。
/mir 鏡像目錄樹狀目錄 (相當於 /e 加上 /purge) 。 使用此選項搭配 /e 選項和目的地目錄，會覆寫目的地目錄安全性設定。
/mov 移動檔案，並在複製檔案之後從來源刪除檔案。
/移動 移動檔案和目錄，並在複製檔案和目錄之後從來源刪除它們。
/a+：[QUIETCNET] 將指定的屬性加入至複製的檔案。 此選項的有效值為：
  • R - 唯讀
  • A - 封存
  • S - 系統
  • H - 隱藏
  • C - 壓縮
  • N - 未編制索引的內容
  • E - 加密
  • T - 暫存
/a-：[QUIETCNETO] 從複製的檔案中移除指定的屬性。 此選項的有效值為：
  • R - 唯讀
  • A - 封存
  • S - 系統
  • H - 隱藏
  • C - 壓縮
  • N - 未編制索引的內容
  • E - 加密
  • T - 暫存
  • O - 離線
/create 僅建立目錄樹狀目錄和零長度檔案。
/脂肪 僅使用 8.3 個字元長度的 FAT 檔案名來建立目的地檔案。
/256 關閉超過 256 個字元的路徑支援。
/週一：<n> 監視來源，並在偵測到超過 n 個變更時再次執行。
/mot：<m> 如果偵測到變更，請監視來源，並在 m 分鐘內再次執行。
/rh：hhmm-hhmm 指定可能啟動新複本的執行時間。
/pf 檢查每個檔案的執行時間， (不是個別) 。
/ipg：<n> 指定封包間間距，以釋放慢速線路上的頻寬。
/Sj 將連接 (軟體連結) 複製到目的地路徑，而不是連結目標。
/Sl 請勿遵循符號連結，而是建立連結的複本。
/mt：<n> 使用 n 個執行緒建立多執行緒複本。 n 必須是介於 1 到 128 之間的整數。 n的預設值為 8。 若要提升效能，請使用 /log 選項重新導向您的輸出。

/mt參數不能與/ipg和/efsraw參數搭配使用。
/nodcopy (預設 /dcopy：DA 完成) ，則不會複製任何目錄資訊。
/nooffload 不使用 Windows 複製卸載機制來複製檔案。
/壓縮 如果適用，請在檔案傳輸期間要求網路壓縮。
/稀疏 啟用在複製期間保留疏鬆狀態。

重要

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

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

注意

/mt參數是在 Windows Server 2008 R2 中引進，其功能適用于目前的 Windows Server 版本。

複製檔案節流選項

選項 描述
/iomaxsize： <n> [kmg] 每個讀取/寫入週期所要求的最大 i/o 大小，以 nk tb、 megabytes 或 GB為單位。
/iorate： <n> [kmg] 以 nk 單位為單位的要求 i/o 速率，單位為megabytes，或每秒GB。
/threshold： <n> [kmg] The file size threshold for throttling in nkilobytes, megabytes, or gigabytes (see Remarks).

檔案選取選項

選項 描述
/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 - 離線
/芳 <filename>[ ...] 排除符合指定名稱或路徑的檔案。 支援通 * 配符 (和 ？) 。
/Xd <directory>[ ...] 排除符合指定名稱和路徑的目錄。
/xc 排除具有相同時間戳記但不同檔案大小的現有檔案。
/xn 來原始目錄檔案比目的地還新的檔案會從複本中排除。
/Xo 比目的地還舊的來原始目錄檔案會從複本中排除。
/Xx 排除目的地中存在的額外檔案和目錄，但不會排除來源。 排除額外的檔案不會從目的地刪除檔案。
/Xl 排除來源中存在的「lonely」檔案和目錄，但不包含目的地。 排除單一檔案可防止任何新檔案新增至目的地。
/我 包含已修改的檔案， () 變更時間不同。
/is 包含相同的檔案。 相同檔案的名稱、大小、時間和所有屬性都相同。
/it 包含「已調整」檔案。 已調整的檔案具有相同的名稱、大小和時間，但有不同的屬性。
/麥克斯：<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 秒) 。
/註冊 將 /r 和 /w 選項中指定的值儲存為登錄中的預設設定。
/待定 指定系統會等候定義共用名稱稱， (重試錯誤 67) 。
/lfsm Operate in low free space mode which enables copy, pause and resume (see Remarks).
/lfsm： <n> [kmg] 指定 nk tb、 megabytes 或 GB的樓層大小。

記錄選項

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

作業選項

選項 描述
/工作：<jobname> 指定要衍生自具名作業檔案的參數。 若要執行 /job:jobname ，您必須先執行 /save:jobname 參數來建立作業檔案。
/救：<jobname> 指定要將參數儲存至具名作業檔案。 執行 之前，必須先執行 /job:jobname 此動作。 所有複製、重試和記錄選項都必須在此參數之前指定。
/quit 在處理命令列 (之後結束，以檢視參數) 。
/nosd 表示未指定任何來原始目錄。
/nodd 表示未指定任何目的地目錄。
/如果 包含指定的檔案。

備註

  • 在磁片區的根目錄上使用 /PURGE 或 /MIR ，會導致 robocopy 在系統磁片區資訊目錄內的檔案上套用要求的作業。 這已不再如此，如同已指定一樣，robocopy 會略過在複製會話的最上層來源和目的地目錄中使用該名稱的任何檔案或目錄。

  • 只有在來源和目的地檔案系統都支援變更時間戳記時，才會套用修改過的檔案分類，例如 NTFS，而來源和目的地檔案有不同的變更時間，但否則相同。 預設不會複製這些檔案。 指定 /IM 以包含它們。

  • 應該針對目錄嘗試擴充屬性複製的 /DCOPY：E 旗標要求。 如果無法複製目錄的 EA，Robocopy 將會繼續。 此旗標不包含在 /COPYALL中。

  • 如果指定 /IoMaxSize 或 /IoRate ，robocopy 將會啟用複製檔案節流，以減少系統負載。 這兩者都可以調整為最佳值和複製參數，但系統與 robocopy 可以視需要調整為允許的值。

  • 如果使用 /Threshold ，它會指定吸引人節流的最小檔案大小。 低於該大小的檔案將不會受到節流。 這三個參數的值後面可能接著選擇性尾碼字元，例如 [KMG] (kb、mega、gb、gb) 。

  • 使用 /LFSM 要求 robocopy 以「低可用空間模式」運作。 在此模式中，每當檔案複本會導致目的地磁片區的可用空間低於 'floor' 值時，robocopy 就會暫停。 您可以使用 /LFSM：n[KMG] 旗標明確指定此值。

  • 如果未指定 /LFSM 且沒有明確的樓層值，則樓層會設定為目的地磁片區大小的 10%。 低可用空間模式與 /MT 和 /EFSRAW不相容。

結束 (傳回) 碼

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

注意

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