如何在PowerShell脚本中实现多目标可配置日志功能？

绝对可以！PowerShell完全能实现这种类似Python logging或Java log4j的多目标日志功能——核心就是把日志目标配置和实际记录逻辑彻底拆分开，让你只需要调用一个日志函数，就能根据配置自动把消息路由到你想要的任意（或多个）目标里。下面我给你一步步拆解实现方式：

咱先把逻辑捋清楚，要实现配置和记录分离，关键分三层：

• 配置层：用一个可灵活修改的结构（哈希表或配置文件）定义各个日志目标的启用状态、参数（比如文件路径、事件日志源、日志级别）
• 逻辑层：写一个统一的日志处理函数，读取配置后自动将消息分发到所有启用的目标
• 调用层：业务代码里只需要调用这个统一函数，完全不用关心消息最终会输出到哪

第一步：定义日志配置 #

先搞个配置哈希表，你可以把它单独存成.ps1配置文件，随时修改不用动业务代码：

# 日志配置：可单独提取为配置文件，随时调整目标和级别
$LogConfig = @{
    # 控制台输出配置
    Console = @{
        Enabled = $true
        Level = "Info" # 可选级别：Debug/Info/Warn/Error
    }
    # 文件日志配置
    File = @{
        Enabled = $true
        Path = "C:\Logs\MyScript.log"
        Level = "Debug"
        MaxSizeMB = 10 # 可选：日志文件超过大小自动滚动备份
    }
    # Windows事件日志配置
    EventLog = @{
        Enabled = $true
        LogName = "Application"
        Source = "MyPowerShellScript"
        Level = "Error" # 仅Error级别消息写入事件日志
    }
}

第二步：编写统一日志函数 #

这个函数是核心，负责读取配置并把消息分发到各个启用的目标：

function Write-MultiTargetLog {
    param(
        [Parameter(Mandatory=$true)]
        [string]$Message,
        [ValidateSet("Debug","Info","Warn","Error")]
        [string]$Level = "Info"
    )

    # 定义级别优先级，方便判断当前消息是否符合目标的级别要求
    $LevelPriority = @{ Debug=0; Info=1; Warn=2; Error=3 }
    $currentMsgPriority = $LevelPriority[$Level]

    # 1. 输出到控制台
    if ($LogConfig.Console.Enabled -and $currentMsgPriority -ge $LevelPriority[$LogConfig.Console.Level]) {
        # 按级别设置控制台输出颜色
        $color = switch ($Level) {
            "Debug" { "Gray" }
            "Info" { "White" }
            "Warn" { "Yellow" }
            "Error" { "Red" }
        }
        Write-Host "[$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')] [$Level] $Message" -ForegroundColor $color
    }

    # 2. 输出到日志文件
    if ($LogConfig.File.Enabled -and $currentMsgPriority -ge $LevelPriority[$LogConfig.File.Level]) {
        # 确保日志目录存在，不存在就创建
        $logDir = Split-Path $LogConfig.File.Path -Parent
        if (-not (Test-Path $logDir)) {
            New-Item -ItemType Directory -Path $logDir | Out-Null
        }

        # 检查日志文件大小，超过设定值就滚动备份
        if (Test-Path $LogConfig.File.Path) {
            $fileSizeMB = (Get-Item $LogConfig.File.Path).Length / 1MB
            if ($fileSizeMB -ge $LogConfig.File.MaxSizeMB) {
                $timestamp = Get-Date -Format 'yyyyMMddHHmmss'
                Rename-Item $LogConfig.File.Path "$($LogConfig.File.Path).$timestamp" -Force
            }
        }

        # 写入日志内容
        "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') [$Level] $Message" | Add-Content -Path $LogConfig.File.Path -Encoding utf8
    }

    # 3. 输出到Windows事件日志
    if ($LogConfig.EventLog.Enabled -and $currentMsgPriority -ge $LevelPriority[$LogConfig.EventLog.Level]) {
        # 第一次使用需要创建事件源（需管理员权限）
        if (-not [System.Diagnostics.EventLog]::SourceExists($LogConfig.EventLog.Source)) {
            New-EventLog -LogName $LogConfig.EventLog.LogName -Source $LogConfig.EventLog.Source
        }

        # 按级别设置事件日志条目类型
        $eventType = switch ($Level) {
            "Debug" { "Information" }
            "Info" { "Information" }
            "Warn" { "Warning" }
            "Error" { "Error" }
        }
        Write-EventLog -LogName $LogConfig.EventLog.LogName -Source $LogConfig.EventLog.Source -EntryType $eventType -EventId 1 -Message $Message
    }
}

第三步：业务代码中调用日志函数 #

现在你在脚本里只需要调用这个函数就行，完全不用管消息去哪——配置怎么设，它就怎么输出：

# 示例调用：只需要传消息和级别，剩下的交给配置和函数
Write-MultiTargetLog -Message "脚本开始执行" -Level Info
Write-MultiTargetLog -Message "读取配置文件时发现非关键警告" -Level Warn
Write-MultiTargetLog -Message "数据库连接失败，脚本终止" -Level Error
Write-MultiTargetLog -Message "调试信息：当前执行路径是 $PWD" -Level Debug

如果想要更完善的功能，还可以做这些优化：

• 把配置存成JSON/XML文件，用Get-Content | ConvertFrom-Json加载，更方便团队共享和修改
• 增加日志格式化自定义（比如添加脚本名称、行号、进程ID）
• 支持更多日志目标（比如邮件通知、Slack消息、远程日志服务器）
• 增加日志级别动态调整（不用重启脚本就能修改配置）

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