PowerShell中用数组/变量配置含/XF的Robocopy参数

问题场景 #

编写PowerShell脚本调用Robocopy时，用数组管理基础参数可正常运行，但添加/XF排除指定文件类型（如.lnk）时，尝试字符串变量、错误数组拼接均报错，直接调用Robocopy不通过变量/数组则正常执行。需要通过数组$robocopyExcludedExtensions实现灵活的多类型排除。

错误原因 #

Robocopy的参数规则是开关（如/XF）与对应的值（如*.lnk）是两个独立的参数项，不能合并为单个字符串或拼接成一个元素传递。之前的错误均是将开关和值合并成了一个参数，导致Robocopy识别为无效参数。

正确实现步骤 #

1. 定义基础参数数组（原有可正常运行的部分） #

$robocopyBaseArguments = @(
    '/S',                   # 复制子目录，排除空目录
    '/ZB',                  # 重启模式复制，访问拒绝时切换到备份模式
    '/COPY:DT',             # 复制文件数据和时间戳属性
    '/XA:SHT',              # 排除系统、隐藏、临时文件
    '/W:1',                 # 重试间隔1秒
    '/R:2'                  # 重试2次
)

2. 定义需要排除的文件扩展名数组 #

可根据需求添加多个扩展名，每个扩展名作为独立元素：

$robocopyExcludedExtensions = @('*.lnk', '*.tmp') # 示例：排除快捷方式和临时文件

3. 构建完整的Robocopy参数数组 #

将源目录、目标目录、基础参数、排除参数、日志参数依次拼接，注意**/XF作为独立参数项，后面跟排除扩展名数组的所有元素**：

# 构建排除相关的参数：先加开关/XF，再追加所有要排除的扩展名
$excludeArgs = @('/XF') + $robocopyExcludedExtensions

# 组合所有参数
$directorySource = "C:\Source"
$directoryTarget = "D:\Target"
$LogPath = "C:\RobocopyLogs\copy.log"
$robocopyArguments = @($directorySource, $directoryTarget) + $robocopyBaseArguments + $excludeArgs + "/LOG+:$LogPath"

4. 调用Robocopy #

使用PowerShell的**数组展开运算符@**传递参数：

Robocopy.exe @robocopyArguments

错误方法解析 #

• 失败方法1（字符串变量）：'/XF "*.lnk"'将开关和值合并为单个字符串，Robocopy会把整个字符串当作无效参数，报ERROR : Invalid Parameter #9 : "/XF "*.lnk""。
• 失败方法2（错误数组拼接）："/XF $robocopyExcludedExtensions"将开关和扩展名拼成单个字符串，同样被Robocopy识别为无效参数，报ERROR : Invalid Parameter #9 : "/xf *.lnk"。

内容的提问来源于stack exchange，提问作者music2myear