Contact Info

Crumbtrail » Administration » Powershell » Powershell 3.0 » New-JobTrigger

New-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
Creates a job trigger for a scheduled job

New-JobTrigger [-Once] [-RandomDelay <TimeSpan>] [-RepetitionDuration <TimeSpan>] [-RepetitionInterval <TimeSpan>] -At 
<DateTime> [<CommonParameters>]
New-JobTrigger [-Weekly] [-RandomDelay <TimeSpan>] [-WeeksInterval <Int32>] -At <DateTime> -DaysOfWeek <DayOfWeek[]> [<
New-JobTrigger [-Daily] [-DaysInterval <Int32>] [-RandomDelay <TimeSpan>] -At <DateTime> [<CommonParameters>]
New-JobTrigger [-AtLogOn] [-RandomDelay <TimeSpan>] [-User <String>] [<CommonParameters>]
New-JobTrigger [-AtStartup] [-RandomDelay <TimeSpan>] [<CommonParameters>]

The New-JobTrigger cmdlet creates a "job trigger" that starts a scheduled job on a one-time or recurring schedule, or w
hen an event occurs.

You can use the ScheduledJobTrigger object that New-JobTrigger returns to set a job trigger for a new or existing sched
uled job.  You can also create a job trigger by using the Get-JobTrigger cmdlet to get the job trigger of an existing s
cheduled job, or by using a hash table value to represent a job trigger.

When creating a job trigger, review the default values of the options specified by the New-ScheduledJobOption cmdlet. T
hese options, which have the same valid and default values as the corresponding options in Task Scheduler, affect the s
cheduling and timing of scheduled jobs.

New-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.