Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
ScheduleByWeek (calendarTriggerType) Element
Collapse the table of content
Expand the table of content

ScheduleByWeek (calendarTriggerType) Element

Specifies a weekly schedule. For example, the task starts at 8:00 AM on a specific day of the week every week or on a specific day of the week every other week.

<xs:element name="ScheduleByWeek"

The ScheduleByWeek element is defined by the calendarTriggerType complex type.

Parent element

ElementDerived fromDescription
CalendarTrigger calendarTriggerType

Specifies a daily, weekly, monthly, or a monthly day-of-the-week (DOW) trigger.

Child elements

DaysOfWeek daysOfWeekType

Specifies the days of the week in which the task runs.

WeeksInterval unsignedByte

Specifies the interval between the weeks in the schedule.


The child elements listed above are defined by the weeklyScheduleType complex element types.

The time of day that the task is started is set by the StartBoundary element.

For scripting development, a weekly trigger is specified using the WeeklyTrigger object.

For C++ development, a weekly trigger is specified using the IWeeklyTrigger interface.


The following XML defines a weekly calendar trigger that starts a task Monday through Friday (at 8:00 AM) every week.



Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

See also

Task Scheduler Schema Elements
Task Scheduler



Community Additions

© 2015 Microsoft