WeeklyTrigger オブジェクト

毎週のスケジュールに基づいてタスクを開始するトリガーを表すスクリプト オブジェクト。 たとえば、タスクは、毎週または隔週の特定の曜日の午前 8 時に開始されます。

メンバー

WeeklyTrigger オブジェクトには、次の種類のメンバーがあります。

• Properties

プロパティ

WeeklyTrigger オブジェクトには、これらのプロパティがあります。

プロパティ	アクセスの種類	説明
DaysOfWeek	読み取り/書き込み	タスクが実行される曜日を取得または設定します。
Enabled	読み取り/書き込み	Trigger オブジェクトから継承されます。 トリガーが有効かどうかを示すブール値を取得または設定します。
EndBoundary	読み取り/書き込み	Trigger オブジェクトから継承されます。 トリガーが非アクティブ化される日時を取得または設定します。 トリガーは、非アクティブ化された後にタスクを開始できません。
ExecutionTimeLimit	読み取り/書き込み	Trigger オブジェクトから継承されます。 トリガーによって起動されたタスクの実行が許可される最大時間を取得または設定します。
Id	読み取り/書き込み	Trigger オブジェクトから継承されます。 トリガーの識別子を取得または設定します。
RandomDelay	読み取り/書き込み	トリガーの開始時刻にランダムに追加される遅延時間を取得または設定します。
繰り返し	読み取り/書き込み	Trigger オブジェクトから継承されます。 タスクの実行頻度と、タスクの開始後に繰り返される繰り返しパターンの長さを取得または設定します。
StartBoundary	読み取り/書き込み	Trigger オブジェクトから継承されます。 トリガーがアクティブ化される日時を取得または設定します。
Type	読み取り専用	Trigger オブジェクトから継承されます。 トリガーの種類を取得します。
WeeksInterval	読み取り/書き込み	スケジュール内の週の間隔を取得または設定します。

注釈

タスクが開始される時刻は、 StartBoundary プロパティによって設定されます。

タスクに対する独自の XML の読み取りまたは書き込み時に、タスク スケジューラ スキーマの ScheduleByWeek 要素を使用して週単位のトリガーが指定されます。

夏時間 (DST) が 1 年で開始される日に、 太平洋タイム ゾーン (2022 年の午前 2 時から午前 3 時 00 分にシフトされた時刻) の場合、午前 2 時から午前 2 時 59 分 59 分 999 分の間に実行される予定のタスクは、その日に存在する可能な限り早い時刻 (つまり午前 03:00) に実行されます。 これは、DST を監視するさまざまな時刻に基づいて、すべての DST タイム ゾーンに適用されます。

2022 年の毎週日曜日の午前 2 時 30 分に太平洋タイム ゾーンで実行するように設定されている週単位のタスクについて考えてみます。次の実行時間は 2022 年 3 月 13 日午前 2 時 30 分です。 午前 2:30 は 2022 年 3 月 13 日に存在しない時刻であるため、タスクは代わりに午前 3 時に実行されます。 その年の他の日曜日には、タスクは通常どおり午前 2 時 30 分に実行されます。

例

このスクリプト オブジェクトの詳細とコード例については、「 Weekly Trigger Example (Scripting)」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
タイプ ライブラリ	Taskschd.tlb
[DLL]	Taskschd.dll

こちらもご覧ください

トリガー

TriggerCollection

TriggerCollection.Create