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

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