寻求将PowerShell执行命令自动记录至日志文件的解决方案

先优化现有脚本的路径拼接（可选但推荐）：
将原来的日志文件路径拼接代码替换为：

$LogFile = Join-Path -Path $LogPath -ChildPath "$FileName.log"

使用Join-Path能自动处理不同系统的路径分隔符，避免手动拼接出错。

方案1：批量命令数组循环 #

把需要执行的命令整理成数组，通过循环自动完成日志记录与命令执行，无需重复编写WriteLog和命令行：

修改后的完整脚本：

$LogPath        = "C:\Logs"
$FileName       = (Get-Item $PSCommandPath).Basename                                                        
$LogFile        = Join-Path -Path $LogPath -ChildPath "$FileName.log"

Function WriteLog
{
Param ([string]$LogString)
$Stamp      = (Get-Date).toString("yyyy-MM-dd HH:mm:ss")
$LogMessage = "$Stamp $LogString"
Add-content $LogFile -value $LogMessage
}

# 定义需要执行的命令列表
$commandsToExecute = @(
    "Command1",
    "Command2",
    "Command3",
    "Command4",
    "Command5"
)

WriteLog "***********************"
WriteLog ""

foreach ($cmd in $commandsToExecute) {
    WriteLog "Executing command: $cmd"
    # 执行命令，若需要捕获输出可将结果赋值给变量后写入日志
    Invoke-Expression $cmd
}

WriteLog ""
WriteLog "***********************"

方案2：封装执行日志函数（更安全灵活） #

使用脚本块代替字符串命令，避免Invoke-Expression的安全风险，同时可扩展捕获执行结果、错误信息：

修改后的完整脚本：

$LogPath        = "C:\Logs"
$FileName       = (Get-Item $PSCommandPath).Basename                                                        
$LogFile        = Join-Path -Path $LogPath -ChildPath "$FileName.log"

Function WriteLog
{
Param ([string]$LogString)
$Stamp      = (Get-Date).toString("yyyy-MM-dd HH:mm:ss")
$LogMessage = "$Stamp $LogString"
Add-content $LogFile -value $LogMessage
}

# 封装执行并记录日志的函数
Function Invoke-LoggedCommand {
    Param(
        [Parameter(Mandatory=$true)]
        [scriptblock]$ScriptBlock,
        [switch]$PassThru  # 可选开关，用于返回命令执行结果
    )
    $commandText = $ScriptBlock.ToString().Trim()
    WriteLog "Starting execution: $commandText"
    
    try {
        $result = & $ScriptBlock
        WriteLog "Command succeeded: $commandText"
        # 可选：记录命令输出
        # if ($result) { WriteLog "Command output: $($result -join "`n")" }
        
        if ($PassThru) { return $result }
    }
    catch {
        WriteLog "Command failed: $commandText"
        WriteLog "Error details: $_"
        # 可选：抛出错误终止脚本，注释则继续执行后续命令
        # throw
    }
}

WriteLog "***********************"
WriteLog ""

# 调用函数执行命令
Invoke-LoggedCommand { Command1 }
Invoke-LoggedCommand { Command2 }
Invoke-LoggedCommand { Command3 }
Invoke-LoggedCommand { Command4 }
Invoke-LoggedCommand { Command5 }

# 若需要获取命令执行结果，使用-PassThru开关
# $output = Invoke-LoggedCommand { Get-ChildItem C:\ } -PassThru

WriteLog ""
WriteLog "***********************"

方案优势对比 #

• 方案1：代码改动最小，适合简单的命令列表场景，维护命令数组即可。
• 方案2：安全性更高（避免字符串注入风险），支持错误捕获、结果返回，扩展性更强，适合复杂脚本场景。

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