TaskSettings オブジェクト
タスク スケジューラ サービスがタスクの実行に使用する設定を提供するスクリプト オブジェクト。
メンバー
TaskSettings オブジェクトには、次の種類のメンバーがあります。
プロパティ
TaskSettings オブジェクトには、これらのプロパティがあります。
| プロパティ | アクセスの種類 | 説明 |
|---|---|---|
|
AllowDemandStart |
読み取り/書き込み |
[実行] コマンドまたは [コンテキスト] メニューを使用してタスクを開始できることを示すブール値を取得または設定します。 |
|
AllowHardTerminate |
読み取り/書き込み |
TerminateProcess を使用してタスクが終了する可能性があることを示すブール値を取得または設定します。 |
|
互換性 |
読み取り/書き込み |
タスクと互換性のあるタスク スケジューラのバージョンを示す整数値を取得または設定します。 |
|
DeleteExpiredTaskAfter |
読み取り/書き込み |
タスク スケジューラが期限切れ後にタスクを削除するまでに待機する時間を取得または設定します。 |
|
DisallowStartIfOnBatteries |
読み取り/書き込み |
コンピューターがバッテリ電源で実行されている場合にタスクが開始されないことを示すブール値を取得または設定します。 |
|
Enabled |
読み取り/書き込み |
タスクが有効になっていることを示すブール値を取得または設定します。 タスクは、この設定が True の場合にのみ実行できます。 |
|
ExecutionTimeLimit |
読み取り/書き込み |
タスクの完了に許可される時間を取得または設定します。 |
|
[非表示] |
読み取り/書き込み |
タスクが UI に表示されないことを示すブール値を取得または設定します。 ただし、管理者は、UI ですべてのタスクを表示する "マスター スイッチ" を使用して、この設定をオーバーライドできます。 |
|
IdleSettings |
読み取り/書き込み |
コンピューターがアイドル状態のときにタスク スケジューラがタスクを実行する方法を指定する情報を取得または設定します。 |
|
MultipleInstances |
読み取り/書き込み |
タスク スケジューラがタスクの複数のインスタンスを処理する方法を定義するポリシーを取得または設定します。 |
|
NetworkSettings |
読み取り/書き込み |
ネットワーク プロファイルの識別子と名前を含むネットワーク設定オブジェクトを取得または設定します。
TaskSettings の RunOnlyIfNetworkAvailable プロパティが True で、NetworkSettings プロパティにネットワーク propfile が指定されている場合、タスクは指定されたネットワーク プロファイルが使用可能な場合にのみ実行されます。 |
|
優先順位 |
読み取り/書き込み |
タスクの優先度レベルを取得または設定します。 |
|
RestartCount |
読み取り/書き込み |
タスク スケジューラがタスクの再起動を試行する回数を取得または設定します。 |
|
RestartInterval |
読み取り/書き込み |
タスク スケジューラがタスクの再起動を試みる時間を指定する値を取得または設定します。 |
|
RunOnlyIfIdle |
読み取り/書き込み |
コンピューターがアイドル状態の場合にのみタスク スケジューラがタスクを実行することを示すブール値を取得または設定します。 |
|
RunOnlyIfNetworkAvailable |
読み取り/書き込み |
ネットワークが使用可能な場合にのみタスク スケジューラがタスクを実行することを示すブール値を取得または設定します。 |
|
StartWhenAvailable |
読み取り/書き込み |
スケジュールされた時刻が経過した後、タスク スケジューラがタスクをいつでも開始できることを示すブール値を取得または設定します。 |
|
StopIfGoingOnBatteries |
読み取り/書き込み |
コンピューターがバッテリ電源で実行を開始した場合にタスクが停止されることを示すブール値を取得または設定します。 |
|
WakeToRun |
読み取り/書き込み |
タスクスケジューラがタスクの実行時にコンピューターをスリープ解除することを示すブール値を取得または設定します。 |
|
Xmltext |
読み取り/書き込み |
タスク設定の XML 形式の定義を取得または設定します。 |
解説
既定では、タスクは実行を開始してから 72 時間後に停止されます。 これを変更するには、 ExecutionTimeLimit 設定を変更します。
タスクの XML の読み取りまたは書き込み時に、タスク設定はタスク スケジューラ スキーマの Settings 要素で定義されます。
例
このスクリプト オブジェクトの詳細とコード例については、「 Time Trigger Example (Scripting)」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |
| タイプ ライブラリ |
|
| [DLL] |
|