Partager via


Objet WeeklyTrigger

Objet de script qui représente un déclencheur qui démarre une tâche en fonction d’une planification hebdomadaire. Par exemple, la tâche commence à 8h00 un jour spécifique de la semaine chaque semaine ou toutes les autres semaines.

Membres

L’objet WeeklyTrigger a les types de membres suivants :

Propriétés

L’objet WeeklyTrigger a ces propriétés.

Propriété Type d’accès Description
DaysOfWeek
Lecture/écriture
Obtient ou définit les jours de la semaine sur lesquels la tâche s’exécute.
activé
Lecture/écriture
Hérité de l’objet Trigger . Obtient ou définit une valeur booléenne qui indique si le déclencheur est activé.
Limite de fin
Lecture/écriture
Hérité de l’objet Trigger . Obtient ou définit la date et l’heure de désactivation du déclencheur. Le déclencheur ne peut pas démarrer la tâche après sa désactivation.
ExecutionTimeLimit
Lecture/écriture
Hérité de l’objet Trigger . Obtient ou définit la durée maximale pendant laquelle la tâche lancée par le déclencheur est autorisée à s’exécuter.
Id
Lecture/écriture
Hérité de l’objet Trigger . Obtient ou définit l’identificateur du déclencheur.
RandomDelay
Lecture/écriture
Obtient ou définit un délai qui est ajouté de manière aléatoire à l’heure de début du déclencheur.
Répétition
Lecture/écriture
Hérité de l’objet Trigger . Obtient ou définit la fréquence d’exécution de la tâche et la durée pendant laquelle le modèle de répétition est répété après le démarrage de la tâche.
Limite de début
Lecture/écriture
Hérité de l’objet Trigger . Obtient ou définit la date et l’heure d’activation du déclencheur.
Type
Lecture seule
Hérité de l’objet Trigger . Obtient le type du déclencheur.
WeeksInterval
Lecture/écriture
Obtient ou définit l’intervalle entre les semaines de la planification.

Notes

L’heure de démarrage de la tâche est définie par la propriété StartBoundary .

Lors de la lecture ou de l’écriture de votre propre code XML pour une tâche, un déclencheur hebdomadaire est spécifié à l’aide de l’élément ScheduleByWeek du schéma Task Scheduler.

Le jour où l’heure d’été commence dans une année, pour un fuseau horaire du Pacifique (heure déplacée de 02:00 à 03:00 en 2022), toute tâche qui est planifiée pour s’exécuter entre 02:00 et 02:59:59:999 s’exécutera à l’heure la plus précoce possible qui existe dans ce jour donné, c’est-à-dire à 03:00 AM. Cela s’applique à tous les fuseaux horaires d’heure d’été en fonction des différentes heures auxquelles ils observent l’heure d’été.

Considérez une tâche hebdomadaire qui est définie pour s’exécuter tous les dimanches de 2022 à 02:30 dans le fuseau horaire du Pacifique, de sorte que l’heure d’exécution suivante est le 13 mars 2022 à 2:30 AM. Comme 2:30 am est une heure qui n’existe pas le 13 mars 2022, la tâche s’exécute à 3:00 AM à la place. Les autres dimanches de l’année, la tâche s’exécute comme d’habitude à 2h30.

Exemples

Pour plus d’informations et un exemple de code pour cet objet de script, consultez Exemple de déclencheur hebdomadaire (script).

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2008 [applications de bureau uniquement]
Bibliothèque de types
Taskschd.tlb
DLL
Taskschd.dll

Voir aussi

Déclencheur

TriggerCollection

TriggerCollection.Create