Dashboard does not start

Dashboard does not start

Version: PowerShell Universal 2.x
When attempting to start a dashboard, the dashboard either reports Start Failed or does not transition from Stopped. 
Root Cause and Resolution:
There can be multiple root causes for this issue. Each root cause has a different resolution. 
Terminating Error in Script During Start Up
If there is a terminating error in your script, it can prevent the dashboard from starting. You can identify if there is an error in the script by attempting to start the dashboard and then by clicking the Details for the dashboard and navigating to the Log tab. The error will be shown within the log. 
Resolve the error within the script to fix the issue. 
Syntax Error within Script
Syntax errors within scripts will prevent a script from starting. You can use an editor like VS Code or PSScriptPad to validate that there are no syntax errors within your dashboard script. Common syntax errors can be unclosed quotes or braces. You may not see an error in the Dashboard \ Details \ Log if there is a syntax error. 
Fix the syntax error to address this issue. 
Missing Environment
If you have assigned a specific environment to a dashboard and that environment is no longer available, the dashboard will fail to start. You will see an error in the PowerShell Universal log regarding the missing environment. 
Reset the environment to one that exists within PowerShell Universal to fix this issue. 
    • Related Articles

    • Out-String doesn't work in Universal Dashboard

      Product: PowerShell Universal - Any Version  Issue: Out-String does not appear to work in PowerShell Universal Dashboard running in Windows PowerShell v5.1. You will receive empty strings when attempting to use Out-String. See the example below for ...
    • PowerShell Universal Service crashes on startup after an upgrade to 1.4.6

      Version: PowerShell Universal 1.4.6 Issue The PowerShell Universal service will crash with the following error in Event Viewer.  Application: Universal.Server.exe CoreCLR Version: 4.700.19.56402 .NET Core Version: 3.1.0 Description: The process was ...
    • PowerShell Universal crashes after upgrade to 1.5

      Version: 1.5 Issue: The PowerShell Universal service will not start properly when upgrading from 1.4 to 1.5. The following error is shown in the log.  Unhandled exception. System.InvalidCastException: Unable to cast object of type ...
    • "Did not receive port from client process." when running jobs

      Version: PowerShell Universal 2.x Problem: When executing jobs, jobs can fail without starting the PowerShell script. Within the PowerShell Universal logs, you will see an error that states: Did not receive port from client process. Root Cause: When ...
    • IIS: HTTP Error 502.5 - ANCM Out-Of-Process Startup Failure

      Applies to: PowerShell Universal 1.4 or later When configuring PowerShell Universal to run under IIS, you may be presented with an error that states ANCM Out-Of-Process Startup Failure. This error can be presented for a variety of reasons but the ...