Win32_ScheduledJob 类

项目
06/12/2023

Win32_ScheduledJobWMI 类表示使用 AT 命令创建的作业。

注意

Win32_ScheduledJob 类不表示使用控制面板的计划任务向导创建的作业。无法在“计划任务”UI 中更改 WMI 创建的任务。有关详细信息，请参见“备注”部分。

以下语法从托管对象格式 (MOF) 代码中简化，包括所有继承的属性。属性和方法按字母顺序排列，而不是按 MOF 顺序排列。

语法

[Dynamic, Provider("CIMWin32"), UUID("{8502C4E0-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("Delete"), AMENDMENT]
class Win32_ScheduledJob : CIM_Job
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  datetime ElapsedTime;
  string   Notify;
  string   Owner;
  uint32   Priority;
  datetime TimeSubmitted;
  datetime UntilTime;
  string   Command;
  uint32   DaysOfMonth;
  uint32   DaysOfWeek;
  boolean  InteractWithDesktop;
  uint32   JobId;
  string   JobStatus;
  boolean  RunRepeatedly;
  datetime StartTime;
};

成员

Win32_ScheduledJob 类具有以下类型的成员：

方法
属性

方法

Win32_ScheduledJob 类具有这些方法。

方法	说明
创建	类方法，用于将作业提交到操作系统，以便在指定的未来时间和日期执行。
删除	用于删除计划作业的类方法。

属性

Win32_ScheduledJob 类具有这些属性。

Caption

数据类型： string
访问类型：只读
限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement。

命令

数据类型： string
访问类型：只读
限定符： MappingStrings (“Win32API|网络管理结构 |AT_INFO|Command“)

计划服务用于调用作业的命令、批处理程序或二进制文件 (和命令行参数) 的名称。

示例：“defrag/q/f”

DaysOfMonth

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|网络管理结构 |AT_INFO|DaysOfMonth“)

计划运行作业的月份中的天数。如果作业计划为在当月的多个日期运行，则可以将这些值联接到逻辑 OR 中。例如，如果作业要在每月 1 日和 16 日运行，则 DaysOfMonth 属性的值将为 1 或 32768。

1 (1)

1st

2 (2)

第二

3 (4)

第 3 个

4 (8)

第 4

5 (16)

第 5 个字符

6 (32)

第 6 个字符

7 (64)

第 7 个字符

8 (128)

第 8 个字符

9 (256)

第 9 个字符

10 (512)

10 日

11 (1024)

第 11

12 (2048)

第 12

13 (4096)

第 13

14 (8192)

14 日

15 (16384)

15 日

16 (32768)

16 日

17 (65536)

17 日

18 (131072)

18 日

19 (262144)

19 日

20 (524288)

20 日

21 (1048576)

第 21

22 (2097152)

第 22

23 (4194304)

第 23

24 (8388608)

24 日

25 (16777216)

25 日

26 (33554432)

26 日

27 (67108864)

27 日

28 (134217728)

28 日

29 (268435456)

29 日

30 (536870912)

第 30 位

31 (1073741824)

31 日

DaysOfWeek

数据类型： uint32
访问类型：只读
限定符：MappingStrings (“Win32API|网络管理结构 || AT_INFODaysOfWeek“)

计划运行作业的星期几。如果作业计划在一周中的多天运行，则可以在逻辑 OR 中联接这些值。例如，如果作业计划于星期一、星期三和星期五运行， 则 DaysOfWeek 属性的值将为 1 或 4 或 16。

星期一 (1)

星期二 (2)

星期三 (4)

星期四 (8)

星期五 (16)

星期六 (32)

星期日 (64)

描述

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“Description”)

对象的文本说明。

此属性继承自 CIM_ManagedSystemElement。

ElapsedTime

数据类型： datetime
访问类型：只读

作业执行的时间长度。

此属性继承自 CIM_Job。

InstallDate

数据类型： datetime
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)

指示对象的安装时间。缺少值并不表示未安装对象。

此属性继承自 CIM_ManagedSystemElement。

InteractWithDesktop

数据类型： 布尔值
访问类型：只读
限定符：MappingStrings (“Win32API|网络管理结构 || AT_INFO标志|JOB_NONINTERACTIVE“)

指定的作业是交互式作业，这意味着用户可以在执行计划作业时向其提供输入。

JobId

数据类型： uint32
访问类型：只读
限定符：Key、MappingStrings (“Win32API|网络管理结构 || AT_ENUMJobId“)

作业的标识编号。它由方法用作在此计算机上计划一个作业的句柄。

JobStatus

数据类型： 字符串
访问类型：只读
限定符：重写 (“JobStatus”) ，MappingStrings (“Win32API|网络管理结构 || AT_ENUM标志|JOB_EXEC_ERROR“)

上次计划运行此作业时的执行状态。

成功 (“成功”)

失败 (“失败”)

名称

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“Name”)

对象的已知标签。子类化后，可将此属性重写为键属性。

此属性继承自 CIM_ManagedSystemElement。

通知

数据类型： 字符串
访问类型：只读

作业完成或失败时，系统会通知用户。

此属性继承自 CIM_Job。

所有者

数据类型： 字符串
访问类型：只读

提交作业的用户。

此属性继承自 CIM_Job。

优先级

数据类型： uint32
访问类型：只读

作业执行的重要性。

此属性继承自 CIM_Job。

RunRepeatedly

数据类型： 布尔值
访问类型：只读
限定符：MappingStrings (“Win32API|网络管理结构 || AT_INFO标志|JOB_RUN_PERIODICALLY“)

计划的作业在计划作业的日期重复运行。如果 为 False，则运行作业一次。

StartTime

数据类型： datetime
访问类型：只读
限定符：替代 (“StartTime”) ，MappingStrings (“Win32API|网络管理结构 || AT_ENUMJobTime“)

运行作业的 UTC 时间，格式为“YYYYMMDDHHMMSS。MMMM (+-) OOO“，其中”YYYYMMDD“必须替换为”********”。更换是必需的，因为计划服务只允许将作业配置为运行一次，或在一个月或一周的某一天运行。作业不能在特定日期运行。

StartTime 属性值的“ (+-) OOO”部分是本地时间转换的当前偏差。偏差是 UTC 时间和本地时间之间的差值。若要计算时区的偏差，请将时区早于格林威治标准时间或格林威治标准时间 (GMT) 的小时数乘以 60， (如果时区早于 GMT，则使用正数作为小时数，如果时区早于 GMT) ，则为负数。如果时区使用夏令时，则向计算添加额外的 60。例如，太平洋标准时区比 GMT 差 8 小时，因此在使用夏令时，偏差等于 -420 (-8 * 60 + 60) ，在不使用夏令时为 -480 (-8 * 60) 。还可以通过查询 Win32_TimeZone 类的 bias 属性来确定偏差的值。

例如：“*****123000.000000-420”指定 14.30 (下午 2：30 ) PST，夏令时有效。

Status

数据类型： 字符串
访问类型：只读
限定符： MaxLen (10) 、 DisplayName (“Status”)

指示对象的当前状态的字符串。可以定义操作状态和非操作状态。操作状态可能包括“正常”、“已降级”和“预失败”。 “Pred Fail”表示元素正常运行，但预测故障 (例如启用 SMART 的硬盘驱动器) 。

非操作状态可能包括“错误”、“正在启动”、“正在停止”和“服务”。 “服务”可以在磁盘镜像重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都处于联机状态，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

OK (“OK”)

错误 (“错误”)

已降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

正在启动 (“正在启动”)

正在停止 (“停止”)

服务 (“Service”)

压力 (“有压力”)

NonRecover (“NonRecover”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

TimeSubmitted

数据类型： datetime
访问类型：只读

提交作业的时间。

此属性继承自 CIM_Job。

UntilTime

数据类型： datetime
访问类型：只读

作业无效或应停止的时间。

此属性继承自 CIM_Job。

备注

针对计划服务计划的每个作业都永久存储 (计划程序可以在重新启动) 后启动作业，并在指定的星期或月份日期执行。如果计算机未处于活动状态，或者计划服务未在指定的作业时间运行，则计划服务将在第二天指定的时间运行指定的作业。

作业根据协调世界时 (UTC) 进行计划，其偏差偏移了格林威治标准时间 (GMT) ，这意味着可以使用任何时区指定作业。 Win32_ScheduledJob 类在枚举对象时返回具有 UTC 偏移量的本地时间，并在创建新作业时转换为本地时间。例如，指定在波士顿的计算机上在 10：30 晚上 10：30 运行作业（太平洋标准时间星期一）将安排为在 EST 周二凌晨 1：30 本地运行。

注意

客户端必须考虑夏令时是否在本地计算机上运行，如果是，则从 UTC 偏移量减去 60 分钟的偏差。

Win32_ScheduledJob 类派生自 CIM_Job。必须是管理员组的成员才能使用此类创建计划作业。

Win32_ScheduledJob 类在内部使用 AT 协议，该协议从 Windows 8 和 Windows Server 2012 开始绑定到弃用。作为第一步，AT 协议默认处于禁用状态。例如，如果禁用了协议，则对 Win32_ScheduledJob 对象调用 Create 方法将失败，并出现错误0x8。可以通过添加以下注册表项重新打开 AT 协议：

Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Schedule\Configuration 
Name: EnableAt 
Type: REG_DWORD
Value: 1

可能需要重新启动计算机才能使设置生效。

由于 Win32_ScheduledJob 基于 NetScheduleJobGetInfo Win32 API，因此不能将此类与任务计划程序结合使用。如果要使用任务计划程序，请使用任务计划程序 API。有关详细信息，请参阅任务计划程序参考。

示例

以下 VBScript 代码示例计划Notepad.exe，以交互方式在每周三的本地计算机时间 1：25 运行。

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\Root\CIMv2")
Set objNewJob = objWMIService.Get("Win32_ScheduledJob")
errJobCreated = objNewJob.Create("Notepad.exe", "********012500.000000-420", True , 4, , True, JobId) 
If errJobCreated <> 0 Then
Wscript.Echo "Error on task creation"
Else
Wscript.Echo "Task created"
End If

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另请参阅

CIM_Job
操作系统类
WMI 任务：计划任务

通过

Win32_ScheduledJob 类

语法

成员

方法

属性

备注

示例

要求

另请参阅

反馈

其他资源