Partilhar via


Objeto RepetitionPattern

Objeto de script que 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.

Membros

O objeto RepetitionPattern tem estes tipos de membros:

Propriedades

O objeto RepetitionPattern tem essas propriedades.

Propriedade Tipo de acesso Descrição
Duração
Leitura/gravação
Obtém ou define por quanto tempo o padrão é repetido.
Intervalo
Leitura/gravação
Obtém ou define a quantidade de tempo entre cada reinicialização da tarefa.
StopAtDurationEnd
Leitura/gravação
Obtém ou define um valor booliano que indica se uma instância em execução da tarefa é interrompida no final da duração do padrão de repetição.

Comentários

Se você especificar uma duração de repetição para uma tarefa, também deverá especificar o intervalo de repetição.

Se você registrar uma tarefa que contém um gatilho com um intervalo de repetição igual a um minuto e uma duração de repetição igual a quatro minutos, a tarefa será iniciada cinco vezes. As cinco repetições podem ser definidas pelo padrão a seguir.

  1. Uma tarefa começa no início do primeiro minuto.
  2. A próxima tarefa começa no final do primeiro minuto.
  3. A próxima tarefa começa no final do segundo minuto.
  4. A próxima tarefa começa no final do terceiro minuto.
  5. A próxima tarefa começa no final do quarto minuto.

Windows Server 2003, Windows XP e Windows 2000: Se você registrar uma tarefa que contém um gatilho com um intervalo de repetição igual a um minuto e uma duração de repetição igual a quatro minutos, a tarefa será iniciada quatro vezes.

Ao ler ou gravar XML para uma tarefa, o padrão de repetição é especificado usando o elemento Repetition do esquema do Agendador de Tarefas.

Exemplos

Para obter mais informações e código de exemplo para essa propriedade, consulte Exemplo de gatilho diário (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

Objetos do Agendador de Tarefas

Agendador de Tarefas