Programming Field

Schtasks /End - DOS/コマンドプロンプト コマンド一覧

登録済みのスケジュールタスクが実行中である場合それを停止します。Schtasksのコマンド(オプション)の1つです。

構文

schtasks[.exe] /End [/S <remote-system> [/U <user-name> [/P [<password>]]]]
    /TN <task-name> [/HRESULT]

オプション一覧

/S <remote-system> タスクが登録されているコンピューター(ローカル/リモート)の名前を指定します。IPアドレスやホスト名を指定します。省略した場合はローカルコンピューターが対象になります。
/U <user-name> [/P [<password>]]

コンピューター名を指定した際のログイン名・パスワードを指定します。<user-name> にはドメイン名を指定することができます(「ドメイン名\ユーザー名」の形式です)。省略した場合はこのコマンドを実行したユーザーが使用されます。

パスワード指定は、「/P [<password>]」全体を省略した場合はパスワードなし、「/P」のみ指定して「<password>」を省略した場合はプロンプトを表示してユーザーにパスワード入力を促すようになります(このプロンプトでは入力されたパスワードが「*」で表示されます)。

/TN <task-name> タスク名を指定します。タスク名にスペース文字が含まれている場合は「" "」で括ります。タスクがフォルダー階層内に存在する場合はそのパスも含めて指定します。
/HRESULT [Windows 10?以降] Schtasksコマンドの終了コードを HRESULT にします。エラー発生時に詳細なハンドリングを行いたい場合に使用します。

解説

「/End」によるタスク停止は、プログラムの強制終了と同じ処理で終了されます。また、タスクのプログラムが子プログラムを実行している場合、そのプログラムも強制終了されます(ただし子プログラムがGUIプログラムである場合などでは終了されない場合があります)。

「/End」を使って実行を停止させた場合、「タスクの最後の実行はユーザーによって強制終了されました。(0x41306)」の記録が残ります。「タスク スケジューラ」でこの記録を確認することができます。

サンプル

schtasks /end /tn HogePiyo

タスク「HogePiyo」がプログラムを実行中である場合、それを強制終了させます。

関連項目