Создание метода класса Win32_ScheduledJob

Метод класса 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
);

Параметры

Команда [в]

Имя команды, пакетной программы или двоичного файла и параметров командной строки, которые служба расписания использует для вызова задания.

Пример: defrag /q /f.

StartTime [in]

Время выполнения задания в формате UTC. Форма должна быть: "ГГГГММДДЧЧММСС. MMMMMM(+-)ООО", где "ГГГГММДД" необходимо заменить на "*****". Например: "********143000.000000-420" указывает 14,30 (14:30 вечера) PST с переходом на летнее время.

Раздел "(+-)ООО" значения свойства StartTime — это текущее смещение для перевода местного времени. Смещение — это разница между временем в формате UTC и местным временем. Чтобы вычислить смещение для часового пояса, умножьте количество часов, в течение которых часовой пояс опережает или отстает от среднего времени по Гринвичу (GMT) на 60 (используйте положительное число для количества часов, если часовой пояс опережает GMT, и отрицательное число, если часовой пояс отстает от GMT). Если в часовом поясе используется летнее время, добавьте в вычисление еще 60. Например, тихоокеанский стандартный часовой пояс отстает от времени по гринвичу на восемь часов, поэтому смещение равно -420 (-8 * 60 + 60), когда используется летнее время, и -480 (-8 * 60), если летнее время не используется. Вы также можете определить значение смещения, запросив свойство bias класса Win32_TimeZone .

RunRepeatedly [in, необязательный]

Если задано значение True, запланированное задание выполняется несколько раз в определенные дни. По умолчанию False.

DaysOfWeek [in, необязательный]

Дни недели, когда запланировано выполнение задания; используется только в том случае, если параметр RunRepeatedly имеет значение True. Чтобы запланировать задание на более чем один день недели, соедините соответствующие значения в логическом ИЛИ. Например, чтобы запланировать задание по вторникам и пятницам, значение DaysOfWeek равно 2 ИЛИ 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 Error Constants или 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