Win32_ScheduledJob 类的 Create 方法

项目
06/12/2023

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 值，请参阅系统错误代码。

成功完成

请求已接受。

不支持

不支持该请求。

访问被拒绝

用户没有必要的访问权限。

未知失败

交互式进程。

找不到路径

找不到服务可执行文件的目录路径。

参数无效

已将无效参数传递给服务。

服务未启动

运行此服务的帐户无效或缺少运行服务的权限。

其他

23 4294967295

备注

如果计划的作业启动记事本等交互式程序，则必须将 InteractWithDeskto 属性设置为 True ，否则程序的屏幕不可见。即使任务 管理器 中未显示该进程，该进程仍会显示在屏幕上。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另请参阅

操作系统类
Win32_ScheduledJob

Win32_ScheduledJob 类的 Create 方法

语法

参数

返回值

备注

要求

另请参阅

反馈

反馈

其他资源