繰り返し (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. 次のタスクは、最初の 1 分の終わりに開始されます。
  3. 次のタスクは、2 分の終わりに開始されます。
  4. 次のタスクは、3 分目の終わりに開始されます。
  5. 次のタスクは、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 [デスクトップ アプリのみ]

関連項目

タスク スケジューラ スキーマ要素

タスク スケジューラ