Rob van der Woude's Scripting Pages

SCHTASKS

XP's AT replacement

 

Note: This page shows the command line options for the Windows XP version of SCHTASKS.
Click here for the Windows 7 version of SCHTASKS.

 

Syntax:

SCHTASKS /parameter [arguments]

Description:

Enables an administrator to create, delete, query, change, run and end scheduled tasks on a local or remote system.
Replaces AT.exe.

Parameter List:

/Create Creates a new scheduled task.
/Delete Deletes the scheduled task(s).
/Query Displays all scheduled tasks.
/Change Changes the properties of scheduled task.
/Run Runs the scheduled task immediately.
/End Stops the currently running scheduled task.
/? Displays this help/usage.

Examples:

SCHTASKS  
SCHTASKS /?
SCHTASKS /Run /?
SCHTASKS /End /?
SCHTASKS /Create /?
SCHTASKS /Delete /?
SCHTASKS /Query /?
SCHTASKS /Change /?

/RUN

SCHTASKS /Run [/S system [/U username [/P password]]] /TN taskname

Description:

Runs a scheduled task immediately.

Parameter List:

/S system Specifies the remote system to connect to.
/U username Specifies the user context under which the command should execute.
/P password Specifies the password for the given user context.
/TN taskname Identifies the scheduled task to run.
/? Displays this help/usage.

Examples:

SCHTASKS /Run /?
SCHTASKS /Run /TN "Start Backup"
SCHTASKS /Run /S system /U user /P password /TN "Backup and Restore"

/END

SCHTASKS /End [/S system [/U username [/P password]]] /TN taskname
SCHTASKS /End [/S system [/U username [/P password]]] /TN taskname

Description:

Stops a running scheduled task.

Parameter List:

/S system Specifies the remote system to connect to.
/U username Specifies the user context under which the command should execute.
/P password Specifies the password for the given user context.
/TN taskname Specifies the scheduled task to terminate.
/? Displays this help/usage.

Examples:

SCHTASKS /End /?
SCHTASKS /End /TN "Start Backup"
SCHTASKS /End /S system /U user /P password /TN "Backup and Restore"

/CREATE

SCHTASKS /Create [/S system [/U username [/P password]]] [/RU username [/RP password]] /SC schedule [/MO modifier] [/D day] [/I idletime] /TN taskname /TR taskrun [/ST starttime] [/M months] [/SD startdate] [/ED enddate]

Description:

Enables an administrator to create scheduled tasks on a local or remote systems.

Parameter List:

/S system Specifies the remote system to connect to.
If omitted the system parameter defaults to the local system.
/U username Specifies the user context under which the command should execute.
/P password Specifies the password for the given user context.
/RU username Specifies the user account (user context) under which the task runs.
For the system account, valid values are "", "NT AUTHORITY\SYSTEM" or "SYSTEM".
/RP password Specifies the password for the user.
To prompt for the password, the value must be either "*" or none.
Password will not effect for the system account.
/SC schedule Specifies the schedule frequency.
Valid schedule types: MINUTE, HOURLY, DAILY, WEEKLY, MONTHLY, ONCE, ONSTART, ONLOGON, ONIDLE.
/MO modifier Refines the schedule type to allow finer control over schedule recurrence.
Valid values are: MINUTE: 1 - 1439 minutes.
HOURLY: 1 - 23 hours.
DAILY: 1 - 365 days.
WEEKLY: weeks 1 - 52.
ONCE: No modifiers.
ONSTART: No modifiers.
ONLOGON: No modifiers.
ONIDLE: No modifiers.
MONTHLY: 1 - 12, or FIRST, SECOND, THIRD, FOURTH, LAST, LASTDAY.
/D days Specifies the day of the week to run the task.
Valid values: MON, TUE, WED, THU, FRI, SAT, SUN and for MONTHLY schedules 1 - 31 (days of the month).
/M months Specifies month(s) of the year.
Defaults to the first day of the month.
Valid values: JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC.
/I idletime Specifies the amount of idle time to wait before running a scheduled ONIDLE task.
Valid range: 1 - 999 minutes.
/TN taskname Specifies a name which uniquely identifies this scheduled task.
/TR taskrun Specifies the path and file name of the program to be run by this scheduled task.
Example: C:\windows\system32\calc.exe
/ST starttime Specifies the time to run the task.
The time format is HH:MM:SS (24 hour time) for example, 14:30:00 for 2:30 PM.
/SD startdate Specifies the first date on which the task runs.
The format is "dd/mm/yyyy".
/ED enddate Specifies the last date when the task should run.
The format is "dd/mm/yyyy".
/? Displays this help/usage.

Examples:

SCHTASKS /Create /S system /U user /P password /RU runasuser /RP runaspassword /SC HOURLY /TN rtest1 /TR notepad
SCHTASKS /Create /S system /U user /P password /RU runasuser /RP runaspassword /SC HOURLY /TN rtest1 /TR notepad
SCHTASKS /Create /S system /U domain\user /P password /SC MINUTE /MO 5 /TN rtest2 /TR calc.exe /ST 12:00:00 /SD 15/09/2001 /ED 15/09/2001 /RU runasuser /RP *
SCHTASKS /Create /SC MONTHLY /MO first /D SUN /TN game /TR c:\windows\system32\freecell
SCHTASKS /Create /S system /U user /P password /RU runasuser /RP runaspassword /SC WEEKLY /TN test1 /TR notepad.exe
SCHTASKS /Create /S system /U domain\user /P password /SC MINUTE /MO 5 /TN test2 /TR c:\windows\system32\notepad.exe /ST 18:30:00 /RU runasuser /RP *
SCHTASKS /Create /SC MONTHLY /MO first /D SUN /TN cell /TR c:\windows\system32\freecell /RU runasuser

/DELETE

SCHTASKS /Delete [/S system [/U username [/P password]]] /TN taskname [/F]

Description:

Deletes one or more scheduled tasks.

Parameter List:

/S system Specifies the remote system to connect to.
/U username Specifies the user context under which the command should execute.
/P password Specifies the password for the given user context.
/TN taskname Specifies the name of the scheduled task to delete.
Wildcard "*" may be used to delete all tasks.
/F (Force) Deletes the task and suppresses warnings if the specified task is currently running.
/? Displays this help/usage.

Examples:

SCHTASKS /Delete /TN * /F
SCHTASKS /Delete /TN "Backup and Restore"
SCHTASKS /Delete /S system /U user /P password /TN "Start Restore"
SCHTASKS /Delete /S system /U user /P password /TN "Start Backup" /F

/QUERY

SCHTASKS /Query [/S system [/U username [/P password]]] [/FO format] [/NH] [/V] [/?]

Description:

Enables an administrator to display the scheduled tasks on the local or remote system.

Parameter List:

/S system Specifies the remote system to connect to.
/U username Specifies the user context under which the command should execute.
/P password Specifies the password for the given user context.
/FO format Specifies the output format to be displayed.
Valid values: TABLE, LIST, CSV.
/NH Specifies that the column header should not be displayed in the output.
Valid only for TABLE and CSV formats.
/V Specifies additional output to be displayed.
/? Displays this help/usage.

Examples:

SCHTASKS /Query
SCHTASKS /Query /?
SCHTASKS /Query /S system /U user /P password
SCHTASKS /Query /FO LIST /V /S system /U user /P password
SCHTASKS /Query /FO TABLE /NH /V

/CHANGE

SCHTASKS /Change [/S system [/U username [/P password]]] {[/RU runasuser] [/RP runaspassword] [/TR taskrun]} /TN taskname

Description:

Changes the program to run, or user account and password used by a scheduled task.

Parameter List:

/S system Specifies the remote system to connect to.
/U username Specifies the user context under which the command should execute.
/P password Specifies the password for the given user context.
/RU username Changes the user name (user context) under which the scheduled task has to run.
For the system account, valid values are "", "NT AUTHORITY\SYSTEM" or "SYSTEM".
/RP password Specifies a new password for the existing user context or the password for a new user account.
Password will not effect for the system account.
/TR taskrun Specifies a new program that the scheduled task runs. Type the path and file name of the program.
/TN taskname Specifies which scheduled task to change.
/? Displays this help/usage.

Examples:

SCHTASKS /Change /RP password /TN "Backup and Restore"
SCHTASKS /Change /TR restore.exe /TN "Start Restore"
SCHTASKS /Change /S system /U user /P password /RU newuser /TN "Start Backup"

page last modified: 2016-09-19; loaded in 0.0014 seconds