PowerShell复制源文件夹文件到匹配目标时Destination参数报错如何解决

核心错误点 #

你遇到的问题由3个常见的PowerShell语法和参数使用错误导致：

• 变量引用错误：PowerShell中变量调用使用$前缀，你代码里的%localDirPath是批处理语法，PowerShell无法识别，导致目标路径传参错误
• 缺少强制覆盖参数：默认情况下Copy-Item不会覆盖目标路径下已存在的同名文件，因此更新的文件无法写入，这是你看到路径显示正常但文件没有更新的核心原因
• 缺少目标目录自动创建逻辑：如果目标路径的子目录未提前创建，复制会直接失败，增加容错判断可以避免依赖其他进程提前创建目录

修正后的完整代码 #

$sourcedir = "C:\Unsynchronised\Alpha"
$localdir = "C:\Unsynchronised\Beta"
# 保留local命名是为了后续适配服务器-客户端的使用场景

Get-ChildItem -Path $sourcedir -Recurse -File | ForEach-Object {
    # 拼接目标目录路径
    $localDirPath = Join-Path -Path $localdir -ChildPath $_.DirectoryName.Substring($sourcedir.Length)
    # 拼接目标完整文件路径
    $localDirFile = Join-Path -Path $localDirPath -ChildPath $_.Name

    # 自动创建不存在的目标目录
    if (-not (Test-Path -Path $localDirPath)) {
        New-Item -ItemType Directory -Path $localDirPath -ErrorAction SilentlyContinue | Out-Null
    }

    # 复制文件，加Force参数强制覆盖旧文件
    $_ | Copy-Item -Destination $localDirFile -Force
}

适配说明 #

该代码逻辑同时支持本地路径、网络共享路径（\\服务器地址\共享名格式）的使用场景，后续如果要适配URL源，仅需要修改Get-ChildItem部分为URL文件下载逻辑，路径拼接、目标目录创建、文件覆盖的逻辑都可以直接复用，符合你没有选用Robocopy的扩展需求。

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