Objeto LogonTrigger

Objeto de script que representa um gatilho que inicia uma tarefa quando um usuário faz logon. Quando o serviço Agendador de Tarefas é iniciado, todos os usuários conectados são enumerados e todas as tarefas registradas com gatilhos de logon que correspondem ao usuário conectado são executadas.

Membros

O objeto LogonTrigger tem estes tipos de membros:

• Propriedades

Propriedades

O objeto LogonTrigger tem essas propriedades.

Propriedade	Tipo de acesso	Descrição
Atrasar	Leitura/gravação	Obtém ou define um valor que indica a quantidade de tempo entre quando o usuário faz logon e quando o trabalho é iniciado.
habilitado	Leitura/gravação	Herdado do objeto Trigger . Obtém ou define um valor booliano que indica se o gatilho está habilitado.
EndBoundary	Leitura/gravação	Herdado do objeto Trigger . Obtém ou define a data e a hora em que o gatilho é desativado. O gatilho não pode iniciar a tarefa depois que ela é desativada.
ExecutionTimeLimit	Leitura/gravação	Herdado do objeto Trigger . Obtém ou define a quantidade máxima de tempo que a tarefa iniciada pelo gatilho tem permissão para ser executada.
Id	Leitura/gravação	Herdado do objeto Trigger . Obtém ou define o identificador do gatilho.
Repetição	Leitura/gravação	Herdado do objeto Trigger . Obtém ou define um valor que indica com que frequência a tarefa é executada e por quanto tempo o padrão de repetição é repetido após o início da tarefa.
StartBoundary	Leitura/gravação	Herdado do objeto Trigger . Obtém ou define a data e a hora em que o gatilho é ativado.
Tipo	Somente leitura	Herdado do objeto Trigger . Obtém o tipo do gatilho.
UserId	Leitura/gravação	Obtém ou define o identificador do usuário.

Comentários

Se você quiser que uma tarefa seja disparada quando qualquer membro de um grupo fizer logon no computador em vez de quando um usuário específico fizer logon, não atribua um valor à propriedade LogonTrigger.UserId . Em vez disso, crie um gatilho de logon com uma propriedade LogonTrigger.UserId vazia e atribua um valor à entidade de segurança para a tarefa usando a propriedade Principal.GroupId .

Ao ler ou gravar XML para uma tarefa, um gatilho de logon é especificado usando o elemento LogonTrigger do esquema do Agendador de Tarefas.

Exemplos

Para obter mais informações e código de exemplo para esse objeto de script, consulte Exemplo de gatilho de logon (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

Confira também

Gatilho