Класс Win32_ScheduledJob
Класс 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 |
|
| DLL |
|
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по