WeeklyTrigger 개체

주간 일정에 따라 작업을 시작하는 트리거를 나타내는 스크립팅 개체입니다. 예를 들어 작업은 매주 또는 격주로 특정 요일에 오전 8시에 시작됩니다.

멤버

WeeklyTrigger 개체에는 다음과 같은 유형의 멤버가 있습니다.

• 속성

속성

WeeklyTrigger 개체에는 이러한 속성이 있습니다.

속성	액세스 유형	설명
DaysOfWeek	읽기/쓰기	작업이 실행되는 요일을 가져오거나 설정합니다.
사용	읽기/쓰기	Trigger 개체에서 상속됩니다. 트리거를 사용할 수 있는지 여부를 나타내는 부울 값을 가져오거나 설정합니다.
EndBoundary	읽기/쓰기	Trigger 개체에서 상속됩니다. 트리거가 비활성화된 날짜와 시간을 가져오거나 설정합니다. 트리거는 비활성화된 후 작업을 시작할 수 없습니다.
ExecutionTimeLimit	읽기/쓰기	Trigger 개체에서 상속됩니다. 트리거에서 시작한 작업을 실행할 수 있는 최대 시간을 가져오거나 설정합니다.
자료	읽기/쓰기	Trigger 개체에서 상속됩니다. 트리거의 식별자를 가져오거나 설정합니다.
RandomDelay	읽기/쓰기	트리거의 시작 시간에 임의로 추가되는 지연 시간을 가져오거나 설정합니다.
반복	읽기/쓰기	Trigger 개체에서 상속됩니다. 작업이 실행되는 빈도와 작업이 시작된 후 반복 패턴이 반복되는 기간을 가져오거나 설정합니다.
StartBoundary	읽기/쓰기	Trigger 개체에서 상속됩니다. 트리거가 활성화된 날짜와 시간을 가져오거나 설정합니다.
Type	읽기 전용	Trigger 개체에서 상속됩니다. 트리거의 형식을 가져옵니다.
WeeksInterval	읽기/쓰기	일정의 주 간격을 가져오거나 설정합니다.

설명

작업이 시작되는 시간은 StartBoundary 속성에 의해 설정됩니다.

작업에 대한 고유한 XML을 읽거나 쓸 때 작업 스케줄러 스키마의 ScheduleByWeek 요소를 사용하여 주간 트리거를 지정합니다.

DST(일광 절약 시간)가 1년에 시작되는 날 태평양 표준 시간대(2022년 오전 02:00에서 오전 03:00로 변경됨)의 경우 오전 02:00~02:59:59:999 사이에 실행되도록 예약된 모든 작업은 해당 날짜에 존재하는 가장 빠른 시간(즉, 오전 03:00)에 실행됩니다. 이는 DST를 관찰하는 다양한 시간에 따라 모든 DST 표준 시간대에 적용됩니다.

다음 런타임이 2022년 3월 13일 오전 2시 30분이 되도록 태평양 표준 시간대에서 2022년 매주 일요일 오전 2시 30분에 실행되도록 설정된 주간 작업을 고려합니다. 오전 2시 30분은 2022년 3월 13일에 존재하지 않는 시간이므로 작업은 대신 오전 3시에 실행됩니다. 연중 다른 일요일에는 오전 2시 30분에 평소와 같이 작업이 실행됩니다.

예제

이 스크립팅 개체에 대한 자세한 내용과 코드 예제는 주간 트리거 예제(스크립팅)를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
유형 라이브러리	Taskschd.tlb
DLL	Taskschd.dll

추가 정보

트리거

TriggerCollection

TriggerCollection.Create