Windows Server 2016上PowerShell v5.1通配符遍历用户目录失效问题

问题诊断 #

1. 通配符遍历失效：Windows Server 2016搭载的PowerShell 5.1对嵌套通配符（如E:\storage\*\Microsoft\appdata\teams\system worker\cache）的解析支持有限，直接用该路径调用Get-ChildItem无法正确匹配多层级目录结构。
2. 脚本逻辑错误：
   • 变量名拼写错误：$TargerFolder应为$TargetFolder
   • if条件误用赋值运算符=，而非比较运算符（如-eq、Test-Path）
3. CSV导入异常：大概率是CSV格式不符合要求（如缺少表头、路径列名不匹配），或导入时未正确指定参数导致路径读取失败。

分步解决方案 #

1. 修复通配符路径遍历逻辑 #

放弃直接使用嵌套通配符，改为先枚举上层用户目录，再拼接完整缓存路径：

# 先获取E:\storage下的所有用户目录
$userDirs = Get-ChildItem -Path "E:\storage" -Directory

# 遍历每个用户目录，拼接Teams缓存路径
foreach ($userDir in $userDirs) {
    $cachePath = Join-Path -Path $userDir.FullName -ChildPath "Microsoft\appdata\teams\system worker\cache"
    if (Test-Path -Path $cachePath) {
        # 后续处理缓存目录
    }
}

2. 修正脚本基础逻辑错误 #

• 统一变量名：将所有$TargerFolder替换为$TargetFolder
• 修正if条件：比如判断目录是否存在时，用Test-Path而非赋值操作：

  # 错误写法
  if ($TargerFolder = "某个路径") { ... }
  
  # 正确写法
  if (Test-Path -Path $TargetFolder) { ... }
  

3. 修复CSV导入问题 #

确保CSV格式正确（示例格式）：

Path
E:\storage\user1\Microsoft\appdata\teams\system worker\cache
E:\storage\user2\Microsoft\appdata\teams\system worker\cache

导入CSV时指定正确的表头：

# 如果CSV有表头"Path"，直接导入
$csvPaths = Import-Csv -Path "C:\scripts\cache_paths.csv"

# 如果CSV无表头，手动指定
$csvPaths = Import-Csv -Path "C:\scripts\cache_paths.csv" -Header "Path"

4. 完善操作日志（Transcript） #

添加可靠的日志记录逻辑，避免日志覆盖：

# 设置日志路径，建议用日期命名避免覆盖
$logPath = "C:\scripts\TeamsCacheCleanup_$(Get-Date -Format 'yyyyMMdd').log"
Start-Transcript -Path $logPath -Append -IncludeInvocationHeader

# 脚本核心逻辑...

Stop-Transcript

优化后的完整脚本 #

<#
.SYNOPSIS
清理Teams系统工作进程缓存文件，支持CSV导入路径、操作日志记录
#>

# 配置参数
$csvPath = "C:\scripts\cache_paths.csv"  # CSV路径
$daysToKeep = 0  # 保留当日及以后的文件，删除早于当日的
$logPath = "C:\scripts\TeamsCacheCleanup_$(Get-Date -Format 'yyyyMMdd').log"

# 启动日志记录
Start-Transcript -Path $logPath -Append -IncludeInvocationHeader

# 导入CSV路径
try {
    $targetPaths = Import-Csv -Path $csvPath | Select-Object -ExpandProperty Path
    Write-Host "成功导入$($targetPaths.Count)条缓存路径"
}
catch {
    Write-Error "CSV导入失败：$_"
    Stop-Transcript
    exit 1
}

# 遍历所有目标路径，清理过期文件
foreach ($path in $targetPaths) {
    if (-not (Test-Path -Path $path)) {
        Write-Warning "路径不存在：$path"
        continue
    }

    Write-Host "开始清理路径：$path"
    # 获取早于当日的文件
    $oldFiles = Get-ChildItem -Path $path -File -Recurse | Where-Object { $_.LastWriteTime -lt (Get-Date).Date }

    if ($oldFiles.Count -eq 0) {
        Write-Host "路径下无过期文件：$path"
        continue
    }

    # 删除文件（测试时加-WhatIf确认）
    $oldFiles | Remove-Item -Force -WhatIf
    Write-Host "已删除$($oldFiles.Count)个过期文件：$path"
}

# 停止日志记录
Stop-Transcript

额外注意事项 #

• 权限要求：脚本需以管理员权限运行，确保能访问所有用户的Teams缓存目录
• 定时任务配置：通过Windows任务计划程序设置每日/每周触发，选择“不管用户是否登录都要运行”，并配置最高权限
• 测试建议：首次运行时保留-WhatIf参数，确认待删除文件列表无误后再移除
• 路径兼容：如果部分用户目录不存在Teams缓存路径，脚本会自动跳过并记录警告

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