robocopyrobocopy

Копирует данные файла.Copies file data.

СинтаксисSyntax

robocopy <Source> <Destination> [<File>[ ...]] [<Options>]

Например, чтобы скопировать файл с именем еарли-репорт. mov из к:\репортс в общую папку (* \ маркетинг\видеос*) и включить многопоточность для более высокой производительности (с параметром/MT) и возможность перезапуска перемещения в случае его прерывания (с параметром/z), используйте следующий синтаксис:For example, to copy a file named yearly-report.mov from c:\reports to a file share (\marketing\videos) 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), you'd use the following syntax:

robocopy C:\reports '\\marketing\videos' yearly-report.mov /mt /z

Параметры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. При необходимости можно использовать подстановочные знаки (* или ?).You can use wildcard characters (* or ?), if you want. Если параметр файла не указан, в качестве значения по умолчанию используется ** * . * **If the File parameter is not specified, *.* is used as the default value.
<Options> Указывает параметры для использования с командой Robocopy .Specifies options to be used with the robocopy command.

Параметры копированияCopy options

ПараметрOption Описание:Description
/s/s Копирует подкаталоги.Copies subdirectories. Обратите внимание, что этот параметр исключает пустые каталоги.Note that this option excludes empty directories.
/e/e Копирует подкаталоги.Copies subdirectories. Обратите внимание, что этот параметр включает пустые каталоги.Note that this option includes empty directories. Дополнительные сведения см. в разделе Примечания.For additional information, see Remarks.
Лев<N>/lev:<N> Копирует только N верхних уровней исходного дерева каталогов.Copies only the top N levels of the source directory tree.
/z/z Копирование файлов в перезапускаемом режиме.Copies files in restartable mode.
/b/b Копирует файлы в режиме резервного копирования.Copies files in Backup mode.
/zb/zb Использует перезапускаемый режим.Uses restartable mode. Если доступ запрещен, то для этого параметра используется режим резервного копирования.If access is denied, this option uses Backup mode.
/efsraw/efsraw Копирует все зашифрованные файлы в режиме файловой системы EFS RAW.Copies all encrypted files in EFS RAW mode.
/Copy<CopyFlags>/copy:<CopyFlags> Задает свойства файла для копирования.Specifies the file properties to be copied. Ниже приведены допустимые значения для этого параметра.The following are the valid values for this option:
D данныхD Data
АтрибутыA Attributes
Метки времени TT Time stamps
Список управления доступом (ACL) для NTFSS NTFS access control list (ACL)
O сведения о владельцеO Owner information
U . сведения аудитаU Auditing information
Значение по умолчанию для копифлагсdat (данные, атрибуты и метки времени).The default value for CopyFlags is DAT (data, attributes, and time stamps).
/дкопи:<copyflags>/dcopy:<copyflags> Определяет, какие объекты нужно копировать для каталогов.Defines what to copy for directories. Значение по умолчанию — DA.Default is DA. Возможные варианты: D = Data, A = Attributes и T = timestamps.Options are D = data, A = attributes, and T = timestamps.
/сек/sec Копирует файлы с безопасностью (эквивалентно /Copy: DATS).Copies files with security (equivalent to /copy:DATS).
/copyall/copyall Копирует все сведения о файле (эквивалентно /Copy: датсау).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. Дополнительные сведения см. в разделе Примечания.For additional information, see Remarks.
/мир/mir Зеркальное отражение дерева каталогов (эквивалентно /e плюс /пурже).Mirrors a directory tree (equivalent to /e plus /purge). Дополнительные сведения см. в разделе Примечания.For additional information, see Remarks.
/мов/mov Перемещает файлы и удаляет их из источника после копирования.Moves files, and deletes them from the source after they are copied.
/Move/move Перемещает файлы и каталоги и удаляет их из источника после копирования.Moves files and directories, and deletes them from the source after they are copied.
/a +: [РАШКНЕТ]/a+:[RASHCNET] Добавляет указанные атрибуты в скопированные файлы.Adds the specified attributes to copied files.
/а-: [РАШКНЕТ]/a-:[RASHCNET] Удаляет указанные атрибуты из скопированных файлов.Removes the specified attributes from copied files.
/CREATE/create Создает дерево каталогов и только файлы нулевой длины.Creates a directory tree and zero-length files only.
/фат/fat Создает файлы назначения, используя только имена файлов FAT длиной 8,3 символов.Creates destination files by using 8.3 character-length FAT file names only.
/256/256 Отключает поддержку слишком длинных путей (более 256 символов).Turns off support for very long paths (longer than 256 characters).
Понедельник<N>/mon:<N> Отслеживает источник и выполняется снова при обнаружении более N изменений.Monitors the source, and runs again when more than N changes are detected.
/МОТ:<M>/mot:<M> Отслеживание источника и повторный запуск через M минут при обнаружении изменений.Monitors source, and runs again in M minutes if changes are detected.
/MT [: N]/MT[:N] Создает многопоточные копии с N потоками.Creates multi-threaded copies with N threads. Значение N должно быть целым числом от 1 до 128.N must be an integer between 1 and 128. Значение по умолчанию для N равно 8.The default value for N is 8.
Параметр /MT не может использоваться с параметрами /ИПГ и /ефсрав .The /MT parameter cannot be used with the /IPG and /EFSRAW parameters.
Перенаправление вывода с помощью параметра /log для повышения производительности.Redirect output using /LOG option for better performance.
Примечание. параметр/MT применяется к Windows Server 2008 R2 и Windows 7.Note: The /MT parameter applies to Windows Server 2008 R2 and Windows 7.
/РХ: ЧЧММ — ЧЧММ/rh:hhmm-hhmm Указывает время выполнения, когда могут быть запущены новые копии.Specifies run times when new copies may be started.
/PF/pf Проверяет время выполнения для каждого файла (не для каждого прохода).Checks run times on a per-file (not per-pass) basis.
/ИПГ: n/ipg:n Указывает зазор между пакетами для освобождения пропускной способности в медленной линии.Specifies the inter-packet gap to free bandwidth on slow lines.
/сл/sl Не используйте символьные ссылки, а вместо этого создайте копию ссылки.Don't follow symbolic links and instead create a copy of the link.

Важно!

При использовании параметра копирования /секфикс укажите тип сведений, которые необходимо скопировать, с помощью одного из следующих дополнительных параметров копирования: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:O
  • /COPY: S/COPY:S
  • /COPY: U/COPY:U
  • Контекст/SEC

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

ПараметрOption Описание:Description
/a/a Копирует только те файлы, для которых задан атрибут Archive .Copies only files for which the Archive attribute is set.
/m/m Копирует только те файлы, для которых задан атрибут Archive , и сбрасывает атрибут архива .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.
/КСФ <FileName> [...]/xf <FileName>[ ...] Исключает файлы, соответствующие указанным именам или путям.Excludes files that match the specified names or paths. Обратите внимание, что имя файла может содержать подстановочные знаки (* и ?).Note that FileName can include wildcard characters (* and ?).
/КСД <Directory> [...]/xd <Directory>[ ...] Исключает каталоги, соответствующие указанным именам и путям.Excludes directories that match the specified names and paths.
/кск/xc Исключает измененные файлы.Excludes changed files.
/ксн/xn Исключает новые файлы.Excludes newer files.
/ксо/xo Исключает старые файлы.Excludes older files.
/кскс/xx Исключает лишние файлы и каталоги.Excludes extra files and directories.
/ксл/xl Исключает файлы и каталоги "ничего".Excludes "lonely" files and directories.
/is/is Включает одни и те же файлы.Includes the same files.
разрешает/it Включает "оптимизированные" файлы.Includes "tweaked" files.
максимальной<N>/max:<N> Указывает максимальный размер файла (для исключения файлов размером более N байт).Specifies the maximum file size (to exclude files bigger than N bytes).
/min<N>/min:<N> Указывает минимальный размер файла (для исключения файлов размером менее N байт).Specifies the minimum file size (to exclude files smaller than N bytes).
maxAge<N>/maxage:<N> Указывает максимальный возраст файла (для исключения файлов старше N дней или дат).Specifies the maximum file age (to exclude files older than N days or date).
/минаже:<N>/minage:<N> Указывает минимальный возраст файла (исключая файлы более чем N дней или даты).Specifies the minimum file age (exclude files newer than N days or date).
/макслад:<N>/maxlad:<N> Задает максимальную дату последнего доступа (исключает файлы, не используемые с момента N).Specifies the maximum last access date (excludes files unused since N).
/минлад:<N>/minlad:<N> Задает минимальную дату последнего доступа (исключает файлы, используемые после n), если n меньше 1900, N указывает количество дней.Specifies the minimum last access date (excludes files used since N) If N is less than 1900, N specifies the number of days. В противном случае N указывает дату в формате ГГГГММДД.Otherwise, N specifies a date in the format YYYYMMDD.
/ксж/xj Исключает точки соединения, которые обычно включаются по умолчанию.Excludes junction points, which are normally included by default.
/fft/fft Предположение времени файла FAT (двухсекундная точность).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>/r:<N> Указание количества повторных попыток для неудавшихся копий.Specifies the number of retries on failed copies. Значение N по умолчанию равно 1 000 000 (1 000 000 повторных попыток).The default value of N is 1,000,000 (one million retries).
/w<N>/w:<N> Указание времени ожидания между повторными попытками в секундах.Specifies the wait time between retries, in seconds. Значение N по умолчанию равно 30 (время ожидания 30 секунд).The default value of N is 30 (wait time 30 seconds).
/рег/reg Сохраняет значения, указанные в параметрах /r и /w , в качестве параметров по умолчанию в реестре.Saves the values specified in the /r and /w options as default settings in the registry.
/тбд/tbd Указывает, что система будет ожидать определения имен общих ресурсов (ошибка повтора 67).Specifies that the system will wait for share names to be defined (retry error 67).

Параметры ведения журналаLogging options

ПараметрOption Описание:Description
/l/l Указывает, что файлы должны быть перечислены только в списке (а не копировать, удалять или отмечать время).Specifies that files are to be listed only (and not copied, deleted, or time stamped).
/x/x Сообщает все дополнительные файлы, а не только выбранные.Reports all extra files, not just those that are selected.
/v/v Создает подробный вывод и отображает все пропущенные файлы.Produces verbose output, and shows all skipped files.
/тс/ts Включает в выходные данные метки времени исходных файлов.Includes source file time stamps in the output.
/fp/fp Содержит полные имена путей к файлам в выходных данных.Includes the full path names of the files in the output.
/bytes/bytes Выводит размеры в байтах.Prints sizes, as bytes.
/нс/ns Указывает, что размеры файлов не должны записываться в журнал.Specifies that file sizes are not to be logged.
/nc/nc Указывает, что классы файлов не должны регистрироваться.Specifies that file classes are not to be logged.
/nfl/nfl Указание, что имена файлов не должны регистрироваться.Specifies that file names are not to be logged.
/ndl/ndl Указание, что имена каталогов не должны регистрироваться.Specifies that directory names are not to be logged.
/np/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>/log:<LogFile> Запись выходных данных о состоянии в файл журнала (перезапись существующего файла журнала).Writes the status output to the log file (overwrites the existing log file).
/log +:<LogFile>/log+:<LogFile> Записывает выходные данные состояния в файл журнала (Добавляет выходные данные в существующий файл журнала).Writes the status output to the log file (appends the output to the existing log file).
/unicode/unicode Отображает вывод состояния в виде текста в Юникоде.Displays the status output as Unicode text.
/унилог:<LogFile>/unilog:<LogFile> Записывает выходные данные состояния в файл журнала в виде текста в Юникоде (перезаписывает существующий файл журнала).Writes the status output to the log file as Unicode text (overwrites the existing log file).
/унилог +:<LogFile>/unilog+:<LogFile> Записывает выходные данные состояния в файл журнала в виде текста в Юникоде (Добавляет выходные данные в существующий файл журнала).Writes the status output to the log file as Unicode text (appends the output to the existing log file).
/tee/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
/Задание<JobName>/job:<JobName> Указывает, что параметры должны быть производными от файла именованного задания.Specifies that parameters are to be derived from the named job file.
/Save<JobName>/save:<JobName> Указывает, что параметры должны быть сохранены в файле именованного задания.Specifies that parameters are to be saved to the named job file.
/куит/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/if Включает указанные файлы.Includes the specified files.

Коды выхода (Return)Exit (return) codes

ЗначениеValue Описание:Description
00 Файлы не были скопированы.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.
11 Все файлы успешно скопированы.All files were copied successfully.
22 В целевом каталоге имеются дополнительные файлы, отсутствующие в исходном каталоге.There are some additional files in the destination directory that are not present in the source directory. Файлы не были скопированы.No files were copied.
33 Некоторые файлы были скопированы.Some files were copied. Имеются дополнительные файлы.Additional files were present. Сбой не обнаружен.No failure was encountered.
55 Некоторые файлы были скопированы.Some files were copied. Некоторые файлы не совпали.Some files were mismatched. Сбой не обнаружен.No failure was encountered.
66 Существуют дополнительные файлы и несоответствующие файлы.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.
77 Файлы были скопированы, обнаружено несоответствие файлов, и имеются дополнительные файлы.Files were copied, a file mismatch was present, and additional files were present.
88 Не удалось скопировать несколько файлов.Several files did not copy.

Примечание

Любое значение больше 8 указывает, что во время операции копирования существовала хотя бы одна ошибка.Any value greater than 8 indicates that there was at least one failure during the copy operation.

RemarksRemarks

  • Параметр /мир равнозначен параметру /e Plus /пурже с одним небольшим различием в поведении:The /mir option is equivalent to the /e plus /purge options with one small difference in behavior:
    • Если задан параметр /e плюс /пурже , то при наличии конечного каталога параметры безопасности каталога назначения не перезаписываются.With the /e plus /purge options, if the destination directory exists, the destination directory security settings are not overwritten.
    • При использовании параметра /мир , если каталог назначения существует, параметры безопасности каталога назначения перезаписываются.With the /mir option, if the destination directory exists, the destination directory security settings are overwritten.

Дополнительные ссылкиAdditional References