Compartilhar via


Objeto RegisteredTask

Objeto de script que fornece os métodos usados para executar a tarefa imediatamente, obter todas as instâncias em execução da tarefa, obter ou definir as credenciais usadas para registrar a tarefa e as propriedades que descrevem a tarefa.

Membros

O objeto RegisteredTask tem estes tipos de membros:

Métodos

O objeto RegisteredTask tem esses métodos.

Método Descrição
GetInstances Retorna todas as instâncias da tarefa registrada que estão em execução no momento.
GetRunTimes Obtém os horários em que a tarefa registrada está agendada para ser executada durante um período especificado.
GetSecurityDescriptor Obtém o descritor de segurança usado como credenciais para a tarefa registrada.
Executar Executa a tarefa registrada imediatamente.
RunEx Executa a tarefa registrada imediatamente usando sinalizadores especificados e um identificador de sessão.
SetSecurityDescriptor Define o descritor de segurança usado como credenciais para a tarefa registrada.
Stop Interrompe a tarefa registrada imediatamente.

Propriedades

O objeto RegisteredTask tem essas propriedades.

Propriedade Tipo de acesso Descrição
Definição
Somente leitura
Obtém a definição da tarefa.
Enabled
Leitura/gravação
Obtém ou define um valor booliano que indica se a tarefa registrada está habilitada.
LastRunTime
Somente leitura
Obtém a hora em que a tarefa registrada foi executada pela última vez.
LastTaskResult
Somente leitura
Obtém os resultados que foram retornados na última vez em que a tarefa registrada foi executada.
Nome
Somente leitura
Obtém o nome da tarefa registrada.
NextRunTime
Somente leitura
Obtém a hora em que a tarefa registrada está agendada para ser executada.
NumberOfMissedRuns
Somente leitura
Obtém o número de vezes que a tarefa registrada perdeu uma execução agendada.
Caminho
Somente leitura
Obtém o caminho para onde a tarefa registrada está armazenada.
Estado
Somente leitura
Obtém o estado operacional da tarefa registrada.
XML
Somente leitura
Obtém as informações de registro formatadas em XML para a tarefa registrada.

Exemplos

Para obter mais informações e código de exemplo para esse objeto de script, consulte Exemplo de gatilho de tempo (scripts) e Exibindo nomes e estados de tarefa (scripts).

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]
Biblioteca de tipos
Taskschd.tlb
DLL
Taskschd.dll