Schtasks.exe
Permite a un administrador crear, eliminar, consultar, cambiar, ejecutar y finalizar tareas programadas en un equipo local o remoto. La ejecución de Schtasks.exe sin argumentos muestra el estado y la siguiente hora de ejecución para cada tarea registrada.
Para obtener más información sobre el Programador de tareas, consulte esta introducción: Programador de tareas para desarrolladores.
Crear una tarea
La sintaxis siguiente se usa para crear una tarea en el equipo local o remoto.
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]
Parámetros
-
/Ssystem
-
Valor que especifica el equipo remoto al que se va a conectar. Si se omite, el parámetro del sistema tiene como valor predeterminado el equipo local.
-
/Uusername
-
Valor que especifica el contexto de usuario en el que se debe ejecutar Schtasks.exe.
-
/P[password]
-
Valor que especifica la contraseña de un contexto de usuario determinado. Si se omite, Schtasks.exe solicita al usuario la entrada.
-
Nombre de usuario/RU
-
Valor que especifica el contexto de usuario en el que se ejecuta la tarea. Para la cuenta del sistema, los valores válidos son "", "NT AUTHORITY\SYSTEM" o "SYSTEM". Para las tareas del Programador de tareas 2.0, "NT AUTHORITY\LOCALSERVICE" y "NT AUTHORITY\NETWORKSERVICE" también son valores válidos.
-
/RP[password]
-
Valor que especifica la contraseña del usuario especificado con el parámetro /RU. Para solicitar la contraseña, el valor debe ser "*" o ningún valor. Esta contraseña se omite para la cuenta del sistema. Este parámetro debe combinarse con /RU o el modificador /XML.
-
Programación /SC
-
Valor que especifica la frecuencia de programación. Los valores válidos son: MINUTE, HOURLY, DAILY, WEEKLY, MONTHLY, ONCE, ONSTART, ONLOGON, ONIDLE y ONEVENT.
-
Modificador /MO
-
Valor que refina el tipo de programación para permitir un control más preciso sobre la periodicidad de la programación. Los valores válidos son:
- MINUTO: 1 - 1439 minutos.
- HORA: 1 - 23 horas.
- DIARIO: 1 - 365 días.
- SEMANAL: semanas 1 - 52.
- ONCE: sin modificadores.
- ONSTART: no hay modificadores.
- ONLOGON: sin modificadores.
- ONIDLE: no hay modificadores.
- MENSUAL: 1 - 12, o PRIMERO, SEGUNDO, TERCERO, CUARTO, ÚLTIMO y ÚLTIMO DÍA.
- ONEVENT: cadena de consulta de eventos XPath.
-
/Ddías
-
Valor que especifica el día de la semana para ejecutar la tarea. Los valores válidos son: MON, TUE, WED, THU, FRI, SAT, SUN y para las programaciones MENSUALes de 1 a 31 (días del mes). El carácter comodín (*) especifica todos los días.
-
/Mmeses
-
Valor que especifica meses del año. El valor predeterminado es el primer día del mes. Los valores válidos son: JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV y DEC. El carácter comodín (*) especifica todos los meses.
-
/Itiempo de inactividad
-
Valor que especifica la cantidad de tiempo de inactividad que se debe esperar antes de ejecutar una tarea ONIDLE programada. El intervalo válido es de 1 a 999 minutos.
-
/TNtaskname
-
Valor que especifica un nombre que identifica de forma única la tarea programada.
-
/TRtaskrun
-
Valor que especifica la ruta de acceso y el nombre de archivo de la tarea que se va a ejecutar en la hora programada. Por ejemplo: C:\Windows\System32\calc.exe.
-
/STstarttime
-
Valor que especifica la hora de inicio para ejecutar la tarea. El formato de hora es HH:mm (hora de 24 horas). Por ejemplo, 14:30 especifica las 2:30 p. m. El valor predeterminado es la hora actual es /ST no se especifica. Esta opción es necesaria para el argumento /SC ONCE.
-
/RIinterval
-
Valor que especifica el intervalo de repetición en minutos. Esto no es aplicable a los siguientes tipos de programación: MINUTE, HOURLY, ONSTART, ONLOGON, ONIDLE y ONEVENT. El intervalo válido es de 1 a 599940 minutos. Si se especifican los parámetros /ET o /DU, el valor predeterminado es 10 minutos.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/ETendtime
-
Valor que especifica la hora de finalización para ejecutar la tarea. El formato de hora es HH:mm (hora de 24 horas). Por ejemplo, 14:50 especifica 2:50PM. Esto no es aplicable a los siguientes tipos de programación: ONSTART, ONLOGON, ONIDLE y ONEVENT.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
Duración de /DU
-
Valor que especifica la duración de la ejecución de la tarea. El formato de hora es HH:mm (hora de 24 horas). Por ejemplo, 14:50 especifica 2:50PM. Esto no es aplicable con /ET y para los siguientes tipos de programación: ONSTART, ONLOGON, ONIDLE y ONEVENT. Para las tareas /V1 (tareas del Programador de tareas 1.0), si se especifica /RI, el valor predeterminado de duración es una hora.
Windows XP: Esta opción no está disponible.
-
/K
-
Valor que finaliza la tarea en la hora de finalización o el tiempo de duración. Esto no es aplicable a los siguientes tipos de programación: ONSTART, ONLOGON, ONIDLE y ONEVENT. Se debe especificar /ET o /DU.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/SDstartdate
-
Valor que especifica la primera fecha en la que se va a ejecutar la tarea. El formato es mm/dd/aaaa. Este valor tiene como valor predeterminado la fecha actual. Esto no es aplicable a los siguientes tipos de programación: ONCE, ONSTART, ONLOGON, ONIDLE y ONEVENT.
-
/EDenddate
-
Valor que especifica la última fecha en que se ejecutará la tarea. El formato es mm/dd/aaaa. Esto no es aplicable a los siguientes tipos de programación: ONCE, ONSTART, ONLOGON, ONIDLE y ONEVENT.
-
/ECChannelName
-
Valor que especifica el canal de eventos para los desencadenadores ONEVENT.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/ESO
-
Valor que permite que la tarea se ejecute de forma interactiva solo si el usuario /RU ha iniciado sesión actualmente en el momento en que se ejecuta la tarea. La tarea solo se ejecuta si el usuario ha iniciado sesión.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/NP
-
Valor que indica que no se almacena ninguna contraseña. La tarea no se ejecuta de forma interactiva como el usuario especificado. Solo están disponibles los recursos locales.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/Z
-
Valor que marca la tarea que se va a eliminar después de su ejecución final.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/XMLxmlfile
-
Valor que crea una tarea a partir de un archivo XML. Este parámetro se puede combinar con modificadores /RU y /RP, o con el modificador /RP solo cuando el XML de tarea ya contiene la entidad de seguridad.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/V1
-
Valor que crea una tarea visible para las plataformas Windows 2000, Windows Server 2003 y Windows XP.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/F
-
Valor que crea la tarea con fuerza y suprime las advertencias si la tarea especificada ya existe.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
Nivel /RL
-
Valor que establece el nivel de ejecución de la tarea. Los valores válidos son LIMITED y HIGHEST. El valor predeterminado es LIMITED.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/DELAYdelaytime
-
Valor que especifica el tiempo de espera para retrasar la tarea después de que se desencadene el desencadenador. El formato de hora es mmmm:ss. Esta opción solo es válida para los tipos de programación ONSTART, ONLOGON y ONEVENT.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/?
-
Valor que muestra el mensaje de ayuda para Schtasks.exe.
Observaciones
Al crear una tarea en un equipo remoto que se ejecuta en el sistema operativo Windows XP, Windows Server 2003 o Windows 2000, use el modificador /V1.
No se puede crear una tarea remota no interactiva del Programador de tareas 1.0 (cree una tarea sin usar el modificador /IT y con el modificador /V1) si el equipo remoto tiene habilitada la excepción firewall De uso compartido de archivos e impresoras y la excepción de firewall de administración de tareas programadas remotas deshabilitada.
Eliminar una tarea
La siguiente sintaxis se usa para eliminar una o varias tareas programadas.
schtasks /Delete
[/S system [/U username [/P [password]]]]
[/TN taskname] [/F]
Parámetros
-
/Ssystem
-
Valor que especifica el equipo remoto al que se va a conectar. Si se omite, el parámetro del sistema tiene como valor predeterminado el equipo local.
-
/Uusername
-
Valor que especifica el contexto de usuario en el que se debe ejecutar Schtasks.exe.
-
/P[password]
-
Valor que especifica la contraseña para el contexto de usuario especificado. Si se omite, Schtasks.exe solicita al usuario la entrada.
-
/TNtaskname
-
Valor que especifica el nombre de la tarea programada que se va a eliminar. El carácter comodín (*) se puede usar para eliminar todas las tareas.
-
/F
-
Valor que elimina forzadamente la tarea y suprime las advertencias si se está ejecutando la tarea especificada.
-
/?
-
Valor que muestra ayuda para Schtasks.exe.
Ejecución de una tarea
La sintaxis siguiente se usa para ejecutar inmediatamente una tarea programada.
schtasks /Run
[/S system [/U username [/P [password]]]]
/TN taskname
Parámetros
-
/Ssystem
-
Valor que especifica el equipo remoto al que se va a conectar. Si se omite, el parámetro del sistema tiene como valor predeterminado el equipo local.
-
/Uusername
-
Valor que especifica el contexto de usuario en el que se debe ejecutar Schtasks.exe.
-
/P[password]
-
Valor que especifica la contraseña para el contexto de usuario especificado. Si se omite, Schtasks.exe solicita al usuario la entrada.
-
/TNtaskname
-
Valor que especifica el nombre de la tarea programada que se va a ejecutar.
-
/?
-
Valor que muestra ayuda para Schtasks.exe.
Finalizar una tarea en ejecución
La sintaxis siguiente se usa para detener una tarea programada en ejecución.
Nota
Para detener la ejecución de una tarea remota, asegúrese de que el equipo remoto tiene habilitadas las excepciones de firewall de administración de tareas programadas remotas y uso compartido de archivos e impresoras.
schtasks /End
[/S system [/U username [/P [password]]]]
/TN taskname
Parámetros
-
/Ssystem
-
Valor que especifica el equipo remoto al que se va a conectar. Si se omite, el parámetro del sistema tiene como valor predeterminado el equipo local.
-
/Uusername
-
Valor que especifica el contexto de usuario en el que se debe ejecutar Schtasks.exe.
-
/P[password]
-
Valor que especifica la contraseña para el contexto de usuario especificado. Si se omite, Schtasks.exe solicita al usuario la entrada.
-
/TNtaskname
-
Valor que especifica el nombre de la tarea programada que se va a detener.
-
/?
-
Valor que muestra ayuda para Schtasks.exe.
Consulta de información de tareas
La sintaxis siguiente se usa para mostrar las tareas programadas desde el equipo local o remoto.
schtasks /Query
[/S system [/U username [/P [password]]]]
[/FO format | /XML] [/NH] [/V] [/TN taskname] [/?]
Parámetros
-
/Ssystem
-
Valor que especifica el equipo remoto al que se va a conectar. Si se omite, el parámetro del sistema tiene como valor predeterminado el equipo local.
-
/Uusername
-
Valor que especifica el contexto de usuario en el que se debe ejecutar Schtasks.exe.
-
/P[password]
-
Valor que especifica la contraseña para el contexto de usuario especificado. Si se omite, Schtasks.exe solicita al usuario la entrada.
-
Formato /FO
-
Valor que especifica el formato de salida. Los valores válidos son TABLE, LIST y CSV.
-
/NH
-
Valor que especifica que el encabezado de columna no debe mostrarse en la salida. Esto solo es válido para formatos TABLE y CSV.
-
/V
-
Valor que muestra la salida detallada de la tarea.
Nota:
Si una tarea estaba programada para ejecutarse solo una vez, la información de programación mostrada es "Los datos de programación no están disponibles en este formato".
-
/TNtaskname
-
Valor que especifica el nombre de la tarea para el que se va a recuperar la información. Si no se especifica ningún nombre de tarea, se mostrará información para todas las tareas.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/XML
-
Valor que se usa para mostrar las definiciones de tareas en formato XML.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/?
-
Valor que se usa para mostrar la Ayuda para Schtasks.exe.
Cambiar una tarea
La sintaxis siguiente se usa para cambiar cómo se ejecuta el programa o cambiar la cuenta de usuario y la contraseña usadas por una tarea programada.
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] }
Parámetros
-
/Ssystem
-
Valor que especifica el equipo remoto al que se va a conectar. Si se omite, el parámetro del sistema tiene como valor predeterminado el equipo local.
-
/Uusername
-
Valor que especifica el contexto de usuario en el que se debe ejecutar Schtasks.exe.
-
/P[password]
-
Valor que especifica la contraseña para el contexto de usuario especificado. Si se omite, Schtasks.exe solicita al usuario la entrada.
-
/TNtaskname
-
Valor que especifica qué tarea programada se va a cambiar.
-
/RUrunasuser
-
Valor que cambia el nombre de usuario (contexto de usuario) en el que se ejecutará la tarea programada. Para la cuenta del sistema, los valores válidos son "", "NT AUTHORITY\SYSTEM" o "SYSTEM". Para las tareas del Programador de tareas 2.0, "NT AUTHORITY\LOCALSERVICE" y "NT AUTHORITY\NETWORKSERVICE" también son valores válidos.
-
/RPrunaspassword
-
Valor que especifica una nueva contraseña para el contexto de usuario existente o la contraseña de una nueva cuenta de usuario. Esta contraseña se omite para la cuenta del sistema.
-
/TRtaskrun
-
Valor que especifica un nuevo programa que ejecutará la tarea.
-
/STstarttime
-
Valor que especifica la hora de inicio para ejecutar la tarea. El formato de hora es HH:mm (hora de 24 horas). Por ejemplo, 14:30 especifica las 2:30 p. m.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/RIinterval
-
Valor que especifica el intervalo de repetición, en minutos. El intervalo válido es de 1 a 599940 minutos.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/ETendtime
-
Valor que especifica la hora de finalización de la tarea. El formato de hora es HH:mm (hora de 24 horas). Por ejemplo, 14:50 especifica 2:50PM.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
Duración de /DU
-
Valor que especifica la duración de la ejecución de la tarea. El formato de hora es HH:mm (hora de 24 horas). Por ejemplo, 14:50 especifica 2:50PM. Esto no es aplicable con el parámetro /ET.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/K
-
Valor que finaliza la tarea en la hora de finalización o el tiempo de duración.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/SDstartdate
-
Valor que especifica la primera fecha en la que se va a ejecutar la tarea. El formato es mm/dd/aaaa.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/EDenddate
-
Valor que especifica la última fecha en que se ejecutará la tarea. El formato es mm/dd/aaaa.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/ESO
-
Valor que permite que la tarea se ejecute de forma interactiva solo si el usuario /RU ha iniciado sesión actualmente en el momento en que se ejecuta la tarea. La tarea solo se ejecuta si el usuario ha iniciado sesión.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
Nivel /RL
-
Valor que establece el nivel de ejecución de la tarea. Los valores válidos son LIMITED y HIGHEST.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/HABILITAR
-
Valor que habilita la tarea programada. Una tarea habilitada se puede ejecutar y no se puede ejecutar una tarea deshabilitada.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/DESACTIVAR
-
Valor que deshabilita la ejecución de la tarea programada.
Nota
Si una tarea remota del Programador de tareas 1.0 está deshabilitada por Schtasks.exe y el equipo remoto tiene habilitada la excepción de firewall de uso compartido de archivos e impresoras y la excepción de firewall de administración de tareas programadas remotas deshabilitada, la tarea no se deshabilitará cuando se lea desde una API del Programador de tareas 2.0.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/Z
-
Valor que marca la tarea que se va a eliminar después de su ejecución final.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/DELAYdelaytime
-
Valor que especifica el tiempo de espera para retrasar la ejecución de la tarea después de que se desencadene el desencadenador. El formato de hora es mmmm:ss. Esta opción solo es válida para las tareas con los tipos de programación ONSTART, ONLOGON y ONEVENT.
Windows XP y Windows Server 2003: Esta opción no está disponible.
-
/?
-
Valor que muestra el mensaje de Ayuda para Schtasks.exe.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible |
Windows XP [solo aplicaciones de escritorio] |
Servidor mínimo compatible |
Windows Server 2003 [solo aplicaciones de escritorio] |