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