Partilhar via


Objeto WeeklyTrigger

Objeto de script que representa um gatilho que inicia uma tarefa com base em um agendamento semanal. Por exemplo, a tarefa começa às 8:00 da manhã em um dia específico da semana toda semana ou a cada duas semanas.

Membros

O objeto WeeklyTrigger tem estes tipos de membros:

Propriedades

O objeto WeeklyTrigger tem essas propriedades.

Propriedade Tipo de acesso Descrição
DaysOfWeek
Leitura/gravação
Obtém ou define os dias da semana em que a tarefa é executada.
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.
RandomDelay
Leitura/gravação
Obtém ou define um tempo de atraso adicionado aleatoriamente à hora de início do gatilho.
Repetição
Leitura/gravação
Herdado do objeto Trigger . Obtém ou define a frequência com que a tarefa é executada e 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.
WeeksInterval
Leitura/gravação
Obtém ou define o intervalo entre as semanas na agenda.

Comentários

A hora do dia em que a tarefa é iniciada é definida pela propriedade StartBoundary .

Ao ler ou gravar seu próprio XML para uma tarefa, um gatilho semanal é especificado usando o elemento ScheduleByWeek do esquema do Agendador de Tarefas.

No dia em que o horário de verão (DST) começa em um ano, para um fuso horário do Pacífico (horário deslocado das 02:00 para 03:00 em 2022), qualquer tarefa agendada para ser executada entre 02:00 e 02:59:59:999 AM será executada o mais cedo possível que existe nesse determinado dia— ou seja, às 03:00 am. Isso se aplica a todos os fusos horários DST com base nas várias vezes em que eles observam o DST.

Considere uma tarefa semanal que deve ser executada todos os domingos de 2022 às 2h30 no fuso horário do Pacífico, de modo que o próximo horário de execução seja 13 de março de 2022 às 2h30. Como 2h30 é uma hora que não existe em 13 de março de 2022, a tarefa é executada às 3h00. Em outros domingos do ano, a tarefa é executada normalmente às 2h30.

Exemplos

Para obter mais informações e um exemplo de código para esse objeto de script, consulte Exemplo de gatilho semanal (script).

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

Triggercollection

TriggerCollection.Create