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 クラスには、これらのメソッドがあります。

メソッド	説明
作成	指定した将来の日時に実行するためにジョブをオペレーティング システムに送信するクラス メソッド。
削除	スケジュールされたジョブを削除するクラス メソッド。

 

プロパティ

Win32_ScheduledJob クラスには、これらのプロパティがあります。

Caption

データ型: string

アクセスの種類: 読み取り専用

修飾子: MaxLen (64)、 DisplayName ("Caption")

オブジェクトの短いテキストの説明。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

コマンド

データ型: string

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|ネットワーク管理構造|| AT_INFOCommand")

スケジュール サービスがジョブの呼び出しに使用するコマンド、バッチ プログラム、またはバイナリ ファイル (およびコマンド ライン引数) の名前。

例: "defrag/q/f"

DaysOfMonth

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|ネットワーク管理構造|| AT_INFODaysOfMonth")

ジョブの実行がスケジュールされている月の日数。 ジョブが月の複数の日に実行されるようにスケジュールされている場合、これらの値は論理 OR で結合できます。 たとえば、ジョブを毎月 1 日と 16 日に実行する場合、 DaysOfMonth プロパティの値は 1 または 32768 になります。

1 (1)

1st

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 日

DaysOfWeek

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|ネットワーク管理構造|| AT_INFODaysOfWeek")

ジョブの実行がスケジュールされている曜日。 ジョブが週の複数の日に実行されるようにスケジュールされている場合、値は論理 OR で結合できます。 たとえば、ジョブが月曜日、水曜日、および金曜日に実行されるようにスケジュールされている場合、 DaysOfWeek プロパティの値は 1 OR 4 OR 16 になります。

月曜日 (1)

火曜日 (2)

水曜日 (4)

木曜日 (8)

金曜日 (16)

土曜日 (32)

日曜日 (64)

説明

データ型: string

アクセスの種類: 読み取り専用

修飾子: DisplayName ("Description")

オブジェクトのテキスト説明。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

ElapsedTime

データ型: datetime

アクセスの種類: 読み取り専用

ジョブが実行されている時間の長さ。

このプロパティは、 CIM_Jobから継承されます。

InstallDate

データ型: datetime

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")

オブジェクトがインストールされたタイミングを示します。 値がない場合、オブジェクトがインストールされていないことを示すわけではありません。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

InteractWithDesktop

データ型: boolean

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|ネットワーク管理構造|| AT_INFOフラグ|JOB_NONINTERACTIVE")

指定されたジョブは対話型です。つまり、ユーザーは実行中にスケジュールされたジョブに入力を渡すことができます。

JobId

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: Key、MappingStrings ("Win32API|ネットワーク管理構造|| AT_ENUMJobId")

ジョブの番号を識別します。 このコンピューターでスケジュールされている 1 つのジョブへのハンドルとしてメソッドによって使用されます。

JobStatus

データ型: string

アクセスの種類: 読み取り専用

修飾子: オーバーライド ("JobStatus")、MappingStrings ("Win32API|ネットワーク管理構造|| AT_ENUMフラグ|JOB_EXEC_ERROR")

このジョブが最後に実行されるようにスケジュールされた実行の状態。

成功 ("Success")

エラー ("Failure")

Name

データ型: string

アクセスの種類: 読み取り専用

修飾子: DisplayName ("Name")

オブジェクトが認識されるラベル。 サブクラス化すると、このプロパティをキー プロパティとしてオーバーライドできます。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

通知

データ型: string

アクセスの種類: 読み取り専用

ジョブの完了または失敗時にユーザーに通知されます。

このプロパティは、 CIM_Jobから継承されます。

所有者

データ型: string

アクセスの種類: 読み取り専用

ジョブを送信したユーザー。

このプロパティは、 CIM_Jobから継承されます。

優先順位

データ型: uint32

アクセスの種類: 読み取り専用

ジョブの実行の重要性。

このプロパティは、 CIM_Jobから継承されます。

RunRepeatedly

データ型: boolean

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|ネットワーク管理構造|| AT_INFOフラグ|JOB_RUN_PERIODICALLY")

スケジュールされたジョブは、ジョブがスケジュールされた日に繰り返し実行されます。 False の場合、ジョブは 1 回実行されます。

StartTime

データ型: datetime

アクセスの種類: 読み取り専用

修飾子: オーバーライド ("StartTime")、MappingStrings ("Win32API|ネットワーク管理構造|| AT_ENUMJobTime")

ジョブを実行する UTC 時刻 ("YYYYMMDDHHMMSS" の形式)。MMMMMM(+-)OOO"。ここで、"YYYYMMDD" は "********" に置き換える必要があります。 スケジュール サービスでは、ジョブを 1 回だけ実行するか、月または週の日に実行するように構成できるため、この置換が必要です。 特定の日付にジョブを実行することはできません。

StartTime プロパティ値の "(+-)OOO" セクションは、ローカル時刻変換の現在のバイアスです。 偏りは UTC 時刻と現地時刻の差です。 タイム ゾーンの偏りを計算するには、タイム ゾーンがグリニッジ標準時 (GMT) より前または後ろの時間数に 60 を乗算します (タイム ゾーンが GMT より前の場合は正の数を使用し、タイム ゾーンが GMT より後にある場合は負の数を使用します)。 タイム ゾーンで夏時間が使用されている場合は、計算にさらに 60 を追加します。 たとえば、太平洋標準時ゾーンは GMT より 8 時間遅れているため、夏時間が使用されている場合は -420 (-8 * 60 + 60) に、夏時間が使用されていない場合は -480 (-8 * 60) に等しくなります。 また、Win32_TimeZone クラスの bias プロパティに対してクエリを実行して、バイアスの値を確認することもできます。

たとえば、"********123000.000000-420" は 14.30 (午後 2:30) を指定します。夏時間が有効な PST。

状態

データ型: string

アクセスの種類: 読み取り専用

修飾子: MaxLen (10)、 DisplayName ("Status")

オブジェクトの現在の状態を示す文字列。 運用状態と非運用状態を定義できます。 操作状態には、"OK"、"低下"、"事前失敗" が含まれます。 "Pred Fail" は、要素が正しく機能しているが、エラー (SMART 対応ハード ディスク ドライブなど) を予測していることを示します。

非運用状態には、"エラー"、"開始中"、"停止中"、"サービス" が含まれる場合があります。 "サービス" は、ディスクのミラー、ユーザーのアクセス許可リストの再読み込み、またはその他の管理作業中に適用できます。 このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

次の値があります。

OK ("OK")

エラー ("Error")

機能低下 ("Degraded")

不明 ("不明")

Pred Fail ("Pred Fail")

開始 ("開始")

停止中 ("停止中")

サービス ("Service")

ストレス ( "ストレス")

NonRecover ("NonRecover")

連絡先なし ("連絡先なし")

Lost Comm ("Lost Comm")

TimeSubmitted

データ型: datetime

アクセスの種類: 読み取り専用

ジョブが送信された時刻。

このプロパティは、 CIM_Jobから継承されます。

UntilTime

データ型: datetime

アクセスの種類: 読み取り専用

ジョブが無効であるか、停止する必要がある時刻。

このプロパティは、 CIM_Jobから継承されます。

注釈

スケジュール サービスに対してスケジュールされた各ジョブは永続的に格納され (スケジューラは再起動後にジョブを開始できます)、指定した曜日または曜日に実行されます。 コンピューターがアクティブでない場合、またはスケジュールされたサービスが指定したジョブ時刻に実行されていない場合、スケジュール サービスは、指定した時刻の翌日に指定したジョブを実行します。

ジョブは、グリニッジ標準時 (GMT) からのバイアス オフセットを使用して協定世界時 (UTC) に従ってスケジュールされます。つまり、任意のタイム ゾーンを使用してジョブを指定できます。 Win32_ScheduledJob クラスは、オブジェクトを列挙するときに UTC オフセットを持つローカル時刻を返し、新しいジョブを作成するときにローカル時刻に変換します。 たとえば、月曜日の PST 時間の午後 10 時 30 分にボストンのコンピューターで実行するように指定されたジョブは、EST 火曜日の午前 1 時 30 分にローカルで実行されるようにスケジュールされます。

注意

クライアントは、ローカル コンピューターで夏時間が動作しているかどうかを考慮する必要があります。その場合は、UTC オフセットから 60 分のバイアスを減算する必要があります。

 

Win32_ScheduledJob クラスは、CIM_Jobから派生します。 このクラスを使用してスケジュールされたジョブを作成するには、administrators グループのメンバーである必要があります。

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 コード例では、毎週水曜日のローカル コンピューター時刻の 1:25 に対話形式で実行するようにNotepad.exeをスケジュールします。

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 タスク: スケジュールされたタスク