New-Scheduled Task Trigger

Syntax

New-ScheduledTaskTrigger
   [-RandomDelay <TimeSpan>]
   -At <DateTime>
   [-Once]
   [-RepetitionDuration <TimeSpan>]
   [-RepetitionInterval <TimeSpan>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

New-ScheduledTaskTrigger
   [-Daily]
   [-DaysInterval <UInt32>]
   [-RandomDelay <TimeSpan>]
   -At <DateTime>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

New-ScheduledTaskTrigger
   [-RandomDelay <TimeSpan>]
   -At <DateTime>
   [-DaysOfWeek <DayOfWeek[]>]
   [-Weekly]
   [-WeeksInterval <UInt32>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

New-ScheduledTaskTrigger
   [-RandomDelay <TimeSpan>]
   [-AtStartup]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

New-ScheduledTaskTrigger
   [-RandomDelay <TimeSpan>]
   [-AtLogOn]
   [-User <String>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

The New-ScheduledTaskTrigger cmdlet creates and returns a new scheduled task trigger object.

You can use a time-based trigger or an event-based trigger to start a task. Time-based triggers include starting a task at a specific time or starting a task multiple times on a daily or weekly schedule. Event-based triggers include starting a task when the system starts up or when a user logs on to the computer. Each task can contain one or more triggers, which means there are many ways that you can start a task. If a task has multiple triggers, Task Scheduler starts the task when any of the triggers occur.

Examples

Example 1: Register a scheduled task that starts a task once

PS C:\>$Sta = New-ScheduledTaskAction -Execute "Cmd"

The second command creates a scheduled task trigger that starts the task once at 3:00 A.M and assigns the **ScheduledTaskTrigger** object to the $Stt variable.
PS C:\>$Stt = New-ScheduledTaskTrigger -Once -At 3am

The third command registers the scheduled task Task01 to run the task action named Cmd once at 3:00 A.M.
PS C:\>Register-ScheduledTask Task01 -Action $Sta -Trigger $Stt

This example registers a scheduled task that starts once.

The first command creates a scheduled task action named Cmd and assigns the ScheduledTaskAction object to the $Sta variable.

Example 2: Register a scheduled task that starts every day

PS C:\>$Sta = New-ScheduledTaskAction -Execute "Cmd"

The second command creates a scheduled task trigger that starts every day at 3:00 A.M and assigns the **ScheduledTaskTrigger** object to the $Stt variable.
PS C:\>$Stt = New-ScheduledTaskTrigger -Daily -At 3am

The third command registers the scheduled task Task01 to run the task action named Cmd every day at 3:00 A.M.
PS C:\>Register-ScheduledTask Task01 -Action $Sta -Trigger $Stt

This example registers a scheduled task that starts every day.

The first command creates a scheduled task action named Cmd and assigns the ScheduledTaskAction object to the $Sta variable.

Example 3: Register a scheduled task that starts every 3 days

PS C:\>$Sta = New-ScheduledTaskAction -Execute "Cmd"

The second command creates a scheduled task trigger that starts every 3 days at 3:00 A.M and assigns the **ScheduledTaskTrigger** object to the $Stt variable.
PS C:\>$Stt = New-ScheduledTaskTrigger -Daily -DaysInterval 3 -At 3am

The third command registers the scheduled task Task01 to run the task action named cmd every 3 days at 3:00 A.M.
PS C:\>Register-ScheduledTask Task01 -Action $Sta -Trigger $Stt

This example registers a scheduled task that starts every 3 days.

The first command creates a scheduled task action named Cmd and assigns the ScheduledTaskAction object to the $Sta variable.

Example 4: Register a scheduled task that starts every-other week

PS C:\>$Sta = New-ScheduledTaskAction -Execute "Cmd"

The second command creates a scheduled task trigger that starts every other Sunday at 3:00 A.M and assigns the **ScheduledTaskTrigger** object to the $Stt variable.
PS C:\>$Stt = New-ScheduledTaskTrigger -Weekly -WeeksInterval 2 -DaysOfWeek Sunday -At 3am

The third command registers the scheduled task Task01 to run the task action named Cmd every other Sunday at 3:00 A.M.
PS C:\>Register-ScheduledTask Task01 -Action $Sta -Trigger $Stt

This example registers a scheduled task that starts every other week.

The first command creates a scheduled task action named Cmd and assigns the ScheduledTaskAction object to the $Sta variable.

Example 5: Register a scheduled task that starts when a user logs on

PS C:\>$Sta = New-ScheduledTaskAction -Execute "Cmd"

The second command creates a scheduled task trigger that starts when a user logs on, and assigns the **ScheduledTaskTrigger** object to the $Stt variable.
PS C:\>$Stt = New-ScheduledTaskTrigger -AtLogon

The third command registers the scheduled task Task01 to run the task action named Cmd when a user logs on.
PS C:\>Register-ScheduledTask Task01 -Action $Sta -Trigger $Stt

This example registers a scheduled task that starts when a user logs on.

The first command creates a scheduled task action named Cmd and assigns the ScheduledTaskAction object to the $Sta variable.

Required Parameters

Optional Parameters

Outputs

Microsoft.Management.Infrastructure.CimInstance#MSFT_TaskTrigger

Related Links

• Enable-ScheduledTask
• Get-ScheduledTaskInfo
• New-ScheduledTask
• New-ScheduledTaskAction
• Register-ScheduledTask
• Start-ScheduledTask