筛选以E开头用户文件夹的PowerShell迁移脚本问题排查

一、筛选E开头用户文件夹的错误解决 #

你之前的代码报错是因为Get-ChildItem的-Filter参数不支持脚本块（{name -like "e*"}），该参数仅接受系统原生的通配符字符串，传入脚本块会被解析为路径的一部分，导致“非法字符”错误。

正确写法二选一： #

1. 直接用-Filter指定通配符（性能更优，文件系统层面直接过滤）：

$users = Get-ChildItem "\\$Computer\c$\users" -Filter "e*" | Select-Object -ExpandProperty Name

2. 用Where-Object做灵活过滤（适合复杂匹配规则，比如区分大小写）：

# 不区分大小写匹配e/E开头
$users = Get-ChildItem "\\$Computer\c$\users" | Where-Object { $_.Name -like "e*" } | Select-Object -ExpandProperty Name

# 严格匹配大写E开头（加-CaseSensitive）
$users = Get-ChildItem "\\$Computer\c$\users" | Where-Object { $_.Name -clike "E*" } | Select-Object -ExpandProperty Name

二、权限问题与文件夹排除优化 #

My Music/My Pictures/My Videos无法复制的核心原因是：这些是系统创建的符号链接（Junction Points），并非真实文件夹，且默认权限限制了访问。直接忽略错误会掩盖其他潜在问题，建议用以下方案替代：

1. 跳过符号链接复制 #

复制Documents文件夹时，先过滤掉符号链接：

$sourceDocs = Get-ChildItem "\\$Computer\c$\users\$user\Documents" -Force | Where-Object { !$_.LinkType }
$sourceDocs | Copy-Item -Destination "\\serverpath\$user\Documents" -Recurse -Force -ErrorAction Stop

-Force用于显示隐藏的符号链接，!$_.LinkType筛选出非链接的真实文件/文件夹。

2. 用Robocopy替代Copy-Item（推荐） #

Robocopy是Windows原生专业迁移工具，更适配权限处理、符号链接场景，支持直接排除指定文件夹：

robocopy "\\$Computer\c$\users\$user\Desktop" "\\serverpath\$user\Desktop" /E /COPYALL /R:3 /W:5
robocopy "\\$Computer\c$\users\$user\Downloads" "\\serverpath\$user\Downloads" /E /COPYALL /R:3 /W:5
robocopy "\\$Computer\c$\users\$user\Documents" "\\serverpath\$user\Documents" /E /COPYALL /XD "My Music" "My Pictures" "My Videos" /R:3 /W:5

参数说明：

• /E：复制所有子目录（包括空目录）
• /COPYALL：复制文件的所有属性、权限、时间戳
• /XD：排除指定文件夹
• /R:3：失败后重试3次
• /W:5：重试间隔5秒

三、脚本整体优化建议 #

• 预检查目标路径：迁移前自动创建服务器端用户文件夹，避免因路径不存在导致复制失败：

foreach ($user in $users) {
    $targetPath = "\\serverpath\$user"
    if (-not (Test-Path $targetPath)) {
        New-Item -ItemType Directory -Path $targetPath -Force | Out-Null
    }
    # 执行复制逻辑...
}

• 添加日志记录：将每个用户的迁移结果写入日志文件，便于后续排查：

$logPath = "C:\MigrationLogs\$(Get-Date -Format 'yyyyMMdd').log"
foreach ($user in $users) {
    try {
        # 复制逻辑...
        "$(Get-Date -Format 'HH:mm:ss') - 成功迁移用户：$user" | Add-Content $logPath
    }
    catch {
        "$(Get-Date -Format 'HH:mm:ss') - 迁移用户$user失败：$($_.Exception.Message)" | Add-Content $logPath
    }
}

• 权限预处理：确保运行脚本的账号拥有本地用户文件夹的读取权限，可临时获取权限（谨慎使用，避免破坏原有权限）：

$localUserPath = "\\$Computer\c$\users\$user"
TakeOwn /F $localUserPath /R /D Y
icacls $localUserPath /grant "$env:USERDOMAIN\$env:USERNAME":F /T

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