Contact Info

Crumbtrail » Administration » Powershell » Powershell 3.0 » Set-JobTrigger

Set-JobTrigger - Powershell 3.0 CmdLet

ActiveXperts Network Monitor ships with integrated Powershell scripts to monitor complex network. The scripts run out of the box
Download the ActiveXperts Network Monitor FREE version now »


Short description
Changes the job trigger of a scheduled job.

Set-JobTrigger [-InputObject] <ScheduledJobTrigger[]> [-At <DateTime>] [-AtLogOn] [-AtStartup] [-Daily] [-DaysInterval 
<Int32>] [-DaysOfWeek <DayOfWeek[]>] [-Once] [-PassThru] [-RandomDelay <TimeSpan>] [-RepetitionDuration <TimeSpan>] [-R
epetitionInterval <TimeSpan>] [-User <String>] [-Weekly] [-WeeksInterval <Int32>] [<CommonParameters>]

The Set-JobTrigger cmdlet changes the properties of the job triggers of scheduled jobs. You can use it to change the ti
me or frequency at which the jobs start or to change from a time-based schedules to schedules that are triggered by a l
ogon or startup.

A "job trigger" defines a recurring schedule or conditions for starting a scheduled job. Although job triggers are not 
saved to disk, you can change the job triggers of scheduled jobs, which are saved to disk.

To change a job trigger of a scheduled job, begin by using the Get-JobTrigger cmdlet to get the job trigger of a schedu
led job. Then, pipe the trigger to Set-JobTrigger or save the trigger in a variable and use the InputObject parameter o
f Set-JobTrigger cmdlet to identify the trigger. Use the remaining parameters of Set-JobTrigger to change the job trigg

When you change the type of a job trigger, such as changing a job trigger from a  daily or weekly trigger to an AtLogon
 trigger, the original trigger properties are deleted. However, if you change the values of the trigger, but not its ty
pe, such as changing the days in a weekly trigger, only the properties that you specify are changed. All other properti
es of the original job trigger are retained.

Set-JobTrigger is one of a collection of job scheduling cmdlets in the PSScheduledJob module that is included in Window
s PowerShell.

For more information about Scheduled Jobs, see the About topics in the PSScheduledJob module. Import the PSScheduledJob
 module and then type: Get-Help about_Scheduled*  or see about_Scheduled_Jobs.

This cmdlet is introduced in Windows PowerShell 3.0.