Windows Task Scheduler
A component of Microsoft Windows | |
---|---|
Management console for Task Scheduler 2.0 in Windows 7 | |
Details | |
Other names |
taskschd.msc |
Type | Windows service |
Included with |
|
Replaces | System Agent |
Service name |
Task Scheduler (Schedule ) |
Description | Enables a user to configure and schedule automated tasks on this computer. The service also hosts multiple Windows system-critical tasks. |
Related components | |
Microsoft Management Console, Windows Event Log |
Task Scheduler is a component of Microsoft Windows that provides the ability to schedule the launch of programs or scripts at pre-defined times or after specified time intervals: job scheduling (task scheduling). It was first introduced in the Microsoft Plus! for Windows 95 as System Agent[1] but was renamed to Task Scheduler in Windows 98. The Windows Event Log service must be running before the Task Scheduler starts up.
This service should not be confused with the scheduler that allocates CPU resources to processes already in memory.
Versions
Task Scheduler 1.0
Task Scheduler 1.0 is included with Windows 2000, Windows XP and Windows Server 2003.[2] It runs as a Windows Service, and the task definitions and schedules are stored in binary .job
files. Tasks are manipulated directly by manipulating the .job
files. Each task corresponds to single action. On Windows 95, Windows 98 and Windows Me, the Task Scheduler runs as an ordinary program, mstask.exe
. It also displays a status icon in the notification area on Windows 95 and Windows 98 and runs as a hidden service on Windows Me, but can be made to show a tray icon.[3] On Windows 2000, Windows XP and Windows Server 2003, it is implemented as a Windows service. Computer programs and scripts can access the service through six COM interfaces.[4] Microsoft provides a scheduling agent DLL, a sample VBScript and a configuration file to automate Task Scheduler.[5]
In addition to the graphical user interface for Task Scheduler in Control Panel, Windows provides two command-line tools for managing scheduled task: at.exe
(deprecated) and schtasks.exe
.[6][7] However, at.exe
cannot access tasks created or modified by Control Panel or schtasks.exe
.[8] Also, tasks created with at.exe
are not interactive by default; interactivity needs to be explicitly requested.[9]
Task Scheduler 2.0
Task Scheduler 2.0 was introduced with Windows Vista and included in Windows Server 2008 as well.[2] The redesigned Task Scheduler user interface is now based on Management Console. In addition to running tasks on scheduled times or specified intervals, Task Scheduler 2.0 also supports calendar and event-based triggers, such as starting a task when a particular event is logged to the event log, or when a combination of events has occurred. Also, several tasks that are triggered by the same event can be configured to run either simultaneously or in a pre-determined chained sequence of a series of actions, instead of having to create multiple scheduled tasks. Tasks can also be configured to run based on system status such as being idle for a pre-configured amount of time, on startup, logoff, or only during or for a specified time. XPath expressions can be used to filter events from the Windows Event Log. Tasks can also be delayed for a specified time after the triggering event has occurred, or repeat until some other event occurs. Actions that need to be done if a task fails can also be configured. The actions that can be taken in response to triggers, both event-based as well as time-based, not only include launching applications but also take a number of custom actions. Task Scheduler includes a number of actions built-in, spanning a number of applications; including send an e-mail, show a message box, or fire a COM handler when it is triggered. Custom actions can also be specified using the Task Scheduler API. Task Scheduler keeps a history log of all execution details of all the tasks. .[10] Windows Vista uses Task Scheduler 2.0 to run various system-level tasks;[11] consequently, the Task Scheduler service can no longer be disabled (except with a simple registry tweak).
Task Scheduler 2.0 exposes an API to allow computer programs and scripts create tasks.[12] It consists of 42 COM interfaces.[13] The Windows API does not, however, include a managed wrapper for Task Scheduler though an open source implementation exists. The job files for Task Scheduler 2.0 are XML-based, and are human-readable, conforming to the Task Scheduler Schema.[12] Although possible, Microsoft advises not to create the job files by hand, and instead, use the Task Scheduler API.
Other features
- New security features, including using Credential Manager to passwords for tasks on workgroup computers and using Active Directory for task credentials on domain-joined computers so that they cannot be retrieved easily. Also, scheduled tasks are executed in their own session, instead of the same session as system services or the current user.
- Ability to wake up a machine remotely or using BIOS timer from sleep or hibernation to execute a scheduled task or run a previously scheduled task after a machine gets turned on.
- Ability to attach tasks to events directly from the Event Viewer.
Tasks
The Task Scheduler service works by managing Tasks; Task refers to the action (or actions) taken in response to trigger(s). A task is defined by associating a set of actions, which can include launching an application or taking some custom-defined action, to a set of triggers, which can either be time-based or event-based. In addition, a task also can contain metadata that defines how the actions will be executed, such as the security context the task will run in. Tasks are serialized to .job
files and are stored in the special folder titled Task Folder, organized in subdirectories. Programmatically, the task folder is accessed using the ITaskFolder
interface or the TaskFolder
scripting object and individual tasks using the IRegisteredTask
interface or RegisteredTask
object.[14]
Column 'Last Result'
The Last Result column displays a completion code. The common codes for scheduled tasks are:[15]
- 0 or 0x0 The operation completed successfully.
- 1 or 0x1 Incorrect function called or unknown function called.
- 2 or 0x2 File not found.
- 10 or 0xa The environment is incorrect.
- 0x41300 Task is ready to run at its next scheduled time.
- 0x41301 Task is currently running.
- 0x41302 Task is disabled.
- 0x41303 Task has not yet run.
- 0x41304 There are no more runs scheduled for this task.
- 0x41306 Task is terminated.
- 0x8004131F An instance of this task is already running.
- 0x800704DD The service is not available (is 'Run only when a user is logged on' checked?)
- 0xC000013A The application terminated as a result of a CTRL+C.
- 0xC06D007E Unknown software exception.
- SCHED_S_TASK_READY: 0x00041300: The task is ready to run at its next * SCHEDuled time.
- SCHED_S_TASK_RUNNING: 0x00041301: The task is currently running.
- SCHED_S_TASK_DISABLED: 0x00041302: The task will not run at the * SCHEDuled times because it has been disabled.
- SCHED_S_TASK_HAS_NOT_RUN: 0x00041303: The task has not yet run.
- SCHED_S_TASK_NO_MORE_RUNS: 0x00041304: There are no more runs * SCHEDuled for this task.
- SCHED_S_TASK_NOT_* SCHEDULED: 0x00041305: One or more of the properties that are needed to run this task on a * SCHEDule have not been set.
- SCHED_S_TASK_TERMINATED: 0x00041306: The last run of the task was terminated by the user.
- SCHED_S_TASK_NO_VALID_TRIGGERS: 0x00041307: Either the task has no triggers or the existing triggers are disabled or not set.
- SCHED_S_EVENT_TRIGGER: 0x00041308: Event triggers do not have set run times.
- SCHED_E_TRIGGER_NOT_FOUND: 0x80041309: A task's trigger is not found.
- SCHED_E_TASK_NOT_READY: 0x8004130A: One or more of the properties required to run this task have not been set.
- SCHED_E_TASK_NOT_RUNNING: 0x8004130B: There is no running instance of the task.
- SCHED_E_SERVICE_NOT_INSTALLED: 0x8004130C: The Task * SCHEDuler service is not installed on this computer.
- SCHED_E_CANNOT_OPEN_TASK: 0x8004130D: The task object could not be opened.
- SCHED_E_INVALID_TASK: 0x8004130E: The object is either an invalid task object or is not a task object.
- SCHED_E_ACCOUNT_INFORMATION_NOT_SET: 0x8004130F: No account information could be found in the Task * SCHEDuler security database for the task indicated.
- SCHED_E_ACCOUNT_NAME_NOT_FOUND: 0x80041310: Unable to establish existence of the account specified.
- SCHED_E_ACCOUNT_DBASE_CORRUPT: 0x80041311: Corruption was detected in the Task * SCHEDuler security database
- SCHED_E_NO_SECURITY_SERVICES: 0x80041312: Task * SCHEDuler security services are available only on Windows NT.
- SCHED_E_UNKNOWN_OBJECT_VERSION: 0x80041313: The task object version is either unsupported or invalid.
- SCHED_E_UNSUPPORTED_ACCOUNT_OPTION: 0x80041314: The task has been configured with an unsupported combination of account settings and run time options.
- SCHED_E_SERVICE_NOT_RUNNING: 0x80041315: The Task * SCHEDuler Service is not running.
- SCHED_E_UNEXPECTEDNODE: 0x80041316: The task XML contains an unexpected node.
- SCHED_E_NAMESPACE: 0x80041317: The task XML contains an element or attribute from an unexpected namespace.
- SCHED_E_INVALIDVALUE: 0x80041318: The task XML contains a value which is incorrectly formatted or out of range.
- SCHED_E_MISSINGNODE: 0x80041319: The task XML is missing a required element or attribute.
- SCHED_E_MALFORMEDXML: 0x8004131A: The task XML is malformed.
- SCHED_S_SOME_TRIGGERS_FAILED: 0x0004131B: The task is registered, but not all specified triggers will start the task.
- SCHED_S_BATCH_LOGON_PROBLEM: 0x0004131C: The task is registered, but may fail to start. Batch logon privilege needs to be enabled for the task principal.
- SCHED_E_TOO_MANY_NODES: 0x8004131D: The task XML contains too many nodes of the same type.
- SCHED_E_PAST_END_BOUNDARY: 0x8004131E: The task cannot be started after the trigger end boundary.
- SCHED_E_ALREADY_RUNNING: 0x8004131F: An instance of this task is already running.
- SCHED_E_USER_NOT_LOGGED_ON: 0x80041320: The task will not run because the user is not logged on.
- SCHED_E_INVALID_TASK_HASH: 0x80041321: The task image is corrupt or has been tampered with.
- SCHED_E_SERVICE_NOT_AVAILABLE: 0x80041322: The Task * SCHEDuler service is not available.
- SCHED_E_SERVICE_TOO_BUSY: 0x80041323: The Task * SCHEDuler service is too busy to handle your request. Please try again later.
- SCHED_E_TASK_ATTEMPTED: 0x80041324: The Task * SCHEDuler service attempted to run the task, but the task did not run due to one of the constraints in the task definition.
- SCHED_S_TASK_QUEUED: 0x00041325: The Task * SCHEDuler service has asked the task to run.
- SCHED_E_TASK_DISABLED: 0x80041326: The task is disabled.
- SCHED_E_TASK_NOT_V1_COMPAT: 0x80041327: The task has properties that are not compatible with earlier versions of Windows.
- SCHED_E_START_ON_DEMAND: 0x80041328: The task settings do not allow the task to start on demand.
Bugs
On Windows 2000 and Windows XP, tasks assigned to run with SYSTEM privileges do not function when the computer is prepared for disk imaging with sysprep
. Sysprep changes the security identifier (SID) to avoid duplication but does not update scheduled tasks to use the new SID. Consequently, all SYSTEM scheduled tasks fail to run on the imaged computers. There is no solution for this problem but one may reschedule the tasks to work around the issue.[17]
On Windows Vista or Windows Server 2008, where Service Pack 2 is not installed, the next execution time displayed in Task Scheduler may be wrong.[18]
On Windows Vista, 7, 2008, and 2008 R2: The MMC Component says that you are running "Task Scheduler 1.0" when in fact you are running 2.0, this is a trivial bug so it wasn't noticed, and is likely due to the re-write of the task scheduler. The version has been corrected to 2.0 in Windows 8 and in 2012.
See also
References
- ↑ Al Fasoltd. "Windows 98: Stable and fast, as well as 'new and improved'". The Syracuse Newspapers. Retrieved 2007-10-06.
- 1 2 "About the Task Scheduler". Retrieved 2007-10-06.
- ↑ How to Enable the Scheduled Tasks Icon in Windows Me
- ↑ "Task Scheduler 1.0 Interfaces". MSDN. Microsoft. Retrieved 30 May 2014.
- ↑ Task Scheduler Using VBScript
- ↑ "Schtasks". Windows XP command-line reference. Microsoft. Retrieved 18 May 2014.
- ↑ "At". Windows XP command-line reference. Microsoft. Retrieved 18 May 2014.
- ↑ "How To Use the AT Command to Schedule Tasks". Support (4.5 ed.). Microsoft. 30 October 2006.
- ↑ "Applications Started with AT Are Not Interactive". Support (3.2 ed.). Microsoft. 20 February 2007.
- ↑ "Windows Vista Task Scheduler". Microsoft TechNet. March 3, 2006. Retrieved 2006-04-24.
- ↑ Description of the scheduled tasks in Windows Vista
- 1 2 Kenny Kerr. "Task Scheduler 2.0". MSDN. Retrieved 2007-10-06.
- ↑ "Task Scheduler 2.0 Interfaces". MSDN. Microsoft. Retrieved 30 May 2014.
- ↑ "Tasks (Windows)". MSDN. Retrieved 2007-10-06.
- ↑ "How to troubleshoot scheduled tasks in Windows XP and in Windows Server 2003". Microsoft Support. Microsoft. 22 May 2013. Retrieved 3 Sep 2013.
- ↑ http://msdn.microsoft.com/en-gb/library/windows/desktop/aa383604(v=vs.85).aspx
- ↑ "Scheduled tasks may not start if you used a System Preparation image to install Windows XP or Windows 2000". Microsoft Support. Microsoft. 1 July 2004. Retrieved 19 May 2012.
- ↑ "The value in the Next Run Time field in Task Scheduler is incorrect in Windows Vista and in Windows Server 2008". Microsoft Support. Microsoft. 15 October 2008. Retrieved 19 May 2012.
External links
- Task Scheduler on MSDN
- The Log File in the Task Scheduler May Be Incorrectly Formatted and Difficult to Read
- Unable to Delete Text in the Task Scheduler Log File
- Task Scheduler Service Does Not Start
- Scheduled Program Does Not Start in Task Scheduler
- Cannot Disable Task Scheduler
- Scheduled Tasks for Active Directory Management
- Task Scheduler Managed Wrapper