【bat】ROBOCOPYの使い方完全ガイド｜ミラーリング・差分コピー・ログ出力

ポイント：新規開発のバッチでは xcopy は使わず、最初から ROBOCOPY を選択することをおすすめします。コード量はほぼ同じですが、信頼性と機能が大幅に向上します。

ROBOCOPY 送り元 送り先 [ファイルパターン] [オプション]

@echo off
:: 1ファイルをコピー（フォルダ指定で特定ファイルを対象にする）
ROBOCOPY C:Source D:Dest report.xlsx /R:3 /W:5
echo 完了

@echo off
setlocal

set SRC=C:ProjectsMyApp
set DST=D:BackupMyApp

:: /E でサブフォルダと空フォルダも含めてコピー
ROBOCOPY "%SRC%" "%DST%" /E /R:3 /W:5 /NP

echo フォルダコピー完了
endlocal

注意：/MIR は送り先の余分なファイルを削除します。送り先に独自ファイルがある場合は失われます。初めて実行する前に必ず内容を確認してください。

@echo off
setlocal

set SRC=C:ProductionWeb
set DST=D:StagingWeb

:: /MIR = /E + /PURGE（送り先にない余分なファイルを削除）
ROBOCOPY "%SRC%" "%DST%" /MIR /R:3 /W:5 /NP /LOG:mirror.log /TEE

echo ミラーリング完了
endlocal

@echo off
setlocal

set SRC=C:DataDocuments
set DST=D:BackupDocuments

:: /XO で送り先より古いファイルをスキップ（新しいファイルだけコピー）
ROBOCOPY "%SRC%" "%DST%" /E /XO /R:3 /W:5 /NP

echo 差分コピー完了
endlocal

@echo off
setlocal

set SRC=C:ProjectsMyApp
set DST=D:BackupMyApp

:: node_modules と .git フォルダを除外、一時ファイルも除外
ROBOCOPY "%SRC%" "%DST%" /E /R:3 /W:5 /NP ^
  /XD node_modules .git dist .cache ^
  /XF *.tmp *.log *.bak

echo 除外コピー完了
endlocal

@echo off
setlocal

:: 日付をログファイル名に含める
set TODAY=%date:~0,4%%date:~5,2%%date:~8,2%
set LOGFILE=D:Logsackup_%TODAY%.log

ROBOCOPY C:Source D:Dest ^
  /E /R:3 /W:5 /NP ^
  /LOG+:"%LOGFILE%" ^
  /TEE

echo ログ出力先: %LOGFILE%
endlocal

補足：/LOG: は上書き、/LOG+: は追記です。毎日バックアップする場合は /LOG+: でひとつのログファイルに追記していくか、日付をファイル名に含めて日別ログにするのが一般的です。

@echo off
setlocal

set TODAY=%date:~0,4%%date:~5,2%%date:~8,2%
set SRC=C:DataImportant
set DST=D:DailyBackup\%TODAY%
set LOG=D:Logsackup_%TODAY%.log

ROBOCOPY "%SRC%" "%DST%" /E /R:3 /W:10 /NP /LOG:"%LOG%" /TEE

:: 終了コードが8以上（コピー失敗）ならエラー通知
if %ERRORLEVEL% GEQ 8 (
  echo エラー発生: ERRORLEVEL=%ERRORLEVEL% >> "%LOG%"
  exit /b 1
)

endlocal

@echo off
setlocal

set PROD=\\prod-serversharewebapp
set STAG=C:Stagingwebapp

:: /MIR で完全同期（ステージングを本番と同じ状態に）
:: /XD で一時フォルダとキャッシュを除外
ROBOCOPY "%PROD%" "%STAG%" ^
  /MIR /R:5 /W:10 /NP ^
  /XD tmp cache logs .git ^
  /LOG+:sync.log /TEE

endlocal

@echo off
setlocal

:: ネットワーク越しのコピーはリトライを多めに設定
:: /IPG:間隔ms でパケット間隔を指定してネットワーク帯域を節約
ROBOCOPY \\fileserverdata C:LocalCopy ^
  /E /R:10 /W:30 /NP /IPG:10 ^
  /LOG+:netcopy.log /TEE

endlocal

補足：エラー判定には IF %ERRORLEVEL% GEQ 8 を使います。タスクスケジューラでは ROBOCOPY の終了コードをエラーと判定しないよう、終了コードが 7 以下なら EXIT /B 0 を明示的に実行するのが実務上の定石です。