robocopy

  • 아티클

파일 데이터를 한 위치에서 다른 위치로 복사합니다.

구문

robocopy <source> <destination> [<file>[ ...]] [<options>]

예를 들어 c:\reports에서 yearly-report.mov 파일을 파일 공유 \\marketing\videos로 복사하는 동시에 성능 향상을 위해 다중 스레딩을 사용하도록 설정하고(/mt 매개 변수 사용) 중단된 경우 전송을 다시 시작할 수 있도록 하려면(/z 매개 변수 포함) 다음을 입력합니다.

robocopy c:\reports "\\marketing\videos" yearly-report.mov /mt /z

Important

디바이스의 루트에서 데이터를 복사하는 경우 대상 디렉터리가 복사 프로세스 중에 "숨겨진" 특성을 채택합니다.

매개 변수

매개 변수 설명
<source> 원본 디렉터리의 경로를 지정합니다.
<destination> 대상 디렉터리의 경로를 지정합니다.
<file> 파일 또는 파일을 복사할 수를 지정 합니다. 와일드카드 문자(*또는 ?)가 지원됩니다. 이 매개 변수 *.* 를 지정하지 않으면 기본값으로 사용됩니다.
<options> 복사, 파일, 다시 시도, 로깅 및 작업 옵션을 포함하여 robocopy 명령에 사용할 옵션을 지정합니다.

복사 옵션

옵션 설명
/s 복사본 하위 디렉터리입니다. 이 옵션은 빈 디렉터리를 자동으로 제외합니다.
/e 복사본 하위 디렉터리입니다. 이 옵션에는 빈 디렉터리도 자동으로 포함됩니다.
/레프:<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(데이터 및 특성)입니다.
/sec 보안(/copy:DATS와 동일)을 사용하여 파일을 복사합니다.
/copyall 모든 파일 정보 복사 (동일 /copy:DATSOU).
/nocopy 복사 하는 파일 정보가 없습니다 (유용 제거/).
/secfix 모든 파일에 대 한 파일 보안 픽스는 스토리를 건너뜁니다.
/timfix 모든 파일에 대해 파일 시간을 수정 된 건너뜁니다.
/purge 더 이상 원본에 존재 하는 대상 파일 및 디렉터리를 삭제 합니다. /e 옵션 및 대상 디렉터리와 함께 이 옵션을 사용하면 대상 디렉터리 보안 설정을 덮어쓰지 않을 수 있습니다.
/mir 디렉터리 트리를 미러링합니다 (동일 /e plus 제거/). /e 옵션 및 대상 디렉터리와 함께 이 옵션을 사용하면 대상 디렉터리 보안 설정을 덮어씁니다.
/mov 파일을 이동하고 복사한 후 원본에서 파일을 삭제합니다.
/move 파일 및 디렉터리를 이동하고 복사한 후 원본에서 삭제합니다.
/a +: [RASHCNET] 복사 된 파일에 지정 된 특성을 추가합니다. 이 옵션의 유효한 값은 다음과 같습니다.
  • R - 읽기 전용
  • A - 보관
  • S - 시스템
  • H - 숨김
  • C - 압축됨
  • N - 인덱싱된 콘텐츠 없음
  • E - 암호화됨
  • T - 임시
/a-:[RASHCNETO] 복사 된 파일에서 지정 된 특성을 제거합니다. 이 옵션의 유효한 값은 다음과 같습니다.
  • R - 읽기 전용
  • A - 보관
  • S - 시스템
  • H - 숨김
  • C - 압축됨
  • N - 인덱싱된 콘텐츠 없음
  • E - 암호화됨
  • T - 임시
  • O - 오프라인
만들기 / 디렉터리 트리 및 길이가 0 인 파일만 만듭니다.
fat / 8.3 문자 길이 FAT 파일 이름을 사용 하 여 대상 파일을 만듭니다.
/256 256자보다 긴 경로에 대한 지원을 해제합니다.
/월:<n> 원본을 모니터링하고 n개 이상의 변경 내용이 검색되면 다시 실행됩니다.
/Mot:<m> 원본을 모니터링하고 변경 내용이 감지되면 m분 안에 다시 실행됩니다.
/rh:hhmm-hhmm 새 복사본을 시작할 수 있는 런타임을 지정합니다.
/pf 파일당 실행 시간을 검사합니다(통과당 아님).
/Ipg:<n> 저속 회선에서의 대역폭을 확보 하는 패킷 간 간격을 지정 합니다.
/Sj 연결 대상 대신 대상 경로에 접합(소프트 링크)을 복사합니다.
/sl 기호화된 링크를 따르지 않고 대신 링크의 복사본을 만듭니다.
/마운트:<n> n개 스레드를 사용하여 다중 스레드 복사본을 만듭니다. n 은 1에서 128 사이의 정수여야 합니다. n의 기본값은 8입니다. 성능을 향상시키려면 /log 옵션을 사용하여 출력을 리디렉션합니다.

/mt 매개 변수는 /ipg 및 /efsraw 매개 변수와 함께 사용할 수 없습니다.
/nodcopy 디렉터리 정보를 복사하지 않습니다(기본 /dcopy:DA 가 완료됨).
/nooffload Windows 복사 오프로드 메커니즘을 사용하지 않고 파일을 복사합니다.
/compress 해당하는 경우 파일 전송 중에 네트워크 압축을 요청합니다.
/스파스 복사하는 동안 파일의 스파스 상태를 유지할 수 있습니다.

Important

/secfix 복사 옵션을 사용하는 경우 다음 추가 복사 옵션 중 하나를 사용하여 복사할 보안 정보의 유형을 지정합니다.

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

참고 항목

/mt 매개 변수는 Windows Server 2008 R2에서 도입되었으며 해당 기능은 현재 버전의 Windows Server에 적용됩니다.

파일 제한 옵션 복사

옵션 설명
/iomaxsize:<n>[kmg] 요청된 읽기/쓰기 주기당 요청된 최대 i/o 크기(nkilobytes, megabytes 또는 gigabytes)입니다.
/iorate:<n>[kmg] nk ilobytes megabytes 또는 초당 gigabytes의 요청된 i/o 속도입니다.
/threshold:<n>[kmg] nkilobytes, megabytes 또는 gigabytes로 제한하기 위한 파일 크기 임계값입니다(주의 참조).

이러한 제한 옵션은 Robocopy에서 초당 바이트 단위로 사용할 수 있는 최대 I/O 대역폭을 지정하는 데 사용됩니다. 초당 바이트 단위로 지정하지 않으면 k, m 또는 g가 지정된 경우 정수를 사용할 수 있습니다. 제한된 최소 I/O 대역폭은 더 작은 값이 지정된 경우에도 524288 바이트입니다.

파일 선택 옵션

옵션 설명
/a 있는 파일만 복사는 보관 특성이 설정 되어 있습니다.
/m 있는 파일만 복사는 보관 특성을 설정 하 고 다시 설정 된 보관 특성입니다.
/아이오 와:[RASHCNETO] 지정된 된 특성의 모든 설정 되어 있는 파일만 포함 됩니다. 이 옵션의 유효한 값은 다음과 같습니다.
  • R - 읽기 전용
  • A - 보관
  • S - 시스템
  • H - 숨김
  • C - 압축됨
  • N - 인덱싱된 콘텐츠 없음
  • E - 암호화됨
  • T - 임시
  • O - 오프라인
/Xa:[RASHCNETO] 지정된 된 특성의 모든 설정 되는 파일을 제외 합니다. 이 옵션의 유효한 값은 다음과 같습니다.
  • R - 읽기 전용
  • A - 보관
  • S - 시스템
  • H - 숨김
  • C - 압축됨
  • N - 인덱싱된 콘텐츠 없음
  • E - 암호화됨
  • T - 임시
  • O - 오프라인
/Xf <filename>[ ...] 지정 된 이름이 나 경로 일치 하는 파일을 제외 합니다. 와일드카드 문자(*및 ?)가 지원됩니다.
/Xd <directory>[ ...] 지정 된 이름 및 경로가 일치 하는 디렉터리를 제외 합니다.
/Xc 타임스탬프가 동일하지만 파일 크기가 다른 기존 파일을 제외합니다.
/xn 대상보다 최신의 원본 디렉터리 파일은 복사본에서 제외됩니다.
/xo 대상보다 오래된 원본 디렉터리 파일은 복사본에서 제외됩니다.
/xx 원본이 아닌 대상에 있는 추가 파일 및 디렉터리를 제외합니다. 추가 파일을 제외해도 대상에서 파일이 삭제되지는 않습니다.
/xl 원본에 있지만 대상에는 없는 "외로운" 파일 및 디렉터리를 제외합니다. 외로운 파일을 제외하면 새 파일이 대상에 추가되지 않습니다.
/im 수정된 파일(변경 시간 차이)을 포함합니다.
/is 동일한 파일에 포함 되어 있습니다. 동일한 파일은 이름, 크기, 시간 및 모든 특성에서 동일합니다.
/it "조정" 파일을 포함 합니다. 조정된 파일의 이름, 크기 및 시간은 같지만 특성은 다릅니다.
/최대:<n> 최대 파일 크기를 지정합니다(n바이트보다 큰 파일을 제외하려면).
/분:<n> 최소 파일 크기를 지정합니다(n바이트보다 작은 파일을 제외하려면).
/maxage:<n> 최대 파일 사용 기간을 지정합니다(n일 또는 날짜보다 오래된 파일을 제외하려면).
/minage:<n> 최소 파일 사용 기간을 지정합니다(n일 또는 날짜보다 최신 파일 제외).
/maxlad:<n> 최대 마지막 액세스 날짜를 지정합니다(n 이후 사용되지 않는 파일 제외).
/minlad:<n> 최소 마지막 액세스 날짜(n 이후 사용된 파일 제외)를 지정합니다. n이 1900보다 작은 경우 n은 일 수를 지정합니다. 그렇지 않으면 n 은 YYYYMMDD 형식의 날짜를 지정합니다.
/xj 기본적으로 일반적으로 포함 된 연결 지점에서 제외 됩니다.
/fft FAT 파일 (2 초 전체 자릿수) 시간을 가정합니다.
/dst 1 시간 짜리 DST 시간 차이를 보정합니다.
/xjd 디렉터리에 대 한 연결 지점을 제외합니다.
/xjf 파일에 대 한 연결 지점을 제외합니다.

옵션을 다시 시도 하십시오.

옵션 설명
/R:<n> 실패 한 복사에 대 한 재시도 횟수를 지정합니다. n의 기본값은 1,000,000(백만 번 다시 시도)입니다.
/W:<n> 다시 시도 시간 (초)에서 사이의 대기 시간을 지정합니다. n의 기본값은 30(대기 시간 30초)입니다.
/reg 에 지정 된 값을 저장 된 /r 및 /w 레지스트리에서 기본 설정으로 옵션입니다.
/tbd 시스템에서 공유 이름이 정의될 때까지 대기하도록 지정합니다(다시 시도 오류 67).
/lfsm 복사, 일시 중지 및 다시 시작할 수 있는 사용 가능한 공간 부족 모드에서 작동합니다(주의 참조).
/lfsm:<n>[kmg] 바닥 크기를 nkilobytes, megabytes 또는 gigabytes로 지정합니다.

로깅 옵션

옵션 설명
/l 파일이 나열 될 지 지정 합니다 (및 복사 되지 않으며, 삭제 또는 타임 스탬프).
/x 선택한 파일뿐만 아니라 모든 추가 파일을 보고합니다.
/v 자세한 정보 출력을 생성 하 고 건너뛴된 파일을 모두를 보여 줍니다.
/ts 출력 소스 파일 타임 스탬프를 포함합니다.
/fp 출력 파일의 전체 경로 이름을 포함합니다.
/bytes 크기를 바이트로 인쇄합니다.
/ns 파일 크기를 기록하지 않도록 지정합니다.
/nc 파일 클래스를 기록하지 않도록 지정합니다.
/nfl 파일 이름을 기록할 수 없도록 지정합니다.
/ndl 디렉터리 이름을 기록하지 않도록 지정합니다.
/np 복사 작업의 진행률(지금까지 복사한 파일 또는 디렉터리 수)이 표시되지 않도록 지정합니다.
/eta 복사 된 파일의 (ETA) 도착 예상된 시간을 보여 줍니다.
/로그:<logfile> (기존 로그 파일을 덮어씀) 하는 로그 파일에 상태 출력에 씁니다.
/log+:<logfile> (기존 로그 파일에 출력 추가) 하는 로그 파일에 상태 출력에 씁니다.
/unilog:<logfile> 상태 출력을 로그 파일에 유니코드 텍스트로 씁니다(기존 로그 파일 덮어쓰기).
/unilog+:<logfile> (기존 로그 파일에 출력 추가) 하는 유니코드 텍스트로 출력 로그 파일에 상태를 씁니다.
/tee 콘솔 창 및 로그 파일에 상태 출력을 씁니다.
/njh 작업 헤더가 없음을 지정합니다.
/njs 작업 요약이 없음을 지정합니다.
/unicode 상태 출력을 유니코드 텍스트로 표시합니다.

작업 옵션

옵션 설명
/작업:<jobname> 매개 변수 명명 된 작업 파일에서 파생 시 키도 록 지정 합니다. 실행 /job:jobname하려면 먼저 매개 변수를 /save:jobname 실행하여 작업 파일을 만들어야 합니다.
/저장:<jobname> 매개 변수를 명명 된 작업 파일에 저장 되도록 지정 합니다. 실행 /job:jobname하기 전에 실행해야 합니다. 이 매개 변수 앞에 모든 복사, 다시 시도 및 로깅 옵션을 지정해야 합니다.
종료 / 후 처리 (보려면 명령줄에 매개 변수)를 종료 합니다.
/nosd 원본 디렉터리가 지정 되었음을 나타냅니다.
/nodd 대상 디렉터리가 지정 되었음을 나타냅니다.
/if 지정된 된 파일에 포함 되어 있습니다.

설명

  • 이전에 볼륨의 루트 디렉터리에 /PURGE 또는 /MIR을 사용하면 robocopy가 시스템 볼륨 정보 디렉터리 내의 파일에 요청된 작업을 적용했습니다. 로보코피는 복사 세션의 최상위 원본 및 대상 디렉터리에서 해당 이름의 파일 또는 디렉터리를 건너뛰는 것처럼 더 이상 그렇지 않습니다.

  • 수정된 파일 분류는 원본 및 대상 파일 시스템이 NTFS와 같은 변경 타임스탬프를 지원하고 원본 및 대상 파일의 변경 시간이 다르지만 그렇지 않은 경우에만 적용됩니다. 이러한 파일은 기본적으로 복사되지 않습니다. 포함할 /IM을 지정합니다.

  • 디렉터리에 대해 확장 특성 복사를 시도해야 하는 /DCOPY:E 플래그 요청입니다. 디렉터리의 EA를 복사할 수 없는 경우 Robocopy가 계속됩니다. 이 플래그는 /COPYALL에 포함되지 않습니다.

  • /IoMaxSize 또는 /IoRate가 지정된 경우 robocopy를 사용하면 복사 파일 제한을 사용하여 시스템 부하를 줄일 수 있습니다. 둘 다 최적 값 및 복사 매개 변수로 조정할 수 있지만 시스템 및 robocopy는 필요에 따라 허용되는 값으로 조정할 수 있습니다.

  • /Threshold를 사용하는 경우 참여 제한에 대한 최소 파일 크기를 지정합니다. 해당 크기 미만의 파일은 제한되지 않습니다. 세 매개 변수의 값 뒤에 [KMG](킬로바이트, 메가바이트, 기가바이트)와 같은 선택적 접미사 문자가 뒤에 올 수 있습니다.

  • /LFSM을 사용하면 robocopy가 '사용 가능한 낮은 공간 모드'에서 작동하도록 요청합니다. 이 모드에서는 파일 복사본으로 인해 대상 볼륨의 여유 공간이 'floor' 값 아래로 이동될 때마다 robocopy가 일시 중지됩니다. 이 값은 /LFSM:n[KMG] 플래그를 사용하여 명시적으로 지정할 수 있습니다.

  • 명시적 바닥 값 없이 /LFSM을 지정하면 바닥은 대상 볼륨 크기의 10%로 설정됩니다. 사용 가능한 낮은 공간 모드는 /MT 및 /EFSRAW와 호환되지 않습니다.

종료(반환) 코드

값 설명
0 파일이 복사되지 않았습니다. 오류가 발생하지 않았습니다. 일치하지 않는 파일이 없습니다. 파일이 대상 디렉터리에 이미 있습니다. 따라서 복사 작업을 건너뛰었다.
1 모든 파일이 성공적으로 복사되었습니다.
2 원본 디렉터리에 없는 일부 추가 파일이 대상 디렉터리에 있습니다. 파일이 복사되지 않았습니다.
3 일부 파일이 복사되었습니다. 추가 파일이 있었습니다. 오류가 발생하지 않았습니다.
5 일부 파일이 복사되었습니다. 일부 파일이 일치하지 않습니다. 오류가 발생하지 않았습니다.
6 추가 파일 및 일치하지 않는 파일이 있습니다. 파일이 복사되지 않았고 실패가 발생하지 않았습니다. 즉, 파일이 대상 디렉터리에 이미 존재합니다.
7 파일이 복사되고, 파일이 일치하지 않으며, 추가 파일이 존재했습니다.
8 여러 파일이 복사되지 않았습니다.

참고 항목

8보다 크거나 같은 값은 복사 작업 중에 하나 이상의 오류가 발생했음을 나타냅니다.

예제

이 명령을 실행 robocopy 하여 프로세스가 무결성 확인을 완료하면 볼 수 있는 로그 파일을 만드는 것이 좋습니다. 다음 예제에서는 각각 매개 변수를 /LOG: 사용합니다. 로그 정보를 동일한 로그 파일에 추가하려면 대신 매개 변수를 /LOG+: 사용합니다.

빈 디렉터리를 포함한 모든 파일 및 하위 디렉터리를 "Records" 폴더에서 드라이브 "D"의 "Backup" 폴더로 복사하려면 다음을 입력합니다.

robocopy C:\Users\Admin\Records D:\Backup /E /ZB /LOG:C:\Logs\Backup.log

"레코드" 폴더의 내용을 드라이브 "D"의 "Backup" 폴더에 미러 2번의 재시도와 각 재시도 사이에 5초 동안 대기하는 원본에 없는 대상의 파일을 삭제하려면 다음을 입력합니다.

robocopy C:\Users\Admin\Records D:\Backup /MIR /R:2 /W:5 /LOG:C:\Logs\Backup.log

"Records" 폴더에서 비어 있지 않은 모든 파일 및 하위 디렉터리를 드라이브 "D"의 "Backup" 폴더로 복사하고 16개의 다중 스레드 복사 작업으로 파일 데이터, 특성 및 타임스탬프를 유지하려면 다음을 입력합니다.

robocopy C:\Users\Admin\Records D:\Backup /S /E /COPY:DAT /MT:16 /LOG:C:\Logs\Backup.log

빈 디렉터리를 제외한 파일 및 하위 디렉터리를 "Records" 폴더에서 드라이브 "D"의 "Backup" 폴더로 이동하고 7일보다 오래된 파일을 제외하려면 다음을 입력합니다.

robocopy C:\Users\Admin\Records D:\Backup /S /MAXAGE:7 /MOV /LOG:C:\Logs\Backup.log

빈 디렉터리를 포함한 모든 파일 및 하위 디렉터리를 "Records" 폴더에서 드라이브 "D"의 "Backup" 폴더로 복사하여 각 파일의 예상 시간을 표시하고 원본에서 존재하지 않는 대상의 파일 및 디렉터리를 삭제하려면 다음을 입력합니다.

robocopy C:\Users\Admin\Records D:\Backup /ETA /PURGE /LOG:C:\Logs\Backup.log

복사 작업 중에 I/O 속도를 초당 1MB로 제한하면서 "C" 드라이브의 "Records" 폴더에서 "D" 드라이브의 "Backup"이라는 폴더로 모든 파일 및 하위 디렉터리를 복사하려면 다음을 입력합니다.

robocopy C:\Records D:\Backup /iorate:1m