HOWTO · PowerShell
使用 Robocopy 和参数传递的 PowerShell
了解如何从 PowerShell 使用 robocopy 复制文件和目录,包括如何将选项作为单独参数传递。
本页内容
在 PowerShell 中复制文件或目录时,使用 Windows 自带的 robocopy 实用程序,并指定源目录、目标目录,以及所需的文件筛选条件或选项。下面的命令格式展示了这些参数的排列方式;PowerShell 示例则说明如何将多个选项分别传入。
在 PowerShell 中使用 robocopy 命令复制文件
命令格式为 robocopy <Source> <Destination> [<File(s)>] [<Options>]。源和目标都必须是目录。可选的文件筛选参数可以指定一个或多个文件,也可以使用匹配模式;选项则用于控制复制行为。Robocopy 是 Windows 命令行实用程序,因此请在装有 robocopy.exe 的 Windows 系统上运行此命令。
例如,下面的命令会将一个目录中的 report.txt 复制到另一个目录,并隐藏 Robocopy 的作业标题和作业摘要:
robocopy C:\Work\Source C:\Work\Backup report.txt /njh /njs
请将示例中的路径和文件名替换为计算机上实际存在的位置。若要复制目录树,请省略文件筛选参数,并将选项放在目标目录之后。Robocopy 会复制指定目录中的文件;可根据需要使用 /S 或 /E 等选项包含子目录。请确认预期文件已到达目标位置,并查看 Robocopy 的报告,再将复制结果用于备份或同步任务。
此 PowerShell 示例将各个选项分别放入数组元素,并显示可通过 splatting 传入命令调用的列表:
$options = @('/njh', '/njs')
"Options passed: $($options -join ', ')"
Options passed: /njh, /njs
在 PowerShell 中调用外部程序时,使用数组 splatting 会将每个数组元素作为独立参数传递。例如,将 $source、$destination 和 $file 设置为所需的路径和文件名后,可以调用 & robocopy $source $destination $file @options。该调用需要 Windows 和 Robocopy,因此这里以内联形式展示,不包含在可移植的数组示例中。
避免将多个选项存入同一个字符串,例如 '/njh /njs':PowerShell 会将整个值作为一个参数传递。对简单开关来说,按空格拆分字符串可能可行,但这并不是通用的参数解析方式。如果某个值包含空格或使用了引号,单靠空白字符无法确定参数应如何分组,因此拆分可能出错。建议使用数组,并让每个元素包含一个完整参数。
你可以将更多开关分别添加为数组元素,也可以使用 *.txt 之类的匹配模式筛选文件。请检查已复制的文件,并依据 Robocopy 文档中定义的退出代码含义判断其报告结果:低于 8 表示未报告复制失败,8 或更高则表示至少发生了一次失败。如需了解选项和退出代码的详细信息,请参阅 Microsoft 的 Robocopy 命令参考。
结论
在 PowerShell 中使用 robocopy 时,先指定源目录和目标目录,再按需提供文件筛选条件和选项。将多个选项分别放入数组并使用 splatting 传入,确保每个选项都作为独立参数到达 Robocopy。请核对复制的文件,并查看 Robocopy 报告的结果。