Win32_ScheduledJob 类
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 |
|
| DLL |
|
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈