Triggers
Trigger scripts when events happen with PowerShell Universal.
Triggers allow for automation jobs to be started when certain events happen within PowerShell Universal. For example, this allows you to take action when jobs complete, the server starts or dashboards stop. Triggers are useful for assigning global error handling or sending notifications when certain things happen.
Triggered jobs will not cause additional triggers to start. Triggers are stored in the
triggers.ps1.The following types of events can be assigned a trigger.
- Job Started
- Job Completed
- Job Requesting Feedback
- Job Failed
- Dashboard Started
- Dashboard Stopped
- Server Started
- Server Stopping
- User Login
- Use of a Revoked App Token
Available in PowerShell Universal 2.9 or later.
The user login event takes place when a user accesses PowerShell Universal. The script will receive a
$data parameter with user information. The data structure is shown below.@{
UserName = 'username'
}
Available in PowerShell Universal 2.9 or later.
The app token event takes place when a revoked app token is used. The script will receive a
$data parameter that contains the contents of the app token as a string.Global triggers will start the assigned script whenever the event type is invoked.
For example, the
Script.ps1 will be run whenever any job is run.New-PSUTrigger -Name 'Trigger' -EventType JobStarted -TriggerScript Script.ps1
Resource triggers will start the assigned script when the event takes place on the selected resource.
For example, the
Script.ps1 will be run whenever the Dashboard is stopped.New-PSUTrigger -Name 'Trigger' -EventType DashboardStopped -TriggerScript Script.ps1 -Dashboard 'Dashboard'
Whenever a job is started from a trigger, it will be provided with metadata about object that caused the event to trigger.
Triggers related to jobs will be provided a
$Job parameter.param($Job)
$Job
Triggers related to dashboards will be provided a
$Dashboard parameter.param($Dashboard)
$Dashboard
Triggers related to the server status will not receive a parameter.
Last modified 1yr ago