Objeto MonthlyTrigger

Objeto de script que representa um gatilho que inicia uma tarefa com base em um agendamento mensal. Por exemplo, a tarefa começa em dias específicos de meses específicos.

Membros

O objeto MonthlyTrigger tem estes tipos de membros:

• Propriedades

Propriedades

O objeto MonthlyTrigger tem essas propriedades.

Propriedade	Tipo de acesso	Descrição
DaysOfMonth	Leitura/gravação	Obtém ou define os dias do mês durante os quais a tarefa é executada.
Enabled	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.
MonthsOfYear	Leitura/gravação	Obtém ou define os meses do ano durante os quais a tarefa é executada.
RandomDelay	Leitura/gravação	Obtém ou define um tempo de atraso que é 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 por quanto tempo o padrão de repetição é repetido após o início da tarefa.
RunOnLastDayOfMonth	Leitura/gravação	Obtém ou define um valor booliano que indica que a tarefa é executada no último dia do mês.
StartBoundary	Leitura/gravação	Herdado do objeto Trigger . Obtém ou define a data e a hora em que o gatilho é ativado.
Type	Somente leitura	Herdado do objeto Trigger . Obtém o tipo do gatilho.

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 mensal é especificado usando o elemento ScheduleByMonth do esquema 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 às 03:00 em 2022), qualquer tarefa agendada para ser executada entre 02:00 e 02:59:59:999 AM será executada no momento mais cedo possível que existir 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 será executada todos os domingos de 2022 às 02h30 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 02:30 AM. Como 02:30 é uma hora que não existe em 13 de março de 2022, a tarefa é executada às 03:00. Em outros domingos do ano, a tarefa é executada normalmente às 02h30.

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

Objetos do Agendador de Tarefas

Agendador de Tarefas

Triggercollection

TriggerCollection.Create