Scheduled Endpoints
Universal Dashboard is now a part of PowerShell Universal. This documentation is for reference to the v2 version of Universal Dashboard and is no longer maintained.
Scheduled Endpoints
Required Version: 1.6.0 or later
Scheduled endpoints allow you to run PowerShell script blocks on an interval. You can easily run a job every minute, hour or day. You can also got as far as you want and specify a schedule using a CRON expression.
Uses for scheduling
Scheduling can be useful for collecting data from monitored systems. This data can be stored in a database or within a cache variable. This can greatly improve the performance of your dashboard. Rather than looking up the data when the user visits the dashboard, the data is collected in the background and loaded from the cache.
For example, you could create a scheduled endpoint to retrieve the count of modules on your machine. To expose this data, you could use a REST API. In the below example we have a cached value that is refreshed every hour and a value that is executed every time the REST API is invoked.
1
$Schedule = New-UDEndpointSchedule -Every 1 -Hour
2
​
3
$EveryHour = New-UDEndpoint -Schedule $Schedule -Endpoint {
4
$Cache:ModuleCount = (Get-Module -ListAvailable).Count
5
}
6
​
7
$moduleCount = New-UDEndpoint -Url "/moduleCount" -Endpoint {
8
(Get-Module -ListAvailable).Count
9
}
10
​
11
$CachedModuleCount = New-UDEndpoint -Url "/cached-moduleCount" -Endpoint {
12
$Cache:ModuleCount
13
}
14
​
15
$dashboard = New-UDDashboard -Title "Test" -Content {
16
New-UDCounter -Title "Test" -Id "Counter" -Endpoint {
17
$Cache:ModuleCount
18
} -AutoRefresh -RefreshInterval 1
19
}
20
​
21
$Server = Start-UDDashboard -Port 10001 -Dashboard $dashboard -Endpoint @($EveryHour, $ModuleCount, $CachedModuleCount)
Copied!
You can see from the execution of these APIs that the cached version is much faster. The cached version can be called 100 times in 30 seconds. The uncached version takes 13 minutes to process 100 requests in sequence.
1
PS C:\Users\adamr> measure-command { 1..100 | % { Invoke-RestMethod http://localhost:10001/api/cached-moduleCount } }
2
​
3
​
4
Days : 0
5
Hours : 0
6
Minutes : 0
7
Seconds : 29
8
Milliseconds : 50
9
Ticks : 290500385
10
TotalDays : 0.000336227297453704
11
TotalHours : 0.00806945513888889
12
TotalMinutes : 0.484167308333333
13
TotalSeconds : 29.0500385
14
TotalMilliseconds : 29050.0385
15
​
16
​
17
​
18
PS C:\Users\adamr> measure-command { 1..100 | % { Invoke-RestMethod http://localhost:10001/api/moduleCount } }
19
​
20
​
21
Days : 0
22
Hours : 0
23
Minutes : 12
24
Seconds : 55
25
Milliseconds : 253
26
Ticks : 7752531632
27
TotalDays : 0.00897283753703704
28
TotalHours : 0.215348100888889
29
TotalMinutes : 12.9208860533333
30
TotalSeconds : 775.2531632
31
TotalMilliseconds : 775253.1632
Copied!
Defining a schedule
To define a schedule, use the
New-UDEndpointSchedule cmdlet. A simple schedule to run every 10 minutes could be defined as follows.1
New-UDEndpointSchedule -Every 10 -Minute
Copied!
Changing the switch parameter used defines which unit of time to run the schedule on. For example, the following schedule runs every 10 seconds.
1
New-UDEndpointSchedule -Every 10 -Second
Copied!
To run a more complex schedule, you can use a CRON expression. For more information, see the Quartz.NET documentation about CRON expressions that it supports.
For example, this CRON expression runs at 10:15am every Monday, Tuesday, Wednesday, Thursday and Friday.
1
New-UDEndpointSchedule -Cron '0 15 10 ? * MON-FRI'
Copied!
Creating a scheduled endpoint
The
New-UDEndpoint cmdlet has a -Schedule parameter that accepts the object created by New-UDEndpointSchedule.Just pass in your schedule and define your script block for the endpoint to execute.
In the below example, we are look up all the computers in our domain every 10 minutes.
1
$Schedule = New-UDEndpointSchedule -Every 10 -Minute
2
$Endpoint = New-UDEndpoint -Schedule $Schedule -Endpoint {
3
$Cache:Computers = Get-ADComputer
4
}
Copied!
The
$Cache:Computers variable can now be used in any endpoint within your dashboard. This include endpoints for charts, counters or a REST API.Finally, you need to pass the
$Endpoint into the -Endpoint parameter of Start-UDDashboard.1
Start-UDDashboard -Endpoint $Endpoint -Dashboard $Dashboard
Copied!
Last modified 8mo ago