Windows 定时脚本是否按时完成：导出指定任务文件夹的最近运行结果

发布日期：2026-10-29。

适用场景

服务器上已经存在定时脚本，但每天逐个打开任务查看结果很费时间。本教程读取指定任务文件夹中的任务，生成一份 CSV 清单，帮助你先找出需要继续检查的条目。

适用于安装了 ScheduledTasks 模块的 Windows 11 或 Windows Server，示例使用 Windows PowerShell 5.1。查询只针对本机，不创建、启动、结束或禁用任务，也不收集任务的账户、操作参数或脚本正文。

原理：当前状态和上次结果需要一起看

任务定义描述注册了什么任务，运行信息描述最近一次运行的时间与结果。Microsoft 分别提供 Get-ScheduledTask 和 Get-ScheduledTaskInfo 来获取这些对象。

当前显示“就绪”只能说明任务目前处于等待状态，不能证明上一次业务处理正确。最近结果为零，也通常只说明动作返回了成功代码；如果脚本没有把内部错误转换为失败退出码，任务层面仍可能显示成功。

因此，报告同时保留任务路径、名称、当前状态、最近运行时间、下次运行时间和结果码，不把任何一个字段单独当成最终结论。同名任务也可能位于不同文件夹，必须用完整路径区分。

准备工作

打开任务计划程序（Task Scheduler），找到自己负责的任务文件夹，确认其中任务的预期运行频率。例如，应明确它是每天运行、登录时运行，还是按事件触发，不能统一用“下次时间为空”判断异常。

使用具备读取目标任务权限的现有会话。遇到访问拒绝时，先确认组织的权限安排；只有确有需要并且获准时才使用提升权限的终端。

先列出本机会话可以读取的任务文件夹：

Get-ScheduledTask -ErrorAction Stop |
    Select-Object -ExpandProperty TaskPath -Unique |
    Sort-Object

输出中的路径属于任务计划程序命名空间，不是磁盘目录。输入时应保留开头和结尾的反斜杠。

分步骤操作

第一步：选择确切范围

$taskFolder = Read-Host '输入上方列表中的完整任务文件夹路径'
$tasks = @(Get-ScheduledTask -TaskPath $taskFolder -ErrorAction Stop)
$tasks | Select-Object TaskPath, TaskName, State

$taskFolder 保存你实际输入的任务文件夹路径，$tasks 保存查询结果。直接输入已经列出的完整路径，不输入通配符，避免无意扩大范围。

先检查屏幕上的任务名称。如果列表为空，核对路径、权限以及任务是否确实位于该文件夹。这里按指定文件夹查询，不把子文件夹中的任务自动视为已经检查。

第二步：生成含读取状态的报告对象

$rows = foreach ($task in $tasks) {
    try {
        $info = $task | Get-ScheduledTaskInfo -ErrorAction Stop
        [pscustomobject]@{
            TaskPath = $task.TaskPath
            TaskName = $task.TaskName
            State = [string]$task.State
            LastRunTime = $info.LastRunTime.ToString('s')
            NextRunTime = $info.NextRunTime.ToString('s')
            LastResultDecimal = $info.LastTaskResult
            LastResultHex = ('0x{0:X8}' -f $info.LastTaskResult)
            QueryStatus = '读取成功'
            QueryError = ''
        }
    }
    catch {
        [pscustomobject]@{
            TaskPath = $task.TaskPath
            TaskName = $task.TaskName
            State = [string]$task.State
            LastRunTime = $null
            NextRunTime = $null
            LastResultDecimal = $null
            LastResultHex = $null
            QueryStatus = '读取失败'
            QueryError = $_.Exception.Message
        }
    }
}

读取失败的任务也保留一行，而不是悄悄跳过。这样能区分“没有发现异常”和“根本没有取得运行信息”。十进制值方便保留原始数字，十六进制值则便于与官方结果码对照。

第三步：保存到独立输出目录

$outDir = Join-Path ([Environment]::GetFolderPath('MyDocuments')) (
    'TaskReview-' + (Get-Date -Format 'yyyyMMdd-HHmmss-fff')
)
New-Item -ItemType Directory -Path $outDir -ErrorAction Stop | Out-Null
$reportPath = Join-Path $outDir 'task-results.csv'
$rows | Export-Csv -LiteralPath $reportPath -NoTypeInformation -Encoding UTF8
$reportPath

$outDir 是当前用户文档目录下的新文件夹，$reportPath 是最终报告路径。保存前先确保该位置适合存放运维记录。时间后缀便于区分不同巡检批次，不把输出覆盖到脚本或任务使用的数据目录。

不要先把对象转换成格式化表格再导出，否则 CSV 可能保存格式对象，而不是任务字段。

第四步：筛出需要复核的条目

$rows |
    Where-Object {
        $_.QueryStatus -ne '读取成功' -or
        $_.LastResultHex -ne '0x00000000'
    } |
    Select-Object TaskPath, TaskName, State, LastRunTime,
        LastResultHex, QueryStatus, QueryError

这个筛选结果是复核队列，不是失败任务名单。Microsoft 的任务计划程序结果码说明区分成功状态常量与错误常量。例如，0x00041301 表示任务正在运行，0x00041303 表示尚未运行，不能把所有非零数字统一解释成脚本崩溃。

验证方法

先核对导出行数是否与选定范围一致：

$imported = @(Import-Csv -LiteralPath $reportPath)
[pscustomobject]@{
    SelectedTasks = $tasks.Count
    ExportedRows = $imported.Count
}

再选择一个自己熟悉的任务，在任务计划程序中找到相同路径和名称，对照上次运行时间（Last Run Time）以及上次运行结果（Last Run Result）。任务可能在查询过程中再次启动，因此两次观察时间不同，字段也可能变化。

最后查看该脚本应该产生的文件、日志或其他业务产物，确认时间和内容符合预期。不要为了验证报告随意手动运行备份、同步或清理任务，以免重复产生业务操作。

常见错误

最近运行时间很早，不一定是任务故障，也可能是触发条件很少出现。下次运行时间显示特殊日期或没有实际意义时，应回到触发器配置判断。报告中的时间采用本机时间，跨服务器比较前应确认时区。

一个任务内有多个动作时，单一结果码不能替代逐个动作的日志。任务当前已禁用，也不意味着之前的运行失败。刚开始运行的任务可能尚未产生本轮最终结果，应等待其正常结束后重新查询。

安全与回退

报告只用于观察，不据此批量结束任务或更改触发器。文件中仍可能包含内部任务名称、路径和错误信息，分享前应按组织要求检查并脱敏。

本教程没有改变任务配置，因此无需恢复任务状态。结束巡检后，可以按实际保留周期删除新建的报告文件夹。若需要修复某个任务，应另行备份其定义，并在明确影响范围后实施。

参考资料与转载说明

• Microsoft Learn：Get-ScheduledTask
• Microsoft Learn：Get-ScheduledTaskInfo
• Microsoft Learn：Task Scheduler error and success constants

本文依据上述公开资料进行中文原创整理，不是逐句翻译，也不替代厂商手册。操作前请核对自己的版本、型号和备份。