Settings (taskType) 要素
タスク スケジューラがタスクの実行に使用する設定を指定します。
<xs:element name="Settings"
type="settingsType"
minOccurs="0"
/>
Settings 要素は、taskType 複合型によって定義されます。
親要素
| 要素 | 派生元 | 説明 |
|---|---|---|
| Task | taskType | タスク スケジューラ サービスによって実行されるタスクを指定します。 |
子要素
| 要素 | Type | 説明 |
|---|---|---|
| AllowHardTerminate | boolean | TerminateProcess を使用してタスクを終了することを指定します。 |
| AllowStartOnDemand | boolean | [実行] コマンドまたは [コンテキスト] メニューのいずれかを使用してタスクを開始できることを指定します。 |
| DeleteExpiredTaskAfter | duration | タスク スケジューラがタスクの期限切れ後にタスクを削除するまで待機する時間を指定します。 |
| DisallowStartIfOnBatteries | boolean | コンピューターがバッテリで実行されている場合にタスクを開始しないことを指定します。 |
| 有効 | boolean | タスクが有効になっていることを指定します。 タスクは、この設定が True の場合にのみ実行できます。 |
| ExecutionTimeLimit | duration | タスクを完了できる時間。 |
| [非表示] | boolean | タスクが既定で UI に表示されないように指定します。 |
| IdleSettings | idleSettingsType | コンピューターがアイドル状態のときにタスク スケジューラがタスクを実行する方法を指定します。 |
| MaintenanceSettings | maintenanceSettingsType | 自動メンテナンス中にタスク スケジューラがタスクを実行する方法を指定します。 |
| MultipleInstancesPolicy | multipleInstancesPolicyType | タスク スケジューラがタスクの複数のインスタンスを処理する方法を定義するポリシーを指定します。 |
| 優先順位 | priorityType | タスクの優先度レベルを指定します。 |
| RestartOnFailure | restartType | 何らかの理由でタスクが失敗した場合に、タスク スケジューラがタスクの再起動を試みるように指定します。 |
| RunOnlyIfIdle | boolean | コンピューターがアイドル状態の場合にのみタスクを実行することを指定します。 |
| RunOnlyIfNetworkAvailable | boolean | ネットワークが使用可能な場合にのみ、タスク スケジューラでタスクを実行することを指定します。 |
| StartWhenAvailable | boolean | タスク スケジューラは、スケジュールされた時刻が経過した後、いつでもタスクを開始できることを指定します。 |
| StopIfGoingOnBatteries (settingsType) | boolean | コンピューターがバッテリに接続されている場合にタスクを停止することを指定します。 |
| 揮発 性 | boolean | Windows 起動時にタスク スケジューラによってタスクを自動的に無効にするかどうかを指定します。 |
| WakeToRun (settingsType) | boolean | タスクスケジューラがタスクの実行時にコンピューターをスリープ解除することを指定します。 |
注釈
上記で参照されている子要素を 1 つ以上選択できます。
C++ 開発の場合、タスクの登録情報は 、ITaskDefinition の Settings プロパティを使用して指定されます。
スクリプト開発の場合、タスクの登録情報は TaskDefinition.Settings プロパティを使用して指定されます。
例
次の XML コード例では、タスクをハード終了できるようにする settings 要素を定義します。
<task>
<Settings>
<AllowHardTerminate>true</AllowHardTerminate>
<AllowStartOnDemand>true</AllowStartOnDemand>
</Settings>
</task>
タスク設定の XML の詳細と完全な例については、「 タイム トリガーの例 (XML)」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |