robocopy の使い方|基本構文と主要オプション、/MIR の削除リスクまで解説
結論
robocopy は、Windows に標準搭載されているフォルダー単位のコピー用コマンドです。コピー元とコピー先を比べて「違うファイルだけ」をコピーするので、2回目以降のバックアップが速く、通常のエクスプローラーのコピーより確実に処理できます。
基本の形はこれだけです。
robocopy コピー元 コピー先 /E
ただし、似た名前のオプション /MIR は、コピー先にだけあるファイルを削除する強力なオプションです。便利な反面、指定を間違えるとコピー先のデータを消してしまいます。この記事では基本構文と主要オプションの意味、実例、つまずき所を順に解説します。


robocopy とは(意味と仕組み)
robocopy は「Robust File Copy」の略で、Windows 10 / Windows 11 と Windows Server に標準で含まれています(別途インストールは不要です)。
特徴は次の3つです。
- コピー元とコピー先を比較し、存在しないファイルと、サイズ・更新日時が違うファイルだけをコピーする
- ネットワーク越しのコピーでエラーが起きても、再試行して続行できる
- 結果を終了コードとログで確認でき、バッチファイルやタスクスケジューラでの自動実行に向く
通常のコピーは「全部を毎回コピーする」方式ですが、robocopy は差分だけを処理するため、日々のバックアップ用途ではこちらが向いています。
基本構文と、コピー元・コピー先の書き方
構文は次のとおりです。
robocopy <コピー元> <コピー先> [<ファイル>] [<オプション>]
- <コピー元> と <コピー先> は、フォルダーのパスを書きます。ドライブ直下(例:D:\Backup)でも、ネットワーク共有(例:\\NAS\share\Backup)でも指定できます
- <ファイル> は省略できます。省略すると *.*(すべてのファイル)が対象になります。*.docx のようにワイルドカードで種類を絞ることも、複数並べることもできます
- コピー先のフォルダーが存在しない場合は、自動で作成されます
たとえば、C:\Data の中身を D:\Backup にコピーする場合はこう書きます。
robocopy C:\Data D:\Backup /E
書き方で間違えやすい点
- コピーされるのは「コピー元フォルダーの中身」です。上の例では D:\Backup の直下に C:\Data の中身が入ります。D:\Backup\Data のようにフォルダーごと入れ子にはなりません
- パスにスペースが含まれる場合は、パス全体を " " で囲みます。例:robocopy "C:\My Data" "D:\Backup Data" /E
- 引用符で囲んだパスの末尾に \ を付けないでください("C:\My Data\" のような書き方は、引用符の解釈が崩れてエラーになることがあります)
主要オプション一覧
よく使うオプションを目的別にまとめます。大文字・小文字は区別されません。
コピーの範囲を決めるオプション
| オプション | 意味 |
|---|---|
| /S | サブフォルダーもコピーする(ただし空のフォルダーは除く) |
| /E | サブフォルダーを、空のフォルダーも含めてコピーする |
| /MIR | コピー元とコピー先を完全に同じ状態にする(/E と /PURGE を合わせたもの)。コピー先にだけあるファイル・フォルダーは削除される |
| /PURGE | コピー元に無いものを、コピー先から削除する |
| /L | 実際にはコピーせず、処理対象の一覧だけを表示する(事前確認用) |
何もオプションを付けない場合、対象は指定フォルダー直下と、空でないサブフォルダーのファイルです。フォルダー構成ごとそのままコピーしたい場合は /E を付けるのが基本になります。
再試行のオプション(付けないと長時間止まる)
| オプション | 意味 | 既定値 |
|---|---|---|
| /R:n | コピーに失敗したファイルの再試行回数 | 1,000,000 回 |
| /W:n | 再試行までの待ち時間(秒) | 30 秒 |
既定値のままだと、使用中のファイルに当たったとき、30 秒おきに最大100万回も再試行を続けるため、終わらないように見える状態になります。手動実行では /R:2 /W:5 程度に下げるのが実用的です。
ログのオプション
| オプション | 意味 |
|---|---|
| /LOG:ファイル名 | 結果をログファイルに保存する(画面には出なくなる) |
| /LOG+:ファイル名 | ログファイルに追記する |
| /TEE | ログに書きつつ、画面にも表示する(/LOG と併用) |
| /NP | 進捗のパーセント表示をしない(ログが読みやすくなる) |
その他の便利なオプション
| オプション | 意味 |
|---|---|
| /MT:n | マルチスレッドでコピーする。n は 1〜128、既定は 8。小さいファイルが大量にあるとき効く |
| /XD フォルダー名 | 指定したフォルダーを除外する |
| /XF ファイル名 | 指定したファイルを除外する(ワイルドカード可) |
| /SEC | ファイルのセキュリティ情報(アクセス権)もコピーする(/COPY:DATS と同等) |
| /Z | ネットワーク越しで中断しても途中から再開できるモードでコピーする |
| /COPY:フラグ | コピーするファイル情報の種類。既定は DAT(データ・属性・タイムスタンプ) |
/MIR の削除リスク(必ず読んでください)
/MIR は「ミラーリング」の名のとおり、コピー先をコピー元とまったく同じ状態にそろえるオプションです。コピー元に無いファイルは、コピー先から削除されます。
危険なのは次のようなケースです。
- コピー元とコピー先を逆に書いてしまった(空に近いフォルダーが「元」になり、バックアップ側のファイルが消える)
- コピー元フォルダーの中身を整理・移動したあとに、そのまま /MIR を実行した(コピー先の旧ファイルも一括で消える)
- コピー先に、robocopy 管理外のファイルを置いていた(それも「元に無いもの」として消える)
対策はシンプルです。
- 初回は必ず /L を付けて試運転し、削除対象(ログ上で「追加」と表示されるコピー先だけのファイル)に問題がないか確認する
- コピー元・コピー先の指定を、実行前に声に出すつもりで見直す
- 大事なデータでは、まず /E(削除なし)で運用し、/MIR は必要になってから使う
実例
例1:フォルダーを丸ごとバックアップする(削除なし)
robocopy C:\Data D:\Backup /E /R:2 /W:5
C:\Data の中身を、空フォルダーも含めて D:\Backup にコピーします。コピー先だけに残っているファイルは消えません。
例2:バックアップ先を元と完全に一致させる(/MIR+ログ)
robocopy C:\Data D:\Backup /MIR /R:2 /W:5 /LOG:D:\Backup\robocopy.log /NP
実行前に、必ず /MIR を /MIR /L に変えた試運転で、削除されるファイルを確認してください。
例3:特定の種類のファイルだけコピーする
robocopy C:\Data D:\Backup *.docx *.xlsx /E /R:2 /W:5
Word と Excel のファイルだけが対象になります。
例4:一時フォルダーを除外してコピーする
robocopy C:\Data D:\Backup /E /XD Temp Cache /R:2 /W:5
Temp と Cache という名前のフォルダーは丸ごと除外されます。
終了コードの読み方
robocopy は、処理結果を終了コードで返します。バッチファイルなどで成功・失敗を判定するときの目安です。
| 終了コード | 意味 |
|---|---|
| 0 | コピーしたファイルなし(元と先が既に一致していた) |
| 1 | ファイルのコピーに成功した |
| 2 | コピー先にだけ存在するファイル・フォルダーがあった |
| 3 | 1 と 2 の両方が起きた |
| 8 | 一部のファイル・フォルダーをコピーできなかった |
| 16 | 重大なエラー(引数の誤り、コピー元にアクセスできない等) |
0〜7 は「正常終了の範囲内」で、内容の組み合わせで数値が変わります。8 以上が失敗ありと覚えておくと判定しやすくなります。特に「1 はエラー」という誤解が多いのですが、1 はコピー成功を表す正常なコードです。

つまずき所・よくある失敗
- 終わらないように見える:使用中のファイルに対して既定の再試行(30 秒 × 最大100万回)が続いている状態です。/R と /W を小さく指定してください
- 開いているファイルがコピーできない:robocopy は使用中(ロック中)のファイルをそのままではコピーできません。対象アプリを閉じてから実行してください。エラー 32(別のプロセスが使用中)が出ます
- 空のフォルダーがコピーされない:既定および /S では空フォルダーは対象外です。/E を使ってください
- 思った場所にコピーされない:コピーされるのはコピー元フォルダーの「中身」です。フォルダーごと入れ子にしたい場合は、コピー先にフォルダー名まで含めて指定します(例:robocopy C:\Data D:\Backup\Data /E)
- アクセス権までコピーしたい:既定ではデータ・属性・タイムスタンプのみです。アクセス権も必要なら /SEC(または /COPYALL)を使います。管理者権限が必要になる場合があります
まとめ
- robocopy の基本形は robocopy コピー元 コピー先 /E。差分だけをコピーするので繰り返しのバックアップが速い
- 手動実行では /R:2 /W:5 を付けて、再試行で止まらないようにする
- /MIR はコピー先を元と完全一致させる代わりに、先にだけあるファイルを削除する。使う前に必ず /L で試運転する
- 結果の判定は終了コードで。0〜7 が正常範囲、8 以上は失敗あり
