Platform
KB0069 - PowerShell Universal Startup Process
Purpose The purpose of this document is to outline the steps that PowerShell Universal takes when starting up. Process 1. Insert current product version and install date in database Updates the database with a record about the current product version ...
KB0068 - Group Membership Claims are Missing when using OpenID Connect (OIDC) and Azure Entra ID (Azure AD)
Scope This issue affects users wishing to retreive group membership claims from Azure Entra ID (formerly, Azure Active Directory) using OpenID Connect (OIDC) authentication. Problem Not group membership claims are available within Apps while using ...
KB0067 - Granting an app token with a username and password on the command line
Scope This applies to users wishing to issue app tokens from the command line in PowerShell Universal using a username and password. Process Method 1 - Form Authentication You can use the PowerShell Universal form authentication endpoint to produce a ...
KB0059 - Error During PowerShell Universal Install or Upgrade
Affected Versions - All PowerShell Universal Versions Problem When running the PowerShell Universal MSI on a system that had an older version of the product installed, the user will see an error message that states "The folder path 'C:' contains an ...
KB0058 - PowerShell Universal Browser Times Out Before Session Timeout When Using OIDC
Affected Versions - All Support Versions Problem Setting the session timeout in appsettings.json does not have an affect on how soon the user is logged out from their session. Root Cause When using OpenID Connect, the -UseTokenLifetime parameter ...
KB0053 - Refreshing specific configuration files manually
Product Versions - PowerShell Universal 3.x - PowerShell Universal 4.0.x - PowerShell Universal 4.1.x Purpose When making changes in PowerShell Universal, the configuration system will detect changes to files through the management API, admin console ...
KB0049 - Failure to login after changing security environment
Problem Changing from a security environment, such as Windows PowerShell, to the integrated environment may cause users to fail to be able to login. The login button will appear to do nothing when clicked. Root Cause Changing the security environment ...
KB0045 - The requested certificate could not be found
Problem When specifying a certificate for PowerShell Universal in appsettings.json, an error may occur stating that the certificate could not be found. 2023-09-06 07:52:06.376 -05:00 [FTL] Fatal error starting PowerShell Universal. ...
KB0041 - About Templates
Purpose The purpose of this article is to provide a timeline around the Template functionality of PowerShell Universal. Background Templates were introduced to provide a starting point for newcomers to PowerShell Universal. They have since been ...
KB0040 - PSScriptAnalyzer module is not installed
Problem In the PowerShell Universal health check you see a warning: PSScriptAnalyzer module is not installed. You will have limited features in the editor. (figure shows the health check entry for PSScriptAnalyzer before the module has been ...
KB0039 - Environments Disappear if Clicking Cancel within Git Manual Edit Mode
Purpose The purpose of this article is to outline an issue and workaround that is present in version 4.0.6 and 3.9.12 and earlier of PowerShell Universal. Issue When PowerShell Universal has git sync enabled in manual edit mode, it's possible to ...
KB0030 - Git sync no longer runs after switching from Manual mode to Automatic mode
Applicability This article applies to users running PowerShell Universal 3.4.0 or later and using git synchronization. In the debug log level, you will see the message: Git edit in progress. Skipping git sync. Root Cause When PowerShell Universal is ...
KB0028 - Update the default admin password during startup.
Applicability This article applies to users wishing to set the default admin password automatically on startup. Root Cause PowerShell Universal creates an admin account during startup if it does not exist. It will set the default password to admin. ...
KB0027 - Error "unable to get local issuer certificate" when attempting to Synchronize with Git
Applicability This article applies to any version of PowerShell Universal running on Windows, with git sync enabled and using the external git process. Symptom When attempting to synchronize with a git remote, you receive the error "unable to get ...
KB0026 - Authentication failure when connecting to BitBucket using a HTTP Access Token
Applicability This article applies to any version of PowerShell Universal with git sync enabled. Symptom When attempting to synchronize with a BitBucket git repository using a HTTP Access Token generated from the BitBucket repository, it fails to ...
KB0024 - Moving a PowerShell Universal to a new git remote
Purpose The purpose of this document is to provide the steps necessary to migrate a PowerShell Universal git repository from one remote to another. Overview PowerShell Universal does not provide this functionality directly in the platform. You will ...
KB0023 - Unauthorized Access screen presented after upgrading to PowerShell Universal 3.7.1
Affected Versions - PowerShell Universal 3.7.0 - PowerShell Universal 3.7.1 Issue A user attempts to access the admin console on a machine that was upgraded and are presented with a Not Authorized screen. Solution 1. Upgrade to PowerShell Universal ...
KB0022 - Unable to login after upgrading to PowerShell Universal 3.7.1
Affected Versions - PowerShell Universal 3.7.0 - PowerShell Universal 3.7.1 Issue A user attempts to login with the default admin account and cannot access the system. Solution - Upgrade to PowerShell Universal 3.7.2 - Remove the admin account from ...
KB0020 - Firewall Configuration for PowerShell Universal
Purpose The purpose of this document is to provide information about the necessary filewall settings required by PowerShell Universal. Overview PowerShell Universal does not offer a built in firewall. We recommend using standard firewalls available ...
KB0018 - An anonymous request was received in between authentication handshake requests.
Symptom #1 PowerShell Universal returns a 500 error when visiting the website that is using Windows Authentication. Symptom #2 When viewing the log file in C:\ProgramData\PowerShellUniversal or within the admin console under Settings \ General ...
KB0017 - Windows Auth Checklist
Purpose The purpose of this article is to list the prerequisite conditions for ensuring that Windows Authentication in PowerShell Universal will function as expected (i.e. seamless logon without authentication pop-ups) Scope The scope of this article ...
KB0012 - High Availability
Update Please see the documentation at https://docs.powershelluniversal.com/config/hosting/high-availability for in-depth details on this topic. Below is an overview statement from Adam Driscoll on this topic as well. Adam's statement Our high ...