Win32_ScheduledJob 클래스

아티클
06/12/2023

Win32_ScheduledJobWMI 클래스는 AT 명령을 사용하여 만든 작업을 나타냅니다.

참고

Win32_ScheduledJob 클래스는 제어판 예약된 작업 마법사를 사용하여 만든 작업을 나타내지 않습니다. 예약된 작업 UI에서는 WMI에서 만든 작업을 변경할 수 없습니다. 자세한 내용은 주의 섹션을 참조하세요.

다음 구문은 MOF(Managed Object Format) 코드를 단순화한 것으로 상속된 속성이 모두 포함되어 있습니다. 속성 및 메서드는 MOF 순서가 아닌 알파벳순입니다.

구문

[Dynamic, Provider("CIMWin32"), UUID("{8502C4E0-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("Delete"), AMENDMENT]
class Win32_ScheduledJob : CIM_Job
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  datetime ElapsedTime;
  string   Notify;
  string   Owner;
  uint32   Priority;
  datetime TimeSubmitted;
  datetime UntilTime;
  string   Command;
  uint32   DaysOfMonth;
  uint32   DaysOfWeek;
  boolean  InteractWithDesktop;
  uint32   JobId;
  string   JobStatus;
  boolean  RunRepeatedly;
  datetime StartTime;
};

멤버

Win32_ScheduledJob 클래스에는 다음과 같은 유형의 멤버가 있습니다.

메서드
속성

메서드

Win32_ScheduledJob 클래스에는 이러한 메서드가 있습니다.

메서드	Description
생성	지정된 미래 시간과 날짜에 실행을 위해 작업을 운영 체제에 제출하는 클래스 메서드입니다.
삭제	예약된 작업을 삭제하는 클래스 메서드입니다.

속성

Win32_ScheduledJob 클래스에는 이러한 속성이 있습니다.

캡션

데이터 형식: string
액세스 형식: 읽기 전용
한정자: MaxLen (64), DisplayName ("Caption")

개체에 대한 간단한 텍스트 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

명령

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| 네트워크 관리 구조| | AT_INFO Command")

일정 서비스에서 작업을 호출하는 데 사용하는 명령, 일괄 처리 프로그램 또는 이진 파일(및 명령줄 인수)의 이름입니다.

예: "defrag/q/f"

DaysOfMonth

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| 네트워크 관리 구조| | AT_INFO DaysOfMonth")

작업이 실행되도록 예약된 월의 일입니다. 작업이 월의 여러 날에 실행되도록 예약된 경우 이러한 값을 논리적 OR에 조인할 수 있습니다. 예를 들어 작업이 매월 1일과 16일에 실행되는 경우 DaysOfMonth 속성의 값은 1 또는 32768입니다.

1 (1)

1st

2 (2)

2위

3 (4)

3번째

4 (8)

4번째

5 (16)

5번째

6 (32)

6번째

7 (64)

7번째

8 (128)

8번째

9 (256)

9번째

10 (512)

10일

11 (1024)

11일

12 (2048년)

12일

13 (4096)

13일

14 (8192)

14일

15 (16384)

15일

16 (32768)

16일

17 (65536)

17일

18 (131072)

18일

19 (262144)

19일

20 (524288)

20일

21 (1048576)

21일

22 (2097152)

22일

23 (4194304)

23일

24 (8388608)

24일

25 (16777216)

25일

26 (33554432)

26일

27 (67108864)

27일

28 (134217728)

28일

29 (268435456)

29일

30 (536870912)

30일

31 (1073741824)

31일

DaysOfWeek

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| 네트워크 관리 구조| | AT_INFO DaysOfWeek")

작업이 실행되도록 예약된 요일입니다. 작업이 요일의 여러 날에 실행되도록 예약된 경우 값을 논리적 OR에 조인할 수 있습니다. 예를 들어 작업이 월요일, 수요일 및 금요일에 실행되도록 예약된 경우 DaysOfWeek 속성의 값은 1 또는 4 또는 16이 됩니다.

월요일 (1)

화요일 (2)

수요일 (4)

목요일 (8)

금요일 (16)

토요일 (32)

일요일 (64)

설명

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("Description")

개체에 대한 텍스트 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

ElapsedTime

데이터 형식: datetime
액세스 형식: 읽기 전용

작업이 실행되고 있는 시간입니다.

이 속성은 CIM_Job 상속됩니다.

InstallDate

데이터 형식: datetime
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("설치 날짜")

개체가 설치된 시기를 나타냅니다. 값이 부족해도 개체가 설치되지 않았음을 의미하지는 않습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

InteractWithDesktop

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| 네트워크 관리 구조| | AT_INFO 플래그|JOB_NONINTERACTIVE")

지정된 작업은 대화형입니다. 즉, 사용자가 실행 중인 동안 예약된 작업에 입력을 제공할 수 있습니다.

JobId

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 키, MappingStrings("Win32API| 네트워크 관리 구조| | AT_ENUM JobId")

작업 수를 식별합니다. 메서드는 이 컴퓨터에서 예약되는 하나의 작업에 대한 핸들로 사용됩니다.

JobStatus

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 재정의("JobStatus"), MappingStrings("Win32API| 네트워크 관리 구조| | AT_ENUM 플래그|JOB_EXEC_ERROR")

이 작업이 마지막으로 실행되도록 예약된 실행 상태입니다.

성공 ("성공")

실패 ("실패")

이름

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("Name")

개체가 알려진 레이블입니다. 서브클래스를 사용하면 이 속성을 키 속성으로 재정의할 수 있습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

알림

데이터 형식: 문자열
액세스 형식: 읽기 전용

작업 완료 또는 실패 시 사용자에게 알림이 표시됩니다.

이 속성은 CIM_Job 상속됩니다.

소유자

데이터 형식: 문자열
액세스 형식: 읽기 전용

작업을 제출한 사용자입니다.

이 속성은 CIM_Job 상속됩니다.

우선 순위

데이터 형식: uint32
액세스 형식: 읽기 전용

작업 실행의 중요도입니다.

이 속성은 CIM_Job 상속됩니다.

RunRepeatedly

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: MappingStrings("Win32API| 네트워크 관리 구조| | AT_INFO 플래그|JOB_RUN_PERIODICALLY")

예약된 작업은 작업이 예약된 날에 반복적으로 실행됩니다. False이면 작업이 한 번 실행됩니다.

StartTime

데이터 형식: datetime
액세스 형식: 읽기 전용
한정자: 재정의("StartTime"), MappingStrings("Win32API| 네트워크 관리 구조| | AT_ENUM JobTime")

"YYYYMMDDHHMMSS 형식으로 작업을 실행하는 UTC 시간입니다. MMMMMM(+-)OOO". 여기서 "YYYYMMDD"를 "********"로 바꿔야 합니다. 예약 서비스는 작업을 한 번만 실행하도록 구성하거나 월 또는 요일에 실행하도록 허용하기 때문에 교체가 필요합니다. 특정 날짜에 작업을 실행할 수 없습니다.

StartTime 속성 값의 "(+-)OOO" 섹션은 현지 시간 변환에 대한 현재 바이어스입니다. 바이어스는 UTC 시간과 현지 시간의 차이입니다. 표준 시간대에 대한 편차를 계산하려면 표준 시간대가 GMT(그리니치 표준시)보다 앞서거나 뒤쳐지는 시간에 60을 곱합니다(표준 시간대가 GMT보다 앞선 경우 시간 수에 양수, 표준 시간대가 GMT보다 뒤쳐지는 경우 음수 사용). 표준 시간대에서 일광 절약 시간을 사용하는 경우 계산에 60을 더 추가합니다. 예를 들어 태평양 표준 시간대는 GMT에 8시간 뒤이므로 일광 절약 시간을 사용 중인 경우 -420(-8 * 60 + 60)이고, 일광 절약 시간을 사용하지 않는 경우 -480(-8 * 60)이 됩니다. Win32_TimeZone 클래스의 bias 속성을 쿼리하여 편차 값을 확인할 수도 있습니다.

예: "********123000.000000-420"은 14.30(오후 2:30)을 지정합니다. 일광 절약 시간이 적용되는 PST입니다.

상태

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MaxLen (10), DisplayName ("상태")

개체의 현재 상태 나타내는 문자열입니다. 운영 및 비운용 상태 정의할 수 있습니다. 운영 상태 "OK", "Degraded" 및 "Pred Fail"을 포함할 수 있습니다. "Pred Fail"은 요소가 제대로 작동하지만 오류를 예측하고 있음을 나타냅니다(예: SMART 지원 하드 디스크 드라이브).

비작동 상태 "오류", "시작 중", "중지" 및 "서비스"를 포함할 수 있습니다. 디스크 미러 다시 실행, 사용자 권한 목록 다시 로드 또는 기타 관리 작업 중에 "서비스"를 적용할 수 있습니다. 이러한 모든 작업이 온라인 상태인 것은 아니지만 관리되는 요소는 "OK"도 아니고 다른 상태 중 하나에 있지도 않습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

여기에는 다음 값이 포함됩니다.

OK ("OK")

오류 ("오류")

성능 저하됨 ("Degraded")

알 수 없음 ("알 수 없음")

사전 실패 ("사전 실패")

시작 중("시작")

중지 ("중지")

서비스 ("서비스")

스트레스( "스트레스")

NonRecover ("NonRecover")

연락처 없음 ("연락처 없음")

Lost Comm ("Lost Comm")

TimeSubmitted

데이터 형식: datetime
액세스 형식: 읽기 전용

작업이 제출된 시간입니다.

이 속성은 CIM_Job 상속됩니다.

UntilTime

데이터 형식: datetime
액세스 형식: 읽기 전용

작업이 잘못되었거나 중지되어야 하는 시간입니다.

이 속성은 CIM_Job 상속됩니다.

설명

일정 서비스에 대해 예약된 각 작업은 영구적으로 저장되며(스케줄러는 다시 부팅 후 작업을 시작할 수 있음) 지정된 요일 또는 월의 시간 및 일에 실행됩니다. 컴퓨터가 활성 상태가 아니거나 예약된 서비스가 지정된 작업 시간에 실행되고 있지 않으면 일정 서비스는 지정된 시간에 다음 날에 지정된 작업을 실행합니다.

작업은 GMT(그리니치 표준시)의 바이어스 오프셋이 있는 UTC(협정 세계시)에 따라 예약됩니다. 즉, 모든 표준 시간대를 사용하여 작업을 지정할 수 있습니다. Win32_ScheduledJob 클래스는 개체를 열거할 때 UTC 오프셋을 사용하여 현지 시간을 반환하고 새 작업을 만들 때 현지 시간으로 변환합니다. 예를 들어 월요일 오후 10시 30분에 보스턴의 컴퓨터에서 실행되도록 지정된 작업은 화요일 오전 1시 30분에 로컬로 실행되도록 예약됩니다.

참고

클라이언트는 일광 절약 시간이 로컬 컴퓨터에서 작동하는지 여부를 고려해야 하며, 이 경우 UTC 오프셋에서 60분의 바이어스 값을 뺍니다.

Win32_ScheduledJob 클래스는 CIM_Job 파생됩니다. 이 클래스를 사용하여 예약된 작업을 만들려면 관리자 그룹의 구성원이어야 합니다.

Win32_ScheduledJob 클래스는 Windows 8 및 Windows Server 2012 시작하여 사용 중단될 수밖에 없는 AT 프로토콜을 내부적으로 사용합니다. 첫 번째 단계로 AT 프로토콜은 기본적으로 사용하지 않도록 설정됩니다. 프로토콜을 사용하지 않도록 설정하면 예를 들어 Win32_ScheduledJob 개체에서 Create 메서드를 호출하면 오류 0x8 실패합니다. 다음 레지스트리 항목을 추가하여 AT 프로토콜을 다시 설정할 수 있습니다.

Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Schedule\Configuration 
Name: EnableAt 
Type: REG_DWORD
Value: 1

설정을 적용하려면 컴퓨터를 다시 시작해야 할 수 있습니다.

Win32_ScheduledJobNetScheduleJobGetInfo Win32 API를 기반으로 하므로 이 클래스를 작업 스케줄러와 함께 사용할 수 없습니다. 작업 스케줄러를 사용하려면 작업 스케줄러 API를 사용합니다. 자세한 내용은 작업 스케줄러 참조를 참조하세요.

예제

다음 VBScript 코드 예제에서는 매주 수요일 로컬 컴퓨터 시간으로 1:25에 대화형으로 실행되도록 Notepad.exe 예약합니다.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\Root\CIMv2")
Set objNewJob = objWMIService.Get("Win32_ScheduledJob")
errJobCreated = objNewJob.Create("Notepad.exe", "********012500.000000-420", True , 4, , True, JobId) 
If errJobCreated <> 0 Then
Wscript.Echo "Error on task creation"
Else
Wscript.Echo "Task created"
End If

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
네임스페이스	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

추가 정보

CIM_Job
운영 체제 클래스
WMI 작업: 예약된 작업

다음을 통해 공유

Win32_ScheduledJob 클래스

구문

멤버

메서드

속성

설명

예제

요구 사항

추가 정보

피드백

추가 리소스