Terminals
In-browser PowerShell terminals.
Terminals require a license.
Terminals are in-browser PowerShell consoles that you can execute arbitrary commands within. Terminals are configured to target an environment that you select and can optionally us Run As credentials to run as other users. The history of terminals is maintained within the PowerShell Universal database. You can reconnect to disconnected terminals as long as they haven't timed out.
Terminal configurations are stored in terminals.ps1
Configure A Terminal
You can configure a new terminal by navigating to Automation \ Terminals and clicking Create New Terminal. You'll be able to select the environment and credential to run the terminal as.
![](https://docs.powershelluniversal.com/~gitbook/image?url=https%3A%2F%2F1373299915-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8F6PrkNTG8Y34hADzKOL%252Fuploads%252Fgit-blob-33e40c48a7c70dbccc4459acb335749ae435111c%252Fimage%2520%28103%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=df9bc9c1&sv=1)
Use a Terminal
To use a terminal, click the Open Terminal button for the terminal you wish to launch. Depending on your configuration, this may start a new PowerShell process based on the environment you selected.
![](https://docs.powershelluniversal.com/~gitbook/image?url=https%3A%2F%2F1373299915-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8F6PrkNTG8Y34hADzKOL%252Fuploads%252Fgit-blob-7b4df99dedea20f8cfb968456a1bea35fc923040%252Fimage%2520%28463%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=a3eba946&sv=1)
Once the terminal has launched, you'll be able to issue commands.
![](https://docs.powershelluniversal.com/~gitbook/image?url=https%3A%2F%2F1373299915-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8F6PrkNTG8Y34hADzKOL%252Fuploads%252Fgit-blob-a60d217f9c1a9f2c36f80526a6d5737da15a3f5b%252Fimage%2520%28239%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=187c9321&sv=1)
Stop a Terminal
To stop a terminal, you can navigate to the terminal instances tab on the Terminals page. Click the trash can to stop the terminal.
![](https://docs.powershelluniversal.com/~gitbook/image?url=https%3A%2F%2F1373299915-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8F6PrkNTG8Y34hADzKOL%252Fuploads%252Fgit-blob-a7d78178c8c499d8dc2decbc93520ae335d7e9f9%252Fimage%2520%28561%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=a1148078&sv=1)
Reconnect to a Terminal
If you navigate away from PowerShell Universal, the terminal will go idle. You can reconnect to a terminal by clicking the Open Terminal button for the idle terminal instance.
![](https://docs.powershelluniversal.com/~gitbook/image?url=https%3A%2F%2F1373299915-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8F6PrkNTG8Y34hADzKOL%252Fuploads%252Fgit-blob-ba33c413b0fd1f6fa2bb701c9ef7d6c9ddd88e7d%252Fimage%2520%28218%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=c9f8c9f6&sv=1)
Terminals will time out automatically after 5 minutes. You can customize the timeout by setting the -IdleTimeout
parameter of New-PSUTerminal
.
History
Terminal history can be enabled per terminal configuration.
![](https://docs.powershelluniversal.com/~gitbook/image?url=https%3A%2F%2F1373299915-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8F6PrkNTG8Y34hADzKOL%252Fuploads%252Fgit-blob-49684b8cf274bd3d85c026497e2c412c1f934a53%252Fimage%2520%28154%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=18957eb3&sv=1)
When terminal history is enabled, you will be able to view the history of all commands that were executed within the terminal. Click the View Command History button for the instance in question.
![](https://docs.powershelluniversal.com/~gitbook/image?url=https%3A%2F%2F1373299915-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8F6PrkNTG8Y34hADzKOL%252Fuploads%252Fgit-blob-14585b7869dee36e38f2832e25e42b287707a1d1%252Fimage%2520%28156%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=1aa3c8a9&sv=1)
You will be able to review what the command was that ran, when it was ran, who started the terminal and what the output of the command was.
![](https://docs.powershelluniversal.com/~gitbook/image?url=https%3A%2F%2F1373299915-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F8F6PrkNTG8Y34hADzKOL%252Fuploads%252Fgit-blob-8c7adae8e843fdf8155897c465fb3691b2504aa4%252Fimage%2520%28135%29.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=d20f0a18&sv=1)
Last updated