次の方法で共有


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
CIMWin32.mof
[DLL]
CIMWin32.dll

こちらもご覧ください

オペレーティング システム クラス

Win32_ScheduledJob