Schtasks.exe

Permite que um administrador crie, exclua, consulte, altere, execute e encerre tarefas agendadas em um computador local ou remoto. Executar Schtasks.exe sem argumentos exibe o status e o próximo tempo de execução para cada tarefa registrada.

Para obter mais informações sobre o Agendador de Tarefas, consulte esta introdução: Agendador de Tarefas para desenvolvedores.

Criando uma tarefa

A sintaxe a seguir é usada para criar uma tarefa no computador local ou 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

Sistema /S

Um valor que especifica o computador remoto ao qual se conectar. Se omitido, o parâmetro do sistema usará como padrão o computador local.

/Uusername

Um valor que especifica o contexto do usuário no qual Schtasks.exe deve ser executado.

/P[password]

Um valor que especifica a senha para um determinado contexto de usuário. Se omitido, Schtasks.exe solicitará entrada ao usuário.

Nome de usuário/RU

Um valor que especifica o contexto do usuário no qual a tarefa é executada. Para a conta do sistema, os valores válidos são "", "NT AUTHORITY\SYSTEM" ou "SYSTEM". Para tarefas do Agendador de Tarefas 2.0, "NT AUTHORITY\LOCALSERVICE" e "NT AUTHORITY\NETWORKSERVICE" também são valores válidos.

/RP[password]

Um valor que especifica a senha para o usuário especificado com o parâmetro /RU. Para solicitar a senha, o valor deve ser "*" ou nenhum valor. Essa senha é ignorada para a conta do sistema. Esse parâmetro deve ser combinado com /RU ou comutador /XML.

Agenda de /SC

Um valor que especifica a frequência de agendamento. Os valores válidos são: MINUTE, HOURLY, DAILY, WEEKLY, MONTHLY, ONCE, ONSTART, ONLOGON, ONIDLE e ONEVENT.

Modificador /MO

Um valor que refina o tipo de agendamento para permitir um controle mais fino sobre a recorrência de agendamento. Os valores válidos são:

• MINUTO: 1 a 1439 minutos.
• POR HORA: 1 a 23 horas.
• DIARIAMENTE: 1 a 365 dias.
• SEMANAL: semanas 1 a 52.
• ONCE: sem modificadores.
• ONSTART: sem modificadores.
• ONLOGON: nenhum modificador.
• ONIDLE: nenhum modificador.
• MENSALMENTE: 1 a 12, ou PRIMEIRO, SEGUNDO, TERCEIRO, QUARTO, ÚLTIMO e ÚLTIMO DIA.
• ONEVENT: cadeia de caracteres de consulta de evento XPath.

/Ddias

Um valor que especifica o dia da semana para executar a tarefa. Os valores válidos são: MON, TUE, WED, THU, FRI, SAT, SUN e para agendas MENSAIS de 1 a 31 (dias do mês). O caractere curinga (*) especifica todos os dias.

/Mmeses

Um valor que especifica meses do ano. O padrão é o primeiro dia do mês. Os valores válidos são: JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV e DEC. O caractere curinga (*) especifica todos os meses.

/Iidletime

Um valor que especifica a quantidade de tempo ocioso a aguardar antes de executar uma tarefa ONIDLE agendada. O intervalo válido é de 1 a 999 minutos.

Nome da tarefa/TN

Um valor que especifica um nome que identifica exclusivamente a tarefa agendada.

/TRtaskrun

Um valor que especifica o caminho e o nome do arquivo da tarefa a ser executada no horário agendado. Por exemplo: C:\Windows\System32\calc.exe.

Hora de início/ST

Um valor que especifica a hora de início para executar a tarefa. O formato de hora é HH:mm (tempo de 24 horas). Por exemplo, 14:30 especifica 14:30PM. O padrão é que a hora atual é /ST não é especificado. Essa opção é necessária para o argumento /SC ONCE.

Intervalo /RI

Um valor que especifica o intervalo de repetição em minutos. Isso não se aplica aos seguintes tipos de agendamento: MINUTE, HOURLY, ONSTART, ONLOGON, ONIDLE e ONEVENT. O intervalo válido é de 1 a 599940 minutos. Se os parâmetros /ET ou /DU forem especificados, o padrão será 10 minutos.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/ETendtime

Um valor que especifica a hora de término para executar a tarefa. O formato de hora é HH:mm (tempo de 24 horas). Por exemplo, 14:50 especifica 14:50PM. Isso não se aplica aos seguintes tipos de agendamento: ONSTART, ONLOGON, ONIDLE e ONEVENT.

Windows XP e Windows Server 2003: Essa opção não está disponível.

Duração de /DU

Um valor que especifica a duração para executar a tarefa. O formato de hora é HH:mm (tempo de 24 horas). Por exemplo, 14:50 especifica 14:50PM. Isso não é aplicável com /ET e para os seguintes tipos de agendamento: ONSTART, ONLOGON, ONIDLE e ONEVENT. Para tarefas /V1 (tarefas do Agendador de Tarefas 1.0), se /RI for especificado, o padrão de duração será de uma hora.

Windows XP: Essa opção não está disponível.

/K

Um valor que encerra a tarefa no tempo de término ou duração. Isso não se aplica aos seguintes tipos de agendamento: ONSTART, ONLOGON, ONIDLE e ONEVENT. /ET ou /DU devem ser especificados.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/SDstartdate

Um valor que especifica a primeira data na qual executar a tarefa. O formato é mm/dd/aaaa. Esse valor usa como padrão a data atual. Isso não se aplica aos seguintes tipos de agendamento: ONCE, ONSTART, ONLOGON, ONIDLE e ONEVENT.

Enddate /ED

Um valor que especifica a última data em que a tarefa será executada. O formato é mm/dd/aaaa. Isso não se aplica aos seguintes tipos de agendamento: ONCE, ONSTART, ONLOGON, ONIDLE e ONEVENT.

/ECChannelName

Um valor que especifica o canal de eventos para gatilhos ONEVENT.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/IT

Um valor que permite que a tarefa seja executada interativamente somente se o usuário /RU estiver conectado no momento no momento em que a tarefa for executada. A tarefa será executada somente se o usuário estiver conectado.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/NP

Um valor que indica que nenhuma senha é armazenada. A tarefa não é executada interativamente como o usuário especificado. Somente recursos locais estão disponíveis.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/Z

Um valor que marca a tarefa a ser excluída após sua execução final.

Windows XP e Windows Server 2003: Essa opção não está disponível.

Xmlfile /XML

Um valor que cria uma tarefa de um arquivo XML. Esse parâmetro pode ser combinado com comutadores /RU e /RP ou apenas com a opção /RP quando o XML da tarefa já contém a entidade de segurança.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/V1

Um valor que cria uma tarefa visível para as plataformas Windows 2000, Windows Server 2003 e Windows XP.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/F

Um valor que cria a tarefa com força e suprime avisos se a tarefa especificada já existir.

Windows XP e Windows Server 2003: Essa opção não está disponível.

Nível/RL

Um valor que define o nível de execução da tarefa. Os valores válidos são LIMITED e HIGHEST. O padrão é LIMITED.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/DELAYdelaytime

Um valor que especifica o tempo de espera para atrasar a tarefa depois que o gatilho é acionado. O formato de hora é mmmm:ss. Essa opção só é válida para os tipos de agendamento ONSTART, ONLOGON e ONEVENT.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/?

Um valor que exibe a mensagem de ajuda para Schtasks.exe.

Comentários

Ao criar uma tarefa em um computador remoto em execução no sistema operacional Windows XP, Windows Server 2003 ou Windows 2000, use a opção /V1.

Não é possível criar uma tarefa do Agendador de Tarefas 1.0 remoto não interativo (crie uma tarefa não usando a opção /IT e usando a opção /V1) se o computador remoto tiver a exceção de firewall de Compartilhamento de Arquivos e Impressoras habilitada e a exceção de firewall gerenciamento de tarefas agendadas remotas desabilitada.

Excluindo uma tarefa

A sintaxe a seguir é usada para excluir uma ou mais tarefas agendadas.

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

Parâmetros

Sistema /S

Um valor que especifica o computador remoto ao qual se conectar. Se omitido, o parâmetro do sistema usará como padrão o computador local.

/Uusername

Um valor que especifica o contexto do usuário sob o qual Schtasks.exe deve ser executado.

/P[password]

Um valor que especifica a senha para o contexto de usuário fornecido. Se omitido, Schtasks.exe solicitará entrada ao usuário.

Nome da tarefa/TN

Um valor que especifica o nome da tarefa agendada a ser excluída. O caractere curinga (*) pode ser usado para excluir todas as tarefas.

/F

Um valor que exclui a tarefa com força e suprime avisos se a tarefa especificada estiver em execução.

/?

Um valor que exibe a Ajuda para Schtasks.exe.

Executando uma tarefa

A sintaxe a seguir é usada para executar imediatamente uma tarefa agendada.

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

Parâmetros

Sistema /S

Um valor que especifica o computador remoto ao qual se conectar. Se omitido, o parâmetro do sistema usará como padrão o computador local.

/Uusername

Um valor que especifica o contexto do usuário sob o qual Schtasks.exe deve ser executado.

/P[password]

Um valor que especifica a senha para o contexto de usuário fornecido. Se omitido, Schtasks.exe solicitará entrada ao usuário.

Nome da tarefa/TN

Um valor que especifica o nome da tarefa agendada a ser executada.

/?

Um valor que exibe a Ajuda para Schtasks.exe.

Encerrando uma tarefa em execução

A sintaxe a seguir é usada para interromper uma tarefa agendada em execução.

Observação

Para impedir a execução de uma tarefa remota, verifique se o computador remoto tem as exceções de firewall de Compartilhamento de Arquivos e Impressoras e Gerenciamento de Tarefas Agendadas Remotas habilitadas.

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

Parâmetros

Sistema /S

Um valor que especifica o computador remoto ao qual se conectar. Se omitido, o parâmetro do sistema usará como padrão o computador local.

/Uusername

Um valor que especifica o contexto do usuário sob o qual Schtasks.exe deve ser executado.

/P[password]

Um valor que especifica a senha para o contexto de usuário fornecido. Se omitido, Schtasks.exe solicitará entrada ao usuário.

Nome da tarefa/TN

Um valor que especifica o nome da tarefa agendada a ser interrompida.

/?

Um valor que exibe a Ajuda para Schtasks.exe.

Consultando informações da tarefa

A sintaxe a seguir é usada para exibir as tarefas agendadas do computador local ou remoto.

schtasks /Query 
[/S system [/U username [/P [password]]]]
[/FO format | /XML] [/NH] [/V] [/TN taskname] [/?]

Parâmetros

Sistema /S

Um valor que especifica o computador remoto ao qual se conectar. Se omitido, o parâmetro do sistema usará como padrão o computador local.

/Uusername

Um valor que especifica o contexto do usuário sob o qual Schtasks.exe deve ser executado.

/P[password]

Um valor que especifica a senha para o contexto de usuário fornecido. Se omitido, Schtasks.exe solicitará entrada ao usuário.

Formato /FO

Um valor que especifica o formato de saída. Os valores válidos são TABLE, LIST e CSV.

/NH

Um valor que especifica que o cabeçalho da coluna não deve ser exibido na saída. Isso é válido apenas para formatos TABLE e CSV.

/V

Um valor que exibe a saída detalhada da tarefa.

Observação

Se uma tarefa foi agendada para ser executada apenas uma vez, as informações de agendamento exibidas serão "Os dados de agendamento não estão disponíveis nesse formato".

Nome da tarefa/TN

Um valor que especifica o nome da tarefa para o qual recuperar as informações. Se nenhum nome de tarefa for especificado, as informações de todas as tarefas serão exibidas.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/XML

Um valor usado para exibir as definições de tarefa no formato XML.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/?

Um valor usado para exibir a Ajuda para Schtasks.exe.

Alterando uma tarefa

A sintaxe a seguir é usada para alterar a forma como o programa é executado ou alterar a conta de usuário e a senha usadas por uma tarefa agendada.

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

Sistema /S

Um valor que especifica o computador remoto ao qual se conectar. Se omitido, o parâmetro do sistema usará como padrão o computador local.

/Uusername

Um valor que especifica o contexto do usuário sob o qual Schtasks.exe deve ser executado.

/P[password]

Um valor que especifica a senha para o contexto de usuário fornecido. Se omitido, Schtasks.exe solicitará entrada ao usuário.

Nome da tarefa/TN

Um valor que especifica qual tarefa agendada será alterada.

/RUrunasuser

Um valor que altera o nome de usuário (contexto do usuário) no qual a tarefa agendada será executada. Para a conta do sistema, os valores válidos são "", "NT AUTHORITY\SYSTEM" ou "SYSTEM". Para tarefas do Agendador de Tarefas 2.0, "NT AUTHORITY\LOCALSERVICE" e "NT AUTHORITY\NETWORKSERVICE" também são valores válidos.

/RPrunaspassword

Um valor que especifica uma nova senha para o contexto de usuário existente ou a senha de uma nova conta de usuário. Essa senha é ignorada para a conta do sistema.

/TRtaskrun

Um valor que especifica um novo programa que a tarefa executará.

Hora de início/ST

Um valor que especifica a hora de início para executar a tarefa. O formato de hora é HH:mm (hora de 24 horas). Por exemplo, 14:30 especifica 14:30PM.

Windows XP e Windows Server 2003: Essa opção não está disponível.

Intervalo /RI

Um valor que especifica o intervalo de repetição, em minutos. O intervalo válido é de 1 a 599940 minutos.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/ETendtime

Um valor que especifica a hora de término da tarefa. O formato de hora é HH:mm (hora de 24 horas). Por exemplo, 14:50 especifica 14:50PM.

Windows XP e Windows Server 2003: Essa opção não está disponível.

Duração de /DU

Um valor que especifica a duração para executar a tarefa. O formato de hora é HH:mm (hora de 24 horas). Por exemplo, 14:50 especifica 14:50PM. Isso não é aplicável com o parâmetro /ET.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/K

Um valor que encerra a tarefa no tempo de término ou duração.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/SDstartdate

Um valor que especifica a primeira data na qual executar a tarefa. O formato é mm/dd/yyyy.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/EDenddate

Um valor que especifica a última data em que a tarefa será executada. O formato é mm/dd/yyyy.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/IT

Um valor que permite que a tarefa seja executada interativamente somente se o usuário /RU estiver conectado no momento no momento em que a tarefa for executada. A tarefa será executada somente se o usuário estiver conectado.

Windows XP e Windows Server 2003: Essa opção não está disponível.

Nível/RL

Um valor que define o nível de execução da tarefa. Os valores válidos são LIMITED e HIGHEST.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/PERMITIR

Um valor que habilita a tarefa agendada. Uma tarefa habilitada pode ser executada e uma tarefa desabilitada não pode ser executada.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/DESATIVAR

Um valor que desabilita a execução da tarefa agendada.

Observação

Se uma tarefa remota do Agendador de Tarefas 1.0 for desabilitada pelo Schtasks.exe e o computador remoto tiver a exceção de firewall de Compartilhamento de Arquivos e Impressoras habilitada e a exceção de firewall gerenciamento de tarefas agendadas remotas estiver desabilitada, a tarefa não será desabilitada quando lida de uma API do Agendador de Tarefas 2.0.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/Z

Um valor que marca a tarefa a ser excluída após sua execução final.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/DELAYdelaytime

Um valor que especifica o tempo de espera para atrasar a execução da tarefa depois que o gatilho é acionado. O formato de hora é mmmm:ss. Essa opção só é válida para tarefas com os tipos de agendamento ONSTART, ONLOGON e ONEVENT.

Windows XP e Windows Server 2003: Essa opção não está disponível.

/?

Um valor que exibe a mensagem de Ajuda para Schtasks.exe.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]