PowerShell 查询 Windows 任务计划程序,用于在特定日期时间之间 运行 的任务

PowerShell query Windows task scheduler for tasks that will run between specific datetimes

我继承了一个服务器,该服务器为数百个不同的进程运行 Windows 计划任务(主要是启动自定义 PowerShell 脚本)- 这些任务的计划可以每 15 分钟一次,或者很少像每年一次的特定日期。

我如何使用 PowerShell(或任何其他方式)查询任务调度程序以确定将来是否有任何任务 运行 在特定日期时间范围内?这是必要的,这样我们就可以在这台服务器以及与之交互的其他服务器上安排和执行维护。

这是获取下一个 运行 个工作的脚本

Get-ScheduledTask |
   Foreach-object { Get-ScheduledTaskInfo $_} |
   where-object {!($_.NextRunTime -eq $null)} |
   Select-object Taskname, NextRunTime |
   Sort-object -property NextRunTime

我应该首先提到这是一个看似复杂的话题。造成这种情况的原因很少,包括但不限于:

  1. 作为对象的计划任务可能非常复杂,具有广泛可变的计划、重复间隔、其他触发器类型和大量其他配置点。
  2. 非 GUI,即 CLI、cmdlet、and/or API 工具多年来发生了变化。而且,将它们串在一起以解决第 1 点中提到的复杂性并不总是那么容易。

警告:这份报告将很难写。在你开始这样的挑战之前,你应该寻找任何可能清点或为任务计划程序提供其他透明度的预先存在的工具。

此外,最好将维护 window 定义为政策问题。然后您可以配置作业以避免 window。乍一看,这比编写一个困难的程序来帮助挑选时间段要容易得多。

如果您选择继续前进,这里有一些工具可能会有所帮助:

  1. Schtasks.exe:一个功能惊人的 CLI 工具,已经存在了很长时间。
  2. TaskScheduler PowerShell 模块:围绕调度 COM 对象编写的 PowerShell 模块。它最初是 Windows 7 PowerShell 包的一部分,但现在您可以通过 PowerShell Gallery 获取它。最简单的方法是通过典型的模块 cmdlet,例如 Find-Module & Install-Module
  3. 较新的 ScheduledTasks 模块默认安装在后来的 Windows 系统上。它是围绕 Cim (WMI) 编写的,默认安装在更高版本的 PowerShell / Windows.

注意:后两种工具很容易混淆。不仅名称非常相似,而且它们包含的命令之间也存在重叠和相似之处。例如,两个模块都有一个 Get-Scheduledtask cmdlet。处理混乱的两种方法:

  1. 使用 Import-Module cmdlet 导入模块时,使用 -Prefix 参数为 cmdlet 的 none 部分添加前缀。然后在之后调用 cmdlet 时使用该前缀。
  2. 使用限定名称调用 cmdlet,例如 TaskScheduler\GetScheduledTasks

现在获取调度数据。根据我的经验,所需的详细信息仅通过任务的 XML 定义公开。同样,您将遇到各种调度 and/or 触发器选项带来的复杂性。您可以阅读 XML 架构 here

以下是如何访问 XML 数据的一些示例:

schtasks.exe /query /s pyexadm1 /tn <TaskName> /XML

在这种情况下,您必须执行额外的字符串操作以隔离 XML,然后将其转换为 [XML],以便您可以以典型的 PowerShell 方式使用它。显然,更广泛地利用该工具将面临挑战。但是,了解快速检查和工作非常方便,尤其是在下一个工具无法立即使用的情况下。

注意:如果您不引用 /TN 参数,将返回所有任务。虽然下一种方法更简单,但了解这种方法还是有好处的,在您开发时会很方便。

下一个示例使用旧的 TaskScheduler 模块(上面的#2):

$TaskXML = [XML](TaskScheduler\Get-ScheduledTask -ComputerName <ComputerName>-Name <TaskName>).XML

注意:以上假设没有使用前缀。因此,您必须引用源模块以防止与 ScheduledTask 模块混淆。

此示例加载 XML 文本并在一行中将其转换为 XmlDocument 对象。然后您可以访问有关任务的数据,如下所示:

$TaskXML.Task.Triggers.CalendarTrigger

这可能会产生如下输出:

StartBoundary       Enabled ScheduleByWeek
-------------       ------- --------------
2020-09-14T08:00:00 true    ScheduleByWeek

您可以 运行 通过利用管道来大量执行此操作,它可能如下所示:

$XMLTaskData = 
TaskScheduler\Get-ScheduledTask -ComputerName <ComputerName> -Recurse | 
ForEach-Object{ [XML]$_.XML }

在上面的管道示例中,生成的 $XMLTaskData 是一个数组,其中每个元素都是相应的 XML 任务定义。

注意:-Recurse开关参数的使用。鉴于任务数量众多,如果将它们组织到子文件夹中,我不会感到惊讶。

同样,您也可以使用 ScheduledTasks 模块中的 Export-ScheduledTask cmdlet:

$TaskXML = [XML](Export-ScheduledTask -CimSession <ComputerName> -TaskName <TaskName>)

您可以像这样利用管道:

$XMLTaskData = 
Get-ScheduledTask -CimSession <ComputerName> | 
Export-ScheduledTask | 
ForEach-Object{ [XML]$_ }

与另一个管道示例一样,这会生成一个 XML 任务定义数组。

注:本例中没有-Recurse参数。不过,您可以具体引用路径。

使用这些方法中的任何一种,您显然需要熟悉在 PowerShell 中使用 XML 对象,但是有大量的教程或其他资源。

同样,这里的复杂性在于处理许多触发器类型和调度范例。在获得最小可行程序 (MVP) 的道路上,您可能希望使用这些技术来清点现有任务。这可以帮助您确定开发过程的优先级。

最后一点;知道一项任务何时进入 运行 可能与知道它何时进入 运行 完全不同。例如,一项任务可能 运行 一个 1:00 下午,但工作的持续时间是可变的且未说明。这让我觉得很难应对。您可能需要另一个过程来在事件日志中查找任务完成事件。您可能还需要考虑可在 XML 数据中找到的执行时间限制。