Share via

ログオン トリガーの例 (XML)

  • [アーティクル]

この例の XML では、ユーザーがログオンしたときにメモ帳を起動するタスクを定義します。

XML で定義されているタスクを登録するには、 ITaskFolder::RegisterTask 関数 (スクリプトの場合は TaskFolder.RegisterTask ) またはコマンド ライン ツールSchtasks.exe使用できます。 Schtasks.exe ツール (C:\Windows\System32 ディレクトリにあります) を使用する場合は、次のコマンドを使用してタスクを登録できます。schtasks /create /XML<パスは、タスク定義>/tn<タスク名>を含む XML ファイルです。

システム起動時にメモ帳を起動するタスクを定義するには

次の XML の例では、1 つの実行アクション (メモ帳の開始)、ユーザーがログオンしたときにタスクを開始する 1 つのログオン トリガー、およびタスクスケジューラによるタスクの処理方法に影響を与えるその他のいくつかのタスク設定を使用して、タスクを定義する方法を示します。

注意

UserId 要素の値を、タスクが登録されているコンピューターのユーザー名に設定します。

 

<?xml version="1.0" ?>
<!--
This sample schedules a task to start notepad.exe when a user logs on.
-->
<Task xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
    <RegistrationInfo>
        <Date>2005-10-11T13:21:17-08:00</Date>
        <Author>AuthorName</Author>
        <Version>1.0.0</Version>
        <Description>Starts Notepad when a specified user logs on.</Description>
    </RegistrationInfo>
    <Triggers>
        <LogonTrigger>
            <StartBoundary>2005-10-11T13:21:17-08:00</StartBoundary>
            <EndBoundary>2006-01-01T00:00:00-08:00</EndBoundary>
            <Enabled>true</Enabled>
            <UserId>DOMAIN_NAME\UserName</UserId>
        </LogonTrigger>
    </Triggers>
    <Principals>
        <Principal>
            <GroupId>Builtin\Administrators</GroupId>
        </Principal>
    </Principals>
    <Settings>
        <Enabled>true</Enabled>
        <AllowStartOnDemand>true</AllowStartOnDemand>
        <AllowHardTerminate>true</AllowHardTerminate>
    </Settings>
    <Actions>
        <Exec>
            <Command>notepad.exe</Command>
        </Exec>
    </Actions>
</Task>

TaskScheduler スキーマ要素

この例を使用する際に注意すべき重要な要素を次に示します。

  • RegistrationInfo: タスクに関する登録情報が含まれます。
  • トリガー: タスクを開始するトリガーを定義します。
  • LogonTrigger: ログオン トリガーを定義します。 この場合、トリガーがアクティブ化および非アクティブ化されるタイミングを指定する開始境界と終了境界、およびユーザーを識別する UserId 要素の 3 つの子要素が使用されます。 このユーザーがコンピューターにログオンすると、タスクが開始されます。
  • プリンシパル: タスクが実行されるセキュリティ コンテキストを定義します。
  • 設定: タスク スケジューラがタスクの実行に使用するタスク設定を定義します。
  • アクション: タスクが実行するアクションを定義します。 この場合は、メモ帳を実行します。

タスク スケジューラの使用