Win32_ScheduledJob类

项目
09/22/2022

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

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

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement。

命令

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

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

示例：“defrag/q/f”

DaysOfMonth

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

计划运行作业的月份天数。如果计划作业在月份的多个天运行，则可以将这些值联接到逻辑 OR 中。例如，如果作业要在每月 1 日和 16 日运行，则 DaysOfMonth 属性的值将为 1 OR 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 OR 4 OR 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。

Priority

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

作业执行的重要性。

此属性继承自 CIM_Job。

RunRepeatedly

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

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

StartTime

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

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

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

例如：“********123000.000000-420”指定 14.30 (2：30 P.M.) PST，夏令时生效。

Status

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

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

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

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

确定 (“确定”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

启动 (“启动”)

停止 (“停止”)

服务 (“服务”)

压力 (“压力”)

NonRecover (“NonRecover ”)

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

Lost Comm (“Lost Comm”)

TimeSubmitted

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

提交作业的时间。

此属性继承自 CIM_Job。

UntilTime

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

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

此属性继承自 CIM_Job。

注解

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

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

注意

客户端必须考虑夏令时是否在本地计算机上运行，如果是，则从 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类

语法

成员

方法

属性

注解

示例

要求

另请参阅

其他资源

其他资源