Schtasks.exe
允许管理员在本地或远程计算机上创建、删除、查询、更改、运行和结束计划任务。 在没有参数的情况下运行Schtasks.exe会显示每个已注册任务的状态和下一次运行时间。
有关任务计划程序的详细信息,请参阅此简介: 面向开发人员的任务计划程序。
创建任务
以下语法用于在本地或远程计算机上创建任务。
schtasks /Create
[/S system [/U username [/P [password]]]]
[/RU username [/RP [password]] /SC schedule [/MO modifier] [/D day]
[/M months] [/I idletime] /TN taskname /TR taskrun [/ST starttime]
[/RI interval] [ {/ET endtime | /DU duration} [/K]
[/XML xmlfile] [/V1]] [/SD startdate] [/ED enddate] [/IT] [/Z] [/F]
参数
-
/S系统
-
一个 值,该值指定要连接到的远程计算机。 如果省略,则系统参数默认为本地计算机。
-
/U用户名
-
一个 值,该值指定运行Schtasks.exe的用户上下文。
-
/P[password]
-
一个 值,该值指定给定用户上下文的密码。 如果省略,Schtasks.exe会提示用户输入。
-
/RU用户名
-
一个 值,该值指定运行任务的用户上下文。 对于系统帐户,有效值为“”、“NT AUTHORITY\SYSTEM”或“SYSTEM”。 对于任务计划程序 2.0 任务,“NT AUTHORITY\LOCALSERVICE”和“NT AUTHORITY\NETWORKSERVICE”也是有效值。
-
/RP[password]
-
一个 值,该值指定使用 /RU 参数指定的用户的密码。 若要提示输入密码,该值必须为“*”或无值。 对于系统帐户,将忽略此密码。 此参数必须与 /RU 或 /XML 开关结合使用。
-
/SC计划
-
一个指定计划频率的 值。 有效值为:MINUTE、HOURLY、DAILY、WEEKLY、MONTHLY、ONCE、ONSTART、ONLOGON、ONIDLE 和 ONEVENT。
-
/MO修饰符
-
一个 值,用于优化计划类型,以便更好地控制计划重复周期。 有效值是:
- 分钟:1 - 1439 分钟。
- 每小时:1 - 23 小时。
- 每日:1 - 365 天。
- 每周:第 1 - 52 周。
- 一次:无修饰符。
- ONSTART:无修饰符。
- ONLOGON:无修饰符。
- ONIDLE:无修饰符。
- 每月:1 - 12 个,或第一个、第二个、第三个、第四个、最后一个和最后一天。
- ONEVENT:XPath 事件查询字符串。
-
/D天
-
一个 值,该值指定要运行任务的星期几。 有效值为:星期一、二、三、四、星期五、星期六、星期六、星期日和每月计划 1 - 31 (天) 。 通配符 (*) 指定所有天数。
-
/M月
-
一个指定一年中的月份的值。 默认为当月的第一天。 有效值为:JAN、FEB、MAR、APR、MAY、JUN、JUL、AUG、SEP、OCT、NOV 和 DEC。 通配符 (*) 指定所有月份。
-
/Iidletime
-
一个 值,该值指定在运行计划的 ONIDLE 任务之前要等待的空闲时间量。 有效范围为 1 - 999 分钟。
-
/TNtaskname
-
一个 值,该值指定唯一标识计划任务的名称。
-
/TRtaskrun
-
一个 值,该值指定要在计划时间运行的任务的路径和文件名。 例如:C:\Windows\System32\calc.exe。
-
/STstarttime
-
一个 值,该值指定运行任务的开始时间。 时间格式为 HH:mm (24 小时) 。 例如,14:30 指定下午 2:30。 默认值为当前时间未指定 /ST。 此选项是 /SC ONCE 参数所必需的。
-
/RI间隔
-
一个 值,该值指定重复间隔(以分钟为单位)。 这不适用于以下计划类型:MINUTE、HOURLY、ONSTART、ONLOGON、ONIDLE 和 ONEVENT。 有效范围为 1 - 599940 分钟。 如果指定了 /ET 或 /DU 参数,则默认值为 10 分钟。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/ETendtime
-
一个 值,该值指定运行任务的结束时间。 时间格式为 HH:mm (24 小时) 。 例如,14:50 指定下午 2:50。 这不适用于以下计划类型:ONSTART、ONLOGON、ONIDLE 和 ONEVENT。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/DU持续时间
-
一个 值,该值指定运行任务的持续时间。 时间格式为 HH:mm (24 小时) 。 例如,14:50 指定下午 2:50。 这不适用于 /ET 和以下计划类型:ONSTART、ONLOGON、ONIDLE 和 ONEVENT。 对于 /V1 任务 (任务计划程序 1.0 任务) ,如果指定了 /RI,则默认持续时间为一小时。
Windowsxp: 此选项不可用。
-
/K
-
一个值,该值在结束时间或持续时间终止任务。 这不适用于以下计划类型:ONSTART、ONLOGON、ONIDLE 和 ONEVENT。 必须指定 /ET 或 /DU。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/SDstartdate
-
一个 值,该值指定运行任务的第一个日期。 格式为 mm/dd/yyyy。 此值默认为当前日期。 这不适用于以下计划类型:ONCE、ONSTART、ONLOGON、ONIDLE 和 ONEVENT。
-
/EDenddate
-
一个 值,该值指定任务将运行的最后一个日期。 格式为 mm/dd/yyyy。 这不适用于以下计划类型:ONCE、ONSTART、ONLOGON、ONIDLE 和 ONEVENT。
-
/ECChannelName
-
一个 值,该值指定 ONEVENT 触发器的事件通道。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/IT
-
一个 值,该值使任务仅当 /RU 用户当前在任务运行时登录时才能以交互方式运行。 仅当用户登录时,任务才会运行。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/Np
-
一个 值,该值指示不存储任何密码。 任务不以给定用户身份以交互方式运行。 只有本地资源可用。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/Z
-
一个值,该值将任务标记为在最终运行后删除。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/XMLxmlfile
-
一个值,该值从 XML 文件创建任务。 当任务 XML 已包含主体时,此参数可以与 /RU 和 /RP 开关结合使用,也可以单独与 /RP 开关结合使用。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/V1
-
一个 值,该值创建对 Windows 2000、Windows Server 2003 和 Windows XP 平台可见的任务。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/F
-
一个值,该值在指定任务已存在时强制创建任务并禁止显示警告。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/RL级别
-
一个值,该值设置任务的运行级别。 有效值为 LIMITED 和 HIGHEST。 默认值为 LIMITED。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/DELAY延迟时间
-
一个 值,该值指定触发触发器后延迟任务的等待时间。 时间格式为 mmmm:ss。 此选项仅适用于计划类型 ONSTART、ONLOGON 和 ONEVENT。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/?
-
一个 值,该值显示Schtasks.exe的帮助消息。
备注
在 Windows XP、Windows Server 2003 或 Windows 2000 操作系统上运行的远程计算机上创建任务时,请使用 /V1 开关。
如果远程计算机启用了文件和打印机共享防火墙例外和禁用远程计划任务管理防火墙例外,则不能创建非交互式远程任务计划程序 1.0 任务, (不使用 /IT) 开关和 /V1 开关创建任务。
删除任务
以下语法用于删除一个或多个计划任务。
schtasks /Delete
[/S system [/U username [/P [password]]]]
[/TN taskname] [/F]
参数
-
/S系统
-
一个 值,该值指定要连接到的远程计算机。 如果省略,则系统参数默认为本地计算机。
-
/U用户名
-
一个 值,该值指定运行Schtasks.exe的用户上下文。
-
/P[password]
-
一个 值,该值指定给定用户上下文的密码。 如果省略,Schtasks.exe会提示用户输入。
-
/TNtaskname
-
一个 值,该值指定要删除的计划任务的名称。 通配符 (*) 可用于删除所有任务。
-
/F
-
一个值,该值在指定的任务正在运行时强制删除任务并取消警告。
-
/?
-
显示Schtasks.exe帮助的值。
运行任务
以下语法用于立即运行计划任务。
schtasks /Run
[/S system [/U username [/P [password]]]]
/TN taskname
参数
-
/S系统
-
一个 值,该值指定要连接到的远程计算机。 如果省略,则系统参数默认为本地计算机。
-
/U用户名
-
一个 值,该值指定运行Schtasks.exe的用户上下文。
-
/P[password]
-
一个 值,该值指定给定用户上下文的密码。 如果省略,Schtasks.exe会提示用户输入。
-
/TNtaskname
-
一个 值,该值指定要运行的计划任务的名称。
-
/?
-
显示Schtasks.exe帮助的值。
结束正在运行的任务
以下语法用于停止正在运行的计划任务。
注意
若要停止远程任务的运行,请确保远程计算机已启用文件和打印机共享和远程计划任务管理防火墙例外。
schtasks /End
[/S system [/U username [/P [password]]]]
/TN taskname
参数
-
/S系统
-
一个 值,该值指定要连接到的远程计算机。 如果省略,则系统参数默认为本地计算机。
-
/U用户名
-
一个 值,该值指定运行Schtasks.exe的用户上下文。
-
/P[password]
-
一个 值,该值指定给定用户上下文的密码。 如果省略,Schtasks.exe会提示用户输入。
-
/TNtaskname
-
一个 值,该值指定要停止的计划任务的名称。
-
/?
-
显示Schtasks.exe帮助的值。
查询任务信息
以下语法用于显示本地或远程计算机中的计划任务。
schtasks /Query
[/S system [/U username [/P [password]]]]
[/FO format | /XML] [/NH] [/V] [/TN taskname] [/?]
参数
-
/S系统
-
一个 值,该值指定要连接到的远程计算机。 如果省略,则系统参数默认为本地计算机。
-
/U用户名
-
一个 值,该值指定运行Schtasks.exe的用户上下文。
-
/P[password]
-
一个 值,该值指定给定用户上下文的密码。 如果省略,Schtasks.exe会提示用户输入。
-
/FO格式
-
一个指定输出格式的 值。 有效值为 TABLE、LIST 和 CSV。
-
/Nh
-
一个 值,该值指定列标题不应显示在输出中。 这仅适用于 TABLE 和 CSV 格式。
-
/V
-
一个显示详细任务输出的值。
注意
如果某个任务只计划运行一次,则显示的计划信息为“计划数据以此格式不可用”。
-
/TNtaskname
-
一个 值,该值指定要检索其信息的任务名称。 如果未指定任务名称,将显示所有任务的信息。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/Xml
-
一个值,用于以 XML 格式显示任务定义。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/?
-
一个值,用于显示Schtasks.exe的帮助。
更改任务
以下语法用于更改程序的运行方式,或更改计划任务使用的用户帐户和密码。
schtasks /Change
[/S system [/U username [/P [password]]]] /TN taskname
{ [/RU runasuser] [/RP runaspassword] [/TR taskrun] [/ST starttime]
[/RI interval] [ {/ET endtime | /DU duration} [/K] ]
[/SD startdate] [/ED enddate] [/ENABLE | /DISABLE] [/IT] [/Z] }
参数
-
/S系统
-
一个 值,该值指定要连接到的远程计算机。 如果省略,则系统参数默认为本地计算机。
-
/U用户名
-
一个 值,该值指定运行Schtasks.exe的用户上下文。
-
/P[password]
-
一个 值,该值指定给定用户上下文的密码。 如果省略,Schtasks.exe会提示用户输入。
-
/TNtaskname
-
一个 值,该值指定要更改的计划任务。
-
/RUrunasuser
-
一个 值,该值更改将运行计划任务) 用户上下文 (用户名。 对于系统帐户,有效值为“”、“NT AUTHORITY\SYSTEM”或“SYSTEM”。 对于任务计划程序 2.0 任务,“NT AUTHORITY\LOCALSERVICE”和“NT AUTHORITY\NETWORKSERVICE”也是有效值。
-
/RPrunaspassword
-
一个 值,该值指定现有用户上下文的新密码或新用户帐户的密码。 对于系统帐户,将忽略此密码。
-
/TRtaskrun
-
一个 值,该值指定任务将运行的新程序。
-
/STstarttime
-
一个 值,该值指定运行任务的开始时间。 时间格式为 HH:mm (24 小时) 。 例如,14:30 指定下午 2:30。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/RI间隔
-
一个 值,该值指定重复间隔(以分钟为单位)。 有效范围为 1 - 599940 分钟。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/ETendtime
-
一个 值,该值指定任务的结束时间。 时间格式为 HH:mm (24 小时) 。 例如,14:50 指定下午 2:50。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/DU持续时间
-
一个 值,该值指定运行任务的持续时间。 时间格式为 HH:mm (24 小时) 。 例如,14:50 指定下午 2:50。 这不适用于 /ET 参数。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/K
-
一个值,该值在结束时间或持续时间终止任务。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/SDstartdate
-
一个 值,该值指定运行任务的第一个日期。 格式为 mm/dd/yyyy。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/EDenddate
-
一个 值,该值指定任务将运行的最后一个日期。 格式为 mm/dd/yyyy。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/IT
-
一个 值,该值使任务仅当 /RU 用户当前在任务运行时登录时才能以交互方式运行。 仅当用户登录时,任务才会运行。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/RL级别
-
一个值,该值设置任务的运行级别。 有效值为 LIMITED 和 HIGHEST。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/使
-
一个启用计划任务的值。 已启用的任务可以运行,禁用的任务无法运行。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/禁用
-
一个值,该值禁止运行计划任务。
注意
如果远程任务计划程序 1.0 任务被Schtasks.exe禁用,并且远程计算机启用了文件和打印机共享防火墙例外和远程计划任务管理防火墙例外,则从任务计划程序 2.0 API 读取时不会禁用该任务。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/Z
-
一个值,该值将任务标记为在最终运行后删除。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/DELAY延迟时间
-
一个 值,该值指定在触发触发器后延迟任务运行的等待时间。 时间格式为 mmmm:ss。 此选项仅适用于计划类型为 ONSTART、ONLOGON 和 ONEVENT 的任务。
Windows XP 和 Windows Server 2003: 此选项不可用。
-
/?
-
一个 值,该值显示Schtasks.exe的“帮助”消息。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |