Primary version
v1.6.0
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. PowerShell Universal Documentation can be found here.
v1.6.0
Released: May 7th, 2018
14 New Controls
From buttons to iframes; you can now create all kinds of controls. All these controls are built on New-UDElement and are open source. They expose all kinds of configuration options and events.
Use buttons, textboxes and select drop downs to create customizable forms. Hook event handlers to take actions as users interact.
1
New-UDButton -Text "Click me!" -OnClick {
2
Send-UDToast -Message "Clicked!"
3
}
4
New-UDCheckbox -Label "Check me!" -OnChange {
5
Send-UDToast -Message "Checked? $EventData"
6
}
7
New-UDSelect -Label "Select me!" -Option {
8
New-UDSelectOption -Name "Option 1" -Value 1
9
New-UDSelectOption -Name "Option 2" -Value 2
10
New-UDSelectOption -Name "Option 3" -Value 3
11
} -OnChange {
12
Send-UDToast -Message "Selected $EventData"
13
}
Copied!
Organize components into collapsibles and collections.
1
New-UDCollapsible -Items {
2
New-UDCollapsibleItem -Icon bug -Title "Bug Report" -Content {
3
New-UDHeading -Size 3 -Content {
4
New-UDIcon -Icon exclamation -Color Green
5
" No bugs!"
6
}
7
}
8
New-UDCollapsibleItem -Icon desktop -Title "Active Desktops" -Content {
9
New-UDCollectionItem -Content { "mac-1234" } -SecondaryContent { New-UDIcon -Icon folder_open }
10
New-UDCollectionItem -Content { "ubuntu-1234" } -SecondaryContent { New-UDIcon -Icon folder_open }
11
New-UDCollectionItem -Content { "win10-1234" } -SecondaryContent { New-UDIcon -Icon folder_open }
12
New-UDCollectionItem -Content { "centos-1234" } -SecondaryContent { New-UDIcon -Icon folder_open }
13
}
14
New-UDCollapsibleItem -Icon empire -Title "Support Cases" -Content {
15
New-UDCollectionItem -Content { "New-UDHeading formats my computer." } -SecondaryContent { New-UDIcon -Icon globe }
16
New-UDCollectionItem -Content { "Start-UDDashboard mines bitcoin." } -SecondaryContent { New-UDIcon -Icon globe }
17
}
18
}
Copied!
Extend UD's control set by contributing to existing controls or developing your own. Visit the ud-controls GitHub repository for more information.
Some existing controls, such as cards, rows, columns and tables have been migrated to use New-UDElement rather than the previous C# cmdlets.
Session Variables
Session variables provide the ability to create rich user interfaces that rival PowerShell UIs built in Windows Forms and WPF. End response to user actions, like checking a checkbox or clicking a button, you can set session variables and update the state of other controls on the page.
1
$Dashboard = New-UDDashboard -Title "Simpsons Dashboard" -Content {
2
New-UDRow -Columns {
3
New-UDColumn -Size 4 -Content {
4
New-UDSelect -Label "Characters" -Option {
5
New-UDSelectOption -Name "Homer" -Value "Homer"
6
New-UDSelectOption -Name "Marge" -Value "Marge"
7
New-UDSelectOption -Name "Bart" -Value "Bart"
8
New-UDSelectOption -Name "Lisa" -Value "Lisa"
9
New-UDSelectOption -Name "Maggie" -Value "Maggie"
10
} -OnChange {
11
$Session:Character = $EventData
12
SEnd-UDToast -Message $EventData
13
Sync-UDElement -Id "Counter"
14
}
15
​
16
New-UDRadio -Group "Season" -Label "Season 1" -OnChange { $Session:Season = 1; Sync-UDElement -Id "Counter" }
17
New-UDRadio -Group "Season" -Label "Season 2" -OnChange { $Session:Season = 2; Sync-UDElement -Id "Counter" }
18
New-UDRadio -Group "Season" -Label "Season 3" -OnChange { $Session:Season = 3; Sync-UDElement -Id "Counter" }
19
New-UDRadio -Group "Season" -Label "Season 4" -OnChange { $Session:Season = 4; Sync-UDElement -Id "Counter" }
20
New-UDRadio -Group "Season" -Label "Season 5" -OnChange { $Session:Season = 5; Sync-UDElement -Id "Counter" }
21
}
22
​
23
New-UDColumn -Size 8 -Content {
24
New-UDCounter -Title "Jokes per minute" -Id "Counter" -Endpoint {
25
if ($Session:Character -eq $null) {
26
0
27
}
28
else {
29
$Cache:SimpsonsData[$Session:Character][$Session:Season]
30
}
31
}
32
}
33
}
34
}
35
​
36
$Cache:SimpsonsData = @{
37
Homer = (0..5 | % {Get-Random})
38
Marge = (0..5 | % {Get-Random})
39
Bart = (0..5 | % {Get-Random})
40
Lisa = (0..5 | % {Get-Random})
41
Maggie = (0..5 | % {Get-Random})
42
}
Copied!
Read more about Session variables on Gitbook.
Cache Variables
Cache variables allow you to improve the performance of your dashboards by storing data across requests or with scheduled endpoints. Instead of querying data every time a control is loaded, you can now load data in the background and simply display the data from a cache variable. This will greatly improve user experience and alleviate the pressure on your resources that are being monitored.
Scheduled Endpoints
Schedule endpoints are the task scheduler for Universal Dashboard. You can create scheduled endpoints with New-UDEndpoint that run on a simple second, minute or hour interval or you can get crazy an create custom CRON jobs.
Scheduled endpoints pair well with cache variables and databases to collect data and then display it in the UI.
For example, running
Get-WmiObject Win32_Product takes about two minutes to run on my machine. No user is going to want to wait for that when looking at a dashboard!Instead, use a scheduled endpoint and the cache to load the data in the background and serve it from the cache. It will only happen every 20 minutes and the page will load quickly.
1
$Schedule = New-UDEndpointSchedule -Every 10 -Minute
2
$Endpoint = New-UDEndpoint -Schedule $Schedule -Endpoint {
3
$Cache:Products = (Get-WmiObject Win32_Product).Count
4
}
5
​
6
$Dashboard = New-UDDashboard -Title "Cached Products" -Content {
7
New-UDCounter -Title "Number of Products" -Endpoint {
8
$Cache:Products
9
}
10
}
11
​
12
Start-UDDashboard -Dashboard $Dashboard -Port 10000 -Endpoint $Endpoint
Copied!
Universal Dashboard as a Windows Service
Universal Dashboard can now be run as a Windows Service. Using Publish-UDDashboard, you can create a Windows service to host your dashboard and avoid using IIS.
Improved Performance
Through some adjustments to the execution service within Universal Dashboard, the performance of endpoint execution has been increased by two to four times; based on your hardware.
Integrated Examples
You can use
Start-UDDashboard without a dashboard specified to see examples of all the controls that UD offers.
Grab the latest and provide feedback!
Grab the latest Universal Dashboard module from the PowerShell Gallery. Feel free to provide feedback on GitHub.
Last modified 1yr ago