MonthlyTrigger object
Scripting object that represents a trigger that starts a task based on a monthly schedule. For example, the task starts on specific days of specific months.
Members
The MonthlyTrigger object has these types of members:
Properties
The MonthlyTrigger object has these properties.
| Property | Access type | Description |
|---|---|---|
| DaysOfMonth |
Read/write |
Gets or sets the days of the month during which the task runs. |
| Enabled |
Read/write |
Inherited from the Trigger object. Gets or sets a Boolean value that indicates whether the trigger is enabled. |
| EndBoundary |
Read/write |
Inherited from the Trigger object. Gets or sets the date and time when the trigger is deactivated. The trigger cannot start the task after it is deactivated. |
| ExecutionTimeLimit |
Read/write |
Inherited from the Trigger object. Gets or sets the maximum amount of time that the task launched by the trigger is allowed to run. |
| Id |
Read/write |
Inherited from the Trigger object. Gets or sets the identifier for the trigger. |
| MonthsOfYear |
Read/write |
Gets or sets the months of the year during which the task runs. |
| RandomDelay |
Read/write |
Gets or sets a delay time that is randomly added to the start time of the trigger. |
| Repetition |
Read/write |
Inherited from the Trigger object. Gets or sets how often the task is run and how long the repetition pattern is repeated after the task is started. |
| RunOnLastDayOfMonth |
Read/write |
Gets or sets a Boolean value that indicates that the task runs on the last day of the month. |
| StartBoundary |
Read/write |
Inherited from the Trigger object. Gets or sets the date and time when the trigger is activated. |
| Type |
Read-only |
Inherited from the Trigger object. Gets the type of the trigger. |
Remarks
The time of day that the task is started is set by the StartBoundary property.
When reading or writing your own XML for a task, a monthly trigger is specified using the ScheduleByMonth element of the Task Scheduler schema.
On the day that daylight savings time (DST) starts in a year, for a Pacific time zone (time shifted from 02:00 AM to 03:00 AM in 2022), any task that's scheduled to run between 02:00 AM and 02:59:59:999 AM will run at the earliest possible time that exists in that given day—that is, at 03:00 AM. This applies to all DST time zones based on the various times at which they observe DST.
Consider a weekly task that's set to run every Sunday of 2022 at 02:30 AM in the Pacific time zone such that the next run time is Mar 13, 2022 02:30 AM. As 02:30 AM is a time that doesn't exist on Mar 13, 2022, the task runs at 03:00 AM instead. On other Sundays of the year, the task runs as usual at 02:30 AM.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista [desktop apps only] |
| Minimum supported server |
Windows Server 2008 [desktop apps only] |
| Type library |
|
| DLL |
|