Technical
KB0078 - Service fails to start during PowerShell Universal v5 Upgrade when using SQLite and MSI
Scope Users that are upgrading from PowerShell Universal v4 to PowerShell Universal v5 using the MSI and SQLite persistence database. Problem The service may not start in a timely manner and cause the MSI process to fail. Root Cause PowerShell ...
KB0074 - Connecting to PSU API w/Windows Auth
Scope This article applies only to PSU environments where Windows Authentication[1] is enabled and known to be working[2]. Problem You are not able to interact with the PSU instance using the Invoke-WebRequest PowerShell cmdlet even though logging in ...
KB0071 - Apps and APIs restart when changing variables in PowerShell Universal
Scope This applies to users who change variable values on their PowerShell Universal environments during runtime. This affects all versions of PowerShell Universal. Problem Apps and APIs will restart when variables are changed. This can cause users ...
KB0070 - Load Npgsql.dll In PowerShell Universal
Purpose The purpose of this document is to provide information on how to load Npgsql in PowerShell Universal's integrated environment. Npgql is a library for accessing PostgreSQL databases. Problem Npgsql versions are built against specific versions ...
KB0066 - Get-WMIObject cmdlet not working
Scope This article applies to any scenario where the Get-WMIObject cmdlet is expected to be available and functioning within a PowerShell Universal instance. Effectively, this article will only apply to instances that run under the Windows operating ...
KB0063 - API, App or Job Not Starting
Problem External processes do not start after upgrades or with the same configuration and script on different machines. Common errors in the log will include: [ERR] Dashboard process running but not response after 10 seconds. Terminating process. ...
KB0062 - TLS Cipher Suites
Problem Your organization has security concerns about the TLS cipher suites that are utilized by PowerShell Universal. You may have been informed by your security team (pen testers) that your instance of PowerShell Universal is vulnerable due to the ...
KB0061 - Enabling Debug System Logs
Purpose The purpose of this document is to outline how to enable debug system logs. System logs provide details into the internals of PowerShell Universal and default to Information. Applicable Versions - PowerShell Universal v4 and later Process ...
KB0060 - Running Side-By-Side PowerShell Universal Instances
Purpose The purpose of this document is to outline how to run side-by-side instances of PowerShell Universal on the same machine. These instances will have their own configuration settings and port. This can be useful for testing between versions. ...
KB0055 - Blank Admin Console or No Updates After Upgrade
Affected Versions - PowerShell Universal 4.2.x Problem When navigating to subpages (such as /admin/automation/scripts) in the admin console, the page will display a blank page. Navigating directly to the /admin URL will load the page. Additionally, ...
KB0054 - Git Sync: There is no tracking information for the current branch
Affected Versions - PowerShell Universal 4.2.0 - 4.2.5 Problem Attempting to synchronize with a git remote returns an error stating "There is no tracking information for the current branch". Root Cause A defect in PowerShell Universal's git ...
KB0052 - Collecting IIS Application Pool Recycle Events
Purpose The purpose of this document is to provide information on how to collect IIS Application Pool recycle events. Application Pool recycling can be problematic for PowerShell Universal servers. Walk Through By default, only three of the eight ...
KB0051 - Viewing database contents
Purpose The purpose of this document is to provide steps for viewing the PowerShell Universal database. Process PowerShell Universal v3 and v4 - LiteDB To view the LiteDB database for PowerShell Universal, you can use LiteDB Studio. PowerShell ...
KB0050 - High memory usage for apps\dashboards using UDElement event handlers
Affected Versions - PowerShell Universal 4.1.1 and earlier - PowerShell Universal 3.9.17 and earlier Problem PowerShell Universal apps (v4) and dashboards (v3) will consume gradually more memory when being accessed by users when the dashboard is ...
KB0046 - Collecting a Memory Dump
Purpose The purpose of this document is to provide steps for collecting a memory dump. Occasionally, Ironman Software support may request a memory dump of one or more of the processes involved with the functioning of our software. These memory dumps ...
KB0036 - How to set the license via environment variable
Purpose The purpose of this article is to explain how to set the license for PowerShell Universal by way of environment variable instead of the traditional file-based method. Scope For now, only Windows is in the scope of this article. Linux and ...
KB0037 - Clearing the Chrome\Edge Browser Cache
Purpose: The purpose of this document is to outline how to clear the Google Chrome and Microsoft Edge browser cache. The cache is used to store session information and files. IMS support may as to perform this while debugging issues. Steps: 1. ...
KB0034 - How to collect logs
Purpose The purpose of this article is to provide clear ordered steps for users of PowerShell Universal and to submit them to Ironman Software (typically for a support case). Background Having logs from PowerShell Universal is typically needed to ...
KB0025 - Universal Server fails to start automatically
Applicability This article applies to PowerShell Universal (Kestrel version*) running on Windows. If you have PowerShell Universal running under IIS or another OS then this article does not apply. Symptom Even though the PowerShell Universal service ...
KB0016 - Capturing a Network Trace in Chrome or Edge
About Occasionally, Ironman Software support engineers will request more information while trying to diagnosis a problem that may be happening when access PowerShell Universal. Since PowerShell Universal is a web application, web application ...
KB0003 - Slow Endpoints and TLS Settings
Be advised that if the TLS settings on a Windows Server are modified, this can result in a severe performance degradation Symptom #1 In the Event Viewer (System Log) there are errors with source Schannel indicating that a "fatal error that occurred ...
KB0002 - Security features of PowerShell Universal
In terms of security features, PowerShell Universal currently provides: HTTPS for over the wire encryption Authentication providers such as SAML2, OpenID Connect, Windows (NTLM\Kerberos), WS-Federation, client certificate, and basic auth Role-based ...
KB0013 - Moving PSU to another server
Below are Adam's comments on this topic from August 2nd, 2022: The configuration for PowerShell Universal, including the license, is stored as PS1 files in the repository directory. https://docs.powershelluniversal.com/config/repository We recommend ...
KB0001 - PSU Uninstall Error: "The setup must update files or services..."
When attempting to uninstall PowerShell Universal (MSI Install) from Control Panel -> Programs you receive the error: "The setup must update files or services that cannot be updated while the system is running. If you choose to continue, a reboot ...
"Did not receive port from client process." when running jobs
Version: Any 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 running in ...
ERR_HTTP2_INADEQUATE_TRANSPORT_SECURITY when accessing PowerShell Universal
Version: Any Issue: When accessing PowerShell Universal with a Chromium-based browser such as Google Chrome or Microsoft Edge, you can encounter an error when HTTPS is enabled. The error will state ERR_HTTP2_INADEQUATE_TRANSPORT_SECURITY. Root ...
Jobs not returning correctly from Get-PSUJob
Version: 1.5 Issue: When running Get-PSUJob and passing in a script returned from Get-PSUScript, jobs may not be returned correctly. Get-PSUScript -Name 'Script.ps1' | Get-PSUJob Root Cause: If the Universal 1.4 PowerShell module is installed, and ...
HTTPS Certificate Not Found
Version: Any Issue: After configuration the certificate for your PowerShell Universal and attempting to start the server, you receive the following error. Unhandled exception. System.InvalidOperationException: The requested certificate ...
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 ...
PowerShell Universal server crashes with error "Unable to cast object of type 'LiteDB.EmptyPage' to type 'LiteDB.DataPage'. "
Version: 1.4.x Issue: An error is thrown when running jobs that states: Error executing job 31: Unable to cast object of type 'LiteDB.EmptyPage' to type 'LiteDB.DataPage'. at LiteDB.PageService.GetPage[T](UInt32 pageID) This only happens ...
"[WARN] Call failed. An error occurred while sending the request." message in all jobs
Version: Any Root Cause When PowerShell Universal starts a new job, it uses the Management API to retrieve job information from the server. It does this over HTTP and will generate a Read-Only app token for the identity of the user that started or ...
OpenID Connect does not work with HTTP
Version: Any Problem: When configuring PowerShell Universal OpenID Connect authentication, the server will return a 500 error when attempting to authenticate. Root Cause Chrome 80 introduced new settings that require cross-site cookies to be secure. ...
PowerShell Universal cmdlets return a 404 over HTTPS
Version: 1.4 PowerShell Version: Windows PowerShell 5.1 Problem When issue commands against the PowerShell Universal Management API (such as Get-UAJob, Get-UAScript, etc), the cmdlet will return a 404 error. This can happen when running scripts ...
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 ...
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 ...