Edit

Share via

calendarTriggerType Complex Type

  • Article

Defines the child elements and sequencing information for calendar elements.

<xs:complexType name="calendarTriggerType">
    <xs:complexContent>
        <xs:extension
            base="triggerBaseType"
        >
            <xs:sequence>
                <xs:element name="RandomDelay"
                    type="duration"
                    default="PT0M"
                    minOccurs="0"
                 />
                <xs:choice>
                    <xs:element name="ScheduleByDay"
                        type="dailyScheduleType"
                     />
                    <xs:element name="ScheduleByWeek"
                        type="weeklyScheduleType"
                     />
                    <xs:element name="ScheduleByMonth"
                        type="monthlyScheduleType"
                     />
                    <xs:element name="ScheduleByMonthDayOfWeek"
                        type="monthlyDayOfWeekScheduleType"
                     />
                </xs:choice>
            </xs:sequence>
        </xs:extension>
    </xs:complexContent>
</xs:complexType>

Child elements

Element Type Description
RandomDelay duration Contains the delay time that is randomly added to the start time of the trigger. The format for this string is P<days>DT<hours>H<minutes>M<seconds>S (for example, P2DT5S is a 2 day, 5 second delay).
ScheduleByDay dailyScheduleType Specifies a daily schedule. For example, the task starts every day, every-other day, every third day, and so on.
ScheduleByMonth monthlyScheduleType Specifies a monthly schedule. For example, the task starts at 8:00 AM on specific days of the month on specific months.
ScheduleByMonthDayOfWeek monthlyDayOfWeekScheduleType Specifies a trigger that starts a job on a monthly day-of-week schedule. For example, the task starts on specific days of the week, weeks of the month, and months of the year.
ScheduleByWeek weeklyScheduleType 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.

Remarks

In addition to the child element defined here, the CalendarTrigger element also uses the child elements defined by the triggerBaseType complex type.

Requirements

Requirement Value
Minimum supported client
 Windows Vista [desktop apps only]
Minimum supported server
 Windows Server 2008 [desktop apps only]

See also

Task Scheduler Schema Complex Types

Task Scheduler