schtasks query
Lista todas as tarefas agendadas a serem executadas no computador.
Sintaxe
schtasks [/query] [/fo {TABLE | LIST | CSV}] [/nh] [/v] [/s <computer> [/u [<domain>\]<user> [/p <password>]]] [/tn <taskname>] [/xml] [/hresult]
Parâmetros
Parâmetro | Descrição |
---|---|
/Query | Opcionalmente, especifica o nome da operação. O uso dessa consulta sem nenhum parâmetro executa uma consulta de todas as tarefas no sistema. |
/fo <format> |
Especifica o formato de saída. Os valores válidos são TABLE, LIST ou CSV. |
/nh | Remove os cabeçalhos de coluna da exibição da tabela. Esse parâmetro é válido com os formatos de saída TABLE ou CSV. |
/v | Adiciona as propriedades avançadas da tarefa à exibição. Esse parâmetro é válido com os formatos de saída LIST ou CSV. |
/s <computer> |
Especifica o nome ou o endereço IP de um computador remoto (com ou sem barras invertidas). O padrão é o computador local. |
/u [<domain>] |
Executa esse comando com as permissões da conta de usuário especificada. Por padrão, o comando é executado com as permissões do usuário atual do computador local. A conta de usuário especificada deve ser um membro do grupo Administradores no computador remoto. Os parâmetros /u e /p são válidos somente quando você usa /s. |
/p <password> |
Especifica a senha da conta de usuário especificada no parâmetro /u. Se você usar o parâmetro /u sem o parâmetro /p ou o argumento de senha, schtasks solicitará uma senha. Os parâmetros /u e /p são válidos somente quando você usa /s. |
/tn <taskname> |
Consulta uma tarefa específica por caminho e nome. Se /tn for usado, <taskname> não poderá ficar em branco. Assume a pasta "\" do diretório raiz por padrão (portanto, \ pode ser omitido se a tarefa estiver localizada no diretório raiz). Não aceita curingas. Use aspas para incluir nomes que incluem espaços. |
/xml | Gera todas as definições de tarefa no sistema para o formato XML. Se /tn for especificado, a saída do nome da tarefa específica para o formato XML. O caminho completo e o nome devem ser usados. |
/hresult | Especifica o código de saída do processo que estará no formato HRESULT. |
/? | Exibe a ajuda no prompt de comando. |
Exemplos
Para listar todas as tarefas agendadas para o computador local, digite:
schtasks
schtasks /query
Esses comandos geram o mesmo resultado e podem ser usados alternadamente.
Para solicitar uma exibição detalhada das tarefas no computador local, digite:
schtasks /query /fo LIST /v
Esse comando usa o parâmetro /v para solicitar uma exibição detalhada (minuciosa) e o parâmetro /fo LIST para formatar a exibição como uma lista para facilitar a leitura. Você pode usar esse comando para verificar se uma tarefa criada tem o padrão de recorrência pretendido.
Para solicitar uma lista de tarefas agendadas para um computador remoto e adicionar as tarefas a um arquivo de log separado por vírgulas no computador local, digite:
schtasks /query /s Reskit16 /fo csv /nh >> \\svr01\data\tasklogs\p0102.csv
Você pode usar esse formato de comando para coletar e acompanhar tarefas agendadas para vários computadores. Esse comando usa o parâmetro /s para identificar o computador remoto, Reskit16 e o parâmetro /fo para especificar o formato e o parâmetro /nh para suprimir os títulos de coluna. O símbolo de acréscimo >> redireciona a saída para o log de tarefas, p0102.csv, no computador local, Svr01. Como o comando é executado no computador remoto, o caminho do computador local deve ser totalmente qualificado.
Para obter informações para a tarefa Manutenção de Assinatura do Office usando o parâmetro /tn, que também pode ser exibido por meio do Agendador de Tarefas no local \Microsoft\Office\ com o diretório raiz "\" na pasta Biblioteca do Agendador de Tarefas, digite:
schtasks /query /tn "\Microsoft\Office\Office Subscription Maintenance"