Web Server
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.
Web Server
The Universal Dashboard webserver is based on the ASP.NET Core Kestrel webserver. It's cross-platform and can be hosted in numerous different ways. See Running Dashboards to learn more how to start the webserver.
Web Server Options
HTTPS
Universal Dashboard supports HTTPS. In order to enable HTTPS, you can specify a certificate file and password or a X509Certificate2 returned from the Certificate provider in PowerShell.
To enable HTTPS, simply specify the
-CertificateFile and -CertificatePassword or -Certificate parameter on Start-UDDashboard.1
$cert = ( Get-ChildItem -Path cert:\LocalMachine\My\2BB51C6FF080B51FCA6D52F0B8B4E5369732AE23 )
2
​
3
Start-UDDashboard -Content {
4
New-UDDashboard -Title "Secure Dashboard" -Content {
5
New-UDElement -Tag "h1" -Content { "Super Secure" }
6
}
7
} -Port 10000 -Certificate $cert
Copied!
The dashboard will now be available on HTTPS and no longer available on HTTP.
HTTP to HTTPS redirection
You can enable HTTP to HTTPS redirection by specifying a port for HTTP (default 80) and a port for HTTPS (default 443). If the user visits the HTTP port, they will automatically be redirected to the HTTPS port. The redirection happens via a
308 permanent redirect status code from the web server.1
$Dashboard = Start-UDDashboard -Port 10001 -HttpsPort 10002 -Certificate $Cert
2
​
3
try
4
{
5
$Request = Invoke-WebRequest http://localhost:10001/dashboard
6
}
7
catch
8
{
9
$_.Exception.Response.StatusCode | should be 308
10
}
11
​
12
$Request = Invoke-WebRequest https://localhost:10002/dashboard
13
$Request.StatusCode | Should be 200
Copied!
Listening Address
By default, the web server will listen on all available addresses. You can adjust the listen addresses by using the
-ListenAddress parameter and passing in a valid IP Address. This is helpful when building desktop apps, like UDForge, that should not open a web server to listen beyond the local machine.1
Start-UDDashboard -Port 10000 -ListenAddress '127.0.0.1'
Copied!
Last modified 7mo ago
Copy link