Compartilhar via


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

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