xcopy

Копирует файлы и каталоги, включая вложенные каталоги.

В разделе Примеры показан принцип использования этой команды.

Синтаксис

xcopy <Source> [<Destination>] [/w] [/p] [/c] [/v] [/q] [/f] [/l] [/g] [/d [:MM-DD-YYYY]] [/u] [/i] [/s [/e]] [/t] [/k] [/r] [/h] [{/a | /m}] [/n] [/o] [/x] [/exclude:FileName1[+[FileName2]][+[FileName3]]] [{/y | /-y}] [/z] [/b] [/j] [/compress]

Параметры

Замечания

• Использование /z

  Если вы потеряете подключение во время этапа копирования (например, если сервер будет отключен, он возобновляется после повторного завершения подключения. /z также отображает процент операции копирования, завершенной для каждого файла.

• Использование /y в переменной среды COPYCMD.

  Можно использовать /y в переменной среды COPYCMD. Эту команду можно переопределить с помощью /-y в командной строке. По умолчанию вам будет предложено перезаписать.

• Копирование зашифрованных файлов

  Копирование зашифрованных файлов в том, который не поддерживает EFS, приводит к ошибке. Расшифруйте файлы сначала или скопируйте их в том, поддерживающий EFS.

• Добавление файлов

  Чтобы добавить файлы, укажите один файл для назначения, но несколько файлов для источника (т. е. с помощью wild карта s или file1+file2+file3 format).

• Значение по умолчанию для назначения

  Если опустить назначение, xcopy команда копирует файлы в текущий каталог.

• Указание того, является ли назначение файлом или каталогом

  Если назначение не содержит существующий каталог и не заканчивается обратной косой чертой (), появится следующее сообщение:

  Does <Destination> specify a file name or directory name on the target(F = file, D = directory)?
  

  Нажмите клавишу F, если нужно, чтобы файл или файлы были скопированы в файл. Нажмите клавишу D, если требуется, чтобы файл или файлы были скопированы в каталог.

  Это сообщение можно отключить с помощью параметра командной строки /i , что приводит xcopy к тому, что назначение является каталогом, если источник имеет несколько файлов или каталогов.

• xcopy Использование команды для задания атрибута архива для целевых файлов

  Команда xcopy создает файлы с набором атрибутов архива, независимо от того, был ли этот атрибут задан в исходном файле. Дополнительные сведения об атрибутах файла и атрибутах см. в статьях "Связанные ссылки".

• xcopy Сравнение иdiskcopy

  Если у вас есть диск, содержащий файлы в подкаталогах, и вы хотите скопировать его на диск с другим форматом, используйте xcopy команду вместо diskcopyэтого. diskcopy Так как команда копирует диски, отслеживаемые по треку, исходные и целевые диски должны иметь одинаковый формат. Эта xcopy команда не имеет этого требования. Используйте xcopy , если вам не нужна полная копия образа диска.

• Ошибка "Недостаточно памяти"

  Ошибка "недостаточно памяти" может возникать при выполнении xcopy копирования файла или папки, путь к имени файла которого превышает 255 символов.

• Коды выхода для xcopy

  Чтобы обработать коды выхода, возвращаемыеxcopy, используйте параметр ErrorLevel в командной строке в пакетной программе. Пример пакетной программы, которая обрабатывает коды выхода, используя если, см. ссылки на связанные. В следующей таблице перечислены код выхода и описание.

  Код выхода	Description
  0	Файлы были скопированы без ошибок.
  1	Никакие файлы не были найдены для копирования.
  2	Пользователь нажимал клавиши CTRL+C, чтобы завершить работу xcopy.
  4	Произошла ошибка инициализации. Недостаточно памяти или места на диске, или в командной строке введено недопустимое имя диска или недопустимый синтаксис.
  5	Произошла ошибка записи диска.

Примеры

1. Копирование всех файлов и подкаталогов (включая все пустые подкаталоги) с диска A на диск B, введите:

xcopy a: b: /s /e

2. Чтобы включить любые системные или скрытые файлы в предыдущем примере, добавьте параметр командной строки /h следующим образом:

xcopy a: b: /s /e /h

3. Чтобы обновить файлы в каталоге \Reports с файлами в каталоге \Rawdata, которые изменились с 29 декабря 1993 года, введите:

xcopy \rawdata \reports /d:12-29-1993

4. Чтобы обновить все файлы, существующие в \Reports в предыдущем примере, независимо от даты, введите:

xcopy \rawdata \reports /u

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

xcopy \rawdata \reports /d:12-29-1993 /l > xcopy.out

Файл xcopy.out выводит список всех файлов, которые необходимо скопировать.

6. Копирование каталога \Customer и всех подкаталогов в каталог \\Public\Address на сетевом диске H:, сохранение атрибута только для чтения и запрос при создании нового файла в H:, введите:

xcopy \customer h:\public\address /s /e /k /p

7. Чтобы выполнить предыдущую команду, убедитесь, что xcopy создается каталог \Address, если он не существует, и отключите сообщение, которое отображается при создании нового каталога, добавьте параметр командной строки /i следующим образом:

xcopy \customer h:\public\address /s /e /k /p /i

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

@echo off
rem COPYIT.BAT transfers all files in all subdirectories of
rem the source drive or directory (%1) to the destination
rem drive or directory (%2)
xcopy %1 %2 /s /e
if errorlevel 4 goto lowmemory
if errorlevel 2 goto abort
if errorlevel 0 goto exit
:lowmemory
echo Insufficient memory to copy files or
echo invalid drive or command-line syntax.
goto exit
:abort
echo You pressed CTRL+C to end the copy operation.
goto exit
:exit

Чтобы использовать предыдущую пакетную программу для копирования всех файлов в каталогЕ C:\Prgmcode и его подкаталогах на диск B, введите следующее:

copyit c:\prgmcode b:

Интерпретатор команд заменяет C:\Prgmcode для %1 и B: для %2, а затем используется xcopy с параметрами командной строки /e и /s . Если xcopy возникает ошибка, пакетная программа считывает код выхода и переходит к метке, указанной в соответствующей инструкции IF ERRORLEVEL , затем отображает соответствующее сообщение и выходит из пакетной программы.

9. В этом примере копируются все непустые каталоги, а также файлы с соответствующим расширением файла после символа звездочки.

xcopy .\toc*.yml ..\..\Copy-To\ /S /Y

rem Output example.
rem  .\d1\toc.yml
rem  .\d1\d12\toc.yml
rem  .\d2\toc.yml
rem  3 File(s) copied

В предыдущем примере это конкретное значение параметра источника .\toc*.yml копирует те же 3 файла, даже если были удалены два символа пути. Однако никакие файлы не будут скопированы, если звездочка дикая карта была удалена из исходного параметра, что делает его просто .\toc.yml.

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

• Копировать
• Передвинуть
• Dir
• Attrib
• Diskcopy
• If
• Условные обозначения синтаксиса команд командной строки