Comando schtasks da linha de comando do MS-DOS e do Windows

comando schtasks

O comando schtasks permite que um administrador crie, exclua, consulte, altere, execute e encerre tarefas agendadas em um sistema local ou remoto.

Disponibilidade

Schtasks é um comando externo disponível para os seguintes sistemas operacionais da Microsoft como schtasks.exe.

Windows Vista
Windows 7
Windows 8
Windows 10

Sintaxe Schtasks

SCHTASKS /parameter [arguments]

/Crio	Cria uma nova tarefa agendada.
/Excluir	Exclui a (s) tarefa (s) agendada (s).
/Consulta	Exibe todas as tarefas agendadas.
/Mudar	Altera as propriedades da tarefa agendada.
/Corre	Executa a tarefa agendada sob demanda.
/Fim	Pára a tarefa agendada em execução no momento.
\/ShowSid	Mostra o identificador de segurança correspondente a um nome de tarefa agendada.

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 | /NP] [/Z] [/F] [/HRESULT] [/?]

\/S	sistema	Especifica o sistema remoto. Se omitido, o parâmetro do sistema é padronizado para o sistema local.
/VOCÊ	nome do usuário	Especifica o contexto do usuário no qual o SchTasks.exe deve ser executado.
\/P	[password]	Especifica a senha para o contexto de usuário fornecido. Solicita entrada, se omitido.
\/RU	nome do usuário	Especifica a conta de usuário “executar como” (contexto do usuário) sob a qual a tarefa é executada. Para a conta do sistema, os valores válidos são “”, “NT AUTHORITY SYSTEM” ou “SYSTEM”. Para tarefas v2, “NT AUTHORITY LOCALSERVICE” e “NT AUTHORITY NETWORKSERVICE” também estão disponíveis e os SIDs bem conhecidos para todos os três.
\/RP	[password]	Especifica a senha para o usuário “executar como”. Para solicitar a senha, o valor deve ser “*” ou nenhum. Esta senha é ignorada para a conta do sistema. Deve ser combinado com a opção \/RU ou \/XML.
\/SC	cronograma	Especifica a frequência da programação. Tipos de programação válidos: MINUTO, HORA, DIÁRIO, SEMANAL, MENSAL, UMA VEZ, NO INÍCIO, ONLOGON, ONIDLE, ONEVENT.
\/MO	modificador	Refina o tipo de programação para permitir um controle mais preciso sobre a recorrência da programação. Os valores válidos estão listados na seção de modificadores a seguir.
\/D	dias	Especifica o dia da semana para executar a tarefa. Valores válidos: SEG, TER, QUA, QUI, SEX, SÁB, DOM e para MENSAIS horários 1 a 31 (dias do mês). O curinga “*” especifica todos os dias.
\/M	meses	Especifica o (s) mês (es) do ano. O padrão é o primeiro dia do mês. Valores válidos: JAN, FEV, MAR, ABR, MAY, JUN, JUL, AGO, SET, OUT, NOV, DEZ. O curinga “*” especifica todos os meses.
/EU	idletimes	Especifica a quantidade de tempo ocioso a aguardar antes de executar uma tarefa ONIDLE agendada. Intervalo válido: 1 – 999 minutos.
\/TN	nome da tarefa	Especifica um nome que identifica exclusivamente esta tarefa agendada.
\/TR	taskrun	Especifica o caminho e o nome do arquivo do programa a ser executado na hora agendada. Exemplo: C: windows system32 calc.exe
\/ST	hora de início	Especifica a hora de início para executar a tarefa. O formato da hora é HH: mm (24 horas) por exemplo, 14:30 para 14:30. O padrão é a hora atual se \/ST não for especificado. Esta opção é necessária com \/SC ONCE.
\/RI	intervalo	Especifica o intervalo de repetição em minutos. O intervalo não é aplicável para os tipos de programação: MINUTE, HOURLY, ONSTART, ONLOGON, ONIDLE, ONEVENT. Intervalo válido: 1 – 599940 minutos. Se \/ET ou \/DU for especificado, o padrão é 10 minutos.
\/ET	Fim do tempo	Especifica a hora de término para executar a tarefa. O formato da hora é HH: mm (24 horas) por exemplo, 14:50 para 14:50 e não é aplicável para os tipos de programação: ONSTART, ONLOGON, ONIDLE, ONEVENT.
\/DU	duração	Especifica a duração da execução da tarefa. O formato da hora é HH: mm e não é aplicável com \/ET e para os tipos de programação: ONSTART, ONLOGON, ONIDLE, ONEVENT. Para tarefas \/V1, se \/RI for especificado, o padrão de duração é 1 hora.
\/K		Encerra a tarefa na hora de término ou hora de duração e não é aplicável para os tipos de programação: ONSTART, ONLOGON, ONIDLE, ONEVENT. Deve ser especificado \/ET ou \/DU.
/SD	data de início	Especifica a primeira data em que a tarefa é executada. O formato é mm \/dd \/aaaa. O padrão é a data atual e não é aplicável para os tipos de programação: ONCE, ONSTART, ONLOGON, ONIDLE, ONEVENT.
\/ED	data final	Especifica a última data em que a tarefa deve ser executada. O formato é mm \/dd \/aaaa e não é aplicável para os tipos de programação: ONCE, ONSTART, ONLOGON, ONIDLE, ONEVENT.
\/EC	Nome do canal	Especifica o canal de eventos para acionadores OnEvent.
/ISTO		Permite que a tarefa seja executada interativamente apenas se o usuário \/RU estiver conectado no momento em que o trabalho é executado. Esta tarefa é executada apenas se o usuário estiver conectado ao computador.
\/NP		Nenhuma senha é armazenada. A tarefa é executada de forma não interativa com o usuário fornecido. Apenas recursos locais estão disponíveis.
\/Z		Marca a tarefa para exclusão após sua execução final.
\/XML	xmlfile	Cria uma tarefa a partir do XML de tarefa especificado em um arquivo. Pode ser combinado com as opções \/RU e \/RP ou apenas com \/RP, quando o XML da tarefa já contém o principal.
\/V1		Cria uma tarefa visível para plataformas pré-Vista. Não compatível com \/XML.
\/F		Cria a tarefa à força e suprime os avisos se a tarefa especificada já existir.
\/RL	nível	Define o nível de execução do trabalho. Os valores válidos são LIMITED e HIGHEST. O padrão é LIMITADO.
/ATRASO	tempo de atraso	Especifica o tempo de espera para atrasar a execução da tarefa depois que o gatilho é disparado. O formato da hora é mmmm: ss. Esta opção é válida apenas para os tipos de programação ONSTART, ONLOGON, ONEVENT.
\/HRESULT		Para uma melhor capacidade de diagnóstico, o código de saída do processo estará no formato HRESULT.

Crie modificadores

Valores válidos para a chave \/MO por tipo de programação:

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.
ONTHLY: 1 - 12, or FIRST, SECOND, THIRD, FOURTH, LAST, LASTDAY.
ONEVENT:  XPath event query string.

Pule para exemplos, incluindo exemplos de exclusão de schtasks.

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

\/S	sistema	Especifica o sistema remoto conectado.
/VOCÊ	nome do usuário	Especifica o contexto do usuário no qual o schtasks.exe deve ser executado.
\/P	[password]	Especifica a senha para o contexto de usuário fornecido. Solicita entrada, se omitido.
\/TN	nome da tarefa	Especifica o nome da tarefa agendada a ser excluída. O caractere curinga “*” pode ser usado para excluir todas as tarefas.
\/F		Exclui a tarefa à força e suprime os avisos se a tarefa especificada estiver em execução no momento.
\/HRESULT		Para uma melhor capacidade de diagnóstico, o código de saída do processo estará no formato HRESULT.

Pule para exemplos, incluindo exemplos de exclusão de schtasks.

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

\/S	sistema	Especifica o sistema remoto conectado.
/VOCÊ	nome do usuário	Especifica o contexto do usuário no qual o schtasks.exe deve ser executado.
\/P	[password]	Especifica a senha para o contexto de usuário fornecido. Solicita entrada, se omitido.
\/FO	formato	Especifica o formato da saída. Valores válidos: TABLE, LIST, CSV.
\/NH		Especifica que o cabeçalho da coluna não deve ser exibido na saída e é válido apenas para os formatos TABLE e CSV.
\/V		Exibe a saída detalhada da tarefa.
\/TN	nome da tarefa	Especifica o nome da tarefa para a qual recuperar as informações, caso contrário, todas elas.
\/XML	[xml_type]	Exibe definições de tarefas em formato XML. Se xml_type for ONE, a saída será um arquivo XML válido. Se xml_type não estiver presente, a saída será a concatenação de todas as definições de tarefa XML.
\/HRESULT		Para uma melhor capacidade de diagnóstico, o código de saída do processo estará no formato HRESULT.

Pule para exemplos, incluindo exemplos de consulta de schtasks.

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] } [/HRESULT] [/?]

\/S	sistema	Especifica o sistema remoto conectado.
/VOCÊ	nome do usuário	Especifica o contexto do usuário no qual o schtasks.exe deve ser executado.
\/P	[password]	Especifica a senha para o contexto de usuário fornecido. Solicita entrada, se omitido.
\/TN	nome da tarefa	Especifica qual tarefa agendada deve ser alterada.
\/RU	nome do usuário	Altera o nome de usuário (contexto do usuário) sob o qual a tarefa agendada deve ser executada. Para a conta do sistema, os valores válidos são “”, “NT AUTHORITY SYSTEM” ou “SYSTEM”. Para tarefas v2, “NT AUTHORITY LOCALSERVICE” e “NT AUTHORITY NETWORKSERVICE” também estão disponíveis e os SIDs bem conhecidos para todos os três.
\/RP	senha	Especifica uma nova senha para o contexto de usuário existente ou a senha para uma nova conta de usuário. Esta senha é ignorada para a conta do sistema.
\/TR	taskrun	Especifica o novo programa executado pela tarefa agendada.
\/ST	hora de início	Especifica a hora de início para executar a tarefa. O formato da hora é HH: mm (formato de 24 horas) por exemplo, 14:30 para 14:30
\/RI	intervalo	Especifica o intervalo de repetição em minutos. Intervalo válido: 1 – 599940 minutos.
\/ET	Fim do tempo	Especifica a hora de término para executar a tarefa. O formato da hora é HH: mm (formato de 24 horas) por exemplo, 14:50 para 14:50
\/DU	duração	Especifica a duração da execução da tarefa. O formato da hora é HH: mm e não é aplicável com \/ET.
\/K		Encerra a tarefa no horário de término ou no horário de duração.
/SD	data de início	Especifica a primeira data em que a tarefa é executada. O formato é mm \/dd \/aaaa.
\/ED	data final	Especifica a última data em que a tarefa deve ser executada. O formato é mm \/dd \/aaaa.
/ISTO		Permite que a tarefa seja executada interativamente apenas se o usuário \/RU estiver conectado no momento em que o trabalho é executado. Esta tarefa é executada apenas se o usuário estiver conectado ao computador.
\/RL	nível	Define o nível de execução do trabalho. Os valores válidos são LIMITED e HIGHEST. O padrão é não alterá-lo.
/PERMITIR		Habilita a tarefa agendada.
\/DESATIVAR		Desativa a tarefa agendada.
\/Z		Marca a tarefa para exclusão após sua execução final.
/ATRASO	tempo de atraso	Especifica o tempo de espera para atrasar a execução da tarefa depois que o gatilho é disparado. O formato da hora é mmmm: ss. Esta opção é válida apenas para os tipos de programação ONSTART, ONLOGON, ONEVENT.
\/HRESULT		Para uma melhor capacidade de diagnóstico, o código de saída do processo estará no formato HRESULT.

Pule para exemplos, incluindo exemplos de mudança de schtasks.

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

\/S	sistema	Especifica o sistema remoto conectado.
/VOCÊ	nome do usuário	Especifica o contexto do usuário no qual o schtasks.exe deve ser executado.
\/P	[password]	Especifica a senha para o contexto de usuário fornecido. Solicita entrada, se omitido.
/EU		Executa a tarefa imediatamente, ignorando qualquer restrição.
\/TN	nome da tarefa	Identifica a tarefa agendada para ser executada agora.
\/HRESULT		Para uma melhor capacidade de diagnóstico, o código de saída do processo estará no formato HRESULT.

Pule para exemplos, incluindo exemplos de execução de schtasks.

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

\/S	sistema	Especifica o sistema remoto conectado.
/VOCÊ	nome do usuário	Especifica o contexto do usuário no qual o schtasks.exe deve ser executado.
\/P	[password]	Especifica a senha para o contexto de usuário fornecido. Solicita entrada, se omitido.
\/TN	nome da tarefa	Especifica a tarefa agendada para terminar.
\/HRESULT		Para uma melhor capacidade de diagnóstico, o código de saída do processo estará no formato HRESULT.

Pule para exemplos incluindo exemplos finais de schtasks.

SCHTASKS /ShowSid /TN taskname [/HRESULT] [/?]

\/TN	nome da tarefa	Especifica o nome da tarefa agendada. Traços não são permitidos no nome.
\/HRESULT		Para uma melhor capacidade de diagnóstico, o código de saída do processo estará no formato HRESULT.

Exemplos de Schtasks

schtasks

Executado sozinho, o schtasks exibe todos os nomes de tarefas, seu próximo tempo de execução e o status.

Exemplo de exclusão de Schtasks

SCHTASKS /Delete /TN "BackupBackup and Restore"

Exclua a tarefa agendada de Backup e Restauração usando schtasks.

Exemplo de consulta Schtasks

SCHTASKS /Query /FO CSV /NH /V

Consulte as tarefas de programação usando schtasks e exiba todas as saídas em formato CSV.

Exemplo de mudança de Schtasks

SCHTASKS /Change /TR restore.exe /TN "BackupStart Restore"

Altere o nome da tarefa restore.exe para Iniciar restauração usando schtasks.

Exemplo de execução de Schtasks

SCHTASKS /Run /TN "BackupStart Backup"

Execute o nome da tarefa Iniciar o backup usando schtasks.

Exemplo final de Schtasks

SCHTASKS /End /TN "BackupStart Backup"

Finalize o nome da tarefa. Inicie o backup usando schtasks.

Exemplo de Schtasks showsid

SCHTASKS /ShowSid /TN "BackupStart Backup"

Executar o comando acima forneceria resultados semelhantes ao exemplo abaixo.

SUCCESS: The SID "S-1-5-17-2047162322-3971081939-4152322419-2583044571-537493394" for the username "Backup-Start Backup" has been computed successfully.