Win32_ScheduledJob 類別

發行項
06/12/2023

Win32_ScheduledJobWMI 類別代表使用AT命令建立的作業。

注意

Win32_ScheduledJob類別不代表從主控台使用 [排程的工作精靈] 建立的作業。您無法在 [排程的工作] UI 中變更 WMI 所建立的工作。如需詳細資訊，請參閱＜備註＞一節。

下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。屬性和方法依字母順序排列，而非 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類別具有這些屬性。

標題

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (64) 、 DisplayName (「Caption」)

物件的簡短文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

命令

資料類型：字串
存取類型：唯讀
限定詞：MappingStrings (「Win32API|網路管理結構 || AT_INFO命令「)

排程服務用來叫用作業的命令、批次程式或二進位檔案的名稱 (和命令列引數) 。

範例：「defrag/q/f」

DaysOfMonth

資料類型： uint32
存取類型：唯讀
限定詞：MappingStrings (「Win32API|網路管理結構 || AT_INFODaysOfMonth「)

排定執行作業的月份天數。如果作業排定在當月的多天執行，這些值可以在邏輯 OR 中聯結。例如，如果作業是在每個月的第 1 和 16 日執行， DaysOfMonth 屬性的值會是 1 OR 32768。

1 (1)

第一

2 (2)

第二

3 (4)

第三

4 (8)

第四

5 (16)

第 5 個

6 (32)

第 6 個

7 (64)

第 7 個

8 (128)

第 8 個

9 (256)

第 9 個

10 (512)

第 10 個

11 (1024)

11th

12 (2048)

12th

13 (4096)

13th

14 (8192)

第 14 天

15 (16384)

第 15 天

16 (32768)

第 16 天

17 (65536)

第 17 天

18 (131072)

第 18 天

19 (262144)

第 19 日

20 (524288)

第 20 天

21 (1048576)

21st

22 (2097152)

22nd

23 (4194304)

23rd

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_INFODaysOfWeek「)

排程執行作業的一周天數。如果工作排定在一周的幾天內執行，這些值可以聯結在邏輯 OR 中。例如，如果工作排定在星期一、星期三和星期五執行， DaysOfWeek 屬性的值會是 1 OR 4 OR 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 (」Install Date「)

指出何時安裝物件。缺少值並不表示未安裝物件。

此屬性繼承自 CIM_ManagedSystemElement。

InteractWithDesktop

資料類型： 布林值
存取類型：唯讀
限定詞：MappingStrings (「Win32API|網路管理結構 || AT_INFO標誌|JOB_NONINTERACTIVE「)

指定的作業是互動式的，這表示使用者可以在執行時提供排程工作的輸入。

JobId

資料類型： uint32
存取類型：唯讀
限定詞：Key、MappingStrings (「Win32API|網路管理結構 || AT_ENUMJobId「)

識別作業的數目。方法會使用它做為此電腦上排程之一個工作的控制碼。

JobStatus

資料類型：字串
存取類型：唯讀
限定詞：覆寫 (「JobStatus」) ，MappingStrings (「Win32API|網路管理結構 || AT_ENUM標誌|JOB_EXEC_ERROR「)

上次排程執行此作業時執行的狀態。

成功 (「成功」)

失敗 (「失敗」)

名稱

資料類型：字串
存取類型：唯讀
限定詞： DisplayName (「Name」)

已知物件的標籤。子類別化時，這個屬性可以覆寫為索引鍵屬性。

此屬性繼承自 CIM_ManagedSystemElement。

通知

資料類型：字串
存取類型：唯讀

使用者會在作業完成或失敗時收到通知。

此屬性繼承自 CIM_Job。

擁有者

資料類型：字串
存取類型：唯讀

提交作業的使用者。

此屬性繼承自 CIM_Job。

優先順序

資料類型： uint32
存取類型：唯讀

作業執行的重要性。

此屬性繼承自 CIM_Job。

RunRepeatedly

資料類型： 布林值
存取類型：唯讀
限定詞：MappingStrings (「Win32API|網路管理結構 || AT_INFO標誌|JOB_RUN_PERIODICALLY「)

排程的作業會在排程作業的天數重複執行。如果 為 False，則作業會執行一次。

StartTime

資料類型： datetime
存取類型：唯讀
限定詞：覆寫 (「StartTime」) ，MappingStrings (「Win32API|網路管理結構 || AT_ENUMJobTime「)

執行作業的 UTC 時間，格式為「YYYYMMDDHHMMSS」。MMMMMM (+-) OOO「，其中」YYYYMMDD「必須取代為」**≧」。需要取代，因為排程服務只允許將作業設定為執行一次，或是在月份或一周的一天執行。作業無法在特定日期執行。

StartTime屬性值的「 (+-) OOO」區段是當地時間翻譯的目前偏差。偏差是 UTC 時間與當地時間之間的差異。若要計算時區的偏差，請將時區前面或位於 Greenwich Mean Time (GMT) 後方的小時數乘以 60 (如果您的時區早于 GMT 時數，則會使用正數作為時數，如果您的時區位於 GMT) 後，則為負數。如果您的時區使用日光節約時間，請將額外的 60 新增至計算。例如，太平洋標準時區在 GMT 後 8 小時，因此當日光節約時間未使用時，偏差等於 -420 (-8 * 60 + 60) ，而 -480 (-8 * 60) 。您也可以藉由查詢 Win32_TimeZone 類別的偏差屬性來判斷偏差的值。

例如：「**≧123000.000000-420」指定 14.30 () 下午 2：30 PST，並具有日光節約時間生效。

狀態

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (10) 、 DisplayName (「Status」)

表示物件目前狀態的字串。您可以定義作業和非操作狀態。作業狀態可以包括「OK」、「已降級」和「Pred Fail」。「預先失敗」表示元素正常運作，但正在預測失敗 (例如，已啟用 SMART 的硬碟) 。

非操作狀態可以包含「錯誤」、「啟動」、「停止」和「服務」。「服務」可以在磁片鏡像重新儲存期間套用、重載使用者許可權清單或其他系統管理工作。並非所有這類工作都處於線上狀態，但 Managed 元素不是「確定」，也不是在其他其中一種狀態。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

確定 (「確定」)

錯誤 (「錯誤」)

降級 (「降級」)

未知 (「未知」)

Pred Fail (「預先失敗」)

starting (「Starting」)

停止 (「停止」)

服務 (「Service」)

壓力 (「壓力」)

NonRecover (「NonRecover」)

無連絡人 (「無連絡人」)

Lost Comm (「Lost Comm」)

TimeSubmitted

資料類型： datetime
存取類型：唯讀

提交作業的時間。

此屬性繼承自 CIM_Job。

UntilTime

資料類型： datetime
存取類型：唯讀

作業無效或應該停止的時間。

此屬性繼承自 CIM_Job。

備註

針對排程服務排程的每個作業會持續儲存， (排程器可以在重新開機) 之後啟動作業，並在一周或月份的指定時間和日期執行。如果電腦沒有作用中，或排程服務未在指定的作業時間執行，則排程服務會在下一天于指定時間執行指定的作業。

作業會根據國際標準時間 (UTC) (排程，其偏差位移自 Greenwich Mean Time (GMT) ，這表示可以使用任何時區來指定作業。 Win32_ScheduledJob類別會在列舉物件時傳回具有 UTC 位移的當地時間，並在建立新作業時轉換為當地時間。例如，指定在波士頓的電腦上執行的工作會在下午 10：30 PST 時間排程在本機 1：30 上午 EST 執行。

注意

用戶端必須考慮日光節約時間是否在本機電腦上運作，如果是，則從 UTC 位移減 60 分鐘的偏差。

Win32_ScheduledJob類別衍生自CIM_Job。您必須是系統管理員群組的成員，才能使用此類別建立排程工作。

Win32_ScheduledJob類別是在內部使用 AT 通訊協定，其系結至從 Windows 8 和 Windows Server 2012 開始的淘汰。根據預設，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_ScheduledJob 是以 NetScheduleJobGetInfo WIN32 API 為基礎，所以您無法搭配工作排程器使用此類別。如果您想要使用工作排程器，請使用工作排程器 API。如需詳細資訊，請參閱工作排程器參考。

範例

下列 VBScript 程式碼範例會排程Notepad.exe在每星期三的本機電腦時間以互動方式在 1：25 執行。

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 類別

語法

成員

方法

屬性

備註

範例

規格需求

另請參閱

意見反應

其他資源