复制文件和目录,包括子目录。
xcopy Source [Destination]
准备复制文件时,请按任意键
列出每个文件的单独行中的每个字符串。如果列出的任何字符串与要复制的文件的绝对路径的任何部分匹配,就从复制进程排除该文件。例如,如果指定字符串 "\Obj\",则会排除 Obj 目录下的所有文件。如果指定字符串 ".obj",则排除具有 .obj 扩展名的所有文件。
如果在复制过程中丢失连接(例如,如果用于连接的服务器脱机),复制过程将在重新建立连接后恢复。/z 也显示每个文件完成的复制操作的百分比。
可在 COPYCMD 环境变量中使用 /y。在命令行上使用 /-y 可以覆盖该命令。默认情况下,会提示您覆盖,除非您从批处理脚本内运行 copy。
将加密文件复制到不支持 EFS 的卷会导致错误。应首先解密文件或将文件复制到支持 EFS 的卷中。
要附加文件,请指定单个目标文件,多个源文件(使用通配符或文件 1 + 文件 2 + 文件 3 格式)。
如果省略 Destination,则 xcopy 命令将文件复制到当前目录。
如果 Destination 不包含现有目录且不以反斜杠 (\) 结尾,会出现下列消息:
目标 xcop 是文件名
还是目录名
(F = file, D = directory)?
如果要将一个或多个文件复制到一个文件,请按 F。如果要将一个或多个文件复制到一个目录,请按 D。
使用 /i 命令行选项可抑制显示该消息,从而导致 xcopy 认定在源是多个文件或一个目录的情况下,目标是一个目录。
xcopy 命令创建具有存档属性设置的文件,无论源文件中是否设定了此属性。有关文件属性和 attrib 的详细信息,请参阅“相关主题”。
如果磁盘的子目录中包含文件,要将其复制到具有不同格式的磁盘中,请使用 xcopy 命令,而不要使用 diskcopy。因为 diskcopy 命令是一个磁道接一个磁道地复制磁盘,所以需要源磁盘和目标磁盘的格式必须相同。xcopy 命令没有该要求。通常情况下请使用 xcopy,除非您需要完整的磁盘图像副本。
要处理 xcopy 返回的退出代码,请在批处理程序的 if 命令行上使用 ErrorLevel 参数。有关使用 if 处理退出代码的批处理程序的示例,请参阅“相关主题”。下表列出每一个退出代码和描述。
退出代码 | 描述 |
---|---|
0 | 文件复制没有错误。 |
1 | 没有找到要复制的文件。 |
2 | 用户按 Ctrl+C 终止了 xcopy。 |
4 | 出现了初始化错误。没有足够的内存或磁盘空间,或命令行上输入了无效的驱动器名称或语法。 |
5 | 出现了磁盘写入错误。 |
要从驱动器 A 将所有文件和子目录(包括所有空的子目录)复制到驱动器 B,请键入:
xcopy a: b: /s /e
要包含上一示例中的任何系统或隐藏文件,请按如下所示添加 /h 命令行选项:
xcopy a: b: /s /e /h
要使用 \Rawdata 目录中 1993 年 12 月 29 日后更改的文件更新 \Reports 目录中的文件,请键入:
xcopy \rawdata \reports /d:12-29-1993
要更新上例中 \Reports 中存在的所有文件而不考虑日期,请键入:
xcopy \rawdata \reports /u
要获得前一个命令要复制的文件列表而不复制文件,请键入:
xcopy \rawdata \reports /d:12-29-1993 /l > xcopy.out
文件 Xcopy.out 列出了要复制的所有文件。
要将 \Customer 目录和所有子目录复制到网络驱动器 H: 上的目录 \\Public\Address,保留只读属性,并在 H: 上创建新文件时对您做出提示,请键入:
xcopy \customer h:\public\address /s /e /k /p
要发出上一个命令,确保在 \Address 目录不存在时 xcopy 会创建该目录,同时应抑制显示创建新目录时要显示的消息,请按如下所示添加 /i 命令行选项:
xcopy \customer h:\public\address /s /e /k /p /i
可以创建批处理程序执行 xcopy 操作,并且使用 if 批处理命令在发生错误时处理退出代码。例如,以下的批处理程序使用可替换的 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:
命令解释程序用 %1 替换 C:\Prgmcode,用 %2 替换 B:,然后使用带有 /e 和 /s 命令行选项的 xcopy 命令。如果 xcopy 遇到错误,批处理程序将读取退出代码并转到相应 IF ERRORLEVEL 语句中指示的标签,然后显示相应的消息并退出批处理程序。
格式 | 含义 |
---|---|
斜体 | 用户必须提供的信息 |
粗体 | 用户必须准确键入的要显示的元素 |
省略号 (...) | 在命令行中可多次重复的参数 |
中括号 ([]) | 可选项 |
大括号 ({});选项用竖线 (|) 分隔。例如:{even|odd} | 用户必须从选项集合中选择一个 |
Courier 字体 | 代码或程序输出 |