Win32_ScheduledJob 類別
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 |
|
| DLL |
|
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應