繰り返し (triggerBaseType) 要素
タスクを実行する頻度と、タスクの開始後に繰り返しパターンを繰り返す時間を指定します。
<xs:element name="Repetition"
type="repetitionType"
/>
繰り返し要素は、triggerBaseType 複合型によって定義されます。
親要素
| 要素 | 派生元 | 説明 |
|---|---|---|
| BootTrigger | bootTriggerType | システムの起動時にタスクを開始するトリガーを指定します。 |
| CalendarTrigger | calendarTriggerType | 毎日、毎週、毎月、または毎月の曜日 (DOW) トリガーを指定します。 |
| EventTrigger | eventTriggerType | システム イベントが発生したときにタスクを開始するトリガーを指定します。 |
| IdleTrigger | idleTriggerType | コンピューターがアイドル状態になったときにタスクを開始するトリガーを指定します。 |
| LogonTrigger | logonTriggerType | ユーザーがログオンしたときにタスクを開始するトリガーを指定します。 |
| RegistrationTrigger | registrationTriggerType | タスクが登録されたときにタスクを開始するトリガーを指定します。 |
| TimeTrigger | timeTriggerType | トリガーがアクティブになったときにタスクを開始するトリガーを指定します。 |
子要素
| 要素 | Type | 説明 |
|---|---|---|
| 期間 | duration | パターンを繰り返す時間を指定します。 |
| Interval | duration | タスクを再起動するまでの時間を指定します。 |
| StopAtDurationEnd | boolean | タスクの実行中のインスタンスが繰り返しパターン期間の最後に停止することを指定します。 |
解説
タスクの繰り返し期間を指定する場合は、繰り返し間隔も指定する必要があります。
繰り返し間隔が 1 分で、繰り返し期間が 4 分のトリガーを含むタスクを登録すると、タスクが 5 回起動されます。 5 つの繰り返しは、次のパターンで定義できます。
- タスクは、最初の 1 分の先頭から開始されます。
- 次のタスクは、最初の 1 分の終わりに開始されます。
- 次のタスクは、2 分の終わりに開始されます。
- 次のタスクは、3 分目の終わりに開始されます。
- 次のタスクは、4 分目の終わりに開始されます。
Windows Server 2003、Windows XP、Windows 2000: 繰り返し間隔が 1 分で、繰り返し期間が 4 分のトリガーを含むタスクを登録すると、タスクが 4 回起動されます。
Windows Vista、Windows 7、Windows Server 2008、Windows 8、Windows Server 2012: 通常、繰り返し期間を間隔の正確な倍数に設定すると、上記の数値が生成されます。 ただし、特定の負荷の高い条件下では、TaskScheduler が最後のタスク間隔を起動するまでの期間がタイムアウトになる可能性があります。
スクリプト開発の場合、繰り返しパターンは、すべてのトリガー オブジェクトによって継承される Trigger.Repetition プロパティを使用して指定されます。
C++ 開発の場合、繰り返しパターンは、すべてのトリガー インターフェイスによって継承される ITRigger::Repetition プロパティを使用して指定されます。
例
次の XML は、トリガーの繰り返しパターンを指定するブート トリガー要素を定義します。
<BootTrigger>
<StartBoundary>2005-01-01T08:00:00</StartBoundary>
<EndBounadry>2007-01-01T08:00:00</EndBoundary>
<Enabled>true</Enabled>
<Repetition>
<Interval></Interval>
<Duration></Duration>
<StopAtDurationEnd>true</StopAtDurationEnd>
</Repetition>
<ExecutionTimeLimit></ExecutionTimeLimit>
<Delay><Delay>
</BootTrigger>
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |