robocopyとは?使い方とオプション一覧 — フォルダごとコピー・バックアップ・ミラー(/MIR)の書き方
※この記事にはプロモーション(広告)が含まれます。広告表記の方針
robocopy(ロボコピー、Robust File Copy)は、Windowsに最初から入っているコピーコマンドです。変更のあったファイルだけをコピーできるので、バックアップやファイルサーバーの引っ越しによく使われます。この記事では、基本の書き方、よく使うオプション、用途別の書き方、実行結果と終了コードの見方を、筆者のPC(Windows 11)で実際に動かした結果を交えて説明します。
robocopyとは:copy・xcopyとの違い
Windowsのコピーコマンドには copy・xcopy・robocopy があります。robocopy は、たくさんのファイルを何度もコピーする用途に向いた機能を持っています。
| できること | copy | xcopy | robocopy |
|---|---|---|---|
| サブフォルダーごとコピー | × | ○(/S /E) | ○(/S /E) |
| 変更があったファイルだけコピー | × | △(/D で日付を比べる) | ○(何も付けなくてもそうなる) |
| 失敗したときの再試行 | × | × | ○(/R /W) |
| コピー元に無いファイルをコピー先から消す(ミラー) | × | × | ○(/MIR) |
| 複数のファイルを同時にコピー(マルチスレッド) | × | × | ○(/MT) |
| ログファイルに記録 | × | × | ○(/LOG) |
robocopy は、コピー元とコピー先のファイルのサイズと更新日時を比べて、同じならコピーしません。筆者のPCで、4KBのファイル1万個を一度コピーしたあと同じコマンドをもう一度実行すると、1万個すべてを「スキップ」と判定して0.1秒かからずに終わりました。毎日のバックアップで2回目以降が速いのはこのためです。
基本の書き方
robocopy /? で表示される書式は次のとおりです。
ROBOCOPY コピー元 コピー先 [ファイル [ファイル]...] [オプション]
- コピー元・コピー先はフォルダーを指定します(ファイルではありません)。
\\サーバー\共有\パスの形も使えます。 - 「ファイル」を省略すると、すべてのファイル(
*.*)が対象です。*.xlsxのようにワイルドカードも使えます。 - コピー先のフォルダーが無ければ、自動で作られます。
テスト用のフォルダー(中身は a.txt、tmp1.tmp、sub\s.txt、空のフォルダー empty、node_modules\n.js)で、書き方によって何がコピーされるかを確かめた結果です。
| コマンド | コピー先にできたもの |
|---|---|
robocopy C:\work\src C:\work\dst | a.txt、tmp1.tmp だけ(サブフォルダーはコピーされない) |
… /S | サブフォルダーの中身も。ただし空の empty は作られない |
… /E | 空のフォルダーも含めてすべて |
robocopy C:\work\src C:\work\dst\src /E | dst\src\ の下にすべて(フォルダーごとコピー) |
robocopy C:\work\src C:\work\dst a.txt | a.txt だけ |
いちばん迷いやすいのはフォルダーごとコピーしたいときです。robocopy はコピー元フォルダーの「中身」をコピー先に入れるので、src というフォルダーごと置きたいときは、コピー先にも …\src とフォルダー名まで書きます。サブフォルダーまでコピーしたいときは、基本的に /E を付けます。
パスにスペースがあるときは、最後に「\」を付けない
パスにスペースが入るときは " で囲みます。このとき "C:\work\my data\src\" のように、閉じる " の直前に \ を付けると失敗します。robocopy は \" を「文字としての "」と解釈するため、2つのパスが1つにつながってしまうからです。実際に試すと、終了コード16(致命的なエラー)で、次のように表示されました(パスは置き換えています)。
エラー 123 (0x0000007B) コピー元ディレクトリにアクセスしています C:\work\my data\src" C:\work\my\
ファイル名、ディレクトリ名、またはボリューム ラベルの構文が間違っています。
コピー元が「…\src" C:\work\my\」という、ありえないパスになっているのが分かります。"C:\work\my data\src" のように、最後の \ を付けなければ正常にコピーできました。
よく使うオプション一覧
robocopy /? の説明をもとに、実務でよく使うものを用途別にまとめました。
コピーする範囲
| オプション | 意味 |
|---|---|
/S | サブフォルダーもコピーする(空のフォルダーは除く) |
/E | 空のフォルダーも含めてサブフォルダーをコピーする |
/LEV:n | 上から n 階層までだけコピーする |
/MIR | ミラー。/E + /PURGE と同じ(コピー元に無いものをコピー先から削除する) |
/PURGE | コピー元に無いファイル・フォルダーをコピー先から削除する |
/MOV | ファイルを移動する(コピー後にコピー元から削除) |
/MOVE | ファイルとフォルダーを移動する |
除外する
| オプション | 意味 |
|---|---|
/XF ファイル名 | 名前・ワイルドカードに一致するファイルを除外(例 /XF *.tmp ~$*) |
/XD フォルダー名 | 名前に一致するフォルダーを除外(例 /XD node_modules .git) |
/XO | 古いファイルを除外(コピー先のほうが新しいときはコピーしない) |
/MAXAGE:n | n 日より古いファイルを除外(n が1900以上なら YYYYMMDD の日付) |
/MINAGE:n | n 日より新しいファイルを除外 |
/MAX:n / /MIN:n | n バイトより大きい/小さいファイルを除外 |
コピーする情報
| オプション | 意味 |
|---|---|
/COPY:DAT | 既定値。D=データ、A=属性、T=タイムスタンプ |
/SEC | アクセス権(NTFSのACL)もコピー(/COPY:DATS と同じ) |
/COPYALL | すべての情報をコピー(/COPY:DATSOU、O=所有者、U=監査情報) |
/DCOPY:DAT | フォルダーのタイムスタンプもコピー(既定は /DCOPY:DA) |
再試行・速度
| オプション | 意味 |
|---|---|
/R:n | 失敗したときの再試行回数(既定値は1,000,000) |
/W:n | 再試行までの待ち秒数(既定値は30秒) |
/MT[:n] | n 個のスレッドで同時にコピー(n を省略すると8、1〜128) |
/Z | 再起動可能モード。途中で切れたファイルを続きからコピーできる |
/B / /ZB | バックアップモード(アクセス権に関係なく読む。管理者が必要)/まず /Z で試し、拒否されたら /B |
/J | バッファーなしでコピー(大きなファイル向け) |
確認・ログ
| オプション | 意味 |
|---|---|
/L | 一覧だけ表示。コピーも削除もしない(実行前の確認に使う) |
/LOG:ファイル | 結果をログファイルに書く(上書き) |
/LOG+:ファイル | 結果をログファイルに追記する |
/TEE | ログファイルと画面の両方に出す |
/NP | 進行状況(○%)を出さない。ログが読みやすくなる |
/NFL / /NDL | ファイル名/フォルダー名を出さない |
/V | スキップしたファイルも表示する |
用途別の書き方
1. フォルダーをまるごとコピーする
robocopy "C:\data\project" "D:\backup\project" /E /R:2 /W:5
/R と /W は必ず付けておきます。付けないと、使用中のファイルが1つあるだけで「30秒待って再試行」を100万回くり返す設定になり、事実上終わりません。
2. 毎日のバックアップ(変更があったファイルだけ)
robocopy "C:\data" "D:\backup\data" /E /XO /R:2 /W:5 /NP /LOG+:"D:\backup\robocopy.log"
同じコマンドを毎日実行すれば、2回目以降は変更があったファイルだけがコピーされます。ここで /XO を付けている理由があります。robocopy は既定で、コピー元のほうが古いファイルも上書きします。実際に、コピー先で後から編集したファイル(更新日時がコピー元より新しい)を用意して実行すると、何も付けない場合はコピー元の古い内容で上書きされ、/XO を付けた場合はコピー先の内容が残りました。コピー先を直接さわる可能性があるなら /XO を付けておくと安全です。
3. ミラー(コピー元とまったく同じにする)
robocopy "C:\data" "D:\mirror\data" /MIR /R:2 /W:5 /L
robocopy "C:\data" "D:\mirror\data" /MIR /R:2 /W:5
/MIR はコピー先の余分なファイルを削除します。1行目のように、まず /L を付けて何が消えるかを確認してから、2行目のように /L を外して実行します。詳しくは次の節で説明します。
4. 一時ファイルや特定のフォルダーを除外する
robocopy "C:\data\project" "D:\backup\project" /E /XF *.tmp ~$* /XD node_modules .git /R:2 /W:5
~$* は、Officeのファイルを開いているあいだにできる一時ファイルです。テスト用フォルダーで試すと、/XF *.tmp /XD node_modules で .tmp ファイルと node_modules フォルダーだけがコピーされませんでした。
5. 30日より古いファイルを別の場所へ移す
robocopy "C:\logs" "E:\archive\logs" /MOV /MINAGE:30 /R:2 /W:5
更新日時が40日前のファイルと今日のファイルで試すと、40日前のファイルだけがコピー先へ移り、コピー元からは消えました。/MOV はファイルだけを移動し、フォルダーは残ります。フォルダーも消したいときは /MOVE です。
6. ファイルサーバー・NASへコピーする
robocopy "C:\data" "\\fileserver\share\data" /E /Z /MT:8 /R:2 /W:5 /NP /LOG:"C:\temp\robocopy.log"
ネットワーク越しのコピーでは、途中で切れても続きから再開できる /Z と、複数のファイルを同時に送る /MT がよく使われます。そもそも共有フォルダーに接続できないときは、共有フォルダにアクセスできない時の確認方法の順番で切り分けます。コピーにかかる時間の目安はデータ転送時間の計算で出せます。
7. アクセス権ごと移す(ファイルサーバーの引っ越し)
robocopy "\\oldserver\share" "\\newserver\share" /MIR /COPYALL /DCOPY:DAT /B /R:1 /W:1 /MT:16 /NP /LOG:"C:\temp\migrate.log"
アクセス権(ACL)や所有者までコピーする /COPYALL と、権限に関係なくファイルを読む /B は、管理者として実行したコマンドプロンプトで使います。引っ越しでは、何回かに分けて同じコマンドを実行し、最後の1回で差分だけをコピーしてから切り替えると、利用者が使えない時間を短くできます。
/E と /MIR の違い:コピー先にだけあるファイルの扱い
/E と /MIR の違いは、コピー先にだけあるファイルをどうするかだけです。/E は残し、/MIR は削除します。
テスト用フォルダーで、コピー先にだけファイルとフォルダーを置いて /MIR を実行したところ、次のことが分かりました。
- 削除されたファイルはごみ箱に入りません。エクスプローラーで消したときと違い、元に戻せません。
- 削除しても終了コードは2(失敗なし)です。終了コードを見ても、何かが消えたことには気づけません。
- 空のフォルダーをコピー元にして /MIR を実行すると、コピー先は空になりました。コピー元とコピー先を逆に書いたときも、仕組み上は同じように削除が起こります。
実行前に /L を付けると、消える予定のものが *EXTRA File・*EXTRA Dir の行で表示されます(日本語版のWindowsでもこの表示は英語のままでした)。
*EXTRA Dir -1 D:\mirror\data\old_project\
*EXTRA File 3 plan.docx
*EXTRA File 9 only_in_backup.txt
バックアップ先にしか無いファイル(過去に消したファイルの控えなど)を残したいなら、/MIR ではなく /E を使います。
実行結果の見方
robocopy は最後に集計を表示します。日本語版のWindowsでの実際の表示です。
合計 コピー済み スキップ 不一致 失敗 Extras
ディレクトリ: 1 0 1 0 0 0
ファイル: 4 3 1 0 0 1
バイト: 33 27 6 0 0 7
| 列 | 意味 |
|---|---|
| コピー済み | 実際にコピーした数 |
| スキップ | 同じだったのでコピーしなかった数 |
| 不一致 | 同じ名前でファイルとフォルダーが食い違っていた数 |
| 失敗 | 再試行してもコピーできなかった数。0以外なら原因を確認する |
| Extras | コピー先にだけあった数(/MIR では削除の対象) |
ファイルごとの行には、コピー元とコピー先を比べた結果(ファイルの分類)が出ます。/V を付けると、スキップしたファイルも表示されます。
| 表示 | 状態 | 既定の動き |
|---|---|---|
| 新しいファイル | コピー先に無い | コピーする |
| 新しい | コピー元のほうが新しい | コピーする |
| 古い | コピー元のほうが古い | コピーする(/XO で除外) |
| 同じ | サイズも更新日時も同じ | コピーしない |
| *EXTRA File | コピー先にだけある | 何もしない(/MIR・/PURGE では削除) |
終了コードの見方:8以上が失敗
robocopy の終了コード(%ERRORLEVEL%・$LASTEXITCODE)は、0か1かではなく、次の値の合計です。
正常にファイルをコピーしたときの終了コードは1です。そのため、バッチで if errorlevel 1(「1以上なら」という意味)と書くと、成功したのに失敗の扱いになります。判定は8以上かどうかで行います。
rem バッチ(.bat)
robocopy "C:\data" "D:\backup\data" /E /R:2 /W:5 /NP /LOG+:"D:\backup\robocopy.log"
if %ERRORLEVEL% GEQ 8 (
echo robocopy failed: %ERRORLEVEL%
exit /b 1
)
exit /b 0
# PowerShell
robocopy C:\data D:\backup\data /E /R:2 /W:5 /NP /LOG+:D:\backup\robocopy.log
if ($LASTEXITCODE -ge 8) { throw "robocopy failed: $LASTEXITCODE" }
バッチの最後の exit /b 0 は、robocopy の終了コード(1や3)がそのままバッチの終了コードにならないようにするためです。タスクスケジューラで動かすと、この値が「前回の実行結果」に表示されるので、成功なのに失敗に見えるのを防げます(前回の実行結果の読み方)。
よくあるつまずき
| 症状・表示 | 原因と対処 |
|---|---|
| いつまでも終わらない/「30 秒間待機しています... 再試行しています...」がくり返される | 使用中・権限なしのファイルで再試行中。既定は100万回×30秒なので、/R:2 /W:5 のように指定する |
| エラー 32「プロセスはファイルにアクセスできません。別のプロセスが使用中です。」 | ファイルを開いているアプリがある。閉じてから再実行するか、ログで対象のファイルを確認する |
| エラー 5「アクセスが拒否されました。」 | 読み取り・書き込みの権限が無い。権限を確認する。管理者で /B / /ZB を使う方法もある |
| エラー 53「ネットワーク パスが見つかりません。」 | サーバー名・共有名の誤り、またはネットワークに届いていない(切り分けの順番) |
| エラー 112「ディスクに十分な空き領域がありません。」 | コピー先の容量不足。/L の集計のバイト数で、必要な容量を事前に確かめられる |
| エラー 123「ファイル名、ディレクトリ名、またはボリューム ラベルの構文が間違っています。」 | "…\" のように、閉じる " の直前に \ がある(上の説明) |
| 毎回、全部のファイルがコピーされる | コピー先がFAT形式(USBメモリなど)や一部のNASだと、更新日時の記録の細かさが違い、日時が一致しないことがある。/FFT を付けると2秒以内の差を同じとみなす |
エラーの文言は、このPC(日本語版Windows 11)で表示されたものです。robocopy のエラー番号はWindows共通のエラー番号なので、net helpmsg 番号 で同じ文言を確認できます。
よくある質問
Q. robocopyとxcopyの違いは?
A. どちらもWindows標準のコピーコマンドですが、robocopyは変更のあったファイルだけをコピーする、失敗したときに再試行する、コピー元に無いファイルをコピー先から消して同じ状態にする(ミラー)、複数のスレッドで同時にコピーする、ログファイルに記録する、といった大量のコピーやバックアップ向けの機能を持っています。
Q. robocopyでフォルダごとコピーするには?
A. robocopyはコピー元フォルダーの「中身」をコピー先に入れます。フォルダーそのものを作りたいときは、コピー先にフォルダー名まで書きます。例:robocopy C:\data\project D:\backup\project /E。コピー先のフォルダーが無ければ自動で作られます。
Q. robocopyの終了コード1はエラー?
A. エラーではありません。1は「1つ以上のファイルをコピーした」という意味です。robocopyの終了コードは0〜7が失敗なし、8以上が失敗ありです。バッチで判定するときは if %ERRORLEVEL% GEQ 8 のように8以上かどうかで判定します。
🔗 関連:タスクスケジューラの使い方 / 共有フォルダにアクセスできない時の確認方法 / ファイル通信の種類と特性(SMB・FTP・rsync) / イベントビューアーの開き方と見方 / データ転送時間の計算 / Linux ⇄ PowerShell コマンド対訳表