Robocopy robust file copy for windows

Обновлено 21.08.2020

Доброе времени суток. Уважаемые читатели и гости, крупного IT блога Pyatilistnik.org, занимающего в рейтинге Яндекс.Радар 2500 место, среди всех сайтов России. В прошлый раз, мы с вами решили проблему со сбоем запроса устройства. Сегодня я не хочу рассматривать новые ошибки, а поделюсь своим опытом использования утилиты Robocopy, приведу примеры использования, поговорю о параметрах утилиты и покажу, как у Robocopy использовать графический интерфейс (GUI). Данной программкой просто обязан пользоваться каждый системный администратор, ну или хотя бы знать. о ее существовании, лично у меня она находится на почетном месте в моем наборе системного инженера.

Что такое robocopy (Robust File Copy Utility)

Утилита Robocopy  (Robust File Copy Utility) — это специализированное средство, в задачи которого входит тонкая настройка процесса копирования, синхронизации, удаления и переноса файлов и папок, между дисками компьютера, компьютерами, сетевыми шарами и лесами, с сохранением атрибутов, прав разрешений и многое другое.

Robocopy за счет своих алгоритмов и многопоточности позволяет проводить копирование или синхронизацию одних файловых ресурсов с другими в десятки раз быстрее, чем обычное копирование средствами проводника Windows.

Данное средство, очень часто используется в задачах системного администратора, по переносу сетевых шар и файловых ресурсов, и в сценариях синхронизации данных.

Если обратиться к Википедии (https://ru.wikipedia.org/wiki/Robocopy), то там вы обнаружите, что она создавалась как средство репликации и шла в составе такого известного комплекса инструментов, как Windows Resource Kit.

Версии утилиты Robocopy

Первая версия robocopy появилась в 1997 году в составе инструментов Windows Resource Kit. На текущий момент самой свежей версией является 10.0.17763.1 входящей в состав Windows 10 1809, табличку в Википедии я подправил (https://en.wikipedia.org/wiki/Robocopy)

Где лежит Robocopy в системе?

Основной исполняемый файл Robocopy.exe располагается по пути C:WindowsSystem32. Утилита очень компактная и весит всего 132 килобайта, но это не уменьшает ее мощи и функционала.

Где скачать утилиту Windows Robocopy

Начиная с Windows 7, данная программулька является ее составной частью, и я уже выше показал, что она лежит в папке C:WindowsSystem32, если по каким-то причинам у вас в ней нет файла robocopy.exe, то у вас есть несколько вариантов его скачать.

• Первый вариант, это скопировать его из другой системы
• Второй вариант, это загрузить средство Windows Server 2003 Resource Kit Tools по ссылке (https://www.microsoft.com/en-us/download/details.aspx?id=17657). В состав этого пакета входит утилита Robust File Copy Utility.

Далее полученный файла robocopy, вам необходимо разархивировать данный файл, для этого у вас должен быть архиватор winrar или 7-zip. Через правый клик извлекаем его содержимое.

Далее 7-Zip-ом распаковываем msi пакет rktools.msi.

Перейдите в папку rktools, там вас будет ждать файл robocopy.exe, который вы можете скачать куда угодно.

Возможности утилиты Robocopy (Robust File Copy Utility)

И так давайте разбираться, какими функциональными возможностями обладает данная утилита. Как я и писал выше Robocopy умеет:

• Производить копирование файлов и папок
• Производить синхронизацию файлов и папок
• Копировать по расширениям файлов
• Переносить права на папки и файлы
• Копирование и перенос файлов по датам и за нужный период
• Удалять файлы и папки

Чтобы посмотреть все ключи и их назначение, нам нужно открыть командную строку, желательно от имени администратора и ввести команду:

У вас появится небольшая справка, в которой вам отобразят конструкцию построения команд и несколько примеров реализации. Чтобы вывести все доступные параметры Robocopy вам необходимо ввести команду:

Тут ключи и параметры будут разбиты на несколько подкатегорий:

1. Параметры копирования
2. /COPY:флаги копирования
3. /DCOPY:флаги копирования
4. Параметры выбора файлов
5. Параметры повторных попыток
6. Параметры ведения журнала
7. Параметры задания
8. Комментарии

Ключи параметров копирования:

• /S — данный параметр позволит вам произвести копирование вложенных папок, за исключением пустых. Очень удобно, чтобы не перетаскивать не используемые каталоги
• /E — данный ключ, альтернатива параметру /S, так как он позволит скопировать вложенные папки, в том числе и пустые.
• /LEV:n — данный параметр копирования Robocopy позволит вам скопировать n-число уровней у текущего каталога папок. Предположим у вас есть папка, которая включает в себя еще 10 подпапок, задав n равное 5, вы скопируете структуру, только первых пяти верхних каталогов, а все, что ниже не будет затронуто.
• /Z — параметр позволяет возобновлять копирование в случае какого-то сбоя
• /B — Копирование файлов в режиме архивирования.
• /ZB — совмещение параметров Robocopy.exe, в данном случае вначале будет использоваться режим с возобновлением, но если доступа к каким либо файлам не будет, то утилита переключиться в режим архивации.
• /J — данный параметр Robocopy.exe используется при копировании крупного размера файлов, где применяется небуферезированный ввод-вывод
• /EFSRAW — будет произведено копирование всех зашифрованных файлов в режиме EFS RAW

Ключи /COPY:флаги копирования

Ключ /COPY это один из базовых ключей, который вы будите применять в своих сценариях синхронизации или копирования, он переносит (Флаги копирования: D=Данные, A=Атрибуты, T=Метки времени). (S=Безопасность=NTFS ACLs, O=Сведения о владельце, U=Сведения аудита)

• /SEC — данный флаг позволит вам скопировать файлы и каталоги вместе с их параметрами безопасности (эквивалентно /COPY:DATS)
• /COPYALL — данный ключ скажет утилите Robocopy.exe, что нужно при копировании перенести все сведения о файле (Аналог /COPY:DATSOU)
• /NOCOPY — данный ключ скажет, что не нужно копировать никаких сведений о файле (полезно с параметром /PURGE).
• /SECFIX — данный ключ будет полезен при синхронизации, когда нужно перезаписать и исправить параметры безопасности на всех папках и файлах. Простой пример, вы сделали первое копирование одного каталога с файлами в другой, и перенесли параметры безопасности (NTFS), в какой-то момент в исходном каталоге у вас поменялись разрешения на некоторые файлы, и если вы произведете синхронизацию, без этого ключа, то эти новые права доступа не перенесутся в новое место, поставив ключ /SECFIX, вы этого избежите и все будет обновлено.
• /TIMFIX — этот флаг позволит исправить атрибуты времени у всех файлов, в том числе и пропущенных
• /PURGE — позволит удалить каталоги и файлы в папке назначения, которые уже не существуют в источнике.
• /MIR — в данном случае будет создана полная копия (зеркальная) источника в назначении, аналогично выполнению Robocopy.exe с ключами /E /PURGE
• /MOV — данный ключ позволит перемещать файлы (удаление из источника после копирования, я бы назвал это аналогов вырезать в Windows)
• /MOVE — похоже на ключ /MOV, но уже вырезаться будут файлы с папками.
• /A+:[RASHCNET] — данный флаг позволяет вам добавлять атрибуты к скопированным файлам
• /A-:[RASHCNET] — данный флаг сообщает утилите Robocopy, что нужно удалить заданные атрибуты у скопированных файлов
• /CREATE — данный флаг создает дерево каталогов и файлы нулевой длины
• /FAT — Создать файлы назначения только в формате 8.3 FAT
• /256 — отключает поддерживание длинных путей свыше 256 знаков, на практике не встречал таких сценариев.
• /MON:n — robocopy в данным флагом в параметрах, будет производить мониторинг источника, и перезапустит выполнение после n изменений
• /MOT:m — Наблюдать за источником; перезапустить через m минут, если произошли изменения.
• /RH:hhmm-hhmm — тут вы говорите для Robocopy.exe в какое время нужно производить запуск, в какой момент будет запущено задание копирования файлов.
• /PF — Проверять часы запуска по файлам (не по проходам)
• /IPG:n — данный ключ поможет снизить нагрузку на сеть, когда у вас не очень хороший канал, n интервал задержки в миллисекундах.
• /SL — копирует сами символические ссылки, за место копирования целевых объектов, на которые эти селинки ссылаются.
• /MT[:n] — использование многопотокового режима, позволяет существенно увеличить скорость копирования, за счет использования процессорных моoностей системы. n может иметь значение от 1 до 128 потоков. Нельзя использовать с параметрами /IPG и /EFSRAW. Для повышения производительности перенаправьте вывод с помощью параметра /LOG.

Ключи /DCOPY:флаги копирования

Данный раздел флагов отвечает за то, что копировать для каталогов (D=Данные, A=Атрибуты, T=Метки времени)

• /NODCOPY — не производить копирование любых сведений о каталоге
• /NOOFFLOAD — Robocopy будет копировать файлы без использования механизма разгрузки копий Windows

Параметры выбора файлов

Утилита Robocopy очень тонко позволяет производить тонкую фильтрацию файлов при копировании, для этого есть огромное количество ключей и флагов.

• /A — флаг задает копирование файлов с атрибутом «Архивный»
• /M — задает копирование файлов с атрибутом «Архивный» и потом его сбросить на конечной стороне
• /IA:[RASHCNETO] — переносить файлы на которых установлены заданные атрибуты (объявленные заранее)
• /XA:[RASHCNETO] — при копирование будут исключены файлы с объявленными атрибутами
• /XF file [файл] — позволяет исключать файлы, у которых заданные имена, пути и подстановочные знаки
• /XD dirs [папки] — исключает каталоги, с заданными именами и путями
• /XC — robocopy не копирует измененные файлы
• /XN — исключить более поздние файлы
• /XO — Исключить более ранние файлы
• /XX — Исключить дополнительные файлы и папки
• /XL — Исключить отдельно расположенные файлы и папки
• /IS — Включить те же файлы
• /IT — Включить оптимизированные файлы
• /MAX:n — Robust File Copy Utility исключит файлы, у которых размер более n-байт, можно это назвать максимальным размеров копируемых файлов
• /MIN:n — данный параметр Robocopy установит минимальный размер копируемого файла, позволит исключить файлы у которых n-байт меньше заданного
• /MAXAGE:n — тут мы задаем максимальный возраст файлов. Мы исключим при копировании файлы, у которых возраст больше n дней
• /MINAGE:n — тут мы задаем минимальный возраст файлов. Мы исключим при копировании файлы, у которых возраст меньше n дней
• /MAXLAD:n — Наиболее поздняя дата последнего обращения. Будут скопированы данные, которые не использовались с даты n
• /MINLAD:n — Наиболее ранняя дата последнего обращения. Robocopy исключит файлы, которые были использованы после даты указанной в n. (Если n < 1900, то n = n дней, в противном случае n — дата в формате ДД.ММ.ГГГГ)
• /XJ — отключение точек соединения, которые по умолчанию включаются
• /FFT — Использовать время файлов FAT (двухсекундная точность)
• /DST — Тут задается. будет ли Robocopy учитывать одно часовую разницу при переходе на летнее время
• /XJD — Исключить точки соединения для папок
• /XJF — Исключить точки соединения для файлов

Ключи параметров повторных попыток

• /R:n — Число повторных попыток для неудавшихся копий, по умолчанию — 1 миллион.
• /W:n — Тут вы зададите период ожидания между повторными попытками: по умолчанию это 30 секунд.
• /REG — Сохранить /R:n и /W:n в реестре как параметры по умолчанию.
• /TBD — Ждать, пока будут определены имена общих ресурсов (ошибка повторной попытки 67).

Ключи параметров ведения журнала

• /L — получить только список, в данном случае Robust File Copy Utility файлы не копирует, не удаляет, не помечается метками времени.
• /X — Сообщать обо всех дополнительных файлах, а не только о выбранных.
• /V — Подробный вывод с указанием пропущенных файлов.
• /TS — Включать в вывод меток времени исходных файлов.
• /FP — Включать в вывод полные пути файлов.
• /BYTES — Печатать размеры файлов в байтах.
• /NS — Режим без размера, у вас не будет заноситься информация, о размерах файлов в журнал.
• /NC — Режим без класса, не заносить в журнал классы файлов.
• /NFL — Режим без списка файлов, не заносить в журнал имена файлов.
• /NDL — Режим без списка папок, не заносить в журнал имена папок.
• /NP — Режим без хода процесса, не отображать число скопированных процентов.
• /ETA — Показывать оценку времени окончания копирования файлов.
• /LOG:файл — Производить запись состояния в файл журнала (перезаписывать существующий журнал).
• /LOG+:файл — Производить запись состояния в файл журнала (добавлять к существующему журналу).
• /UNILOG:файл — Производить запись состояния в файл журнала в формате Юникод (перезаписывать существующий журнал).
• /UNILOG+:файл — Производить запись состояния в файл журнала в формате Юникод (добавлять к существующему журналу).
• /TEE — Направлять выходные данные в окно консоли и в файл журнала.
• /NJH — Без заголовка задания.
• /NJS — Без сведений о задании.
• /UNICODE — Состояние вывода в формате Юникод.

Ключи параметров задания

• /JOB:имя_задания — Взять параметры из указанного файла задания.
• /SAVE:имя_задания — Сохранить параметры в указанный файл задания
• /QUIT — Выйти после обработки командной строки (для просмотра параметров).
• /NOSD — Не указывается исходная папка.
• /NODD — Не указывается папка назначения.
• /IF — Включить следующие файлы.

Как видите у утилиты Robocopy много параметров и ключей, и я рад, что Microsoft не забросила свою полезную программку, которую я полюбил еще в Windows Server 2003 Resource Kit Tools.

Варианты и примеры использования на практике

Теперь когда мы с вами разобрали параметры Robocopy, остается научиться их использовать и применять в ваших сценариях. Сценариев может быть огромное количество. например:

• Нужно скопировать только измененные файлы
• Нужно скопировать только новые файлы
• Нужно скопировать только папки или файлы с определенным расширением, например, PDF
• Нужно копировать файлы из локального расположения в сетевое

Самый простой пример использования Robocopy, это простое копирование одного каталога в другой в рамках одного диска. Предположим мне нужно продублировать содержимое папки C:Temp в C:Test_robocopy

В командной строке пишем вот такую команду

Напоминаю параметр /E копирует файлы и папки, в том числе и пустые. Сам процесс выглядит поэтапным копированием в один поток файлов.

По окончании выполнения команды вы увидите сводную таблицу, в которой будет статистика по каталогам, файлам, времени, пропущенным файлам и скорости.

Но при таком использовании robocopy, вы на каталоге назначения получите файлы с уже другими правами на них. Видно это в свойствах.

Чтобы скопировать и исправить на файлах в каталоге назначения все права доступа (перезаписав текущие и подставив туда из источника), вам необходимо выполнить вот такую команду:

Ключ /COPYALL переносит все сведения о файле, а параметр этого ключа /SECFIX исправит все сведения на вкладке «Безопасность».

Напомню, что есть ключ /MIR параметра robocopy, он делает зеркальную копию каталогов, вот его пример использования:

В момент такого зеркального копирования, утилита Robust File Copy Utility, сделает на конечной стороне полную копию источника, и со всеми списками доступа (ALC) на вкладке безопасности, так же будут перенесены все атрибуты данных. При повторном запуске, будут перенесены, только изменения.

Чтобы осуществить перенос данных на сетевую шару, вы можете использовать вот такую конструкцию:

Теперь представим задачу, что вам необходимо скопировать файлы, которые были изменены за последние 5 дней, выполняем вот такую команду:

Если нужно исключить сегодняшний день, то нужно добавить ключик /MINAGE:1

Если стоит задача скопировать файлы и исключить из все, возраст которых меньше 1 день, то будет выглядеть вот так:

Вот вам пример использования Robocopy, где происходит вырезание файлов в источнике и перенос их в каталог назначения, со всеми правами и атрибутами на файл, вместо сетевого пути, может быть и локальный, как в первом примере.

Иногда может возникнуть задача, перенести все, кроме срытых файлов системы, для этого сценария Robust File Copy Utility имеет ключ /XA:H

Копирование данных только с определенными форматами, например, exe и mp3, и не копировать пустые папки.

Также можно делать выборку по размеру файлов, например, мне нужно скопировать, все, что больше 100 килобайт и меньше 100 мегабайт.

При копировании данных можно исключить не нужные вам каталоги, вот пример команды, где исключается папка CrystalDiskMarkPortable:

Что еще полезного умеет Robocopy, например, автоматическое копирование папок по расписанию да и еще не в один поток. Что такое поток копирования, по сути когда вы в проводнике Windows, запускаете простое копирование, то у вас в диспетчере задач, появляется задача «Проводник», которая последовательно запускает процесс и перенос данных. Когда же Robocopy делает таких потоков больше, то у вас сам процесс идет в разы быстрее, но затрачиваются больше процессорных мощностей, но в виду того, что современные процессору зачастую не дозагружаются даже на 20-30%, то глупо было бы это не использовать, особенно с серверными CPU.

Вот примеры использования команд с заданием потоков, напоминаю, что их может быть от 1 до 128. Особенный прирост скорости вы ощутите в моменты, когда у вас будет огромное количество мелких файлов.

Еще полезной командой будет, когда вам нужно обновить только ACL (Вкладку безопасность на всех файлах, без их повторного копирования)

Ошибки работы Robocopy

У данной утилиты, конечно же могут возникать и проблемы, но чаще всего они не значительные и решаются очень просто, например вы можете встретить ошибку «ОШИБКА 5 (0x00000005) Копирование параметров безопасности NTFS для конечного файла». Данная ошибка гласит, что у вас не хватает прав на перенос параметров и прав на файлы, все дело в том, что ваша cmd-консоль запущена в режиме администратора.

Таблица кодов ошибок, которые появляются в Robocopy

Вот вам подробная, сводная таблица в которой отражены все коды ошибок от 0-8 в данной утилите и дано подробное описание в чем проблема. (Подробнее на https://support.microsoft.com/ru-ru/help/954404/return-codes-that-are-used-by-the-robocopy-utility-in-windows-server-2)

Автоматическое копирование папок по расписанию с Robocopy

Чем хороша данная утилита, так это тем, что с ее помощью можно писать скрипты и сценарии, например в том же PowerShell. Все выше описанные команды, вы можете поместить в текстовый файл (txt), затем сменить ему расширение на bat или cmd, чтобы он стал исполняемым и далее использовать его, либо в групповой политике, или же создать с помощью него задачу в «Планировщике заданий Windows», хотя можно и прямо в нем вписывать все ключи и параметры Robocopy. Про создание задач в планировщике заданий Windows читайте по ссылке. Обратите внимание, что ключи я вписываю в поле аргументы.

Примеры скриптов при резервном копировании или синхронизации. Предположим у вас есть рабочая папка и вы бы хотели ее синхронизировать с другой или сетевой шарой, как я и писал выше вы делаете исполняемый файл или создаете задание в планировщике, вот пример команды, которая перенесет файлы, будет их синхронизировать, перенесет все атрибуты и права, а так же будет их обновлять. Папка C:Test, это источник, а вот каталог \c-10-5210shareTest, уже назначения.

На самом деле примеров использования Robocopy очень много, если будет чем поделиться, пишите в комментариях.

Графический (GUI) интерфейс в Robocopy

С примерами утилиты Robocopy мы ознакомились, теперь предлагаю вам посмотреть для нее графическую оболочку, которая как ни странно есть, и я узнал, о ее существовании буквально недавно. Называется она RoboCopy GUI Utility ver. 3.1, к сожалению она использует robocopy.exe не самой последней версии, но все работает и в Windows 10 1809.

После загрузки RoboCopy GUI Utility ver. 3.1, нам его необходимо установить. Запускаем исполняемый файл. Соглашаемся с лицензионным соглашением.

Утилита вам предложит указать каталог куда будут извлечены файлы.

Соглашаемся с извлечением.

В итоге вы получите вот такую структуру файлов. Запускаем setup.exe.

У вас появится тривиальный мастер установки GUI интерфейса для Robocopy. Нажимаем next.

Принимаем лицензионное соглашение «I gree»

Указываете будет ли утилита устанавливаться только для вас или для всех.

next.

Установка графического интерфейса для Robocopy завершено.

У вас на рабочем столе появится ярлык Microsoft Robocopy GUI. Запускаем его и посмотрим, что из себя представляет эта утилита.

Обзор RoboCopy GUI Utility ver. 3.1

Давайте я бегло покажу, что из себя представляет данная программа. Сам графический интерфейс очень простой, так и должно быть. На первой вкладке вы увидите два действия:

1. Первое, это нужно через «Source Path выбрать, что мы будем копировать»
2. Второе действие, это в «Target Path мы задаем, куда мы будем переносить данные, при желании вы можете смонтировать сетевой диск, через пункт «Map Drive»»

На вкладке «Copy Options», вы увидите уже знакомые параметры использования Robocopy, тут есть и ключи /SEC для переноса прав и команда /MOVE, которую мы применяли для вырезания файлов и многое другое. Тут же вы задаете количество потоков копирования.

Вкладка «Drive Mapping» поможет присоединить сетевой диск, тут вы указываете ip-адрес или DNS имя сервера, и учетные данные для подключения.

Вкладка «Filters» позволит вам указать, что именно нужно переносить и сделать фильтрацию, например, не переносить файлы длина которых в имени составляет более 256 символов, или только txt файлы.

Вкладка «Logging» задает параметры ведения логирования вашего задания.

Вкладка «Monitoring Options» будет полезна для наблюдения за источником копирования, в случае проблем, все можно идентифицировать и перезапустить.

Аналоги утилиты Robocopy

Robust File Copy Utility не единственная утилита, которая позволяет копировать файлы, каталоги с атрибутами и правами, ее аналогами можно назвать утилиты:

• Total Commander
• icacls
• Xcopy
• Far
• Rsync

Вот такая вот полезная и богатая функционалом утилита Robust File Copy Utility или Robocopy.exe, надеюсь, что данный материал был для вас полезен и вы им поделитесь в социальных сетях. А с вами был Семин Иван, автор и создатель IT блога Pyatilistnik.org.

Robocopy – это консольная утилита Windows для копирования файлов, которую можно использовать для синхронизации/репликации файлов и каталогов, и в сценариях резервного копирования. Robocopy (Robust File Copy) доступна начиная с Windows NT 4.0 Resource Kit, но по умолчанию эта функция появилась только в Windows Vista и Windows Server 2008. Robocopy заменяет Xcopy и copy, как более функциональная.

Основные возможности Robocopy

Кроме обычного копирования файлов и папок из папки источника в каталог назначения, в Robocopy есть множество очень полезных функций:

• Устойчивость к обрывам сети (robocopy может продолжить копирования после восстановления сетевого доступа);
• Корректное копирование файлов с их атрибутами и NTFS правами доступа;
• Копирование с сохранением исходной временной метки;
• Возможность копирования файлов и директорий, запрещенных для доступа даже администратору, с помощью ключа /B (ключ позволяет игнорировать проверку прав доступа, ключ доступен только для участников группы Администраторы или Операторы архива);
• Возможность задать количество попыток копирования файла, если файл недоступен;
• Режим полного зеркалирования директорий;
• Пропуск уже существующих файлов (с одинаковым размером или временной меткой timestamp);
• Индикатор прогресса копирования;
• Корректная работа с длинными путями (более 260 символов);
• Эффективные алгоритмы и многопоточность позволяют выполнять копирование файлов намного быстрее, чем обычное копирование средствами Windows;
• Поддержка коды возврата (что позволяет использовать robocopy в различных внешних скриптах и утилитах).

Официальной графической версии robocopy (c GUI) от Microsoft нет. Существуют пользовательские версии, но их поддержка прекращена. Список неофициальных GUI для robocopy (это сторонние программы):

• EazyCopy
• RoboMirror
• RichCopy

Синтаксис и параметры robocopy

Robocopy имеет много параметров, которые на первый взгляд могут показаться сложными, но имея под рукой документацию, вы с легкостью разберетесь и сможете править скрипты под себя.

Официальная документация: https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/robocopy

Синтаксис robocopy состоит из двух обязательных параметров (исходный и целевой каталог) и двух необязательных (фильтр файлов и параметры):

robocopy <source> <dest> [фильтр файлов] [параметры]

Поддерживаются как локальные пути, так и UNC, например, \serverdirectory

Полный синтаксис утилиты robocopy (все параметры и их описания) доступны по команде:

robocopy /?

Исполняемы файл robocopy.exe находится в каталоге C:WindowsSystem32.

Поскольку ключей в robocopy много, мы будем рассматривать их на практике, в готовых командах. Мы не будем рассматривать самые простые примеры использования robocopy, т.к. обычно они не вызывают вопросов. Ниже представлены готовые к применению более сложные команды robocopy, которые можно использовать в реальных сценариях.

Для тестирование различных команд robocopy без выполнения операций (копирования, перемещения или удаления) с файлами используется параметр
/L
. Данный параметр вернет список файлов и папок, которые будут скопированы вашей командой.

Использование robocopy для зеркалирования каталогов

Вы можете зеркалировать (синхронизировать) содержимое двух каталог с помощью следующей команды robocopy (под зеркалированием понимается копирование файлов из целевой папки с удалением файлов в целевом каталоге, если они удалены в источнике).

robocopy \testnode1C$source \testnode2c$dest *.txt /MIR /COPYALL /Z /B /J /R:3 /W:1 /REG /TEE /LOG+:%appdata%robocopy.log

• \testnode1C$source
  — исходный каталог, откуда копируются файлы
• \testnode2C$dest
  — каталог назначения, куда скопируются файлы
• *.txt
  – фильтр файлов. Синхронизируются только .txt файл и директории.
• /MIR
  – полное зеркалирование данных в source и dest директориях. Файлы, удаленные из source директории или не присутствующие в ней, также будут удалены из dest. Если вы хотите, чтобы удаленные из source файлы оставались в dest, то поменяйте параметр /MIR на /E
• /COPYALL
  – копирует всю информацию о файле (Атрибуты, параметры безопасности и т.д.). Как альтернатива, можно применять флаг /COPY:DT для копирования timestamp, а не всей информации. /COPALL требует прав администратора
• /Z
  – robocopy продолжит копирование файла при обрыве. Полезно при копировании больших файлов (неплохая альтернатива копированию файлов по BITS)
• /B
  – позволяет robocopy избегать ошибки access denied error. В этом режиме robocopy игнорирует все права на файлы, которые могли бы помешать прочитать/записать файл. Этот режим требует прав администратора либо участие в группе Операторы архива
• /J
  – Копирование без буфера (файлового кэша, оперативной памяти). Эффективно для больших файлов.
• /R:3
  – количество попыток скопировать недоступный файл. Значение по умолчанию – миллион, поэтому необходимо его сменить.
• /W:1
  – секунды между попытками скопировать недоступный файл. Значение по умолчанию – 30 секунд.
• /REG
  – сохранить текущие значения ключей /R и /W в реестр как стандартные, для будущих вызовов robocopy.
• /TEE
  – разделение вывода работы команды и в лог файл, и в консоль. При фоновом вызове robocopy (например, из планировщика задача) этот параметр можно убрать, оставив только /LOG
• /LOG
  – путь к файлу лога

Обратите внимание на ключ /Z даже если вы копируете небольшие файлы по устойчивому каналу. Он не несёт дополнительных расходов при использовании, но в случае обрыва, вы сможете продолжить копирование просто повторно запустив скрипт.

При копировании больших файлов (более 2 Гб) с некоторых iSCSI/SAN томов, процесс robocopy может существенно использовать оперативную память сервера. Проблем обычно связано с тем, что для данного LUN в настройках RAID используется write-through кэширование вместо write-back.

Инкрементальное копирование с помощью robocopy

Сам по себе robocopy не может полностью обеспечить инкрементальное резервное копирование каталога (копирование новых и измененных файлов), для этого мы будем использовать небольшой bat скрипт:

@echo off
set date_=%date:/=-%
set source=C:source
set dest=\testnode2C$dest%date_%
mkdir %dest%
robocopy "%source%" "%dest%" /maxage:1 /E /COPYALL /Z /B /J /R:3 /W:1 /REG /LOG+: /LOG+:%appdata%robocopy.log
@echo on

• set date_=%date:/=-%
  — эта строчка присваивает значение переменной date_ в формате DD.MM.YYYY
• /maxage:1
  — Максимальный возраст файла. Исключает файлы старше N дней или даты. Дата указывается в формате YYMMDD, например, /maxage:20200421
• /E
  – копирует подпапки, без ограничения уровня вложенности. Для контроля уровня вложенности директорий можно использовать параметр /lev, например, /lev:3

Инкрементальность осуществляется за счёт параметра /maxage:1 — файлы старше суток копироваться не будут. Для первого, “базового” копирования, можно выполнить этот скрипт без параметра /maxage.

Заметка. Если файловые системы source или dest не являются NTFS, используйте ключ
/FFT
, так как на других файловых системах (включая эмулированные NTFS) может возникнуть ошибка, из-за которой robocopy будет видеть старые файлы как измененные, из-за отличий в метке времени.

Robocopy: перемещение файлов

С помощью ключа
/mov
или
/move
вы можете переместить файлы (а точнее удалить успешно скопированные файлы из исходной директории):

robocopy C:source F:dest /MOVE /E /COPYALL /Z /B /J /R:3 /W:1 /REG /TEE /LOG+:%appdata%robocopy.log

• /MOVE
  – удалить файлы и директории из исходной папки, после того как они были скопированы. Имейте в виду, что этот ключ нужно использовать вместе с /E или /S, в противном случае вы перенесете только файлы, но не директории. Если вы хотите перенести только файлы, используйте ключ /MOV

Пример использование robocopy в планировщике задач

Для примера возьмём задачу: нам необходимо с помощью robocopy регулярно синхронизировать содержимое сетевой папки между двумя серверами с ведением логов.

• Исходный путь — \testnode1C$source
• Целевая директория- \testnode2C$source

Запустите командную строку с правами администратора и введите: compmgmt.msc

Перейдите в System Tools -> Task Scheduler Library. Создайте новое задание планировщика (Create task).

Укажите имя задания, и выберите пользователя из-под которого будет выполняться задание. Пользователь должен иметь доступ на чтению и запись в обоих каталогах (при копировании по сети между серверами домена можно использовать аккаунт System, в этом случае нужно предоставить на целевой каталог права RW для объекта computer сервера-источника) .

Выберите опцию Run whether user is logged on or not, для того чтобы задание выполнялось в фоновом режиме. Также отметьте Run with highest privileges. Эта опция сработает если аккаунт из-под которого выполняется задание, будет иметь права администратора.

Перейдите на вкладку Triggers и создайте новый триггер.

Выберите параметр On a schedule (по расписанию), выберите время начала и отметьте Repeat task every, указав интервал выполнения. В моём случае это 5 минут – каждые 5 минут, начиная с часа дня 22 апреля (обязательно измените эту дату на ту, которая нужна вам), директории будут синхронизированы. В for a duration of поставьте Indefinitely (бесконечно)

Перейдите во вкладку Actions и нажмите New…

Выберите Start a program, и укажите путь к .bat скрипту.

Содержание robocopy-mirror.bat:

@echo off
robocopy \testnode1C$source \testnode2c$dest /MIR /COPYALL /Z /B /J /R:3 /W:1 /REG /LOG+:C:robocopy.log
@echo on

Помимо журнала выполнения задания планировщика, robocopy будет писать собственный лог файл копирования в C:robocopy.log. Если аккаунт из-под которого будет выполняться скрипт не имеет прав администратора, смените C:robocopy.log на нужный вам путь.

Остальные настройки заполнять не надо. После нажатия на кнопку ОК, вас попросит ввести пароль от учетной записи, которую вы выбрали для запуска задания.

Если вы всё настроили правильно, директории должны начать синхронизироваться.

Если у вас возникли проблемы с выполнением скрипта, то обязательно проверьте вкладку History вашей задачи

Отслеживание изменений в каталогах с помощью robocopy

В robocopy есть встроенный механизм отслеживания изменений в исходном каталоге (и их последующего копирования) и встроенный планировщик – параметры
/mon
и
/mot
.

• /mon:N
  – проверяет исходную директорию на предмет изменений каждую 1 минуту, и если изменений в директории больше чем N, то будет произведено копирование в целевую директорию. Если задан параметр /mot:Y, то изменения будут проверяться каждые Y минут.
• /mot:N
  – проверяет исходную директорию на предмет изменений каждые N минут. Минимальное значение N = 1, в минутах. Если параметр /mon не задан, то будет считаться что /mon:1

.bat скрипт для зеркалирования с отслеживанием изменений с интервалом в 1 минуту. Этот скрипт нужно запускать из-под аккаунта с правами администратора.

@echo off
robocopy \testnode1C$source \testnode2c$dest /MIR /COPYALL /Z /B /J /R:3 /W:1 /REG /LOG+:%appdata%robocopy.log /mon:1 /mot:1

Плюсы:

• Не нужно создавать задание в планировщике задач
• Подходит для непостоянного выполнения. Например, в течение нескольких часов, в таком случае запустить скрипт руками через CMD проще, чем создавать задание в планировщике

Минусы:

• Чтобы запустить .bat скрипт в фоновом режиме, нужно либо использовать VBS скрипт, либо стороннее ПО, например, NirCmd.
• Минимальный интервал поиска изменений и копирования – 1 минута. Для меньшего интервала нужно использовать PowerShell или bat скрипт.

Коды возврата (ошибки) robocopy

Ниже приведены стандартные коды возврата robocopy, которые можно использовать для обработки различных ошибок, которые возвращает утилита после выполнения действия копирования (кот возврата эта битовая маска).

Hex	Decimal	Meaning if set
0x00	0	No errors occurred, and no copying was done. The source and destination directory trees are completely synchronized.
0x01	1	One or more files were copied successfully (that is, new files have arrived).
0x02	2	Some Extra files or directories were detected. No files were copied Examine the output log for details.
0x04	4	Some Mismatched files or directories were detected. Examine the output log. Housekeeping might be required.
0x08	8	Some files or directories could not be copied (copy errors occurred and the retry limit was exceeded). Check these errors further.
0x10	16	Serious error. Robocopy did not copy any files. Either a usage error or an error due to insufficient access privileges on the source or destination directories.
Коды возврата могут комбинироваться:
0x03	3	(2+1) Some files were copied. Additional files were present. No failure was encountered.
0x05	5	(4+1) Some files were copied. Some files were mismatched. No failure was encountered.
0x06	6	(4+2) Additional files and mismatched files exist. No files were copied and no failures were encountered. This means that the files already exist in the destination directory
0x07	7	(4+1+2) Files were copied, a file mismatch was present, and additional files were present.

Любое значение больше 7 говорит о том, что при копировании через robocopy возникла ошибка. Вы можете обрабатывать эти ошибки в bat файле:

if %ERRORLEVEL% EQU 16 echo ***FATAL ERROR*** & goto end
if %ERRORLEVEL% EQU 15 echo OKCOPY + FAIL + MISMATCHES + XTRA & goto end
if %ERRORLEVEL% EQU 14 echo FAIL + MISMATCHES + XTRA & goto end
if %ERRORLEVEL% EQU 13 echo OKCOPY + FAIL + MISMATCHES & goto end
if %ERRORLEVEL% EQU 12 echo FAIL + MISMATCHES& goto end
if %ERRORLEVEL% EQU 11 echo OKCOPY + FAIL + XTRA & goto end
if %ERRORLEVEL% EQU 10 echo FAIL + XTRA & goto end
if %ERRORLEVEL% EQU 9 echo OKCOPY + FAIL & goto end
if %ERRORLEVEL% EQU 8 echo FAIL & goto end
if %ERRORLEVEL% EQU 7 echo OKCOPY + MISMATCHES + XTRA & goto end
if %ERRORLEVEL% EQU 6 echo MISMATCHES + XTRA & goto end
if %ERRORLEVEL% EQU 5 echo OKCOPY + MISMATCHES & goto end
if %ERRORLEVEL% EQU 4 echo MISMATCHES & goto end
if %ERRORLEVEL% EQU 3 echo OKCOPY + XTRA & goto end
if %ERRORLEVEL% EQU 2 echo XTRA & goto end
if %ERRORLEVEL% EQU 1 echo OKCOPY & goto end
if %ERRORLEVEL% EQU 0 echo No Change & goto end
:end

Утилита robocopy имеет огромный функционал и позволяет гибко настроить операции копирования. Как альтернативу robocopy в PowerShell можно использовать командлет Copy-Item, который хоть и менее функционален, но работает с объектной моделью PowerShell, что может быть важно, если вы часто используете PowerShell или используете цепочки автоматизации с другими языками программирования.

Robocopy (Robust File Copy) is a command-line file copy utility that comes with Windows Vista / Windows 2008 or newer. Until Vista, Robocopy was a part of Windows Resource Kit Tools as a free download (http://aka.ms/robocopydownload).
Unlike normal copy commands, Robocopy is designed for reliable copy or mirroring while maintaining the permissions, attributes, owner information, timestamps and properties of the objects copied.

A few of my customers were complaining that there is not enough documentation on robocopy usage and examples. I am trying to document some of the common scenarios where robocopy can be useful.

---

Robocopy Syntax

ROBOCOPY <source> <destination> [file…] [options]

<source> Source Directory (local or network path)

<destination> Destination Directory (local or network path) and 

[file…] Specifies the file or files to be copied. You can use wildcard characters (* or ?), if you want. If the File parameter is not specified, *.* is used as the default value.

 **Skip to the end of this document for more information on Robocopy Options and Switches .

Examples of Microsoft’s Robocopy Syntax

#1 Simple copy

To copy contents of C:UserFolder to C:FolderBackup:

Robocopy C:UserFolder C:FolderBackup

This is the simplest usage for Robocopy

#2 Copy all content including empty directory

To copy all contents including empty directories of SourceFolder to DestinationFolder:

Robocopy C:SourceDir C:DestDir /E

#3 List only

List only files larger than 32 MBytes(33553332 bytes) in size.

Robocopy.exe c:sourceFolder d:targetfolder /min:33553332 /l

Note: /l — will list files matching the criteria. if /l is omitted, files matching the criteria will be copied to the taget location

#4 Move files over 14 days old

Move files over 14 days old (note the MOVE option will fail if any files are open and locked).

ROBOCOPY C:SourceFoldern D:DestinationFolder /move /minage:14

Similarly you could use the below switches

• /maxage: <N> Specifies the maximum file age (to exclude files older than N days or date).
• /minage: <N>  Specifies the minimum file age (exclude files newer than N days or date).
• /maxlad: <N> Specifies the maximum last access date (excludes files unused since N).
• /minlad: <N> Specifies the minimum last access date (excludes files used since N) If N is less than 1900, N specifies the number of days. Otherwise, N specifies a date in the format YYYYMMDD

#5 Mirror a directory with subfolders incl. empty directories

/MIR is an option to ROBOCOPY where you mirror a directory tree with all the subfolders
including the empty directories and you purge files and folders on the destination server that no longer exists in source.

ROBOCOPY \sourceservershare \destinationservershare /MIR

Or

ROBOCOPY source-drive:DIR destination-drive:DIR /MIR

#6 Mirror directories

The following command will mirror the directories using Robocopy:

Robocopy \SourceServerShare \DestinationServerShare /MIR /FFT /Z /XA:H /W:5

Explanation of the switches used:

• /MIR specifies that Robocopy should mirror the source directory and the destination directory. Note that this will delete files at the destination if they were deleted at the source.
• /FFT uses fat file timing instead of NTFS. This means the granularity is a bit less precise. For across-network share operations this seems to be much more reliable — just don’t rely on the file timings to be completely precise to the second.
• /Z ensures Robocopy can resume the transfer of a large file in mid-file instead of restarting.
• /XA:H makes Robocopy ignore hidden files, usually these will be system files that we’re not interested in.
• /W:5 reduces the wait time between failures to 5 seconds instead of the 30 second default.

#7 Copy all changes

Use Robocopy to copy all changes to files in a directory called c:data to a directory that contains the date, like data_20091124.  Create a batch file as follows.

@echo off

set day=%date:~0,2%

set month=%date:~3,2%

set year=%date:~6,4%

Robocopy "c:data" "c:backupdata%day%-%month%-%year%" /MAXAGE:1

#8 Mirror directory excl. deletion

To mirror the directory «C:directory» to «\server2directory» excluding \server2directorydir2″ from being deleted (since it isn’t present in C:directory) use the following command:

Robocopy "C:Folder" "\Machine2Folder" /MIR /XD  \server2 directorydir2"

Robocopy can be setup as a simply Scheduled Task that runs daily, hourly, weekly etc. Note that Robocopy also contains a switch that will make Robocopy monitor the source for changes and invoke synchronization each time a configurable number of changes has
been made. This may work in your scenario, but be
aware that Robocopy will not just copy the changes, it will scan the complete directory structure just like a normal mirroring procedure. If there are a lot of files & directories, this may hamper performance.

#9 Copy permissions only

You have copied the contents from source to destination but now you made changes to the Security permissions at source. You wanted to copy only the permission changes and not data.

ROBOCOPY <Source> <Target> /E /Copy:S /IS /IT 

Copy option have the following flags to use:

• D Data
• A Attributes
• T Time stamps
• S NTFS access control list (ACL)
• O Owner information
• U Auditing information

The default value for CopyFlags is DAT (data, attributes, and time stamps).

• /IS — Includes the same files.
• /IT — Includes «tweaked» files.

Sidenote: ROBOCOPY c:sourcefolder d:targetfolder /zb /sec /e /nocopy may give you similar results but useful ONLY when more permissions are added. it will not consider or update the target for permissions removed at the source.

See
How to Copy Files Multi-Threaded with Robocopy in Windows 7.

Robocopy, short for Robust File Copy, is a command-line directory replication and file copy command utility that was first made available as feature in Windows Vista and Windows Server 2008, although it has been available as part of Windows Resources Kit.
In Windows 7 and Windows Server 2008, Robocopy utility is further enhanced with ability to multi-threaded copy operation feature.

Multi-threaded support allows Robocopy to open multiple threads simultaneously, allowing many files to be copied in parallel. With multi-threaded copying, total time required to complete the operation will be drastically reduced and cut, when comparing with
with typical copying one file at time in serial sequential order.

As Robocopy is generally a command-line only utility (although a GUI add-on is available for Robocopy), the new multi-threaded operation capability has to be called via a new switch supported by Robocopy. The new multi-threaded copy feature can be enabled
and turned on with the following parameter:

/MT[:n]

Where n will instruct Robocopy to do multi-threaded copies with n threads (default 8). The value of n must be at least 1 and not greater than 128 (between 1 to 128), with 1 as single thread. In fact, Robocopy will copy files and folders in multi-threaded
operation by default, with 8 threads in one go. Note that /MT[:n] switch is not compatible with the /IPG and /EFSRAW operations.

For example,

Robocopy C:Folder1 C:Folder2 /MT:32

#10 Copy directory tree with timestamps

To copy a directory tree along with the source timestamps for folders

Robocopy C:Folder1 C:Folder2 /MIR /dcopy:T

#11 Copy with bandwidth limitation

To copy a directory using /IPG to limit bandwidth usage. General rule of thumb /IPG:750 will use roughly 1Mbps.

Robocopy /ipg:750 /z /r:3 /w:3 /tee /LOG+:c:robolog.txt //server1/share //server2/share

#12 Copy without bandwidth limitation

To copy a directory without bandwidth limitation and logging with bytes level and ETA.

Robocopy /J /tee /LOG+:c:robolog.txt /ETA /BYTES //server1/share //server2/share

---

More Information

TechNet

Robocopy Options and Switches: http://aka.ms/robocopy (Short url for
http://technet.microsoft.com/en-us/library/cc733145(WS.10).aspx)

Robocopy Copy Options

Option	Description
/s	Copies subdirectories. Note that this option excludes empty directories.
/e	Copies subdirectories. Note that this option includes empty directories.
/lev:<N>	Copies only the top N levels of the source directory tree.
/z	Copies files in Restart mode.
/b	Copies files in Backup mode.
/zb	Uses Restart mode. If access is denied, this option uses Backup mode.
/efsraw	Copies all encrypted files in EFS RAW mode.
/copy:<CopyFlags>	Specifies the file properties to be copied. The following are the valid values for this option: D Data A Attributes T Time stamps S NTFS access control list (ACL) O Owner information U Auditing information The default value for CopyFlags is DAT (data, attributes, and time stamps).
/dcopy:T	Copies directory time stamps.
/sec	Copies files with security (equivalent to /copy:DAT).
/copyall	Copies all file information (equivalent to /copy:DATSOU).
/nocopy	Copies no file information (useful with /purge).
/secfix	Fixes file security on all files, even skipped ones.
/timfix	Fixes file times on all files, even skipped ones.
/purge	Deletes destination files and directories that no longer exist in the source.
/mir	Mirrors a directory tree (equivalent to /e plus /purge).
/mov	Moves files, and deletes them from the source after they are copied.
/move	Moves files and directories, and deletes them from the source after they are copied.
/a+:[RASHCNET]	Adds the specified attributes to copied files.
/a-:[RASHCNET]	Removes the specified attributes from copied files.
/create	Creates a directory tree and zero-length files only.
/fat	Creates destination files by using 8.3 character-length FAT file names only.
/256	Turns off support for very long paths (longer than 256 characters).
/mon:<N>	Monitors the source, and runs again when more than N changes are detected.
/mot:<M>	Monitors source, and runs again in M minutes if changes are detected.
/rh:hhmm-hhmm	Specifies run times when new copies may be started.
/pf	Checks run times on a per-file (not per-pass) basis.
/ipg:n	Specifies the inter-packet gap to free bandwidth on slow lines.
/sl	Copies the symbolic link instead of the target.

Important
When using the /SECFIX copy option, specify the type of security information you want to copy by also using one of these additional copy options: /COPYALL /COPY:O /COPY:S /COPY:U /SEC

File Selection Options

Option	Description
/a	Copies only files for which the Archive attribute is set.
/m	Copies only files for which the Archive attribute is set, and resets the Archive attribute.
/ia:[RASHCNETO]	Includes only files for which any of the specified attributes are set.
/xa:[RASHCNETO]	Excludes files for which any of the specified attributes are set.
/xf <FileName>[ …]	Excludes files that match the specified names or paths. Note that FileName can include wildcard characters (* and ?).
/xd <Directory>[ …]	Excludes directories that match the specified names and paths.
/xct	Excludes changed files.
/xn	Excludes newer files.
/xo	Excludes older files.
/xx	Excludes extra files and directories. Extra files are files that exist in the destination directory.
/xl	Excludes «lonely» files and directories.
/is	Includes the same files.
/it	Includes «tweaked» files.
/max:<N>	Specifies the maximum file size (to exclude files bigger than N bytes).
/min:<N>	Specifies the minimum file size (to exclude files smaller than N bytes).
/maxage:<N>	Specifies the maximum file age (to exclude files older than N days or date).
/minage:<N>	Specifies the minimum file age (exclude files newer than N days or date).
/maxlad:<N>	Specifies the maximum last access date (excludes files unused since N).
/minlad:<N>	Specifies the minimum last access date (excludes files used since N) If N is less than 1900, N specifies the number of days. Otherwise, N specifies a date in the format YYYYMMDD.
/xj	Excludes junction points, which are normally included by default.
/fft	Assumes FAT file times (two-second precision).
/dst	Compensates for one-hour DST time differences.
/xjd	Excludes junction points for directories.
/xjf	Excludes junction points for files.

Retry Options 

Option	Description
/r:<N>	Specifies the number of retries on failed copies. The default value of N is 1,000,000 (one million retries).
/w:<N>	Specifies the wait time between retries, in seconds. The default value of N is 30 (wait time 30 seconds).
/reg	Saves the values specified in the /r and /w options as default settings in the registry.
/tbd	Specifies that the system will wait for share names to be defined (retry error 67).

Logging Options

Option	Description
/l	Specifies that files are to be listed only (and not copied, deleted, or time stamped).
/x	Reports all extra files, not just those that are selected.
/v	Produces verbose output, and shows all skipped files.
/ts	Includes source file time stamps in the output.
/fp	Includes the full path names of the files in the output.
/bytes	Prints sizes, as bytes.
/ns	Specifies that file sizes are not to be logged.
/nc	Specifies that file classes are not to be logged.
/nfl	Specifies that file names are not to be logged.
/ndl	Specifies that directory names are not to be logged.
/np	Specifies that the progress of the copying operation (the number of files or directories copied so far) will not be displayed.
/eta	Shows the estimated time of arrival (ETA) of the copied files.
/log:<LogFile>	Writes the status output to the log file (overwrites the existing log file).
/log+:<LogFile>	Writes the status output to the log file (appends the output to the existing log file).
/unicode	Displays the status output as Unicode text.
/unilog:<LogFile>	Writes the status output to the log file as Unicode text (overwrites the existing log file).
/unilog+:<LogFile>	Writes the status output to the log file as Unicode text (appends the output to the existing log file).
/tee	Writes the status output to the console window, as well as to the log file.
/njh	Specifies that there is no job header.
/njs	Specifies that there is no job summary.

Job Options 

Option	Description
/job:<JobName>	Specifies that parameters are to be derived from the named job file.
/save:<JobName>	Specifies that parameters are to be saved to the named job file.
/quit	Quits after processing command line (to view parameters)./nosd:
/nodd	Indicates that no destination directory is specified.
/if	Includes the specified files.

---

From Wikipedia, the free encyclopedia

Robocopy

Developer(s)	Microsoft
Initial release	1996, 26–27 years ago
Stable release	10.0.19041.1 / December 7, 2019; 3 years ago
Operating system	Windows NT 4 and later
Type	Command
License	Freeware
Website	docs.microsoft.com/en-us/windows-server/administration/windows-commands/robocopy

Robocopy, for «Robust File Copy», is a command-line directory and/or file replication command for Microsoft Windows. Robocopy functionally replaces Xcopy, with more options. Created by Kevin Allen^[1] and first released as part of the Windows NT 4.0 Resource Kit, it has been a standard feature of Windows since Windows Vista and Windows Server 2008. The command is robocopy.

Features[edit]

Robocopy is noted for capabilities above and beyond the built-in Windows copy and xcopy commands, including the following, some requiring appropriate command-line options:

• Ability to tolerate network interruptions and resume copy (incomplete files are marked with a date stamp of 1970-01-01 and contain a recovery record so Robocopy knows where to continue from).
• Ability to skip NTFS junction points which can cause copying failures because of infinite loops (/XJ)
• Ability to copy file data and attributes correctly, and to preserve original timestamps, as well as NTFS ACLs, owner information, and audit information using the /COPYALL or /COPY: command line switches.
• Beginning with the XP026 version, the ability to copy folder (or directory) date and timestamps (/DCOPY:T), even with the ability to update folder timestamps (copied from existing folders) on folders already created from previous versions (that did not copy the folder date and timestamps).
• Ability to assert the Windows NT «backup right» (/B) so an administrator may copy an entire directory, including files denied readability to the administrator.
• Persistence by default, with a programmable number of automatic retries if a file cannot be copied.
• A «mirror» mode, which keeps trees synchronised by also deleting files in the destination that are not present in the source.
• Ability to skip files already in the destination folder with identical size and timestamp.
• A continuously updated command-line progress indicator.
• Ability to copy paths exceeding 259 characters — up to a theoretical limit of about 32,000 characters — without errors.^[2]
• Multithreaded copying introduced with Windows 7 and Windows Server 2008 R2.^[3]
• Return code^[4] on program termination for batch file usage.

Compression[edit]

Since Windows Server 2019 and Windows 10, a compression option is available in robocopy when copying across a network. With this switch, if the destination computer supports SMB compression and the files being copied are very compressible, there may be significant improvements to performance. The SMB compression adds inline whitespace compression to file transfers. Compression is also available with the xcopy command and Hyper-V Live Migration with SMB.^[5][6]

Examples of use[edit]

Here are some examples of usage, which is not case-sensitive. If more than one option is specified, they must be separated by spaces.

• Copy directory contents of the source Directory A to the destination Directory B (including file data, attributes and timestamps), recursively with empty directories (/E):

Robocopy "C:Directory A" "C:Directory B" /E

If directory names have non-standard characters, such as spaces, they must be enclosed in double quotes, as is usual in the command line.

• Copy directory recursively (/E), copy all file information (/COPYALL, equivalent to /COPY:DATSOU, D=Data, A=Attributes, T=Timestamps, S=Security=NTFS ACLs, O=Owner info, U=Auditing info), do not retry locked files (/R:0) (the number of retries on failed copies default value is 1 million), preserve original directories’ Timestamps (/DCOPY:T — requires version XP026 or later):

Robocopy C:A C:B /COPYALL /E /R:0 /DCOPY:T

• Mirror A to B, destroying any files in B that are not present in A (/MIR), copy files in resume mode (/Z) in case network connection is lost:

Robocopy C:A \backupserverB /MIR /Z

For the full reference, see the Microsoft TechNet Robocopy page.^[7]

Syntactic focus on copying folders[edit]

Robocopy syntax is markedly different from its predecessors (copy and xcopy), in that it accepts only folder names, without trailing backslash, as its source and destination arguments. File names and wildcard characters (such as * and ?) are not valid as source or destination arguments; files may be selected or excluded using the optional «file» filtering argument (which supports wildcards) along with various other options.^[8]

For example, to copy two files from folder c:bar to c:baz, the following syntax is used:

 robocopy c:bar c:baz file1.txt file2.db

And to copy all PDF files from c:bar to c:baz:

 robocopy c:bar c:baz *.pdf

The files named are copied only from the folder selected for copying; fully qualified path names are not supported.

CAUTION: A long-standing issue with Robocopy means that if you back up from the root folder of a drive [ e.g., robocopy d: b:d-backup ....], the destination files will be given attributes including SH. This means that they will be invisible to normal access (including DIR in cmd.exe). To fix this, add /a-:SH to the robocopy command line — or do an ATTRIB command to remove them afterwards.

Output[edit]

Robocopy outputs to the screen, or optionally to a log file, the names of all the directories it encounters, in alphabetical order. Each name is preceded by the number of files in the directory that fulfill the criteria for being copied. If the directory does not yet exist in the target, it is marked «New Dir»; if the directory is empty and the /E option is not used, or it contains no files meeting the criteria, a new directory will not be created.

If the /NFL (no file names in log) option is not used, the files being copied will be listed after the name of the directory they are in.

At the end of the output is a table giving numbers of directories, files, and bytes. For each of these, the table gives the total number found in the source, the number copied (including directories marked «New Dir» even if they are not copied), the number skipped (because they already exist in the target), and the number of mismatches, FAILED, and extras. «Failed» can mean that there was an I/O error that prevented a file being copied, or that access was denied. There is also a row of time taken (in which the time spent on failed files seems to be in the wrong column).

Bandwidth throttling[edit]

Robocopy’s «inter-packet gap» (IPG) option allows some control over the network bandwidth used in a session. In theory, the following formula expresses the delay (D, in milliseconds) required to simulate a desired bandwidth (B_D, in kilobits per second), over a network link with an available bandwidth of B_A kbps:

In practice however, some experimentation is usually required to find a suitable delay, due to factors such as the nature and volume of other traffic on the network. The methodology employed by the IPG option may not offer the same level of control provided by some other bandwidth throttling technologies, such as BITS (which is used by Windows Update and BranchCache).

Limitations[edit]

• Robocopy does not copy open files. Any process may open files for exclusive read access by withholding the FILE_SHARE_READ^[9] flag during opening. Even Robocopy’s Backup mode will not touch those files. (Backup mode instead runs Robocopy as a «Backup Operator». This allows Robocopy to override permissions settings, specifically, NTFS ACLs).^[10][11] Normally Volume Shadow Copy Service is used for such situations, but Robocopy does not use it. Consequently, Robocopy is not suitable for backing up live operating system volumes. However, a separate utility such as ‘ShadowSpawn’^[12] (Free, Open Sourced, and MIT Licensed) or ‘GSCopyPro’^[13] ($30–50) or Diskshadow^[14] (included with Windows Server 2008), can be used beforehand to create a shadow copy of a given volume, which Robocopy can then back up.

• Robocopy versions on systems older than Windows Vista do not mirror properly. They ignore changed security attributes of previously mirrored files.^[15][16]
• When specifying the /MT[:n] option to enable multithreaded copying, the /NP option to disable reporting of the progress percentage for files is ignored. By default the MT switch provides 8 threads. The n is the number of threads you specify if you do not want to use the default.^[17]

GUI[edit]

Although Robocopy itself is a command-line tool, Microsoft TechNet provided a GUI front-end called Robocopy GUI. It was developed by Derk Benisch, a systems engineer with the MSN Search group at Microsoft, and required .NET Framework 2.0.^[18] It included a copy of Robocopy version XP026. It is no longer available from Microsoft, but may be downloaded from the Internet Archive’s Wayback Machine.^[19]

There are non-Microsoft GUIs for Robocopy:

• Cinchoo’s ChoEazyCopy, Simple and powerful RoboCopy GUI v2.0.0.1 (March 11, 2022)^[20]
• «Easy RoboCopy», latest version 1.0.16 released on January 11, 2022.^[21]
• «WinRoboCopy» revision 1.3.5953.40896 released on April 19, 2016.^[22]
• RoboCop RoboCopy, Robocopy GUI Skin and script generator with Progress Monitoring, 10 September 2015.^[23]
• A program by SH-Soft, also called «Robocopy GUI» v1.0.0.24 (October 8, 2005).^[24]

Ken Tamaru of Microsoft developed a copying program with functionality similar to Robocopy, called RichCopy, discontinued in 2010. It is not based on Robocopy, and does not require .NET Framework.^[25]

Versions[edit]

Several versions of Robocopy do not report the version number when executing robocopy /? on the command line. However, their version is stored inside the executable itself and can be queried with PowerShell for example (gcm robocopy | fl *) or inside Windows Explorer by right-clicking on Robocopy.exe, selecting Properties, then clicking on the Details tab.

Product version	File version	Year	Origin
1.54	—	1996	Windows NT 4.0 Resource Kit
1.70	—	1997	Windows NT Resource Kit
1.71	4.0.1.71	1997	Windows NT Resource Kit
1.95	4.0.1.95	1999	Windows 2000 Resource Kit
1.96	4.0.1.96	1999	Windows 2000 Resource Kit
XP010	5.1.1.1010	2003	Windows 2003 Resource Kit
XP026	5.1.2600.26	2005	Downloaded with Robocopy GUI v.3.1.2; /DCOPY:T option introduced
XP027	5.1.10.1027	2008	Bundled with Windows Vista, Server 2008, Windows 7, Server 2008r2
6.1	6.1.7601	2009	KB2639043
6.2	6.2.9200	2012	Bundled with Windows 8
6.3	6.3.9600	2013	Bundled with Windows 8.1
10.0	10.0.10240.16384	2015	Bundled with Windows 10
10.0.16299	10.0.16299.15	2017	Bundled with Windows 10 1709
10.0.17134	10.0.17134.1	2018	Bundled with Windows 10 1803
10.0.17763	10.0.17763.1	2018	Bundled with Windows 10 1809
10.0.18362	10.0.18362.1	2019	Bundled with Windows 10 1903
10.0.18362.1	10.0.18362.1	2019	Bundled with Windows 10 1909
10.0.19041.1	10.0.19041.1	2020	Bundled with Windows 10 20H2
10.0.22000	10.0.22000	2021	Bundled with Windows 11 21H2
10.0.22621	10.0.22621	2022	Bundled with Windows 11 22H2

See also[edit]

• List of file copying software
• Command line
  • List of DOS commands
  • rsync
• GUI
  • SyncToy
  • Ultracopier

References[edit]

External links[edit]

• Official sources
  • Microsoft Robocopy documentation
  • Robocopy download (Version XP010) as part of Windows Server 2003 Resource Kit Tools. Includes 35-page documentation «robocopy.doc».
  • Robocopy short documentation on Microsoft TechNet Library
  • Robocopy GUI download (Version 3.1.2.0) on Microsoft TechNet Magazine
• Other
  • ROBOCOPY.exe (XP Resource Kit/Standard Vista command)

Robocopy (Robust File Copy) is a command line folder and file replication tool available as a standard Windows feature since Windows Server 2008. The goal of this post is to give you a quick start guide by providing some Robocopy examples.

Over the past 25 years, since Robocopy first became available as part of the Windows NT4 resource pack, it has not changed much. Some features, such as SMB compression, were added, but the usage is still the same. As Robocopy has many great features, such as the ability to copy NTFS ACLs (permissions), it is one of the best free tools for file copy/mirror operations. This Wikipedia post is a good starting point for getting more information about robocopy.

Before we get to the Robocopy examples, you should know the main limitation of robocopy—it cannot copy open or locked files, as it does not use VSS (Volume Shadow Copy Service).

Help and default options

Robocopy itself includes very detailed help, with a description of each option. Simply type robocopy /? to get help displayed.

The basic syntax for Robocopy is:

robocopy c:tempsource c:tempdestination

This will copy all files, excluding subfolders, from the specified source (c:tempsource) to the specified destination (c:tempdestination) with a bunch of default options.

Note: If you have a folder with spaces in the name, simply put quotes around the path (“c:tempsource with spaces”).

Let’s take a closer look at what the options mean:

• *.*—Defines a file filter. The first asterisk (*) represents the filename part, and the second asterisk represents the extension. In this case, the command copies all filenames with all extensions.
• /DCOPY:DA—Defines what to copy for directories. D stands for «data» and A stands for «attributes.»
• /COPY:DAT—Defines what to copy for files. The extra T stands for «timestamps;» DA is the same as for directories.
• /R:1000000—Defines the number of retries on failed copies, for example, if a file is locked.
• /W:30—Defines the number of seconds to wait between retries.

As you can see, the number of retries is very large (one million), which is not practical in most cases. If there is a single locked file inside the directory, robocopy will do a million retries and will wait 30 seconds between them, amounting to almost 350 days. I guess this is not what you normally want.

Generally speaking, there are three things you will do using robocopy: copy, move, and synchronize folders and files.

Copy examples

The easiest way to copy a folder with all files and subfolders is to run this command:

robocopy c:tempsource c:tempdestination /E /DCOPY:DAT /R:10 /W:3

The /E switch tells Robocopy to copy all subfolders, including empty ones. If you don’t want to copy empty subfolders, use the /S switch. Note that I have specified /DCOPY:DAT (default is DA), as I usually want the folder timestamps to be the same as the source. I also limit the number of retries and wait times. If there is a file locked, it won’t usually be unlocked quickly, and it’s easier for me to check the erred files manually later rather than waiting ages for the whole command to complete.

If you are about to copy a large number of files, it might be more useful to save the output to a log file so you can review the results later, even if the command prompt is closed.

robocopy c:tempsource c:tempdestination /E /DCOPY:DAT /R:100 /W:3 /LOG:C:temprobocopylog.txt

Will give you a text log file with all the information you would normally see on screen.

Note: If the destination directory (c:tempdestination) already exists, you will see one skipped folder in the results.

In many (if not most) cases, you will need to create a completely identical copy of the source, including the NTFS owner and auditing information. For that, I add /COPYALL to the command, which is equivalent to /COPY:DATSOU.

robocopy c:tempsource c:tempdestination /E /COPYALL /DCOPY:DAT /R:100 /W:3

Note that this command has to be run from an elevated command prompt, unless you have turned off UAC, otherwise you’ll receive this error message:

ERROR : You do not have the Manage Auditing right.

Move examples

Robocopy offers two options for moving files and folders:

• /MOV—Moves files only, leaving the empty folder structure at the source
• /MOVE—Moves files and folders

Use the command below to move all files and folders, including empty ones, with all attributes. Note that the source folder will also be deleted.

robocopy c:tempsource c:tempdestination /E /COPYALL /DCOPY:DAT /MOVE /R:100 /W:3

Synchronize examples

As with move, there are two options to synchronize folders:

• /PURGE—Deletes the files and folders that are no longer present in the source but without subfolders.
• /MIR—Is equivalent to /PURGE /E. /MIR also copies all files in subfolders, including empty ones.

Be careful with this command, especially with source and destination folders. If you make a mistake here, you might get files lost in the specified folder.

robocopy c:tempsource c:tempdestination /MIR /COPYALL /DCOPY:DAT /R:100 /W:3

Filtering examples

Sometimes you might want to copy only specific files, for example, Word documents. This can be done easily by adding the *.docx filter after the destination folder before any other options.

robocopy c:tempsource c:tempdestination *.doc

You might also want to exclude some files or folders from the operation. This is done using the /XF and /XF options. To exclude all .doc files, use the command below.

robocopy c:tempsource c:tempdestination /XF *.doc

To exclude multiple subfolders, use spaces in the command:

robocopy c:tempsource c:tempdestination /XD Subfolder EmptySubfolder

Robocopy includes many more filtering options, which you can find in help under the File Selection Options section.

Networking examples

Another great feature of Robocopy is that it works well with UNC paths and can resume operation in case of a network interruption. The command below will copy the files in restartable mode.

robocopy c:tempsource \MYSERVERmyshare /Z

Backup mode

The last, but definitely not the least, option I will cover today is the backup mode option /B. This option allows administrators to copy files in a special backup mode. This is extremely useful if you are asked to copy folders to which you don’t have access. The backup mode uses the Backup and Restore security privilege to bypass the NTFS permissions and copy the files. This again requires a command prompt to be elevated. In addition, your account needs at least SeBackupPrivilege, which is usually granted to the Administrators and Backup Operators groups.

robocopy c:tempsource c:tempdestination /E /COPYALL /DCOPY:DAT /B

Final words

Robocopy is a very powerful tool for performing various file and folder operations. Many administrators use it on a daily basis for profile migrations and other similar operations. The big advantage is that it’s part of the operating system itself. There are dozens of other options that can be used with Robocopy, but to cover them all would be beyond the scope of this post.

Updated: 03/13/2021 by

Robocopy is a robust file copy command for the Windows command line. It allows users to copy files, directories, and drives from one location to another.

Availability

Robocopy is an external command available for the following Microsoft operating systems as robocopy.exe.

• Windows NT (In resource kit)
• Windows 2000 (In resource kit)
• Windows Server 2008
• Windows Vista
• Windows 7
• Windows 8
• Windows 10
• Windows 11

Robocopy syntax

• Windows 10 and 11 syntax.
• Windows 8 and earlier syntax.

Windows 10 and 11 syntax

ROBOCOPY source destination [file [file]...] [options]

source	Source directory (drive:path or \serversharepath).
destination	Destination directory (drive:path or \serversharepath).
file	File(s) to copy (names/wildcards: default is «*.*»).

Copy options

/S	Copy subdirectories, but not the empty ones.
/E	Copy subdirectories, including the empty ones.
/LEV:n	Only copy the top n levels of the source directory tree.
/Z	Copy files in restartable mode.
/B	Copy files in backup mode.
/ZB	Use restartable mode. If access is denied, use backup mode.
/J	Copy using unbuffered I/O (recommended for large files).
/EFSRAW	Copy all encrypted files in EFS RAW mode.
/COPY:[copyflags]	What to COPY for files (default is /COPY:DAT). (copyflags: D=Data, A=Attributes, T=Timestamps). (S=Security=NTFS ACLs, O=Owner info, U=aUditing info).
/SEC	Copy files with security (equivalent to /COPY:DATS).
/COPYALL	Copy all file info (equivalent to /COPY:DATSOU).
/NOCOPY	Copy no file info (useful with /PURGE).
/SECFIX	Fix file security on all files, even skipped files.
/TIMFIX	Fix file times on all files, even skipped files.
/PURGE	Delete dest files/dirs that no longer exist in the source.
/MIR	Mirror a directory tree (equivalent to /E plus /PURGE).
/MOV	Move files (delete from the source after copying).
/MOVE	Move files and dirs (delete from the source after copying).
/A+:[RASHCNET]	Add the given attributes to copied files.
/A-:[RASHCNET]	Remove the given attributes from copied files.
/CREATE	Create directory tree and zero-length files only.
/FAT	Create destination files using 8.3 FAT file names only.
/256	Turn off a very long path (> 256 characters) support.
/MON:n	Monitor source; run again when more than n changes are shown.
/MOT:m	Monitor source; run again in m minutes time, if changed.
/RH:hhmm-hhmm	Run hours — times when new copies may be started.
/PF	Check run hours on a per file (not per pass) basis.
/IPG:n	Inter-packet gap (ms), to free bandwidth on slow lines.
/SJ	Copy junctions as junctions instead of as the junction targets.
/SL	Copy symbolic links as links instead of as the link targets.
/MT[:n]	Do multi-threaded copies with n threads (default 8). n must be at least 1 and not greater than 128. This option is incompatible with the /IPG and /EFSRAW options. Redirect output using /LOG option for better performance.
/DCOPY:[copyflags]	What to copy for directories (default is /DCOPY:DA). (copyflags : D=Data, A=Attributes, T=Timestamps, E=EAs, X=Skip alt data streams).
/NODCOPY	Copy no directory info (the default /DCOPY:DA is done).
/NOOFFLOAD	Copy files without using the Windows Copy Offload mechanism.
/COMPRESS	Request network compression during file transfer, if applicable.

Copy File Throttling options

Note

The Copy File Throttling options are only available in Windows 11.

/IoMaxSize:n[KMG]	Requested max I/O size per {read,write} cycle, in n [KMG] bytes.
/IoRate:n[KMG]	Requested I/O rate, in n [KMG] bytes per second.
/Threshold:n[KMG]	File size threshold for throttling, in n [KMG] bytes (see Remarks).

File Selection options

/A	Copy only the files with the archive attribute set.
/M	Copy only the files with the archive attribute and reset it.
/IA:[RASHCNETO]	Include only the files with any of the given attributes set.
/XA:[RASHCNETO]	Exclude files with any of the given attributes set.
/XF file [file]…	Exclude files matching given names/paths/wildcards.
/XD dirs [dirs]…	Exclude directories matching given names/paths.
/XC	Exclude changed files.
/XN	Exclude newer files.
/XO	Exclude older files.
/XX	Exclude extra files and directories.
/XL	Exclude lonely files and directories.
/IS	Include same files.
/IT	Include tweaked files.
/MAX:n	Maximum file size — exclude files bigger than n bytes.
/MIN:n	Minimum file size — exclude files smaller than n bytes.
/MAXAGE:n	Maximum file age — exclude files older than n days/date.
/MINAGE:n	Minimum file age — exclude files newer than n days/date.
/MAXLAD:n	Maximum last access date — exclude files unused since n.
/MINLAD:n	Minimum last access date — exclude files used since n. (If n < 1900 then n = n days, else n = YYYYMMDD date).
/FFT	Assume FAT file times (2-second granularity).
/DST	Compensate for one-hour DST time differences.
/XJ	Exclude symbolic links (for both files and directories) and junction points.
/XJD	Exclude symbolic links for directories and junction points.
/XJF	Exclude symbolic linksfor files.
/IM	Include modified files (differing change times).

Retry options

/R:n	Number of retries on failed copies: default 1 million.
/W:n	Wait time between retries: default is 30 seconds.
/REG	Save /R:n and /W:n in the registry as default settings.
/TBD	Wait for sharenames to be defined (retry error 67).
/LFSM	Operate in low free space mode, enabling copy pause and resume (see Remarks).
/LFSM:n[KMG]	/LFSM, specifying the floor size in n [K:kilo,M:mega,G:giga] bytes.

Logging options

/L	List only — don’t copy, timestamp or delete any files.
/X	Report all extra files, not only those selected.
/V	Produce verbose output, showing skipped files.
/TS	Include source file timestamps in the output.
/FP	Include full pathname of files in the output.
/BYTES	Print sizes as bytes.
/NS	No size — don’t log file sizes.
/NC	No class — don’t log file classes.
/NFL	No file list — don’t log file names.
/NDL	No directory list — don’t log directory names.
/NP	No progress — don’t display percentage copied.
/ETA	Show estimated time of arrival of copied files.
/LOG:file	Output status to LOG file (overwrite existing log).
/LOG+:file	Output status to LOG file (append to existing log).
/UNILOG:file	Output status to LOG file as UNICODE (overwrite existing log).
/UNILOG+:file	Output status to LOG file as UNICODE (append to existing log).
/TEE	Output to console window and the log file.
/NJH	No job header.
/NJS	No job summary.
/UNICODE	Output status as UNICODE.

Job options

/JOB:jobname	Take parameters from the named job file.
/SAVE:jobname	Save parameters to the named job file.
/QUIT	Quit after processing command line (to view parameters).
/NOSD	No source directory is specified.
/NODD	No destination directory is specified.
/IF	Include the following files.

Using /PURGE or /MIR on the root directory of the volume formerly caused robocopy to apply the requested operation on files inside the System Volume Information directory as well. That is no longer the case. If /PURGE or /MIR is specified, robocopy skips any files or directories with that name in top-level source and destination directories of the copy session.

The modified files classification applies only when source and destination filesystems support change timestamps (e.g., NTFS), and the source and destination files have different change times. These files are not copied by default; specify /IM to include them.

The /DCOPY:E flag requests that extended attribute copying should be attempted for directories. Note that currently robocopy continues if a directory’s EAs could not be copied. This flag is also not included in /COPYALL.

Using /LFSM requests robocopy to operate in ‘low free space mode’. In that mode, robocopy pauses whenever file copying would cause the destination volume’s free space to go below a ‘floor’ value, which can be explicitly specified by the LFSM:n[KMG] form of the flag. If /LFSM is specified with no explicit floor value, the floor is set to ten percent of the destination volume’s size. Low free space mode is incompatible with /MT, /EFSRAW, /B, and /ZB.

Windows 8 and earlier syntax

ROBOCOPY source destination [file [file]...] [options]

source	Source directory (drive:path or \serversharepath).
destination	Destination directory (drive:path or \serversharepath).
file	File(s) to copy (names/wildcards: default is «*.*»).

Copy options

/S	Copy subdirectories, but not the empty ones.
/E	Copy subdirectories, including the empty ones.
/LEV:n	Only copy the top n levels of the source directory tree.
/Z	Copy files in restartable mode.
/B	Copy files in backup mode.
/ZB	Use restartable mode. If access denied, use backup mode.
/EFSRAW	Copy all encrypted files in EFS RAW mode.
/COPY:[copyflags]	What to COPY for files (default is /COPY:DAT). (copyflags : D=Data, A=Attributes, T=Timestamps). (S=Security=NTFS ACLs, O=Owner info, U=aUditing info).
/DCOPY:T	COPY the directory timestamps.
/SEC	Copy files with security (equivalent to /COPY:DATS).
/COPYALL	Copy all file info (equivalent to /COPY:DATSOU).
/NOCOPY	Copy no file info (useful with /PURGE).
/SECFIX	Fix file security on all files, even skipped files.
/TIMFIX	Fix file times on all files, even the skipped ones.
/PURGE	Delete dest files/dirs that no longer exist in the source.
/MIR	Mirror a directory tree (equivalent to /E plus /PURGE).
/MOV	Move files (delete from the source after copying).
/MOVE	Move files and dirs (delete from the source after copying).
/A+:[RASHCNET]	Add the given attributes to copied files.
/A-:[RASHCNET]	Remove the given attributes from copied files.
/CREATE	Create directory tree and zero-length files only.
/FAT	Create destination files using 8.3 FAT file names only.
/256	Turn off very long path (> 256 characters) support.
/MON:n	Monitor source; run again when more than n changes seen.
/MOT:m	Monitor source; run again in m minutes time, if changed.
/RH:hhmm-hhmm	Run hours — times when new copies may be started.
/PF	Check run hours on a per file (not per pass) basis.
/IPG:n	Inter-packet gap (ms), to free bandwidth on slow lines.
/SL	Copy symbolic links versus the target.
/MT[:n]	Do multi-threaded copies with n threads (default 8). n must be at least 1 and not greater than 128. This option is incompatible with the /IPG and /EFSRAW options. Redirect output using /LOG option for better performance.

File Selection options

/A	Copy only the files with the archive attribute set.
/M	Copy only the files with the archive attribute and reset it.
/IA:[RASHCNETO]	Include only the files with any of the given attributes set.
/XA:[RASHCNETO]	Exclude files with any of the given attributes set.
/XF file [file]…	Exclude files matching given names/paths/wildcards.
/XD dirs [dirs]…	Exclude directories matching given names/paths.
/XC	Exclude changed files.
/XN	Exclude newer files.
/XO	Exclude older files.
/XX	Exclude extra files and directories.
/XL	Exclude lonely files and directories.
/IS	Include same files.
/IT	Include tweaked files.
/MAX:n	Maximum file size — exclude files bigger than n bytes.
/MIN:n	Minimum file size — exclude files smaller than n bytes.
/MAXAGE:n	Maximum file age — exclude files older than n days/date.
/MINAGE:n	Minimum file age — exclude files newer than n days/date.
/MAXLAD:n	Maximum last access date — exclude files unused since n.
/MINLAD:n	Minimum last access date — exclude files used since n. (If n < 1900 then n = n days, else n = YYYYMMDD date).
/XJ	Exclude junction points. (normally included by default).
/FFT	Assume FAT file times (2-second granularity).
/DST	Compensate for one-hour DST time differences.
/XJD	Exclude junction points for directories.
/XJF	Exclude junction points for files.

Retry options

/R:n	Number of retries on failed copies: default 1 million.
/W:n	Wait time between retries: default is 30 seconds.
/REG	Save /R:n and /W:n in the registry as default settings.
/TBD	Wait for sharenames to be defined (retry error 67).

Logging options

/L	List only — don’t copy, timestamp or delete any files.
/X	Report all extra files, not only those selected.
/V	Produce verbose output, showing skipped files.
/TS	Include source file timestamps in the output.
/FP	Include full pathname of files in the output.
/BYTES	Print sizes as bytes.
/NS	No size — don’t log file sizes.
/NC	No class — don’t log file classes.
/NFL	No file list — don’t log file names.
/NDL	No directory List — don’t log directory names.
/NP	No progress — don’t display percentage copied.
/ETA	Show estimated time of arrival of copied files.
/LOG:file	Output status to LOG file (overwrite existing log).
/LOG+:file	Output status to LOG file (append to existing log).
/UNILOG:file	Output status to LOG file as UNICODE (overwrite existing log).
/UNILOG+:file	Output status to LOG file as UNICODE (append to existing log).
/TEE	Output to console window and the log file.
/NJH	No job header.
/NJS	No job summary.
/UNICODE	Output status as UNICODE.

Job options

/JOB:jobname	Take parameters from the named job file.
/SAVE:jobname	Save parameters to the named job file.
/QUIT	Quit after processing command line (to view parameters).
/NOSD	No source directory is specified.
/NODD	No destination directory is specified.
/IF	Include the following files.

Robocopy examples

robocopy c:hope c:hope2 *.txt

In this first example, any .txt file would be copied from the hope directory into the hope2 directory. Whenever you want to copy one or more files and not a complete directory the file must be specified after the destination directory.

robocopy c:hope c:hope2

In the above example, the robocopy command would copy all files (not directories) in the hope directory to the hope2 directory.

robocopy c:hope c:hope2 /e

In the above example, all files and folders (including empty ones) are copied from the hope directory to the hope2 directory.

robocopy c:hope c:hope2 /MIR

This example mirrors what’s in c:hope into c:hope2 and purge any files in the hope2 directory that don’t exist in the hope directory. Use the /mir switch cautiously since it is deleting files that do not match in the destination directory.

robocopy \computerhope C:hope2

Next, this example would copy any of the files in the hope directory on the network computer named computer to the current computer hope2 directory.

title	description	ms.topic	ms.assetid	author	ms.author	ms.date
robocopy	Reference article for the robocopy command, which copies file data from one location to another.	reference	d4c6e8e9-fcb3-4a4a-9d04-2d8c367b6354	jasongerend	alalve	01/24/2023

Copies file data from one location to another.

Syntax

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

For example, to copy a file named yearly-report.mov from c:reports to a file share \marketingvideos while enabling multi-threading for higher performance (with the /mt parameter) and the ability to restart the transfer in case it’s interrupted (with the /z parameter), type:

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

[!IMPORTANT]
If any data is copied from the root of a device, the destination directory will adopt the «hidden» attribute during the copy process.

Parameters

Parameter	Description
<source>	Specifies the path to the source directory.
<destination>	Specifies the path to the destination directory.
<file>	Specifies the file or files to be copied. Wildcard characters (* or ?) are supported. If you don’t specify this parameter, *.* is used as the default value.
<options>	Specifies the options to use with the robocopy command, including copy, file, retry, logging, and job options.

Copy options

Option	Description
/s	Copies subdirectories. This option automatically excludes empty directories.
/e	Copies subdirectories. This option automatically includes empty directories.
/lev:<n>	Copies only the top n levels of the source directory tree.
/z	Copies files in restartable mode. In restartable mode, should a file copy be interrupted, Robocopy can pick up where it left off rather than recopying the entire file.
/b	Copies files in backup mode allowing Robocopy to override file and folder permission settings (ACLs). This allow copying of files you might otherwise not have access to assuming it’s being run under an account with sufficient privileges.
/zb	Copies files in restartable mode. If file access is denied, switches to backup mode.
/j	Copies using unbuffered I/O (recommended for large files).
/efsraw	Copies all encrypted files in EFS RAW mode.
/copy:<copyflags>	Specifies which file properties to copy. The valid values for this option are: D — Data A — Attributes T — Time stamps X — Skip alt data streams S — NTFS access control list (ACL) O — Owner information U — Auditing information The default value for the /COPY option is DAT (data, attributes, and time stamps). The X flag will be ignored if either /B or /ZB is used.
/dcopy:<copyflags>	Specifies what to copy in directories. The valid values for this option are: D — Data A — Attributes T — Time stamps E — Extended attribute X — Skip alt data streams The default value for this option is DA (data and attributes).
/sec	Copies files with security (equivalent to /copy:DATS).
/copyall	Copies all file information (equivalent to /copy:DATSOU).
/nocopy	Copies no file information (useful with /purge).
/secfix	Fixes file security on all files, even skipped ones.
/timfix	Fixes file times on all files, even skipped ones.
/purge	Deletes destination files and directories that no longer exist in the source. Using this option with the /e option and a destination directory, allows the destination directory security settings to not be overwritten.
/mir	Mirrors a directory tree (equivalent to /e plus /purge). Using this option with the /e option and a destination directory, overwrites the destination directory security settings.
/mov	Moves files, and deletes them from the source after they are copied.
/move	Moves files and directories, and deletes them from the source after they are copied.
/a+:[RASHCNET]	Adds the specified attributes to copied files. The valid values for this option are: R — Read only A — Archive S — System H — Hidden C — Compressed N — Not content indexed E — Encrypted T — Temporary
/a-:[RASHCNETO]	Removes the specified attributes from copied files. The valid values for this option are: R — Read only A — Archive S — System H — Hidden C — Compressed N — Not content indexed E — Encrypted T — Temporary O — Offline
/create	Creates a directory tree and zero-length files only.
/fat	Creates destination files by using 8.3 character-length FAT file names only.
/256	Turns off support for paths longer than 256 characters.
/mon:<n>	Monitors the source and runs again when more than n changes are detected.
/mot:<m>	Monitors the source and runs again in m minutes if changes are detected.
/rh:hhmm-hhmm	Specifies run times when new copies may be started.
/pf	Checks run times on a per-file (not per-pass) basis.
/ipg:<n>	Specifies the inter-packet gap to free bandwidth on slow lines.
/sj	Copies junctions (soft-links) to the destination path instead of link targets.
/sl	Don’t follow symbolic links and instead create a copy of the link.
/mt:<n>	Creates multi-threaded copies with n threads. n must be an integer between 1 and 128. The default value for n is 8. For better performance, redirect your output using /log option. The /mt parameter can’t be used with the /ipg and /efsraw parameters.
/nodcopy	Copies no directory info (the default /dcopy:DA is done).
/nooffload	Copies files without using the Windows Copy Offload mechanism.
/compress	Requests network compression during file transfer, if applicable.
/sparse	Enables retaining sparse state during copy.

[!IMPORTANT]
When using the /secfix copy option, specify the type of security information you want to copy, using one of these additional copy options:

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

[!NOTE]
The /mt parameter was introduced in Windows Server 2008 R2 and its functionality applies to current versions of Windows Server.

Copy file throttling options

Option	Description
/iomaxsize:<n>[kmg]	The requested max i/o size per read/write cycle in n kilobytes, megabytes, or gigabytes.
/iorate:<n>[kmg]	The requested i/o rate in n kilobytes megabytes, or gigabytes per second.
/threshold:<n>[kmg]	The file size threshold for throttling in n kilobytes, megabytes, or gigabytes (see Remarks).

File selection options

Option	Description
/a	Copies only files for which the Archive attribute is set.
/m	Copies only files for which the Archive attribute is set, and resets the Archive attribute.
/ia:[RASHCNETO]	Includes only files for which any of the specified attributes are set. The valid values for this option are: R — Read only A — Archive S — System H — Hidden C — Compressed N — Not content indexed E — Encrypted T — Temporary O — Offline
/xa:[RASHCNETO]	Excludes files for which any of the specified attributes are set. The valid values for this option are: R — Read only A — Archive S — System H — Hidden C — Compressed N — Not content indexed E — Encrypted T — Temporary O — Offline
/xf <filename>[ ...]	Excludes files that match the specified names or paths. Wildcard characters (* and ?) are supported.
/xd <directory>[ ...]	Excludes directories that match the specified names and paths.
/xc	Excludes existing files with the same timestamp, but different file sizes.
/xn	Source directory files newer than the destination are excluded from the copy.
/xo	Source directory files older than the destination are excluded from the copy.
/xx	Excludes extra files and directories present in the destination but not the source. Excluding extra files will not delete files from the destination.
/xl	Excludes «lonely» files and directories present in the source but not the destination. Excluding lonely files prevents any new files from being added to the destination.
/im	Include modified files (differing change times).
/is	Includes the same files. Same files are identical in name, size, times, and all attributes.
/it	Includes «tweaked» files. Tweaked files have the same name, size, and times, but different attributes.
/max:<n>	Specifies the maximum file size (to exclude files bigger than n bytes).
/min:<n>	Specifies the minimum file size (to exclude files smaller than n bytes).
/maxage:<n>	Specifies the maximum file age (to exclude files older than n days or date).
/minage:<n>	Specifies the minimum file age (exclude files newer than n days or date).
/maxlad:<n>	Specifies the maximum last access date (excludes files unused since n).
/minlad:<n>	Specifies the minimum last access date (excludes files used since n) If n is less than 1900, n specifies the number of days. Otherwise, n specifies a date in the format YYYYMMDD.
/xj	Excludes junction points, which are normally included by default.
/fft	Assumes FAT file times (two-second precision).
/dst	Compensates for one-hour DST time differences.
/xjd	Excludes junction points for directories.
/xjf	Excludes junction points for files.

Retry options

Option	Description
/r:<n>	Specifies the number of retries on failed copies. The default value of n is 1,000,000 (one million retries).
/w:<n>	Specifies the wait time between retries, in seconds. The default value of n is 30 (wait time 30 seconds).
/reg	Saves the values specified in the /r and /w options as default settings in the registry.
/tbd	Specifies that the system will wait for share names to be defined (retry error 67).
/lfsm	Operate in low free space mode which enables copy, pause and resume (see Remarks).
/lfsm:<n>[kmg]	Specifies the floor size in n kilobytes, megabytes, or gigabytes.

Logging options

Option	Description
/l	Specifies that files are to be listed only (and not copied, deleted, or time stamped).
/x	Reports all extra files, not just the ones that are selected.
/v	Produces verbose output, and shows all skipped files.
/ts	Includes source file time stamps in the output.
/fp	Includes the full path names of the files in the output.
/bytes	Prints sizes as bytes.
/ns	Specifies that file sizes are not to be logged.
/nc	Specifies that file classes are not to be logged.
/nfl	Specifies that file names are not to be logged.
/ndl	Specifies that directory names are not to be logged.
/np	Specifies that the progress of the copying operation (the number of files or directories copied so far) will not be displayed.
/eta	Shows the estimated time of arrival (ETA) of the copied files.
/log:<logfile>	Writes the status output to the log file (overwrites the existing log file).
/log+:<logfile>	Writes the status output to the log file (appends the output to the existing log file).
/unilog:<logfile>	Writes the status output to the log file as unicode text (overwrites the existing log file).
/unilog+:<logfile>	Writes the status output to the log file as Unicode text (appends the output to the existing log file).
/tee	Writes the status output to the console window, and to the log file.
/njh	Specifies that there is no job header.
/njs	Specifies that there is no job summary.
/unicode	Displays the status output as unicode text.

Job options

Option	Description
/job:<jobname>	Specifies that parameters are to be derived from the named job file. To run /job:jobname, you must first run the /save:jobname parameter to create the job file.
/save:<jobname>	Specifies that parameters are to be saved to the named job file. This must be ran before running /job:jobname. All copy, retry, and logging options must be specified before this parameter.
/quit	Quits after processing command line (to view parameters).
/nosd	Indicates that no source directory is specified.
/nodd	Indicates that no destination directory is specified.
/if	Includes the specified files.

Remarks

• Using /PURGE or /MIR on the root directory of the volume formerly caused robocopy to apply the requested operation on files inside the System Volume Information directory as well. This is no longer the case as if either is specified, robocopy will skip any files or directories with that name in the top-level source and destination directories of the copy session.

• Modified files classification applies only when both source and destination filesystems support change timestamps, such as NTFS, and the source and destination files have different change times but are otherwise the same. These files are not copied by default. Specify /IM to include them.

• The /DCOPY:E flag requests that extended attribute copying should be attempted for directories. Robocopy will continue if a directory’s EAs could not be copied. This flag is not included in /COPYALL.

• If either /IoMaxSize or /IoRate are specified, robocopy will enable copy file throttling to reduce system load. Both may be adjusted to optimal values and copy parameters, but the system and robocopy are allowed to adjust them to allowed values as necessary.

• If /Threshold is used, it specifies a minimum file size for engaging throttling. Files below that size will not be throttled. Values for all three parameters may be followed by an optional suffix character such as [KMG] (kilo, mega, giga).

• Using /LFSM requests robocopy to operate in ‘low free space mode’. In this mode, robocopy will pause whenever a file copy would cause the destination volume’s free space to go below a ‘floor’ value. This value can be explicitly specified using /LFSM:n[KMG] flag.

• If /LFSM is specified with no explicit floor value, the floor is set to 10% of the destination volume’s size. Low free space mode is incompatible with /MT and /EFSRAW.

Exit (return) codes

Value	Description
0	No files were copied. No failure was encountered. No files were mismatched. The files already exist in the destination directory; therefore, the copy operation was skipped.
1	All files were copied successfully.
2	There are some additional files in the destination directory that are not present in the source directory. No files were copied.
3	Some files were copied. Additional files were present. No failure was encountered.
5	Some files were copied. Some files were mismatched. No failure was encountered.
6	Additional files and mismatched files exist. No files were copied and no failures were encountered meaning that the files already exist in the destination directory.
7	Files were copied, a file mismatch was present, and additional files were present.
8	Several files did not copy.

[!NOTE]
Any value equal to or greater than 8 indicates that there was at least one failure during the copy operation.

Related links

• Command-Line Syntax Key