Класс Win32_ScheduledJob

Статья
06/12/2023

Класс WMIWin32_ScheduledJob представляет задание, созданное с помощью команды AT.

Примечание

Класс Win32_ScheduledJob не представляет задание, созданное с помощью мастера запланированных задач из панель управления. Вы не можете изменить задачу, созданную WMI в пользовательском интерфейсе запланированных задач. Дополнительные сведения см. в разделе «Примечания».

Следующий пример синтаксиса — упрощенный MOF-код, который включает все наследуемые свойства. Свойства и методы находятся в алфавитном порядке, а не в порядке MOF.

Синтаксис

[Dynamic, Provider("CIMWin32"), UUID("{8502C4E0-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("Delete"), AMENDMENT]
class Win32_ScheduledJob : CIM_Job
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  datetime ElapsedTime;
  string   Notify;
  string   Owner;
  uint32   Priority;
  datetime TimeSubmitted;
  datetime UntilTime;
  string   Command;
  uint32   DaysOfMonth;
  uint32   DaysOfWeek;
  boolean  InteractWithDesktop;
  uint32   JobId;
  string   JobStatus;
  boolean  RunRepeatedly;
  datetime StartTime;
};

Члены

Класс Win32_ScheduledJob имеет следующие типы членов:

Методы
Свойства

Методы

Класс Win32_ScheduledJob содержит следующие методы.

Метод	Описание
Создать	Метод класса, который отправляет задание в операционную систему для выполнения в указанное будущее время и дату.
Удалить	Метод класса, который удаляет запланированное задание.

Свойства

Класс Win32_ScheduledJob имеет следующие свойства.

Caption

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), DisplayName ("Caption")

Краткое текстовое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

Command

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры управления сетью | | AT_INFO Command")

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

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

DaysOfMonth

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры управления сетью | | AT_INFO DaysOfMonth")

Дни месяца, когда запланировано выполнение задания. Если задание запланировано на выполнение нескольких дней месяца, эти значения можно объединить в логическое ИЛИ. Например, если задание выполняется 1-го и 16-го числа каждого месяца, значение свойства DaysOfMonth будет равно 1 ИЛИ 32768.

1 (1)

1st

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)

11th

12 (2048)

12th

13 (4096)

13th

14 (8192)

14-е

15 (16384)

15-й

16 (32768)

16-е

17 (65536)

17-й

18 (131072)

18-е

19 (262144)

19-й

20 (524288)

20-й

21 (1048576)

21st

22 (2097152)

22nd

23 (4194304)

23rd

24 (8388608)

24-й

25 (16777216)

25-й

26 (33554432)

26-й

27 (67108864)

27-й

28 (134217728)

28-й

29 (268435456)

29-й

30 (536870912)

30-й

31 (1073741824)

31-й

DaysOfWeek

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры управления сетью | | AT_INFO DaysOfWeek")

Дни недели, когда запланировано выполнение задания. Если задание запланировано для выполнения в несколько дней недели, значения можно объединить в логическом ИЛИ. Например, если задание планируется выполнять по понедельникам, средам и пятницам, значение свойства DaysOfWeek будет равно 1 ИЛИ 4 ИЛИ 16.

Понедельник (1)

Вторник (2)

Среда (4)

Четверг (8)

Пятница (16)

Суббота (32)

Воскресенье (64)

Описание

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Описание")

Текстовое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

ElapsedTime

Тип данных: datetime
Тип доступа: только для чтения

Продолжительность выполнения задания.

Это свойство наследуется от CIM_Job.

InstallDate

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")

Указывает, когда был установлен объект . Отсутствие значения не означает, что объект не установлен.

Это свойство наследуется от CIM_ManagedSystemElement.

InteractWithDesktop

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры управления сетью | | AT_INFO Флаги|JOB_NONINTERACTIVE")

Указанное задание является интерактивным, то есть пользователь может предоставить входные данные запланированному заданию во время его выполнения.

JobId

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: Key, MappingStrings ("Win32API| Структуры управления сетью | | AT_ENUM JobId")

Определение номера задания. Он используется методами в качестве дескриптора для одного задания, запланированного на этом компьютере.

JobStatus

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Override ("JobStatus"), MappingStrings ("Win32API| | Структуры управления сетью | | AT_ENUM Флаги|JOB_EXEC_ERROR")

Состояние выполнения последнего запланированного выполнения задания.

Success ("Успех")

Сбой ("Сбой")

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Имя")

Метка, по которой известен объект. При создании подкласса это свойство может быть переопределено как ключевое свойство.

Это свойство наследуется от CIM_ManagedSystemElement.

Уведомление

Тип данных: string
Тип доступа: только для чтения

Пользователь получает уведомление о завершении задания или сбое.

Это свойство наследуется от CIM_Job.

Владелец

Тип данных: string
Тип доступа: только для чтения

Пользователь, отправивший задание.

Это свойство наследуется от CIM_Job.

Приоритет

Тип данных: uint32
Тип доступа: только для чтения

Важность выполнения задания.

Это свойство наследуется от CIM_Job.

RunRepeatedly

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Структуры управления сетью | | AT_INFO Флаги|JOB_RUN_PERIODICALLY")

Запланированное задание выполняется несколько раз в те дни, когда запланировано задание. Если задано значение False, задание выполняется один раз.

StartTime

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: Override ("StartTime"), MappingStrings ("Win32API| | Структуры управления сетью | | AT_ENUM JobTime")

Время выполнения задания в формате UTC в формате ГГГГММДДЧЧМММСС. MMMMMM(+-)ООО", где "ГГГГММДД" необходимо заменить на "*****". Замена необходима, так как служба планирования позволяет настроить задания для выполнения только один раз или в день месяца или недели. Задание не может выполняться в определенную дату.

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

Например: "********123000.000000-420" указывает 14.30 (14:30) PST с переходом на летнее время.

Состояние

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (10), DisplayName ("Status")

Строка, указывающая текущее состояние объекта. Можно определить рабочее и нерабочем состояние. Состояние работы может включать "ОК", "Понижено" и "Сбой предварительного выполнения". "Pred Fail" означает, что элемент работает правильно, но прогнозирует сбой (например, жесткий диск с поддержкой SMART).

Состояние нерабоспособных может включать "Ошибка", "Запуск", "Остановка" и "Служба". "Служба" может применяться во время зеркало повторного изменения размера диска, перезагрузки списка разрешений пользователя или других административных действий. Не все такие работы доступны в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.

Это свойство наследуется от CIM_ManagedSystemElement.

В эти значения входят:

ОК ("ОК")

Ошибка ("Ошибка")

Пониженный ("Пониженный")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Запуск ("Начало")

Остановка ("Остановка")

Служба ("Служба")

Подчеркнуто ("Подчеркнуто")

NonRecover ("NonRecover")

Нет контакта ("Нет контакта")

Lost Comm ("Lost Comm")

TimeSubmitted

Тип данных: datetime
Тип доступа: только для чтения

Время отправки задания.

Это свойство наследуется от CIM_Job.

UntilTime

Тип данных: datetime
Тип доступа: только для чтения

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

Это свойство наследуется от CIM_Job.

Каждое задание, запланированное для службы расписания, хранится постоянно (планировщик может запустить задание после перезагрузки) и выполняется в указанное время и день недели или месяца. Если компьютер не активен или запланированная служба не запущена в указанное время задания, служба расписания запускает указанное задание на следующий день в указанное время.

Задания планируются в соответствии с универсальным координированным временем (UTC) с смещением от среднего по Гринвичу (GMT), что означает, что задание можно указать с помощью любого часового пояса. Класс Win32_ScheduledJob возвращает местное время со смещением в формате UTC при перечислении объекта и преобразуется в местное время при создании новых заданий. Например, задание, указанное для запуска на компьютере в Бостоне в 22:30 по PST-времени понедельника, будет запланировано на локальное выполнение в 1:30 утра вторника по EST.

Примечание

Клиент должен учитывать, работает ли летнее время на локальном компьютере, и если это так, то вычесть смещение в 60 минут из смещения в формате UTC.

Класс Win32_ScheduledJob является производным от CIM_Job. Чтобы создать запланированное задание с помощью этого класса, необходимо быть членом группы администраторов.

Класс Win32_ScheduledJob использует протокол AT, который привязан к устареению, начиная с Windows 8 и Windows Server 2012. В качестве первого шага протокол AT отключен по умолчанию. Если протокол отключен, например вызов метода Create для объекта Win32_ScheduledJob завершится ошибкой 0x8. Вы можете снова включить протокол AT, добавив следующую запись реестра:

Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Schedule\Configuration 
Name: EnableAt 
Type: REG_DWORD
Value: 1

Чтобы этот параметр вступил в силу, может потребоваться перезапустить компьютер.

Так как Win32_ScheduledJob основан на API Win32 NetScheduleJobGetInfo , этот класс нельзя использовать вместе с планировщиком задач. Если вы хотите использовать планировщик задач, используйте API планировщика задач. Дополнительные сведения см. в справочнике по планировщику задач.

Примеры

В следующем примере кода VBScript Notepad.exe выполняться в интерактивном режиме в 1:25 по местному времени компьютера каждую среду.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\Root\CIMv2")
Set objNewJob = objWMIService.Get("Win32_ScheduledJob")
errJobCreated = objNewJob.Create("Notepad.exe", "********012500.000000-420", True , 4, , True, JobId) 
If errJobCreated <> 0 Then
Wscript.Echo "Error on task creation"
Else
Wscript.Echo "Task created"
End If

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

См. также раздел

CIM_Job
Классы операционной системы
Задачи WMI: запланированные задачи

Поделиться через

Класс Win32_ScheduledJob

Синтаксис

Члены

Методы

Свойства

Комментарии

Примеры

Требования

См. также раздел

Обратная связь

Дополнительные ресурсы