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