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 |
|
| DLL |
|