Win32_ScheduledJob クラスの Create メソッド
CREATEWMI クラス メソッドは、将来の指定した日時に実行するためにジョブをオペレーティング システムに送信します。 この方法では、ジョブの送信先のコンピューターでスケジュール サービスを開始する必要があります。
このトピックでは、マネージド オブジェクト形式 (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
);
パラメーター
-
コマンド [入力]
-
スケジュール サービスがジョブの呼び出しに使用するコマンド、バッチ プログラム、またはバイナリ ファイルおよびコマンド ライン パラメーターの名前。
例: "defrag /q /f"
-
StartTime [in]
-
ジョブを実行するための協定世界時 (UTC) 時刻。 形式は"YYYYMMDDHHMMSS" である必要があります。MMMMMM(+-)OOO"。ここで、"YYYYMMDD" は "**********" に置き換える必要があります。 たとえば、"**********143000.000000-420" は 14.30 (午後 2:30) を指定します。夏時間が有効な PST。
StartTime プロパティ値の "(+-)OOO" セクションは、ローカル時刻変換の現在のバイアスです。 バイアスとは、UTC 時刻と現地時刻の差です。 タイム ゾーンの偏りを計算するには、タイム ゾーンがグリニッジ標準時 (GMT) より前または背後にある時間数に 60 を掛けます (タイム ゾーンが GMT より前の場合は正の数を、GMT より後ろにある場合は負の数を使用します)。 タイム ゾーンで夏時間が使用されている場合は、計算にさらに 60 を追加します。 たとえば、太平洋標準時ゾーンは GMT より 8 時間遅れているため、夏時間が使用されている場合は -420 (-8 * 60 + 60) に、夏時間が使用されていない場合は -480 (-8 * 60) になります。 また、 Win32_TimeZone クラスの bias プロパティに対してクエリを実行して、バイアスの値を確認することもできます。
-
RunRepeatedly [in, optional]
-
True の場合、スケジュールされたジョブは特定の日に繰り返し実行されます。 既定値は Falseです。
-
DaysOfWeek [in, optional]
-
ジョブの実行がスケジュールされている曜日。 RunRepeatedly パラメーターが True の場合にのみ使用されます。 ジョブを週の 1 日以上スケジュールするには、適切な値を論理 OR に結合します。 たとえば、火曜日と金曜日のジョブをスケジュールするには、 DaysOfWeek の値は 2 または 16 です。
-
月曜日 (1)
-
火曜日 (2)
-
水曜日 (4)
-
木曜日 (8)
-
金曜日 (16)
-
土曜日 (32)
-
日曜日 (64)
DaysOfMonth [in, optional]
ジョブの実行がスケジュールされている月の日数。 RunRepeatedly パラメーターが True の場合にのみ使用されます。
1 (1)
1 か月の 1 日目
2 (2)
1 か月の 2 日目
3 (4)
月の 3 日目
4 (8)
1 か月の 4 日目
5 (16)
月の 5 日目
6 (32)
1 か月の 6 日目
7 (64)
月の 7 日目
8 (128)
1 か月の 8 日目
9 (256)
1 か月の 9 日目
10 (512)
月の 10 日
11 (1024)
1 か月の 11 日
12 (2048)
1 か月の 12 日
13 (4096)
1 か月の 13 日目
14 (8192)
月の 14 日
15 (16384)
月の 15 日
16 (32768)
月の 16 日
17 (65536)
月の 17 日
18 (131072)
月の 18 日
19 (262144)
1 か月の 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] |
|