LogonTrigger オブジェクト
ユーザーがログオンしたときにタスクを開始するトリガーを表すスクリプト オブジェクト。 タスク スケジューラ サービスが開始されると、すべてのログオン ユーザーが列挙され、ログオン ユーザーと一致するログオン トリガーに登録されているすべてのタスクが実行されます。
メンバー
LogonTrigger オブジェクトには、次の種類のメンバーがあります。
プロパティ
LogonTrigger オブジェクトには、これらのプロパティがあります。
| プロパティ | アクセスの種類 | 説明 |
|---|---|---|
|
遅延 |
読み取り/書き込み |
ユーザーがログオンしてからジョブが開始するまでの時間を示す値を取得または設定します。 |
|
Enabled |
読み取り/書き込み |
Trigger オブジェクトから継承されます。 トリガーが有効かどうかを示すブール値を取得または設定します。 |
|
EndBoundary |
読み取り/書き込み |
Trigger オブジェクトから継承されます。 トリガーが非アクティブ化された日時を取得または設定します。 トリガーは、非アクティブ化された後にタスクを開始できません。 |
|
ExecutionTimeLimit |
読み取り/書き込み |
Trigger オブジェクトから継承されます。 トリガーによって起動されたタスクの実行が許可される最大時間を取得または設定します。 |
|
Id |
読み取り/書き込み |
Trigger オブジェクトから継承されます。 トリガーの識別子を取得または設定します。 |
|
繰り返し |
読み取り/書き込み |
Trigger オブジェクトから継承されます。 タスクの実行頻度と、タスクの開始後に繰り返される繰り返しパターンの長さを示す値を取得または設定します。 |
|
StartBoundary |
読み取り/書き込み |
Trigger オブジェクトから継承されます。 トリガーがアクティブ化される日時を取得または設定します。 |
|
Type |
読み取り専用 |
Trigger オブジェクトから継承されます。 トリガーの型を取得します。 |
|
Userid |
読み取り/書き込み |
ユーザーの識別子を取得または設定します。 |
解説
特定のユーザーがログオンするときではなく、グループのメンバーがコンピューターにログオンしたときにタスクをトリガーする場合は、 LogonTrigger.UserId プロパティに値を割り当てないでください。 代わりに、空の LogonTrigger.UserId プロパティを使用してログオン トリガーを作成し、 Principal.GroupId プロパティを使用してタスクのプリンシパルに値を割り当てます。
タスクの XML の読み取りまたは書き込み時には、タスク スケジューラ スキーマの LogonTrigger 要素を使用してログオン トリガーが指定されます。
例
このスクリプト オブジェクトの詳細とコード例については、「 ログオン トリガーの例 (スクリプト)」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |
| タイプ ライブラリ |
|
| [DLL] |
|