Win32_ScheduledJob 类的 Create 方法
CreateWMI 类方法将作业提交到操作系统,以便在将来的指定时间和日期执行。 此方法要求在提交作业的计算机上启动计划服务。
本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息,请参阅 调用方法。
语法
uint32 Create(
[in] string Command,
[in] datetime StartTime,
[in, optional] boolean RunRepeatedly,
[in, optional] uint32 DaysOfWeek,
[in, optional] uint32 DaysOfMonth,
[in, optional] boolean InteractWithDesktop,
[out] uint32 JobId
);
参数
-
命令 [in]
-
计划服务用来调用作业的命令、批处理程序或二进制文件和命令行参数的名称。
示例:“defrag /q /f”。
-
StartTime [in]
-
协调世界时 (UTC) 运行作业的时间。 窗体必须为:“YYYYMMDDHMMSS。MMMMMM (+-) OOO“,其中”YYYYMMDD“必须替换为”********”。 例如:“********143000.000000-420”指定 14.30 (2:30 P.M.) PST,夏令时生效。
StartTime 属性值的“ (+-) OOO”部分是本地时间转换的当前偏差。 偏差是 UTC 时间与本地时间之间的差异。 若要计算时区的偏差,请将时区提前或落后格林威治标准时间 (格林尼治标准时间) 的小时数乘以 60 (如果时区早于 GMT,则为小时数乘以正数(如果时区落后于 GMT) )。 如果时区使用夏令时,请将额外的 60 添加到计算中。 例如,太平洋标准时区比 GMT 落后 8 小时,因此当夏令时不使用夏令时,偏差等于 -420 (-8 * 60 + 60) ,在夏令时不使用时,偏差等于 -480 (-8 * 60) 。 还可以通过查询 Win32_TimeZone 类的偏差属性来确定偏差的值。
-
RunRepeatedly [in, 可选]
-
如果 为 True,则计划作业在特定日期重复运行。 默认值为 False。
-
DaysOfWeek [in, 可选]
-
计划运行作业的一周中的天数;仅在 RunRepeatedly 参数为 True 时使用。 若要为一周中的多个日期计划作业,请联接逻辑 OR 中的相应值。 例如,若要为星期二和星期五安排作业, DaysOfWeek 的值为 2 OR 16。
-
星期 一 (1)
-
星期二 (2)
-
星期三 (4)
-
星期四 (8)
-
星期五 (16)
-
星期六 (32)
-
星期日 (64)
DaysOfMonth [in, 可选]
计划运行作业的月份天数;仅在 RunRepeatedly 参数为 True 时使用。
1 (1)
每月第 1 天
2 (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 天
InteractWithDesktop [in, 可选]
如果 为 True,则指定的作业应该是交互式的,这意味着用户在执行作业时可以向计划作业提供输入。 默认值为 False。
JobId [out]
作业的标识符号。 此参数是在计算机上计划作业的句柄。
返回值
成功时返回值 0 (零) ,另一个数字指示错误。 有关其他错误代码,请参阅 WMI 错误常量 或 WbemErrorEnum。 有关常规 HRESULT 值,请参阅 系统错误代码。
-
成功完成
-
0
接受请求。
-
不支持
-
1
不支持该请求。
-
访问被拒绝
-
2
用户没有必要的访问权限。
-
未知失败
-
8
交互式进程。
-
找不到路径
-
9
找不到服务可执行文件的目录路径。
-
参数无效
-
21
无效的参数已传递给服务。
-
服务未启动
-
22
此服务所运行的帐户无效或缺少运行服务的权限。
-
其他
-
23 4294967295
注解
如果计划的作业启动交互式程序(如 记事本),则必须将 InteractiveWithDeskto 属性设置为 True 或程序屏幕不可见。 即使进程未在屏幕上显示,进程仍会显示在 任务管理器 中。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista |
最低受支持的服务器 |
Windows Server 2008 |
命名空间 |
Root\CIMV2 |
MOF |
|
DLL |
|