Win32 _ ScheduledJob 类的 Create 方法

Create WMI 类方法将作业提交到操作系统,以在将来的指定时间和日期执行。 此方法要求在提交作业的计算机上启动计划服务。

本主题使用 托管对象格式 (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
);

参数

命令 []

计划服务用于调用作业的命令、批处理程序或二进制文件和命令行参数的名称。

示例:"defrag /q /f"。

StartTime []

协调世界时 (UTC) 运行作业的时间。 窗体必须为:"YYYYMMDDHHMMSS"。MMMMMM (+-) OOO",其中"YYYYMMDD"必须替换为 * * * * * * * * ""。 * * * * * * * * 例如:"143000.000000-420"指定 14.30 (2:30 ) PST,夏令时生效。

StartTime 属性值 (+-) OOO"部分是本地时间转换的当前偏差。 偏差是 UTC 时间与本地时间之间的差值。 若要计算时区的偏差,请将时区提前或晚于 gmt gmt 标准时间 (GMT) 的小时数乘以 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 天

2048 (12)

每月的第 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,则指定的作业应为 interactive,这意味着用户可以在作业执行期间向计划作业发出输入。 默认值为 False

JobId [弄]

作业的标识号。 此参数是在计算机上计划作业的句柄。

返回值

如果成功,则返回值 0 (零) ,并返回一个不同的数字来指示错误。 有关其他错误代码,请参阅 WMI 错误常量WbemErrorEnum。 有关常规 HRESULT 值,请参阅 系统错误代码

成功完成

0

请求被接受。

不支持

1

不支持该请求。

访问被拒绝

2

用户没有所需的访问权限。

未知故障

8

交互进程。

找不到路径

9

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

参数无效

21

向服务传递的参数无效。

服务未启动

22

运行该服务的帐户无效或无权运行该服务。

其他

23 4294967295

备注

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

要求

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

请参阅

操作系统类

Win32 _ get-scheduledjob