Register-ScheduledTask

Verb: RegisterChapter 12: Create a scheduled task

Creates a scheduled task from an action, trigger, and settings.

Syntax

Short syntax for this command. The parameter table below may list more parameters than this short line shows.

Syntax
Register-ScheduledTask -TaskName <Name> -Action <Action> -Trigger <Trigger>

Parameters

ParameterWhat it doesIn short syntax
-TaskNamethe new task nameYes
-Actionwhat runsYes
-Triggerwhen it runsYes

Examples

Registers a daily task.

Example 1
$a = New-ScheduledTaskAction -Execute "powershell.exe"; Register-ScheduledTask -TaskName "Daily" -Action $a -Trigger (New-ScheduledTaskTrigger -Daily -At 2am)

Illustrative output: see the lesson example for this command.

Common mistakes

General cautions for this command.

  • Guessing parameters instead of checking Get-Help for this command.
  • Running a changing form of this command before previewing its effect.

Related commands

Commands that share this command's lesson come first, then commands that share its verb. Every link goes to a real command page.

Related lessons