Compartilhar via


Elemento Repetition (triggerBaseType)

Especifica 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.

<xs:element name="Repetition"
    type="repetitionType"
 />

O elemento Repetition é definido pelo tipo complexo triggerBaseType .

Elemento pai

Elemento Derivado de Descrição
BootTrigger bootTriggerType Especifica um gatilho que inicia uma tarefa quando o sistema é inicializado.
CalendarTrigger calendarTriggerType Especifica um gatilho diário, semanal, mensal ou mensal do dia da semana (DOW).
EventTrigger eventTriggerType Especifica um gatilho que inicia uma tarefa quando ocorre um evento do sistema.
IdleTrigger idleTriggerType Especifica um gatilho que inicia uma tarefa quando o computador entra em um estado ocioso.
LogonTrigger logonTriggerType Especifica um gatilho que inicia uma tarefa quando um usuário faz logon.
RegistrationTrigger registrationTriggerType Especifica um gatilho que inicia uma tarefa quando a tarefa é registrada.
TimeTrigger timeTriggerType Especifica um gatilho que inicia uma tarefa quando o gatilho é ativado.

Elementos filho

Elemento Type Descrição
Duração duration Especifica por quanto tempo o padrão é repetido.
Intervalo duration Especifica a quantidade de tempo entre cada reinicialização da tarefa.
StopAtDurationEnd booleano Especifica que 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.

Windows Vista, Windows 7, Windows Server 2008, Windows 8 e Windows Server 2012: normalmente, definir a duração da repetição como um múltiplo exato do intervalo produz os números descritos acima. No entanto, sob determinadas condições de carga pesadas, é possível que a duração do tempo limite antes de TaskScheduler possa iniciar o intervalo de tarefas final.

Para o desenvolvimento de scripts, o padrão de repetição é especificado usando a propriedade Trigger.Repetition herdada por todos os objetos de gatilho.

Para o desenvolvimento do C++, o padrão de repetição é especificado usando a propriedade ITRigger::Repetition herdada por todas as interfaces de gatilho.

Exemplos

O XML a seguir define um elemento de gatilho de inicialização que especifica um padrão de repetição para um gatilho.

<BootTrigger>
    <StartBoundary>2005-01-01T08:00:00</StartBoundary>
    <EndBounadry>2007-01-01T08:00:00</EndBoundary>
    <Enabled>true</Enabled>
    <Repetition>
        <Interval></Interval>
        <Duration></Duration>
        <StopAtDurationEnd>true</StopAtDurationEnd>
    </Repetition>
    <ExecutionTimeLimit></ExecutionTimeLimit>
    <Delay><Delay>
 </BootTrigger>

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]

Confira também

Elementos de esquema do agendador de tarefas

Agendador de Tarefas