CalendarTrigger (triggerGroup) Element
Specifies a daily, weekly, monthly, or a monthly day-of-the-week (DOW) trigger.
<xs:element name="CalendarTrigger"
type="calendarTriggerType"
/>
The CalendarTrigger element is defined by the calendarTriggerType complex type.
Parent element
| Element | Derived from | Description |
|---|---|---|
| Triggers | triggersType | Specifies the triggers that start the task. |
Child elements
| Element | Type | Description |
|---|---|---|
| Enabled (triggerBaseType) | boolean | Specifies that the trigger is enabled. |
| EndBoundary (triggerBaseType) | dateTime | Specifies the date and time when the trigger is deactivated. The trigger cannot start the task after it is deactivated. |
| ExecutionTimeLimit (triggerBaseType) | duration | Specifies the maximum amount of time in which the task can be started by the trigger. |
| Repetition (triggerBaseType) | repetitionType | Specifies how often the task is run and how long the repetition pattern is repeated after the task is started. |
| ScheduleByDay (calendarTriggerType) | dailyScheduleType | Specifies a daily schedule. |
| ScheduleByMonth (calendarTriggerType) | monthlyScheduleType | Specifies a monthly schedule. |
| ScheduleByMonthDayOfWeek (calendarTriggerType) | monthlyDayOfWeekScheduleType | Specifies a trigger that starts a job on a monthly day-of-week schedule. |
| ScheduleByWeek (calendarTriggerType) | weeklyScheduleType | Specifies a weekly schedule. |
| StartBoundary (triggerBaseType) | dateTime | Specifies the date and time when the trigger is activated. This element is required. |
Attributes
| Name | Type | Description |
|---|---|---|
| Id | ID | The identifier of the trigger. |
Remarks
The StartBoundary element is a required element for time and calendar triggers (TimeTrigger and CalendarTrigger).
The child elements listed above are defined by the triggerBaseType and calendarTriggerType complex element types.
For script development, calendar triggers are specified using one of the following objects.
For C++ development, calendar triggers are specified using one of the following interfaces.
Examples
For a complete example of the XML for a task that specifies a calendar trigger, see Daily Trigger Example (XML).
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista [desktop apps only] |
| Minimum supported server |
Windows Server 2008 [desktop apps only] |