如何为现有PowerShell文件迁移脚本添加日志记录功能？

核心问题排查与修复 #

你的日志未成功写入，大概率是这几个原因：

• 日志文件路径无写入权限（尤其是打包成exe后，默认工作目录可能是系统目录而非脚本所在目录）
• 未正确处理错误捕获，操作失败时没触发日志写入
• 日志写入方式不当（比如直接覆盖而非追加，或未确保目录存在）

带完整日志功能的脚本示例 #

# 配置参数
$SourceDir = "C:\Your\Source\Path"
$TargetDir = "\\Network\Share\Target\Path"
# 指定固定可写目录存储日志，避免打包exe后路径失效
$LogPath = "C:\Temp\FileMoveLog.log"

# 确保日志目录存在
$LogDir = Split-Path -Path $LogPath -Parent
if (-not (Test-Path -Path $LogDir)) {
    New-Item -Path $LogDir -ItemType Directory | Out-Null
}

# 获取机器名和日期格式
$ComputerName = $env:COMPUTERNAME
$DateSuffix = Get-Date -Format "yyyyMMddHHmmss"

# 获取源目录文件（可根据需求加过滤，比如 -Filter *.txt）
$Files = Get-ChildItem -Path $SourceDir -File

foreach ($File in $Files) {
    $Timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
    $OriginalName = $File.Name
    # 加原文件名后缀避免重名
    $NewName = "$ComputerName-$DateSuffix-$OriginalName"
    $TargetPath = Join-Path -Path $TargetDir -ChildPath $NewName
    $Status = "成功"
    $ErrorMsg = ""

    try {
        # 移动并重命名文件，强制覆盖已存在的目标文件
        Move-Item -Path $File.FullName -Destination $TargetPath -Force -ErrorAction Stop
        # 删除源目录备份文件（若备份是单独文件，需替换为实际备份路径）
        # Remove-Item -Path "$SourceDir\Backup\$OriginalName" -Force -ErrorAction Stop
    }
    catch {
        $Status = "失败"
        $ErrorMsg = $_.Exception.Message
    }

    # 拼接日志条目并写入
    $LogEntry = "[$Timestamp] 原文件名: $OriginalName | 新文件名: $NewName | 状态: $Status"
    if ($Status -eq "失败") {
        $LogEntry += " | 错误信息: $ErrorMsg"
    }
    Add-Content -Path $LogPath -Value $LogEntry -Encoding UTF8
}

# 弹出完成提示
[System.Windows.MessageBox]::Show("文件移动操作完成，请查看日志确认结果", "操作完成", [System.Windows.MessageBoxButton]::OK, [System.Windows.MessageBoxImage]::Information)

关键注意事项 #

• 日志路径选择：打包成exe后，脚本默认工作目录可能是系统临时文件夹，建议指定绝对可写路径（如C:\Temp），避免权限或路径失效问题。
• 权限验证：确保运行exe的账户对源目录、目标网络共享、日志目录都具备读写权限（网络共享需同时检查SMB共享权限和NTFS权限）。
• 错误捕获逻辑：必须搭配-ErrorAction Stop和try/catch，否则PowerShell默认忽略错误，无法记录失败状态。
• 重命名唯一性：处理多文件时，在新文件名后追加原文件名或序号，避免同名文件覆盖。
• 打包参数设置：使用PS2EXE等工具打包时，可通过-WorkingDirectory参数指定脚本所在目录，或直接在脚本中用绝对路径替代相对路径。

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