robocopyの使い方｜オプション早見表・/MIRの注意と終了コード

robocopy は、コピー元とコピー先を比べて、無いファイルとサイズ・日時の違うファイルだけをコピーします。コピー先にだけあるファイルは、/MIR か /PURGE を付けたときだけ消します。

flowchart TD
    A[コピー元と<br>コピー先を比べる] --> B{元だけ・<br>違う}
    B -->|はい| C[コピー]
    B -->|同じ| D[スキップ]
    A --> E{コピー先<br>だけ}
    E -->|/MIR| F[削除]

急いでいる人向けに、よく調べられることの答えを先にまとめます。

確認環境：robocopy の書式・オプション・既定値・終了コードは、Microsoft Learn の「robocopy」（英語版 2025年3月17日更新・日本語版）と「Return codes that are used by the Robocopy utility」（2026年2月12日更新）、Microsoft のブログのアーカイブ「Robocopy exit codes」、Azure Files の「RoboCopy を使った移行」の解説で確かめました。タスクスケジューラは schtasks /create・Register-ScheduledTask、エラー番号は Win32 のシステム エラー コードのページで確かめています。コピー・ミラー・試運転・除外・失敗の動きは、Ubuntu 24.04.4 LTS の rsync 3.2.7 で同じ操作を実行して対応づけ、robocopy の終了コードの決まりを Python 3.11.15 で実装して rsync の結果に当てはめました。パスの引用符の解釈は、Microsoft Learn に書かれた規則を Python で実装し、ページの例6件と一致することを確かめてから使っています（確認日 2026年10月23日）。

robocopyとは（読み方・できること）

この節では、robocopy が何で、copy・xcopy と比べて何ができるかが分かります。

robocopy（ロボコピー）は、Windows に最初から入っているファイルコピーのコマンドです。 名前は「Robust File Copy（堅牢なファイルコピー）」の略で、1996年に Windows NT 4.0 Resource Kit の道具として出て、Windows Vista・Windows Server 2008 から標準で入っています。コマンド プロンプトでも PowerShell でも動きます。PowerShell では $ で始まる名前（$RECYCLE.BIN など）が変数として読まれるので、'$RECYCLE.BIN' のように単一引用符で囲みます。

ほかにも、アクセス権（ACL）や所有者のコピー、複数スレッドでの並列コピー（/MT）、帯域の制限（/IPG）、変化を見張って自動で再実行（/MON・/MOT）、オプションの保存（/SAVE・/JOB）ができます。

copy・xcopy との違い（概要）

copy は「1つ以上のファイルをコピーする」コマンドで、Microsoft Learn の copy のページでは、サブフォルダーまで全部コピーするなら xcopy を使うよう書かれています。xcopy はフォルダーごとコピーできますが、コピー先にだけあるファイルを消すミラーや、失敗したファイルの再試行はありません。詳しい比較は後の「xcopy・copy・rsync との違い」の表にまとめました。

robocopyの基本の書式と最初のコピー

この節では、書式の意味と、フォルダーを中身ごとコピーする最初のコマンドが分かります。

robocopy <コピー元> <コピー先> [<ファイル>[ ...]] [<オプション>]

コピー元とコピー先には、ファイルではなくフォルダーを書きます。 1つのファイルだけをコピーするときは、フォルダーを2つ書き、3つ目にファイル名を書きます。

:: フォルダーの中身を、サブフォルダー（空のものも）ごとコピー
robocopy C:\work\project D:\backup\project /E

:: 1つのファイルだけ（report.xlsx）をコピー
robocopy C:\work\project D:\backup\project report.xlsx

:: 拡張子で絞る（.jpg と .jpeg だけ。/S で空のフォルダーは作らない）
robocopy C:\photos D:\photos *.jpg *.jpeg /S

ヘルプは robocopy /? で表示されます。

どのファイルがコピーされるか（差分の判定）

robocopy は、ファイルを「クラス」に分けて、コピーするかを決めます。Microsoft Learn のファイル選択のオプションに出てくる名前と、ログの表示の対応です。

既定では「コピー元が新しいとき」ではなく「違うとき」にコピーします。 コピー先で編集して日時が後になったファイルも、コピー元の内容で上書きされます。上書きを避けたいときは /XO（コピー元のほうが日時が前なら除外）を付けます。

rsync も既定では「サイズか更新日時が違えばコピーする」決まりなので、同じ状況を作って確かめました。コピー先のファイルを後の日時で書き換えておき、コピーの試運転（-n）をした結果です。

【既定（コピー先のほうが新しい）】
>f.st...... a.txt          ← 日時が前のコピー元で上書きする
【--update（robocopy の /XO 相当）】
（何も出ない）              ← 上書きしない
【--ignore-existing（/XC /XN /XO 相当）】
>f+++++++++ b.txt          ← 新しいファイルだけコピー。a.txt は dst-edited のまま

パスの書き方（引用符と末尾の \ に注意）

空白を含むパスは " で囲みます。引用符で囲んだパスの最後に \ を付けると、パスが壊れます。 Microsoft の C の実行時ライブラリは、\" を「文字としての "」と読む決まり（Microsoft Learn「Parsing C command-line arguments」）だからです。この決まりを Python で書き、ページに載っている6つの例がすべて同じ結果になることを確かめてから、robocopy の引数に当てはめました。

"C:\My Files\" "D:\Backup\My Files\" /MIR
  → 3個: C:\My Files" D:\Backup\My | Files" | /MIR      ← コピー元とコピー先がつながった
"C:\My Files" "D:\Backup\My Files" /MIR
  → 3個: C:\My Files | D:\Backup\My Files | /MIR        ← 正しい
"C:\My Files\\" "D:\Backup\My Files\\" /MIR
  → 3個: C:\My Files\ | D:\Backup\My Files\ | /MIR      ← \ を2つ書けば末尾の \ が残る

1つ目は、コピー元が C:\My Files" D:\Backup\My、コピー先が Files" という、存在しないパスになりました。引用符で囲むときは、末尾の \ を付けません。 ドライブのルートを指すときは D:\ を引用符で囲まずに書きます。

よく使うオプション早見表

この節では、よく使うオプションの意味と既定値が、目的別の一覧で分かります。既定値は Microsoft Learn の robocopy のページで確かめました。

コピーのしかた

何をコピーするか（属性・権限）

フラグは、D＝データ、A＝属性、T＝タイムスタンプ、S＝NTFS のアクセス権（ACL）、O＝所有者、U＝監査の情報、X＝代替データ ストリームを飛ばす、です。/DCOPY では E＝拡張属性も指定できます。既定の /COPY:DAT ではアクセス権はコピーされません。 ファイルサーバーの移行のように権限ごと移すときは /COPY:DATSO や /COPYALL を使います。

選ぶ・除外する

/XD・/XF は、名前を空白で区切って続けて書けます。/XD node_modules .git のように1つの /XD に並べます。

再試行・ログ・ジョブ

既定の再試行は、1つのファイルで最長347日待つ

/R と /W を書かないと、使用中のファイルが1つあるだけで、robocopy はそこで止まったように見えます。 定期実行では必ず /R:1 /W:1 のように小さい値を書きます。Azure Files の移行ガイドでは、ファイルが使用中で失敗したと考えられるときは再試行を0か1回にし、次の回の実行で拾う方針が書かれています。/REG を付けると、そのときの /R と /W をレジストリーに保存して既定値にできます。

/MIRの使い方と危険（消える）・/Lで確かめる手順

この節では、/MIR が何を消すか、よくある3つの失敗、実行前に /L で確かめる手順が分かります。

/MIR は「/E ＋ /PURGE」で、コピー元に無いファイルとフォルダーを、コピー先から削除します。 削除したファイルはごみ箱に入りません。バックアップ先を /MIR でそろえると、コピー元で間違って消したファイルも、次の実行でバックアップ先から消えます。

/MIR で起きた3つの失敗（rsync で再現）

robocopy の /MIR と同じ動き（コピーして、コピー先だけのものを消す）は、rsync の -a --delete です。robocopy の /L に当たる試運転は -n です。8個のファイルがあるコピー先に対して、試運転で何が消えるかを見ました（*deleting が削除される予定のもの）。

失敗1：コピー元の階層を間違えた（C:\src\docs を D:\dst に /MIR した場合）

*deleting   olddir/z.txt
*deleting   olddir/
*deleting   node_modules/pkg/index.js
*deleting   node_modules/pkg/
*deleting   node_modules/
*deleting   img/logo.png
*deleting   img/
*deleting   empty/
*deleting   docs/old/memo.txt
*deleting   docs/old/
*deleting   docs/report.txt
*deleting   docs/new.txt
*deleting   docs/extra.txt
*deleting   docs/cache.tmp
*deleting   docs/
>f+++++++++ cache.tmp
>f+++++++++ new.txt
>f+++++++++ report.txt
cd+++++++++ old/
>f+++++++++ old/memo.txt

コピー先の8個のファイルが全部消え、docs の中身がコピー先の1階層目に置かれる予定になりました。 Azure Files の移行ガイドにも、/MIR ではコピー元とコピー先のフォルダーの階層を正確に合わせること、合っていないと大規模な削除と再コピーが起きることが書かれています。

失敗2：コピー元とコピー先を逆に書いた（コピー元にだけある今日のファイル today.txt があるとき）

*deleting   docs/today.txt
.d..t...... docs/
>f+++++++++ docs/extra.txt
cd+++++++++ olddir/
>f+++++++++ olddir/z.txt

バックアップ先をコピー元にしてしまうと、まだバックアップしていない作業中のファイルが消え、代わりにバックアップ先にだけあったファイルが作業フォルダーに入ってきます。

失敗3：コピー先にだけ置いたファイル

バックアップ先に手で置いたメモ（docs/extra.txt）や、別の処理が作ったフォルダー（olddir）は、コピー元に無いので /MIR で消える予定になりました。

*deleting   olddir/z.txt
*deleting   olddir/
*deleting   docs/extra.txt

robocopy では、コピー先だけのものを消さずに残す /XX があります。除外の扱いは robocopy と rsync で同じとは限らないので、/XD・/XF を付けた /MIR も、/L で消える一覧を見てから実行します。

/L で確かめてから実行する手順

Buffalo の NAS の FAQ でも、コピーをせずに差分だけを比べる方法として /L /E /R:1 /FP /LOG:... の形が案内されています。

rsync には削除の上限があり、robocopy には無い

rsync には --max-delete=件数 で削除の数に上限をかける仕組みがあります。失敗1の状態に --max-delete=3 を付けて実行すると、上限で削除が止まり（9件はスキップ）、終了コード 25 で終わりました。

Deletions stopped due to --max-delete limit (9 skipped)
rsync error: the --max-delete limit stopped deletions (code 25) at main.c(1356) [sender=3.2.7]

それでも olddir/z.txt と node_modules/pkg/index.js は消え、docs の中身はコピー先の1階層目にコピーされたので、元の状態には戻りません。robocopy のオプションの一覧に、削除の件数の上限はありません。robocopy で消しすぎを防ぐ方法は、/L での試運転と、パスを変数にしないで書くことです。

目的別のコマンド例（ミラー・バックアップ・移動・差分）

この節では、よくある目的ごとに、そのまま書き換えて使えるコマンドが分かります。

:: 1. フォルダーを中身ごとコピー（空のフォルダーも）
robocopy C:\work D:\backup\work /E /R:1 /W:1

:: 2. ミラー（コピー元と同じにする。消える）。先に /L で確かめる
robocopy C:\work D:\backup\work /MIR /R:1 /W:1 /NP /LOG:C:\logs\mirror.log

:: 3. 上書きしない（コピー先に無いファイルだけコピー）
robocopy C:\work D:\backup\work /E /XC /XN /XO

:: 4. 開発フォルダーを、生成物を除いてコピー
robocopy C:\dev\app D:\backup\app /E /XD node_modules .git bin obj /XF *.tmp *.log

:: 5. 7日以内に更新したファイルだけをコピー
robocopy C:\work D:\backup\recent /S /MAXAGE:7

:: 6. 移動（コピー後にコピー元から消す。フォルダーごと）
robocopy C:\inbox D:\archive /MOVE /E

:: 7. フォルダー構成だけをコピー（ファイルはコピーしない）
robocopy C:\template D:\new /E /XF *

:: 8. ファイルサーバーの移行（権限・所有者も。管理者で実行）
robocopy \\old-server\share \\new-server\share /MIR /B /COPY:DATSO /DCOPY:DAT /MT:16 /R:2 /W:1 /NP /NFL /NDL /XD "System Volume Information" /UNILOG:C:\logs\migrate.log

:: 9. オプションを保存して、次から呼び出す
robocopy C:\work D:\backup\work /MIR /R:1 /W:1 /SAVE:daily /QUIT
robocopy /JOB:daily

• 7 の /XF * は、すべてのファイルを除外して、フォルダーだけを作る書き方です。0バイトのファイルも作るなら /CREATE です。
• 8 は、Azure Files の移行ガイドで勧められているオプションの組み合わせを、サーバー間の移行に当てはめたものです。ガイドでは /MT は最初のコピーで 8〜20、その後の /MIR の実行ではマシンの CPU のスレッド数に近づけるよう書かれています。
• 9 の /SAVE は、Microsoft Learn によると、コピー・再試行・ログのオプションをすべて /SAVE より前に書きます。保存先は .RCJ のファイルです。/QUIT はコマンドラインを処理して終わる（パラメーターを見るため）ので、コピーはされません。

ドライブ全体をミラーするとき

ドライブのルート（E:\ など）を対象にすると、隠しフォルダーの $RECYCLE.BIN（ごみ箱）や System Volume Information でアクセス拒否（ERROR 5）が出ることがあります。Microsoft Learn の Q&A では、これらを /XD で除外する形が案内されています。

robocopy E:\ F:\ /MIR /R:1 /W:1 /XD $RECYCLE.BIN "System Volume Information"

Microsoft Learn の説明では、いまの robocopy は /PURGE・/MIR のとき、コピー元とコピー先の1階層目にある System Volume Information を自動で飛ばします。ごみ箱のフォルダーは自動では飛ばされないので、/XD に書きます。

robocopyを速くするには（/MT・ログの出し方）

この節では、コピーが遅いときに見るオプションと、逆に遅くなるオプションが分かります。

Azure Files の移行ガイドでは、/Z と /ZB は「Use cautiously（注意して使う）」とされ、不安定なネットワークのときだけ勧められています。小さいファイルが多いときは /MT、大きいファイルが少ないときは /J が効く場面です。 /MT は /IPG・/EFSRAW と一緒には使えません。

robocopyのログの読み方

この節では、ログの3つの部分（見出し・ファイルごとの行・集計表）の読み方と、エラーの行の見つけ方が分かります。

ログは /LOG:ファイル（上書き）か /LOG+:ファイル（追記）で残します。画面にも出すなら /TEE を足します。

robocopy C:\work D:\backup\work /MIR /R:1 /W:1 /NP /TEE /LOG+:C:\logs\backup.log

ログは上から次の3つの部分でできています。

ファイルの行の見方

表示の語は、RoboSharp（robocopy のログを読む公開のライブラリ）の英語版の設定と、Microsoft Learn のファイル選択のオプションの名前で確かめました。英語以外の Windows では語が訳されて出ることがあり、RoboSharp にはドイツ語版の設定（ERROR が FEHLER）があります。日本語の Windows のログでは、Buffalo の FAQ に「コピー済み」欄の説明があります。

最後の集計表の見方

hahndorf.eu で公開されている、実際のログの集計表です。

            Total    Copied   Skipped  Mismatch    FAILED    Extras
 Dirs :     13796         1     13794         0         1         0
Files :   4011310     14482   3996828         0         0         3
Bytes : 283.661 g   1.378 g 282.283 g         0         0    33.9 k
Times :   0:15:15   0:08:03                       0:00:00   0:07:12

まず FAILED 列が 0 かを見て、0 でなければログを ERROR で検索します。 この例のフォルダー1個の失敗は、ログの中の次の行が原因でした。

2018/11/13 20:29:22 ERROR 5 (0x00000005) Accessing Source Directory K:\data\export-2017\05\20\ Access is denied.

ERROR の行は「日時・ERROR 番号（16進）・何をしていたか・パス・Windows のエラー文」の順に並びます。番号の意味は、後の「よくあるエラー」の表で引けます。

rsync のログとの対応

rsync で --log-file と --stats を付けたときの集計（ファイル6・フォルダー7を全部コピー）です。

Number of files: 13 (reg: 6, dir: 7)
Number of created files: 13 (reg: 6, dir: 7)
Number of deleted files: 0
Number of regular files transferred: 6
Total file size: 2,073 bytes

robocopy の集計表の Copied に当たるのが「transferred」、Extras を消した数に当たるのが「deleted files」です。rsync には Skipped・FAILED の列は無く、失敗は終了コードとエラーの行で分かります。

robocopyの終了コード（0〜16）の意味と判定

この節では、終了コードの意味、成功と失敗の分かれ目、バッチ・PowerShell での判定の書き方が分かります。

robocopy の終了コードは、5つの意味を持つ数（1・2・4・8・16）の足し算です。8 以上なら、少なくとも1つ失敗しています。 0 と 1 はどちらも成功です。

flowchart TD
    A[終了コード] --> B{8 以上}
    B -->|はい| C[失敗あり<br>ERROR を見る]
    B -->|いいえ| D{0}
    D -->|はい| E[変更なし]
    D -->|いいえ| F[成功<br>1〜7]

Microsoft Learn の表は 0・1・2・3・5・6・7・8 で、「8 以上は少なくとも1つの失敗」と書かれています。4 と 16 の意味は、Microsoft のブログのアーカイブ「Robocopy exit codes」（2008年）にあり、16 は「コマンドラインのパラメーターと、コピー先への書き込みの権限を確かめる」よう書かれています。

0〜16 の全表（計算した結果）

1・2・4・8・16 の足し算を、Python で 0〜16 まで分解した結果です。

同じ操作を rsync で実行して、終了コードを対応づける

rsync の終了コードは「0＝成功」で、コピーしたかどうかでは変わりません。そこで、rsync を -i（変更の一覧を出す）付きで実行し、その出力を robocopy の決まり（コピーしたら 1、コピー先だけのものがあれば 2、一部が失敗なら 8、1つもコピーできなければ 16）で採点する Python のプログラムを書いて、7つの状況を実行しました。

ミラーの行は、消したものを Extra として数える決まりで採点しました。読めないファイルの状況は、権限の無いユーザー（nobody）で rsync を動かして作り、次のエラーが出ました。

rsync: [sender] send_files failed to open ".../s2/secret.txt": Permission denied (13)
rsync error: some files/attrs were not transferred (see previous errors) (code 23) at main.c(1356) [sender=3.2.7]

読めたほうの ok.txt はコピーされ、secret.txt だけが失敗しました。robocopy でも同じように、失敗したファイルを飛ばして最後まで進み、終了コードの 8 のビットで知らせます。 途中で止まらないので、終了コードを見ない運用では失敗に気づけません。

rsync 3.2.7 のソース（errcode.h・log.c）で確かめた主な番号は、1＝syntax or usage error、23＝some files/attrs were not transferred、24＝some files vanished before they could be transferred、25＝the --max-delete limit stopped deletions、30＝timeout in data send/receive です。

バッチで判定する

if errorlevel 8 は「直前の終了コードが 8 以上なら」という意味です（Microsoft Learn の if のページ）。比べる演算子の GEQ（以上）・LSS（未満）でも書けます。

@echo off
robocopy C:\work D:\backup\work /MIR /R:1 /W:1 /NP /LOG+:C:\logs\backup.log
set RC=%ERRORLEVEL%
if %RC% GEQ 8 (
  echo [%date% %time%] robocopy 失敗 終了コード=%RC% >> C:\logs\backup-error.log
  exit /b %RC%
)
exit /b 0

最後に exit /b 0 を書くのは、robocopy の 1〜7（成功）を、呼び出し元に 0 として返すためです。 Microsoft の Windows HPC Server 2008 のドキュメントには、robocopy が成功でも 0 以外を返すので、ジョブの管理の仕組みが「失敗」と記録する例と、IF %ERRORLEVEL% LEQ 1 exit 0 で 0 に直す書き方が載っています。CI のジョブや監視の仕組みも、多くは「0 以外は失敗」と扱います。

PowerShell で判定する

PowerShell では、直前に動かしたプログラムの終了コードが $LASTEXITCODE に入ります。

robocopy C:\work D:\backup\work /MIR /R:1 /W:1 /NP /LOG+:C:\logs\backup.log
$rc = $LASTEXITCODE
if ($rc -ge 8) {
    Write-Error "robocopy 失敗: 終了コード $rc"
    exit $rc
}
"成功: 終了コード $rc（1=コピー, 2=Extra, 4=Mismatch の和）"
exit 0

PowerShell 自体のコマンドの一覧は、関連記事「PowerShellコマンド一覧｜用途別50選とbash対応表・実行例付き」で扱っています。

タスクスケジューラでrobocopyを定期実行する

この節では、上のバッチを毎日決まった時刻に動かす登録のしかたと、つまずきやすい点が分かります。

schtasks で登録する（コマンド プロンプト）

管理者のコマンド プロンプトで、毎日 2時に SYSTEM のアカウントで動かす例です。

schtasks /create /tn "Backup\robocopy-daily" /tr "C:\scripts\backup.bat" /sc daily /st 02:00 /ru SYSTEM /rl HIGHEST /f

Microsoft Learn の schtasks /create の例では、SYSTEM で登録すると INFO: The task will be created under user name (NT AUTHORITY\SYSTEM). と SUCCESS: The Scheduled task MyApp has successfully been created. が表示されます。

PowerShell で登録する

$action  = New-ScheduledTaskAction -Execute "C:\scripts\backup.bat"
$trigger = New-ScheduledTaskTrigger -Daily -At "02:00"
Register-ScheduledTask -TaskName "robocopy-daily" -Action $action -Trigger $trigger `
    -User "NT AUTHORITY\SYSTEM" -RunLevel Highest

定期実行で確かめること

• 1/R と /W を小さくしたか書かないと既定の 100万回・30秒で、使用中のファイルで止まり続ける
• 2ドライブ文字ではなく UNC パスで書いたか手で割り当てた Z: などは、タスクのアカウントから見えないことがある
• 3共有フォルダーに、動かすアカウントの権限があるかSYSTEM はネットワークではコンピューターの資格情報で接続する
• 4終了コード 1〜7 を 0 にして返しているかそのままだと成功したのに失敗に見える。8 以上はそのまま返す
• 5ログを /LOG+ で追記しているか/LOG は毎回上書きなので、失敗した日のログが次の日に消える
• 6/MIR なら、一度 /L で消える一覧を見たか定期実行は人が見ていない時刻に動くので、最初の1回は必ず確かめる

Microsoft Learn の LocalSystem アカウントの説明では、このアカウントで動くサービスは「リモートのサーバーにコンピューターの資格情報を示す」とされています。SYSTEM で動かしたタスクがファイルサーバーに書けないときは、共有フォルダーの権限にコンピューターのアカウントを足すか、権限のあるユーザーで登録します（/ru ユーザー /rp パスワード）。

Linux で同じことを cron と rsync で行う書き方は、関連記事「cronの書き方｜設定例30パターンの早見表と落とし穴まとめ」で扱っています。コマンドではなく画面の操作で自動化したいときは、関連記事「Power Automate Desktopとは｜使い方・無料の範囲とエラー処理」で扱っています。

よくあるエラーと直し方（ERROR 5・ERROR 32 ほか）

この節では、ログに出る ERROR の番号から、原因と直し方を引けます。エラー文は Win32 のシステム エラー コードのページの原文です。

ERROR 5（アクセスが拒否されました）

ERROR 5 は権限が無いときのエラーです。 次の順に確かめます。

1. コマンド プロンプトや PowerShell を「管理者として実行」で開いたか。/B・/ZB（バックアップ モード）は管理者のコンソールが前提です（Azure Files の移行ガイド）。
2. ドライブのルートを対象にしていないか。$RECYCLE.BIN・System Volume Information は /XD で除外します。
3. アクセス権のコピー（/COPY の S・O・U、/COPYALL）で失敗していないか。権限ごと移す必要が無ければ、既定の /COPY:DAT に戻します。
4. コピー先が共有フォルダーなら、共有の権限と NTFS の権限の両方で書き込みが許されているか。

:: 管理者のコンソールで、アクセス拒否ならバックアップ モードに切り替える
robocopy C:\data D:\backup\data /E /ZB /R:1 /W:1 /XD $RECYCLE.BIN "System Volume Information" /LOG+:C:\logs\backup.log

ERROR 32（ほかのプロセスが使用中）

ERROR 32 は、ほかのアプリがファイルを開いていて、読めないときのエラーです。Outlook の .pst、動いているデータベースのファイル、開いている Office の文書などで出ます。

• 既定の /R・/W のままだと、そのファイルで最長347日待ちます。/R:1 /W:1 で飛ばし、次の実行で拾います（Azure Files の移行ガイドの考え方）。
• そのアプリを止める時間帯にタスクを動かします。
• データベースは、ファイルをコピーせず、そのデータベースのバックアップの機能で出力したファイルをコピーします。

Linux では事情が違います。rsync で、別のプロセスが flock -x でロックしているファイルをコピーすると、エラーにならずにコピーされました（終了コード 0）。Linux のファイルのロックは、協力し合うプログラムどうしの約束（勧告ロック）が基本で、読むことは止めないためです。Windows から Linux に置き換えると、使用中のファイルが「エラーにならずに、書きかけの状態でコピーされる」ことがあります。

robocopyとxcopy・copy・rsyncの違い

この節では、似たコマンドとの違いと、Linux・Mac の rsync との対応が分かります。

xcopy の終了コードは、Microsoft Learn によると 0＝エラーなくコピー、1＝コピーするファイルが無い、2＝Ctrl+C で中断、4＝初期化のエラー、5＝ディスクの書き込みエラー、です。robocopy とは数の意味が違うので、xcopy から書き換えるときは判定の式も変えます。

robocopy と rsync のオプションの対応

いちばん違うのは、コピー元の書き方です。 robocopy はコピー元のフォルダーの中身をコピー先に入れます。rsync は src/（末尾の / あり）で中身を、src（なし）でフォルダーごとをコピーします。rsync の詳しい使い方は関連記事「rsyncの使い方｜オプション一覧と目的別コピペ例（実行結果つき）」、Linux の cp との違いは関連記事「cp・rm・mvコマンドの使い方｜オプション早見表とエラーの直し方」で扱っています。

よくある質問

Q. robocopyの読み方は？ A. 「ロボコピー」です。Robust File Copy（堅牢なファイルコピー）の略で、Windows Vista・Windows Server 2008 から標準で入っています。

Q. robocopyで差分だけコピーするには？ A. オプションを足さなくても、2回目からは無いファイルとサイズ・日時の違うファイルだけをコピーします。robocopy C:\src D:\dst /E を繰り返すと差分のコピーになります。

Q. robocopyで上書きしないようにするには？ A. /XC /XN /XO を付けると、コピー先に同じ名前のファイルがあるときはコピーしません。コピー元のほうが日時が前のときだけ上書きを避けたいなら /XO だけを付けます。

Q. /MIRと/Eの違いは？ A. /E はコピーするだけで、コピー先にだけあるファイルは残ります。/MIR は /E ＋ /PURGE で、コピー元に無いファイルとフォルダーをコピー先から消します。/MIR は先に /L で消える一覧を確かめます。

Q. robocopyの終了コード1はエラーですか？ A. エラーではありません。1 は「ファイルをコピーした」という成功の意味です。8 以上が失敗で、0〜7 は成功です。タスクやジョブで失敗に見えるときは、バッチで 8 未満を exit /b 0 にして返します。

Q. robocopyが遅いときは？ A. /MT:16 などで並列にし、/NP・/NFL・/NDL で画面への出力を減らし、/LOG でログに出します。/Z・/ZB は記録が増えて遅くなるので、不安定な回線のときだけ使います。

Q. 特定のフォルダーやファイルを除外するには？ A. フォルダーは /XD node_modules .git、ファイルは /XF *.tmp *.log のように、名前を空白で区切って続けて書きます。/XF ではワイルドカード（* ?）が使えます。

Q. robocopyでファイルを移動するには？ A. /MOV はファイルだけを移動し、コピー元のフォルダーは残します。/MOVE はファイルとフォルダーを移動します。どちらもコピーしてからコピー元を消します。

Q. フォルダー構成だけをコピーするには？ A. robocopy C:\src D:\dst /E /XF * で、すべてのファイルを除外してフォルダーだけを作ります。0バイトのファイルも作るなら /CREATE です。

Q. ERROR 5 (0x00000005) Access is denied. が出ます A. 権限が無いエラーです。管理者のコンソールで /B か /ZB を付け、ドライブのルートなら $RECYCLE.BIN と System Volume Information を /XD で除外します。

Q. ERROR 32 (0x00000020) が出て止まったように見えます A. ほかのアプリがファイルを使っているエラーです。/R と /W を書かないと既定の100万回・30秒で待ち続けるので、/R:1 /W:1 で飛ばし、アプリを閉じた後に再実行します。

Q. MacやLinuxでrobocopyは使えますか？ A. robocopy は Windows のコマンドです。Mac・Linux で同じことをするなら rsync を使い、/MIR は rsync -a --delete、/L は -n に当たります。

まとめ

• robocopy は robocopy コピー元 コピー先 /E でフォルダーを中身ごとコピーし、2回目からは違うファイルだけをコピーする。既定では日時が前のファイルでも上書きする（避けるなら /XO）。
• 引用符で囲んだパスの末尾に \ を付けない。\" が文字の " になり、引数がつながる。
• /MIR は /E ＋ /PURGE で、コピー先にだけあるものを消す。階層の間違い・向きの間違い・コピー先にだけ置いたファイルの3つで消える。先に /L で確かめる。
• /R と /W の既定は 100万回・30秒で、1つのファイルで最長347日待つ。定期実行では /R:1 /W:1 のように書く。
• 終了コードは 1・2・4・8・16 の足し算。0〜7 は成功、8 以上は失敗。バッチでは 8 未満を exit /b 0 にして返す。
• 速くするなら /MT と /NP /NFL /NDL と /LOG。/Z・/ZB は遅くなる。
• ERROR 5 は管理者で /B・/ZB と /XD、ERROR 32 は /R:1 /W:1 で飛ばして次回に拾う。

参考・出典

確認日はいずれも 2026年10月23日です。

• Microsoft Learn「robocopy」：https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/robocopy
• Microsoft Learn「robocopy」（日本語版）：https://learn.microsoft.com/ja-jp/windows-server/administration/windows-commands/robocopy
• Microsoft Learn「Return codes that are used by the Robocopy utility in Windows Server」：https://learn.microsoft.com/en-us/troubleshoot/windows-server/backup-and-storage/return-codes-used-robocopy-utility
• Microsoft Learn（ブログのアーカイブ）「Robocopy Exit Codes」：https://learn.microsoft.com/en-us/archive/blogs/deploymentguys/robocopy-exit-codes
• Microsoft Learn「Migrate to SMB Azure file shares using RoboCopy」：https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-robocopy
• Microsoft Learn「Tasks That Complete Successfully Are Marked As Failed」（Windows HPC Server 2008）：https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-hpc-server-2008/ff182367(v=ws.10)
• Microsoft Learn「xcopy」：https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/xcopy
• Microsoft Learn「copy」：https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/copy
• Microsoft Learn「if」：https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/if
• Microsoft Learn「schtasks create」：https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/schtasks-create
• Microsoft Learn「Register-ScheduledTask」：https://learn.microsoft.com/en-us/powershell/module/scheduledtasks/register-scheduledtask
• Microsoft Learn「about_Automatic_Variables」：https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables
• Microsoft Learn「LocalSystem Account」：https://learn.microsoft.com/en-us/windows/win32/services/localsystem-account
• Microsoft Learn「System Error Codes (0-499)」：https://learn.microsoft.com/en-us/windows/win32/debug/system-error-codes--0-499-
• Microsoft Learn「System Error Codes (1300-1699)」：https://learn.microsoft.com/en-us/windows/win32/debug/system-error-codes--1300-1699-
• Microsoft Learn「Parsing C command-line arguments」：https://learn.microsoft.com/en-us/cpp/c-language/parsing-c-command-line-arguments
• Microsoft Learn Q&A「ERROR 5 (0x00000005) Accessing Destination Directory」：https://learn.microsoft.com/en-us/answers/questions/1302972/robocopy-dummy-needs-your-help-with-error-code-5-r
• Buffalo「Robocopyを使用したファイル比較方法」：https://www.buffalo.jp/support/faq/detail/124145602.html
• hahndorf.eu「Robocopy Directory Failure」：https://hahndorf.eu/blog/RobocopyDirectoryFailure.html
• GitHub「tjscience/RoboSharp」：https://github.com/tjscience/RoboSharp
• GitHub「RsyncProject/rsync」（v3.2.7 の errcode.h・log.c）：https://github.com/RsyncProject/rsync
• Wikipedia「Robocopy」：https://en.wikipedia.org/wiki/Robocopy

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。