XCOPY是COPY的扩展,可以把指定的目录连文件和目录结构一并拷贝,但不能拷贝系统文件;使用时源盘符、源目标路径名、源文件名至少指定一个;选用/S时对源目录下及其子目录下的所有文件进行COPY。除非指定/E参数,否则/S不会拷贝空目录,若不指定/S参数,则XCOPY只拷贝源目录本身的文件,而不涉及其下的子目录;选用/V参数时,对拷贝的扇区都进行较验,但速度会降低。
微软自带解释
XCOPY source [destination] | [/A|/M] [/D[:date]] [/P] [/S [/E]] [/V] [/W] [/C] [/I] [/Q] [/F] [/L] [/G] [/H] [/R] [/T] [/U] [/K] [/N] [/O] [/X] [/Y] [/-Y] [/Z] [/EXCLUDE:file1[+file2][+file3]...] |
---|
source | 指定要复制的文件 |
destination | 指定新文件的位置和/或名称 |
/A | 只复制有存档属性集的文件,但不改变属性 |
/M | 只复制有存档属性集的文件并关闭存档属性。 |
/D:m-d-y | 复制在指定日期或指定日期以后更改的文件。如果没有提供日期,只复制那些源时间比目标时间新的文件。 |
/EXCLUDE:file1[+file2][+file3]… | 指定含有字符串的文件列表。每一个字符串必须在文件的单独行中。如果有任何字符串与要被复制的文件的绝对路径相符,那个文件将不会得到复制。例如,指定如 \obj\ 或 .obj 的字符串会排除目录 obj 下面的所有文件或带有.obj 扩展名的文件。 |
/P | 创建每个目标文件前提示。 |
/S | 复制目录和子目录,除了空的。 |
/E | 复制目录和子目录,包括空的。与 /S /E 相同。可以用来修改 /T。 |
/V | 验证每个新文件。 |
/W | 提示您在复制前按键。 |
/C | 即使有错误,也继续复制。 |
/I | 如果目标不存在,又在复制一个以上的文件,则假定目标一定是一个目录。 |
/Q | 复制时不显示文件名。 |
/F | 复制时显示完整的源和目标文件名。 |
/L | 显示要复制的文件。 |
/G | 允许将没有经过加密的文件复制到不支持加密的目标。 |
/H | 也复制隐藏和系统文件。 |
/R | 覆盖只读文件。 |
/T | 创建目录结构,但不复制文件。不包括空目录或子目录。/T /E 包括空目录和子目录。 |
/U | 只复制已经存在于目标中的文件。 |
/K | 复制属性。一般的 Xcopy 会重置只读属性。 |
/N | 用生成的短名复制。 |
/O | 复制文件所有权和 ACL 信息。 |
/X | 复制文件审核设置(隐含 /O)。 |
/Y | 复制文件审核设置(隐含 /O)。现存目标文件。【就是直接覆盖】 |
/-Y | 导致提示以确认改写一个现存目标文件。 |
/Z | 用重新启动模式复制网络文件。命令行开关 /Y 可以预先在 COPYCMD 环境变量中设置。这可能被命令行上的 /-Y 改写。 |
/B | 复制符号链接本身与链接目标相对。 |
/J | 复制时不使用缓冲的 I/O。推荐复制大文件时使用。 |
语法
XCOPY source [destination] [/A | /M] [/D[:date]] [/P] [/S [/E]] [/V] [/W]
[/C] [/Q] [/F] [/L] [/G] [/H] [/R] [/T] [/U]
[/K] [/N] [/O] [/X] [/Y] [/-Y] [/Z]
[/EXCLUDE:file1[+file2][+file3]...]
参数
destination | explain |
---|
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 命令行选项。 |
/k | 复制文件,如果源文件具有只读属性,则在目标文件中保留该属性。默认情况下,xcopy 会删除只读属性。 |
/r | 复制只读文件。 |
/h | 复制具有隐藏和系统文件属性的文件。默认情况下,xcopy 不复制隐藏或系统文件。 |
/a | 只复制那些具有存档文件属性设置的源文件。/a 不修改源文件的存档文件属性。 |
/m | 复制具有存档文件属性设置的源文件。与 /a 不同,/m 关闭在源中指定的文件的存档文件属性。 |
/n | 使用 NTFS 短文件或目录名创建副本。将文件或目录从 NTFS 卷复制到 FAT 卷或者当目标文件系统需要 FAT 文件系统命名约定(即 8.3 个字符)时,需要 /n。目标文件系统可以是 FAT 或 NTFS。 |
/o | 复制文件所有权与自由选择的访问控制列表(DACL) 信息。 |
/x | 复制文件审核设置和系统访问控制列表(SACL) 信息(包含 /o)。 |
/exclude:filename1 [+[filename2]] [+[filename3]] | 指定包含字符串的文件列表。 |
/y | 禁止提示您确认要覆盖现存的目标文件。 |
/-y | 提示您确认要覆盖现有目标文件。 |
/z | 在可重启模式中通过网络复制。 |
/? | 在命令提示符显示帮助。 |
/t | 只复制子目录结构(即目录树),不复制文件。要复制空目录,必须包含 /e 命令行选项。 |
退出码
要处理 xcopy 返回的退出码,请在批处理程序的 if 命令行上使用 errorlevel 参数。有关使用“if”处理退出码的批处理程序的范例,请参阅“”。下表列出每一个退出码和说明。
退出码 说明
0 文件复制没有错误。
1 没有找到要复制的文件。
2 用户按 CTRL+C 终止了 xcopy。
4 出现了初始化错误。没有足够的内存或磁盘空间,或命令行上输入了无效的驱动器名称或语法。
5 出现了磁盘写入错误。
xcopy /e C:\gpoint\gpointgiftapi C:\Users\wang\Documents\gpointgiftapi