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
• Propriedades

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