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.
- Uma tarefa começa no início do primeiro minuto.
- A próxima tarefa começa no final do primeiro minuto.
- A próxima tarefa começa no final do segundo minuto.
- A próxima tarefa começa no final do terceiro minuto.
- 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] |