如何为创建计划任务的PowerShell脚本获取详细错误日志？

一、需要添加的日志配置 #

• 增强日志函数：让日志同时写入文件和控制台，区分日志级别（信息、警告、错误），方便快速定位问题类型。
• 记录上下文信息：脚本启动时记录运行账户、系统版本、执行路径等关键环境信息，排查部署时的上下文差异问题。
• 分步操作日志：对创建任务动作、触发器、注册任务等每一个关键步骤单独记录执行状态，明确哪一步出现失败。
• 捕获详细错误信息：使用try/catch捕获异常，记录错误消息、堆栈跟踪等细节，而非仅简单提示操作失败。
• 强制错误捕获：设置$ErrorActionPreference = "Stop"，将非终止错误转为终止错误，确保所有异常都能被捕获记录。

二、是否需要if/else语句？ #

需要结合try/catch和if/else使用。try/catch适合捕获命令抛出的异常场景，if/else可用于检查命令返回的状态（比如判断注册任务是否返回有效对象），两者结合能更全面地覆盖错误处理场景，精准定位失败节点。

三、修改后的脚本示例 #

$OutputFile = "$env:WINDIR\TEMP\CPCWindowsUpdates.log"

# 增强日志函数
Function Write-Log {
    param(
        [Parameter(Mandatory=$true)]
        [string]$Message,
        [ValidateSet("Info", "Error", "Warning")]
        [string]$Level = "Info"
    )
    $logEntry = "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') [$Level] - $Message"
    # 确保日志目录存在
    if (-not (Test-Path (Split-Path $OutputFile))) {
        New-Item (Split-Path $OutputFile) -ItemType Directory | Out-Null
    }
    Add-Content -Path $OutputFile -Value $logEntry
    Write-Host $logEntry
}

# 设置错误处理偏好
$ErrorActionPreference = "Stop"

# 记录启动上下文
Write-Log "=== 脚本开始执行 ==="
Write-Log "当前运行用户: $env:USERNAME"
Write-Log "当前系统版本: $([Environment]::OSVersion.VersionString)"
Write-Log "脚本执行路径: $PSScriptRoot"

try {
    # 创建第一个任务动作：安装PSWindowsUpdate模块
    $actionInstallModule = New-ScheduledTaskAction -Execute 'Powershell.exe' -Argument '-NoProfile -WindowStyle Hidden -command "& {Install-Module -Name PSWindowsUpdate -Force -Scope AllUsers}"'
    Write-Log "成功创建「安装PSWindowsUpdate模块」的任务动作"
} catch {
    Write-Log "创建「安装PSWindowsUpdate模块」任务动作失败: $($_.Exception.Message)`n堆栈跟踪: $($_.Exception.StackTrace)" "Error"
    exit 1
}

try {
    # 创建第二个任务动作：执行Windows更新
    $actionRunUpdate = New-ScheduledTaskAction -Execute 'Powershell.exe' -Argument '-NoProfile -WindowStyle Hidden -command "& {Install-WindowsUpdate -AcceptAll -Install -AutoReboot}"'
    Write-Log "成功创建「执行Windows更新」的任务动作"
} catch {
    Write-Log "创建「执行Windows更新」任务动作失败: $($_.Exception.Message)`n堆栈跟踪: $($_.Exception.StackTrace)" "Error"
    exit 1
}

try {
    # 创建登录触发器
    $trigger = New-ScheduledTaskTrigger -AtLogOn
    # 设置重复执行规则
    $trigger.Repetition = (New-ScheduledTaskTrigger -Once -At (Get-Date -Hour 0 -Minute 0) -RepetitionInterval (New-TimeSpan -Minutes 1) -RepetitionDuration (New-TimeSpan -Minutes 3)).Repetition
    Write-Log "成功创建登录触发器及重复执行规则"
} catch {
    Write-Log "创建触发器失败: $($_.Exception.Message)`n堆栈跟踪: $($_.Exception.StackTrace)" "Error"
    exit 1
}

try {
    # 注册计划任务
    $taskParams = @{
        Action      = @($actionInstallModule, $actionRunUpdate)
        Trigger     = $trigger
        TaskName    = "Update Windows"
        Description = "performs Windows Updates at first logon"
        Force       = $true  # 若任务已存在则覆盖
        User        = "SYSTEM"  # 指定SYSTEM账户运行，避免权限问题
        RunLevel    = "Highest" # 以最高权限运行
    }
    $registeredTask = Register-ScheduledTask @taskParams
    if ($registeredTask) {
        Write-Log "成功注册计划任务: $($registeredTask.TaskName)"
    } else {
        Write-Log "计划任务注册返回无效结果" "Error"
        exit 1
    }
} catch {
    Write-Log "注册计划任务失败: $($_.Exception.Message)`n堆栈跟踪: $($_.Exception.StackTrace)" "Error"
    exit 1
}

Write-Log "=== 脚本执行完成 ==="

额外说明 #

• 原脚本中Install-Module添加-Scope AllUsers，避免仅当前用户可见模块；Install-WindowsUpdate添加-AutoReboot自动处理更新后的重启需求。
• 注册任务时指定User = "SYSTEM"和RunLevel = "Highest"，规避Intune部署时的权限不足问题。
• 日志文件路径选用$env:WINDIR\TEMP，确保SYSTEM账户拥有写入权限。

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