xcopy-参数详解

XCOPY——目录复制命令 
1．功能：复制指定的目录和目录下的所有文件连同目录结构。 
2．类型：外部命令 
3．格式：XCOPY [源盘：]〈源路径名〉[目标盘符：][目标路径名][/S][/V][/E] 
4．使用说明： 
（1）XCOPY是COPY的扩展，可以把指定的目录连文件和目录结构一并拷贝，但不能拷贝隐藏文件和系统文件； 
（2）使用时源盘符、源目标路径名、源文件名至少指定一个； 
（3）选用/S时对源目录下及其子目录下的所有文件进行COPY。除非指定/E参数，否则/S不会拷贝空目录，

若不指定/S参数，则XCOPY只拷贝源目录本身的文件，而不涉及其下的子目录； 
（4）选用/V参数时，对的拷贝的扇区都进行较验，但速度会降低。

 

Xcopy

复制文件和目录，包括子目录。

语法

xcopySource [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]

参数

Source

必需。指定要复制的文件的位置和名称。该参数必须包含驱动器或路径。

Destination

指定要复制的文件的目标。该参数可以包含驱动器号和冒号、目录名、文件名或者它们的组合。

/w

在开始复制文件之前将显示以下消息并等待您的响应：

Press any key to begin copying file(s)

/p

提示您确认是否要创建每个目标文件。

/c

忽略错误。

/v

在写入目标文件时验证每个文件，以确保目标文件与源文件完全相同。

/q

禁止显示“xcopy”的消息。

/f

复制时显示源文件名和目标文件名。

/l

显示要复制的文件列表。

/g

创建已解密的目标文件。

/d [:MM-DD-YYYY]

只复制那些在指定日期或指定日期之后更改过的源文件。如果不包括“MM-DD-YYYY”值，“xcopy”会复制比现有“Destination”文件新的所有“Source”文件。该命令行选项使您可以更新更改过的文件。

/u

只从“Source”复制“Destination”中已有的文件。

/i

如果“Source”是一个目录或包含通配符，而“Destination”不存在，“xcopy”会假定“destination”指定目录名并创建一个新目录。然后，“xcopy”会将所有指定文件复制到新目录中。默认情况下，“xcopy”将提示您指定“Destination”是文件还是目录。

/s

复制非空的目录和子目录。如果省略“/s”，则“xcopy”将在单个目录中工作。

/e

复制所有子目录，包括空目录。将“/e”与“/s”和“/t”命令行选项一起使用。

/t

只复制子目录结构（即目录树），不复制文件。要复制空目录，必须包含“/e”命令行选项。

/k

复制文件，如果源文件具有只读属性，则在目标文件中保留该属性。默认情况下，“xcopy”将删除只读属性。

/r

复制只读文件。

/h

复制具有隐藏和系统文件属性的文件。默认情况下，“xcopy”不复制隐藏或系统文件。

/a

只复制那些具有存档文件属性设置的源文件。“/a”不修改源文件的存档文件属性。有关如何通过使用“attrib”来设置存档文件属性的信息，请参阅“相关主题”。

/m

复制具有存档文件属性设置的源文件。与“/a”不同，“/m”关闭在源中指定的文件的存档文件属性。有关如何通过使用“attrib”来设置存档文件属性的信息，请参阅“相关主题”。

/n

使用 NTFS 短文件或目录名创建副本。将文件或目录从 NTFS 卷复制到 FAT 卷或者当目标文件系统需要 FAT 文件系统命名约定（即 8.3 字符）时，需要“/n”。目标文件系统可以是 FAT 或 NTFS。

/o

复制文件所有权与随机访问控制列表 (DACL) 信息。

/x

复制文件审核设置和系统访问控制列表 (SACL) 信息（包含“/o”）。

/exclude:FileName1[+[ FileName2]][+[FileName3]]

指定包含字符串的文件列表。

/y

禁止提示确认要覆盖已存在的目标文件。

/-y

提示您确认要覆盖已存在的目标文件。

/z

在可重启模式中通过网络复制。

/?

在命令提示符显示帮助。

注释

•

使用“/v”

Windows XP 和 Windows Server 2003 家族产品不使用该命令。只为了与现有的 MS-DOS 文件保持兼容性才包含此命令，但是因为其功能是自动实现的，所以在命令行使用时不起作用。

•

使用“/exclude”

在每个文件的单独一行中的列出每个字符串。如果列出的任何字符串与要复制的文件的绝对路径的任何部分匹配，就从复制进程排除该文件。例如，如果指定字符串 "/Obj/"，则会排除 Obj 目录下的所有文件。如果指定字符串 ".obj"，则排除具有 .obj 扩展名的所有文件。

•

使用“/z”

如果在复制过程中丢失连接（例如，如果用于连接的服务器脱机），复制过程将在重新建立连接后恢复。“/z”也显示每个文件完成的复制操作的百分比。

•

在 COPYCMD 环境变量中使用“/y”

可在 COPYCMD 环境变量中使用“/y”。在命令行上使用“/-y”可以覆盖该命令。默认情况下，会提示您覆盖，除非您从批处理脚本内运行“copy”。

•

复制加密的文件

将加密文件复制到不支持 EFS 的卷会导致错误。应首先解密文件或将文件复制到支持 EFS 的卷中。

•

追加文件

要追加文件，请指定单个目标文件，多个源文件（使用通配符或 file1+file2+file3 格式）。

•

“Destination”的默认值

如果省略“Destination”，则“xcopy”命令将文件复制到当前目录。

•

指定“Destination”是文件还是目录

如果“Destination”不包含现有目录且不以反斜杠 (/) 结尾，会出现下列消息：

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

如果要将一个或多个文件复制到一个文件，请按 F。如果要将一个或多个文件复制到一个目录，请按 D。

使用“/i”命令行选项可禁止显示该消息，从而导致“xcopy”认定在源是多个文件或一个目录的情况下，目标是一个目录。

•

使用“xcopy”命令设置“Destination”文件的存档属性

“xcopy”命令创建具有存档属性设置的文件，无论源文件中是否设定了此属性。有关文件属性和“attrib”的详细信息，请参阅“相关主题”。

•

比较“xcopy”和“diskcopy”

如果磁盘的子目录中包含文件，要将其复制到具有不同格式的磁盘中，请使用“xcopy”命令，而不要使用“diskcopy”。因为“diskcopy”命令是一个磁道接一个磁道地复制磁盘，所以需要源磁盘和目标磁盘的格式必须相同。“xcopy”命令没有这个要求。通常情况下请使用“xcopy”，除非您需要完整的磁盘映像副本。

•

“xcopy”的退出代码

要处理“xcopy”返回的退出代码，请在批处理程序的“if”命令行上使用“ErrorLevel”参数。有关使用“if”处理退出码的批处理程序的示例，请参阅“相关主题”。下表列出每一个退出代码和描述。

退出代码	描述
0	文件复制没有错误。
1	没有找到要复制的文件。
2	用户按 Ctrl+C 终止了“xcopy”。
4	出现了初始化错误。没有足够的内存或磁盘空间，或命令行上输入了无效的驱动器名称或语法。
5	出现了磁盘写入错误。