https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/schtasks
语法:
schtasks /change
schtasks /create
schtasks /delete
schtasks /end
schtasks /query
schtasks /run
可运行 taskschd.msc
打开任务计划程序查看。
schtasks create
语法:
schtasks /create /sc <scheduletype> /tn <taskname> /tr <taskrun> [/s <computer> [/u [<domain>\]<user> [/p <password>]]] [/ru {[<domain>\]<user> | system}] [/rp <password>] [/mo <modifier>] [/d <day>[,<day>...] | *] [/m <month>[,<month>...]] [/i <idletime>] [/st <starttime>] [/ri <interval>] [{/et <endtime> | /du <duration>} [/k]] [/sd <startdate>] [/ed <enddate>] [/it] [/np] [/z] [/xml <xmlfile>] [/v1] [/f] [/rl <level>] [/delay <delaytime>] [/hresult]
参数 | 描述 |
---|---|
/sc <scheduletype> |
指定计划类型。 有效值包括: - MINUTE - 指定任务运行前的分钟数。 - HOURLY - 指定任务运行前的小时数。 - DAILY - 指定任务运行前的天数。 - WEEKLY - 指定任务运行前的周数。 - MONTHLY - 指定任务运行前的月数。 - ONCE - 指定该任务在指定的日期和时间运行一次。 - ONSTART - 指定任务在每次系统启动时运行。 可以指定开始日期,也可以在系统下次启动时运行任务。 - ONLOGON - 指定任务在用户(任何用户)登录时运行。 可以指定一个日期,也可以在用户下次登录时运行任务。 - ONIDLE - 指定任务在系统空闲时间段运行。 可以指定一个日期,也可以在系统下次空闲时运行任务。 - ONEVENT - 指定任务基于与系统事件日志中的信息(包括 EventID)匹配的事件运行。 |
/tn <taskname> |
指定任务名称。 系统上的每个任务必须具有唯一的名称,并且必须符合文件名规则,不超过 238 个字符。 使用引号将包含空格的名称括起来。 若要将计划任务存储在其他文件夹中,请运行 /tn<folder name\task name> 。 |
/tr <Taskrun> |
指定任务运行的程序或命令。 键入可执行文件、脚本文件或批处理文件的完全限定路径和文件名。 该路径名称不得超过 262 个字符。 如果不添加路径,则 schtasks 假定该文件位于 目录中。 |
/s <computer> |
指定远程计算机的名称或 IP 地址(带反斜杠或不带反斜杠)。 默认为本地计算机。 |
/u [<domain>] |
使用指定用户帐户的权限来运行该命令。 默认值为本地计算机的当前用户的权限。 /u 和 /p 参数仅在使用 /s 时有效。 指定帐户的权限用于计划任务和运行任务。 若要使用其他用户的权限运行任务,请使用 /ru 参数。 用户帐户必须是远程计算机上 Administrators 组的成员。 此外,本地计算机必须与远程计算机位于同一域中,或者必须位于远程计算机域信任的域中。 |
/p <password> |
指定 /u 参数中指定的用户帐户的密码。 如果在不使用 /p 形参或 password 实参的情况下使用 /u 形参,则 schtasks 将提示你输入密码。 /u 和 /p 参数仅在使用 /s 时有效。 |
/ru {[<domain> ]<user> system } |
使用指定用户帐户的权限运行任务。 默认情况下,使用本地计算机的当前用户的权限运行任务,或者使用 /u 参数指定的用户权限(如果包含)。 在本地或远程计算机上计划任务时,/ru 参数有效。 有效选项包括: - Domain - 指定备用用户帐户。 - System - 指定 Local System 帐户,即操作系统和系统服务所使用的高特权帐户。 |
/rp <password> |
指定现有用户帐户或 /ru 参数指定的用户帐户的密码。 如果在指定用户帐户时未使用此参数,SchTasks.exe 将在下次登录时提示输入密码。 不要将 /rp 参数用于通过 System 帐户凭据 (/ru System) 运行的任务。 System 帐户没有密码,SchTasks.exe 不提示输入密码。 |
/mo <modifiers> |
指定任务在其计划类型中运行的频率。 有效选项包括: - MINUTE - 指定任务每隔 - HOURLY - 指定任务每隔 - DAILY - 指定任务每隔 - WEEKLY - 指定任务每隔 - MONTHLY - 指定任务每隔 - 介于 1 到 12 月的数字 - LASTDAY - 在月份的最后一天运行任务 - FIRST、SECOND、THIRD 或 FOURTH 以及 /d <day> 参数 - 指定运行任务的特定周和日期。 例如,在当月的第三个星期三运行任务。- ONCE - 指定任务运行一次。 - ONSTART - 指定任务在启动时运行。 - ONLOGON - 指定在 /ru 参数指定的用户登录时运行任务。 - ONIDLE - 指定任务在系统空闲后(空闲分钟数由 /i 参数指定)运行 |
/d DAY[,DAY…] | 指定任务在其计划类型中运行的频率。 有效选项包括: - WEEKLY - 通过提供介于 1-52 周之间的值来指定任务每周运行一次。 (可选)还可以通过添加 MON - SUN 的值或 [MON - SUN…] 来添加一周中的特定日期。 - MONTHLY - 通过提供 FIRST、SECOND、THIRD、FOURTH、LAST 的值,指定任务每月每周运行一次。 (可选)还可以通过添加 MON - SUN 的值或提供介于 1 到 12 个月的数字来添加一周中的特定日期。 如果使用此选项,还可以通过提供介于 1-31 之间的数字来添加月份的特定日期。 注意:日期值 1 - 31 仅在没有 /m 参数的情况下有效,或者如果 /mo 参数为每月 (1 - 12) 才有效。 默认值为第 1 天(每月的第一天)。 |
/m MONTH[,MONTH…] | 指定应运行计划任务的月份。 有效选项包括 JAN - DEC 和 * (每月)。 /m 参数仅对 MONTHLY 计划有效。 使用 LASTDAY 修饰符时,该参数是必需的。 否则,该参数为可选参数,默认值为 * (每月)。 |
/i <Idletime> |
指定计算机在任务开始前处于空闲状态的分钟数。 有效值为介于 1 到 999 的整数。 此参数仅对 ONIDLE 计划有效,因此是必需的。 |
/st <Starttime> |
使用 24 小时时间格式 HH:mm 指定任务的开始时间。 默认值为本地计算机的当前时间。 /st 参数对 MINUTE、HOURLY、DAILY、WEEKLY、MONTHLY 和 ONCE 计划有效。 对于 ONCE 计划,该参数是必需的。 |
/ri <interval> |
指定计划任务的重复间隔(分钟)。 对于 MINUTE、HOURLY、ONSTART、ONLOGON、ONIDLE 和 ONEVENT 计划类型,不适合使用此参数。 有效范围为 1 - 599940(599940 分钟 = 9999 小时)。 如果指定了 /et 或 /du 参数,则默认值为“10 分钟”。 |
/et <endtime> |
以 HH:MM 24 小时格式指定分钟或小时任务计划结束的时间。 在指定的结束时间过后,在开始时间重复之前,schtasks 不会再次启动任务。 默认情况下,任务计划没有结束时间。 此参数为可选参数,仅对 MINUTE 或 HOURLY 计划有效。 |
/du <duration> |
以 HHHH:MM 24 小时格式指定分钟或小时计划的最长时间。 在指定的时间过后,在开始时间重复之前,schtask 不会再次启动任务。 默认情况下,任务计划没有最长持续时间。 此参数为可选参数,仅对 MINUTE 或 HOURLY 计划有效。 |
/k | 在 /et 或 /du 指定的时间停止任务运行的程序。 如果没有 /k,则 schtasks 不会在程序达到 /et 或 /du 指定的时间后再次启动程序,也不会停止程序(如果程序仍在运行)。 此参数为可选参数,仅对 MINUTE 或 HOURLY 计划有效。 |
/sd <Startdate> |
指定任务计划的开始日期。 默认值为本地计算机的当前日期。 Startdate 的格式因“区域和语言选项”中为本地计算机选择的区域设置而异。 每个区域设置只有一种格式有效。 有效的日期格式包括(请确保选择的格式与在本地计算机上的“区域和语言选项”中为“短日期”选择的格式最相似): - <MM>// - 指定使用按月优先格式,例如英语(美国)和西班牙语(巴拿马)。- <DD>// - 指定使用按日优先格式,例如保加利亚语和荷兰语(荷兰)。- <YYYY>// - 指定使用按年优先格式,例如瑞典语和法语(加拿大)。 |
/ed <Enddate> |
指定计划的结束日期。 此参数是可选的。 此参数在 ONCE、ONSTART、ONLOGON、ONIDLE 或 ONEVENT 计划中无效。 默认情况下,计划没有结束日期。 默认值为本地计算机的当前日期。 Enddate 的格式因“区域和语言选项”中为本地计算机选择的区域设置而异。 每个区域设置只有一种格式有效。 有效的日期格式包括(请确保选择的格式与在本地计算机上的“区域和语言选项”中为“短日期”选择的格式最相似): - <MM>// - 指定使用按月优先格式,例如英语(美国)和西班牙语(巴拿马)。- <DD>// - 指定使用按日优先格式,例如保加利亚语和荷兰语(荷兰)。- <YYYY>// - 指定使用按年优先格式,例如瑞典语和法语(加拿大)。 |
/ec <channelname> |
指定由与系统事件日志条件匹配的 ONEVENT 计划类型触发的事件通道名称。 |
/it | 指定仅当以用户身份运行(运行任务的用户帐户)登录到计算机时才运行计划任务。 此参数对使用系统权限运行的任务或已设置了仅交互式属性的任务没有影响。 不能使用更改命令从任务中删除仅交互式属性。 默认情况下,以用户身份运行是计划任务时本地计算机的当前用户,或是 /u 参数指定的帐户(如果有使用)。 但是,如果命令包含 /ru 参数,则以用户身份运行的是 /ru 参数指定的帐户。 |
/np | 不存储任何密码。 任务以给定用户身份以非交互方式运行。 只有本地资源可用。 |
/z | 指定在任务完成其计划后删除任务。 |
/xml <xmlfile> |
创建在 XML 文件中指定的任务。 可以与 /ru 和 /rp 参数结合使用;如果 XML 文件已包含用户帐户信息,也可以单独与 /rp 参数结合使用。 |
/v1 | 创建对 Vista 之前的操作系统可见的任务。 这与 /XML 参数不兼容。 |
/f | 指定创建任务,如果指定的任务已存在,则禁止显示警告。 |
/rl <level> |
指定作业的运行级别。 可接受的值为 LIMITED(计划任务将以最低级别的权限运行,例如标准用户帐户)和 HIGHEST(计划任务将以最高级别的权限运行,例如超级用户帐户)。 默认值为 LIMITED。 |
/delay <delaytime> |
指定在触发后延迟运行任务的等待时间(采用 mmmm:ss 格式)。 这仅适用于 ONSTART、ONLOGON 和 ONEVENT 计划类型。 |
/hresult | 指定要采用 HRESULT 格式的进程退出代码。 |
/? | 在命令提示符下显示帮助。 |
[!example]
每天 0 时使用最高权限运行 bat 脚本。
创建的任务位于根目录(不在任何子文件夹中,在中间面板的「名称」列中):
schtasks /create /tn "<task_name>" /tr "D:\path\to\backup.bat" /sc daily /st 00:00 /ru SYSTEM /rl HIGHEST
创建的任务位于 <folder_name>
目录下:
schtasks /create /tn "<folder_name>\<task_name>" /tr "D:\path\to\backup.bat" /sc daily /st 00:00 /ru SYSTEM /rl HIGHEST
schtasks query
语法:
schtasks [/query] [/fo {TABLE | LIST | CSV}] [/nh] [/v] [/s <computer> [/u [<domain>\]<user> [/p <password>]]] [/tn <taskname>] [/xml] [/hresult]
参数 | DESCRIPTION |
---|---|
/query | (可选)指定作的名称。 使用此查询而不使用任何参数会对系统上的所有任务执行查询。 |
/fo <format> |
指定输出格式。 有效值为 TABLE、 LIST 或 CSV。 |
/nh | 从表显示中删除列标题。 此参数对 TABLE 或 CSV 输出格式有效。 |
/v | 将任务的高级属性添加到显示。 此参数对 LIST 或 CSV 输出格式有效。 |
/s <computer> |
指定远程计算机的名称或 IP 地址(带或不使用反斜杠)。 默认值为本地计算机。 |
/u [<domain>] |
使用指定用户帐户的权限运行此命令。 默认情况下,该命令使用本地计算机的当前用户的权限运行。 指定的用户帐户必须是远程计算机上的 Administrators 组的成员。 仅当使用 /s时,/u 和 /p 参数才有效。 |
/p <password> |
指定 /u 参数中指定的用户帐户的密码。 如果使用 /u 参数而不使用 /p 参数或密码参数,则 schtasks 将提示输入密码。 仅当使用 /s时,/u 和 /p 参数才有效。 |
/tn <taskname> |
按路径和名称查询特定任务。 如果使用 /tn , <taskname> 则不能为空。 假定默认从根目录“\”文件夹(因此,如果任务位于根目录中,则省略 \)。 不接受通配符。 使用引号将包含空格的名称括起来。 |
/xml | 将系统上的所有任务定义输出为 XML 格式。 如果指定了 /tn ,则将特定任务名称输出为 XML 格式。 必须使用完整路径和名称。 |
/hresult | 指定进程退出代码为 HRESULT 格式。 |
/? | 在命令提示符下显示帮助。 |
[!example]
查询<folder_name>\<task_name>
。
schtasks /query /tn "<folder_name>\<task_name>"
schtasks run
语法:
schtasks /run /tn <taskname> [/s <computer> [/u [<domain>\]<user> [/p <password>]]]
参数 | 说明 |
---|---|
/tn <taskname> |
标识要启动的任务。 此参数是必需的。 |
/s <computer> |
指定远程计算机的名称或 IP 地址(带或不使用反斜杠)。 默认值为本地计算机。 |
/u [<domain>] |
使用指定用户帐户的权限运行此命令。 默认情况下,该命令使用本地计算机的当前用户的权限运行。 指定的用户帐户必须是远程计算机上的 Administrators 组的成员。 仅当使用 /s时,/u 和 /p 参数才有效。 |
/p <password> |
指定 /u 参数中指定的用户帐户的密码。 如果使用 /u 参数而不使用 /p 参数或密码参数,则 schtasks 将提示输入密码。 仅当使用 /s时,/u 和 /p 参数才有效。 |
/? | 在命令提示符下显示帮助。 |
[!example]
运行<folder_name>\<task_name>
。
schtasks /run /tn "<folder_name>\<task_name>"
schtasks delete
语法:
schtasks /delete /tn {<taskname> | *} [/f] [/s <computer> [/u [<domain>\]<user> [/p <password>]]]
参数 | 说明 |
---|---|
/tn {<taskname> *} |
标识要删除的任务。 如果使用 * ,此命令将删除为计算机计划的所有任务,而不仅仅是当前用户计划的任务。 |
/f | 取消确认消息。 任务将被删除,但不显示警告。 |
/s <computer> |
指定远程计算机的名称或 IP 地址(带或不使用反斜杠)。 默认值为本地计算机。 |
/u [<domain>] |
使用指定用户帐户的权限运行此命令。 默认情况下,该命令使用本地计算机的当前用户的权限运行。 指定的用户帐户必须是远程计算机上的 Administrators 组的成员。 仅当使用 /s时,/u 和 /p 参数才有效。 |
/p <password> |
指定 /u 参数中指定的用户帐户的密码。 如果使用 /u 参数而不使用 /p 参数或密码参数,则 schtasks 将提示输入密码。 仅当使用 /s时,/u 和 /p 参数才有效。 |
/? | 在命令提示符下显示帮助。 |
[!example]
删除<folder_name>\<task_name>
。
schtasks /delete /tn "<folder_name>\<task_name>" /f