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

另请参阅

操作系统类

Win32_ScheduledJob