Win32_ScheduledJob 類別的 Create 方法
CreateWMI 類別方法會將作業提交至作業系統，以便在未來的指定時間和日期執行。 這個方法需要在提交作業的電腦上啟動排程服務。
本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫方法。
語法
uint32 Create(
[in] string Command,
[in] datetime StartTime,
[in, optional] boolean RunRepeatedly,
[in, optional] uint32 DaysOfWeek,
[in, optional] uint32 DaysOfMonth,
[in, optional] boolean InteractWithDesktop,
[out] uint32 JobId
);
參數
-
命令 [in]
-
排程服務用來叫用作業的命令、批次程式或二進位檔案和命令列參數的名稱。
範例：「defrag /q /f」。
-
StartTime [in]
-
國際標準時間 (UTC) 執行作業的時間。 表單必須是：「YYYYMMDDHHMMSS。MMMMMM (+-) OOO「，其中 」YYYYYMMDD「 必須取代為 」**\*\」。 例如：「**≧143000.000000-420」 指定了 14.30 (下午 2：30，) PST，且日光節約時間有效。
StartTime 屬性值的 「 (+-) OOO」 區段是當地時間轉譯目前的偏差。 偏差是 UTC 時間與當地時間之間的差異。 若要計算時區的偏差，請將時區前方或 Greenwich Mean Time (GMT) 的小時數乘以 60 (如果您的時區早于 GMT，則為時區早于 GMT 時數使用正數，如果時區位於 GMT) ，則為負數。 如果您的時區使用日光節約時間，請將額外的 60 新增至計算。 例如，太平洋標準時區在 GMT 後 8 小時，因此當日光節約時間未使用時，偏差等於 -420 (-8 * 60 + 60) ，而 -480 (-8 * 60) 。 您也可以查詢 Win32_TimeZone 類別的 bias 屬性來判斷偏差的值。
-
RunRepeatedly [in， 選擇性]
-
如果 為 True，則排程工作在特定日期重複執行。 預設值為 False。
-
DaysOfWeek [in， optional]
-
排定執行作業的星期幾;只有在 RunRepeatedly 參數為 True時才使用。 若要排程一周中的一天以上的作業，請在邏輯 OR 中聯結適當的值。 例如，若要排程星期二和星期五的工作， DaysOfWeek 的值是 2 OR 16。
-
星期一 (1)
-
星期二 (2)
-
星期三 (4)
-
星期四 (8)
-
星期五 (16)
-
星期六 (32)
-
星期日 (64)
DaysOfMonth [in， optional]
排定執行作業的當月天數;只有在 RunRepeatedly 參數為 True時才使用。
1 (1)
一個月中的第 1 天
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 天
InteractWithDesktop [in， optional]
如果 為 True，則指定的作業應該是互動式的，這表示使用者可以在執行作業時提供排程工作的輸入。 預設值為 False。
JobId [out]
作業的識別碼。 此參數是電腦上排程之作業的控制碼。
傳回值
當成功時，傳回 0 (零) 的值，並傳回不同的數位來表示錯誤。 如需其他錯誤碼，請參閱 WMI 錯誤常數 或 WbemErrorEnum。 如需一般 HRESULT 值，請參閱 系統錯誤碼。
-
成功完成
-
0
已接受要求。
-
不支援
-
1
不支援此要求。
-
拒絕存取
-
2
使用者沒有必要的存取權。
-
未知的失敗
-
8
互動式程式。
-
找不到路徑
-
9
找不到服務可執行檔的目錄路徑。
-
參數不正確
-
21
不正確參數已傳遞至服務。
-
服務未啟動
-
22
此服務執行所在的帳戶無效，或缺少執行服務的許可權。
-
其他
-
23 4294967295
備註
如果您的排程工作啟動互動式程式，例如 [記事本]，則 InteractWithDeskto 屬性必須設定為 True ，否則看不到程式的畫面。 即使進程未出現在畫面上，程式仍會出現在 工作管理員 中。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|