PowerShell文件移动脚本故障排查：无法移动已有文件等问题

问题1：文件移动速度极慢 #

• 原因：脚本未使用定义的服务账号执行移动操作，沿用当前运行上下文权限；且文件尚未完全写入磁盘就触发移动，导致等待文件释放锁的额外耗时。
• 修复：使用Invoke-Command以指定服务账号身份执行移动；添加文件就绪检测逻辑，确保文件写入完成后再处理。

问题2：无法移动已存在的文件 #

• 原因：Move-Item默认遇到目标路径存在同名文件时会终止操作并报错。
• 修复：添加-Force参数强制覆盖目标文件，或按需实现文件名重命名逻辑（如追加时间戳）。

问题3：重复生成5条日志（同一文件被多次触发移动） #

• 原因：FileSystemWatcher的Created事件会在文件创建、写入数据、属性变更等多个阶段触发，导致同一文件被重复处理。
• 修复：通过记录已处理文件的唯一标识（文件名+最后写入时间）实现防抖，结合文件就绪检测确保仅执行一次移动。

问题4：FileSystemWatcher无法识别新文件 #

• 原因：Watcher对象可能被PowerShell垃圾回收机制回收；共享路径权限不足导致监听失效；或EnableRaisingEvents未正确生效。
• 修复：将Watcher对象存储到全局变量防止被回收；确保运行账号对源共享有读取/修改权限；设置Watcher属性后延迟启用事件监听。

修复后的完整脚本 #

# Define variables
$LogFilePath = "C:\Logs\FileTransferLog.txt"
$ServiceAccountUserName = "test\test"
$ServiceAccountPassword = ConvertTo-SecureString "Test123" -AsPlainText -Force
$ServiceAccountCredential = New-Object System.Management.Automation.PSCredential($ServiceAccountUserName, $ServiceAccountPassword)

# 全局存储已处理文件，避免重复操作
$global:ProcessedFiles = @{}

# Define the array of users
$Users = @("TEST")

foreach ($User in $Users) {
    $SourceShare1 = "\\TEST\TEST\$User\"
    $DestinationShare1 = "\\TEST1\TEST\$User\"

    # 创建Watcher并存储到全局变量，防止被垃圾回收
    $global:WatcherServer1 = New-Object System.IO.FileSystemWatcher
    $global:WatcherServer1.Path = $SourceShare1
    $global:WatcherServer1.Filter = "*.*"
    $global:WatcherServer1.IncludeSubdirectories = $false
    $global:WatcherServer1.NotifyFilter = [System.IO.NotifyFilters]::FileName -bor [System.IO.NotifyFilters]::LastWrite

    # Define the event handler for new file creation
    $OnCreated = Register-ObjectEvent $global:WatcherServer1 "Created" -Action {
        $NewFile = $Event.SourceEventArgs.Name
        $FullSourcePath = Join-Path $Event.SourceEventArgs.FullPath.DirectoryName $NewFile
        
        # 检查文件是否已处理过
        $FileHash = (Get-Item $FullSourcePath).LastWriteTimeUtc.ToString("yyyyMMddHHmmssfff") + $NewFile
        if ($global:ProcessedFiles.ContainsKey($FileHash)) {
            return
        }

        # 等待文件就绪（无锁定）
        $FileReady = $false
        $RetryCount = 0
        while (-not $FileReady -and $RetryCount -lt 10) {
            try {
                $FileStream = [System.IO.File]::Open($FullSourcePath, [System.IO.FileMode]::Open, [System.IO.FileAccess]::ReadWrite, [System.IO.FileShare]::None)
                $FileStream.Close()
                $FileReady = $true
            }
            catch {
                Start-Sleep -Milliseconds 500
                $RetryCount++
            }
        }

        if (-not $FileReady) {
            Write-Output "Failed to process file $NewFile after 10 retries at $(Get-Date)" | Out-File $using:LogFilePath -Append
            return
        }

        # 使用服务账号执行移动操作，强制覆盖已存在文件
        try {
            Invoke-Command -ComputerName (Split-Path $using:DestinationShare1 -Qualifier).TrimStart('\') -Credential $using:ServiceAccountCredential -ScriptBlock {
                Move-Item -Path $using:FullSourcePath -Destination $using:DestinationShare1 -Force
            }
            # 标记文件为已处理
            $global:ProcessedFiles[$FileHash] = $true
            Write-Output "Moved file $NewFile from $using:SourceShare1 to $using:DestinationShare1 at $(Get-Date)" | Out-File $using:LogFilePath -Append
        }
        catch {
            Write-Output "Error moving file $NewFile : $_ at $(Get-Date)" | Out-File $using:LogFilePath -Append
        }
    }

    # 延迟启用事件监听，确保Watcher初始化完成
    Start-Sleep -Seconds 1
    $global:WatcherServer1.EnableRaisingEvents = $true
}

# Wait for events to occur
while ($true) { Start-Sleep -Seconds 1 }

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