命令行与文本处理 / 系统课时

创建计划任务

创建计划任务

本课完成一个可验证的 Windows 计划任务:每天以指定账户启动 PowerShell 脚本,固定工作目录,并在执行失败时自动重试。你还会掌握查询运行结果、手动触发测试和安全删除任务的方法。

学习目标

  • 组合操作、触发器、执行账户和任务设置并注册计划任务
  • 配置工作目录、最高权限、失败重试与执行时限
  • 查询任务状态和最近结果,并安全删除任务

认识计划任务的组成

计划任务不是一条孤立命令,而是由四类对象共同定义:操作说明“执行什么”,触发器说明“何时执行”,主体说明“以谁的权限执行”,设置说明“失败、错过时间或超时后怎么办”。最后由 Register-ScheduledTask 将这些对象注册到任务计划程序。

计划任务对象与注册关系

ScheduledTasks 模块只适用于 Windows。创建系统级任务通常需要管理员权限;普通用户任务也必须确保执行账户能够读取脚本、访问工作目录并写入日志。

创建并验证任务

下面的完整示例创建工作目录和测试脚本,注册每天 02:30 运行的任务,并以 SYSTEM 账户执行。失败后每隔 1 分钟重试一次,最多重试 3 次;单次运行超过 30 分钟会被终止。

powershell
Set-StrictMode -Version Latest
$ErrorActionPreference = 'Stop'

$taskName = 'Anystack-Daily-Maintenance'
$workDir = 'C:\ProgramData\Anystack\ScheduledTaskDemo'
$scriptPath = Join-Path $workDir 'maintenance.ps1'
$logPath = Join-Path $workDir 'task.log'

# SYSTEM 任务需要提升后的 PowerShell 会话。
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
$principalCheck = [Security.Principal.WindowsPrincipal]::new($identity)
$isAdmin = $principalCheck.IsInRole(
    [Security.Principal.WindowsBuiltInRole]::Administrator
)
if (-not $isAdmin) {
    throw '请以管理员身份运行 PowerShell。'
}

New-Item -ItemType Directory -Path $workDir -Force | Out-Null

@'
param()
$logPath = Join-Path $PSScriptRoot 'task.log'
try {
    "[$(Get-Date -Format o)] task started" |
        Add-Content -Path $logPath -Encoding utf8
    exit 0
}
catch {
    $_ | Out-String | Add-Content -Path $logPath -Encoding utf8
    exit 1
}
'@ | Set-Content -Path $scriptPath -Encoding utf8

# 优先使用 PowerShell 7;未安装时回退到 Windows PowerShell。
$pwsh = Get-Command pwsh.exe -ErrorAction SilentlyContinue
$shellPath = if ($pwsh) {
    $pwsh.Source
}
else {
    (Get-Command powershell.exe -ErrorAction Stop).Source
}

$argument = "-NoLogo -NoProfile -NonInteractive -File `"$scriptPath`""
$action = New-ScheduledTaskAction `
    -Execute $shellPath `
    -Argument $argument `
    -WorkingDirectory $workDir

$trigger = New-ScheduledTaskTrigger -Daily -At '02:30'
$runAs = New-ScheduledTaskPrincipal `
    -UserId 'SYSTEM' `
    -LogonType ServiceAccount `
    -RunLevel Highest

$settings = New-ScheduledTaskSettingsSet `
    -RestartCount 3 `
    -RestartInterval (New-TimeSpan -Minutes 1) `
    -ExecutionTimeLimit (New-TimeSpan -Minutes 30) `
    -StartWhenAvailable

Register-ScheduledTask `
    -TaskName $taskName `
    -Action $action `
    -Trigger $trigger `
    -Principal $runAs `
    -Settings $settings `
    -Description 'Daily maintenance demo' `
    -Force | Out-Null

Start-ScheduledTask -TaskName $taskName
do {
    Start-Sleep -Seconds 1
    $task = Get-ScheduledTask -TaskName $taskName
} while ($task.State -eq 'Running')

$info = Get-ScheduledTaskInfo -TaskName $taskName
[pscustomobject]@{
    TaskName         = $task.TaskName
    State            = $task.State
    Account          = $task.Principal.UserId
    WorkingDirectory = $task.Actions.WorkingDirectory
    LastTaskResult   = $info.LastTaskResult
    LastRunTime      = $info.LastRunTime
}
Get-Content -Path $logPath -Tail 1

预期输出如下,<TIME> 和本机路径可能不同:

text
TaskName         : Anystack-Daily-Maintenance
State            : Ready
Account          : SYSTEM
WorkingDirectory : C:\ProgramData\Anystack\ScheduledTaskDemo
LastTaskResult   : 0
LastRunTime      : <TIME>

[<TIME>] task started

任务计划程序根据进程退出码判断成功与失败。脚本捕获异常后必须返回非零退出码,否则即使业务处理失败,计划任务仍可能记录为成功,失败重试也不会按预期触发。

查询、修改与删除

Get-ScheduledTask 返回任务定义和当前状态,Get-ScheduledTaskInfo 返回最近运行时间、结果码和下次运行时间。修改任务时,可以重新创建某个组成对象后传给 Set-ScheduledTask;不要直接改查询结果中的只读属性。

完成练习后,可删除任务并验证其已不存在:

powershell
$taskName = 'Anystack-Daily-Maintenance'

Unregister-ScheduledTask -TaskName $taskName -Confirm:$false

$removed = $null -eq (
    Get-ScheduledTask -TaskName $taskName -ErrorAction SilentlyContinue
)
$removed

预期输出:

text
True

删除任务不会自动删除脚本和日志。确认不再需要后,可单独清理 C:\ProgramData\Anystack\ScheduledTaskDemo,避免误删仍被其他任务引用的文件。

权限与失败处理边界

SYSTEM 权限很高,适合本机维护,但不能代替普通用户访问其网络映射盘或交互式桌面。任务需要访问远程共享时,应使用具备最小权限的服务账户,并为该账户授予明确的共享与 NTFS 权限。

不要为了绕过执行策略长期加入 -ExecutionPolicy Bypass。它会削弱脚本来源检查;更稳妥的做法是签名脚本、设置合适的组织策略,并确保任务只执行受控目录中的固定文件。

任务显示 Ready 只表示已经注册,不代表脚本一定成功。验收时至少检查 LastTaskResult、任务日志、工作目录权限和手动触发结果;结果码非零时,先直接以同一账户和相同参数运行命令,再检查路径、权限和脚本退出码。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建计划任务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通