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
CIMWin32.mof
DLL
CIMWin32.dll

另请参阅

操作系统类

Win32_ScheduledJob