Win32_ScheduledJob クラス - WMI Library

Win32_ScheduledJob クラスの説明

Win32_ScheduledJob クラスは、ネットワーク管理スケジュール サービス機能 ("ジョブ" および "AT コマンド" 機能) を使用するスケジュールされたジョブを表します。これは、Windows 2000 タスク スケジューラを使ってスケジュールしたタスクと異なることに注意してください。このクラスは Windows NT 4.0 以降でのみ使用されます。スケジュール サービスに対してスケジュールされた各ジョブは、持続的に格納され (スケジューラにより再起動後もジョブの開始が認知されます)、週と月の指定された日時に実行されます。コンピューターが動作していないか、またはスケジュール サービスが指定されたジョブ時間に実行していない場合、スケジュール サービスにより指定された時間で次の日に指定されたジョブが実行されます。スケジュールされたジョブは、協定世界時 (UTC) に関連して、たとえば GMT からのずれオフセットでスケジュールされます。これは、タイム ゾーン仕様を使用してジョブを指定できることを意味します。Win32_ScheduledJob により、オブジェクトが列挙されるときに UTC オフセットでローカル タイムが返され、新しいジョブが作成されるときにローカル タイムに変換されます。たとえば、ボストンで太平洋標準時で月曜の午後 10:30 に実行するように指定されたジョブは、ローカルでは東部標準時で火曜の午前 1:30 に実行されるようにスケジュールされます。夏時間でローカル コンピューターを操作しているかどうかをクライアントは考慮する必要があることに注意し、操作している場合 UTC オフセットから 60 分のずれを引いてください。
WMI Providerは、CIMWin32です。
UUIDは、{8502C4E0-5FBB-11D2-AAC1-006008C78BC7}です。

---

プロパティ リスト

Caption

Data Type: string

Access Type: Read Only

Caption プロパティは、オブジェクトを短いテキスト (1 行の文字列) で表した説明です。

Command

Data Type: string

Access Type: Read Only

Command パラメーターには、スケジュール サービスがジョブを開始するために使用するコマンド、バッチ プログラム、またはバイナリ ファイルの名前がコマンド ラインの引数と共に含まれています。
例: defrag /q /f

DaysOfMonth

Data Type: uint32

Access Type: Read Only

DaysOfMonth パラメーターは、ジョブの実行がスケジュールされている月の日を示します。

DaysOfWeek

Data Type: uint32

Access Type: Read Only

DaysOfWeek パラメーターは、ジョブの実行がスケジュールされている曜日を示します。

Description

Data Type: string

Access Type: Read Only

Description プロパティは、オブジェクトの説明を提供します。

ElapsedTime

Data Type: datetime

Access Type: Read Only

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

InstallDate

Data Type: datetime

Access Type: Read Only

InstallDate プロパティは、オブジェクトがいつインストールされたかを示す datetime 値です。値がなくても、オブジェクトがインストールされていないことを示すわけではありません。

InteractWithDesktop

Data Type: boolean

Access Type: Read Only

InteractWithDesktop プロパティにより、指定されたジョブを対話型にすることできます。対話型というのは、ユーザーがスケジュールされたジョブの実行中にこのジョブに対して入力処理を行うことができることを意味します。
値は、TRUE または FALSE です。TRUE の場合、ジョブは対話型になります。FALSE の場合、ジョブはインタラクティブでなくなります。

JobId

Data Type: uint32

Access Type: Read Only

JobId プロパティは、ジョブの識別子番号を表します。このコンピューターでスケジュールされている単一のジョブのハンドルとしてメソッドによって使用されます。

JobStatus

Data Type: string

Access Type: Read Only

JobStatus プロパティは、このジョブが前回、実行されることになっていたときに、スケジュールされたサービスが正常に実行されたかどうかを示します。

Name

Data Type: string

Access Type: Read Only

Name プロパティは、オブジェクトを認識するためのラベルを定義します。サブクラスでは、Name プロパティは上書きされて Key プロパティになることがあります。

Notify

Data Type: string

Access Type: Read Only

ジョブの完了または失敗が通知されるユーザーです

Owner

Data Type: string

Access Type: Read Only

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

Priority

Data Type: uint32

Access Type: Read Only

優先順位は、ジョブ実行の緊急性または重要性を示します。

RunRepeatedly

Data Type: boolean

Access Type: Read Only

RunRepeatedly プロパティは、スケジュールされたジョブがスケジュールされた日に繰り返し実行される必要があるかどうかを示します。
値: TRUE または FALSE です。TRUE の場合、ジョブは繰り返し実行されます。FALSE の場合、ジョブは一度実行されます。

StartTime

Data Type: datetime

Access Type: Read Only

StartTime プロパティは、ジョブを実行する UTC 時間を YYYYMMDDHHMMSS.MMMMMM(+-)OOO の形式で表され、YYYYMMDD は ******** で置き換わる必要があります。スケジュールされているサービスにより実行できるジョブは月に一日、週に一日、または一度だけ実行のみに構成されるので、置き換えが必要です。ジョブは特定の日付では実行されません。
例: ********123000.000000-420 は夏時間が有効になっているときの 12:30 pm PST を示します。

Status

Data Type: string

Access Type: Read Only

Status プロパティはオブジェクトの現在の状態を示す文字列です。操作可能な状態および操作不可能な状態が定義されます。操作可能な状態は、"OK"、"低下" および "障害が発生する可能性あり" です。"障害が発生する可能性あり" は、要素は適切に機能するけれども近いうちに障害が発生する可能性があることを示します。例: SMART 対応ハード ディスク。操作不可能な状態も指定できます。これは、"エラー"、"開始中"、"停止動作中" および "サービス" です。最後の "サービス" には、ディスクがミラーされている間、ユーザーのアクセス許可の一覧を再度読み込む間、または他の管理用作業が行われている間などが該当します。この作業がすべてオンラインで行われるとは限りませんが、[管理要素] は "OK" でも他の状態でもありません。

TimeSubmitted

Data Type: datetime

Access Type: Read Only

ジョブを送信した時刻です。

UntilTime

Data Type: datetime

Access Type: Read Only

ジョブが無効または停止する時刻です。

---

メソッド リスト

Create

Create 関数は、ジョブを指定した今後の時刻で実行するようにオペレーティング システムに送信します。この関数は、スケジュール サービスがジョブを送信するコンピューターで開始することを必要とします。メソッドは次のように変換される整数値を返します:
0 - 正常に完了しました。
1 - サポートされていません。
2 - アクセスが拒否されました。
8 - 不明なエラーです。
9 - パスが見つかりません。
21 - パラメーターが無効です。
22 - サービスは開始していません。
その他 - 上の一覧以外の整数値については Win32 エラー コードのドキュメントを参照してください。

Delete

Delete メソッドはスケジュールされたジョブを削除します。メソッドは次のように変換される整数値を返します:
0 - 正常に完了しました。
1 - サポートされていません。
2 - アクセスが拒否されました。
8 - 不明なエラーです。
9 - パスが見つかりません。
21 - パラメーターが無効です。
22 - サービスは開始していません。
その他 - 上の一覧以外の整数値については Win32 エラー コードのドキュメントを参照してください。

---

WQL サンプル

SELECT * FROM Win32_ScheduledJob

VB6/VBS
SWbemServicesクラスのExecQueryメソッドからWQLを実行可能です。
Set PrcSet = Service.ExecQuery("SELECT * FROM Win32_ScheduledJob")

VB.Net
ObjectQueryクラスのQueryStringプロパティにWQLを設定し、ManagementObjectSearcherクラスのGetメソッドからWQLを実行可能です。
Searcher.Query.QueryString = "SELECT * FROM Win32_ScheduledJob"
PrcSrc = Searcher.Get

PowerShell
Get-WmiObjectコマンドレットのqueryオプションを指定しWQLを実行可能です。
Get-WmiObject -query "SELECT * FROM Win32_ScheduledJob"

---

このサイトの情報について

このコンテンツはWMIの各コンポーネントが持っているWin32_ScheduledJobクラス情報を参照・抽出しリファレンスとして作成・提供しています。
参照したWMIの名前空間はroot/CIMV2、書き出し環境はWindows Server 2008 R2になります。

WMIの使い方(VB6, VBS, VBA, VB.NET, VC#, PowerShellを対象)に関してはWMI Stepも参考にしてみてください。(WMI初心者・入門編としてもおすすめです。) 各種言語を使用したWMIを使用するたたき台としてソーステンプレートも公開しています。プログラム/スクリプト作成時に役立てば…と思っています。

今後各WMI ClassをサポートしているOSの種類を掲載する予定です。
予定OS: Windows XP/Windows Vista/Windows 7/Windows Server 2003/Windows Server 2003 R2/Windows Server 2008/Windows Server 2008 R2

---