> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/rdm/knowledge-base/knowledge-base-articles/entry-settings/powershell-terminal-remote.md).

# PowerShell terminal (remote)

Configure PowerShell terminal (remote) settings in Remote Desktop Manager, including the connection type, host, SSL, credentials, parameters, and version.

This article details the many settings and options available for ***PowerShell terminal (remote)*** session entries in Remote Desktop Manager.

<table data-header-hidden><thead><tr><th width="200"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Name</strong></td><td>The name of the entry.</td></tr><tr><td><strong>Folder</strong></td><td>The folder where the entry is located. Click the browse button to select a folder, or click the add button to create a new one.</td></tr><tr><td><strong>Display</strong></td><td>How the session is displayed when it is opened.</td></tr><tr><td><strong>Host</strong></td><td>Where the host of the entry comes from. Select a host mode from the list. When the host comes from a linked host entry, the host field of the <em><strong>General</strong></em> tab is unavailable.</td></tr><tr><td><strong>Credentials</strong></td><td>How the credentials of the entry are provided. Select a credential mode from the list. When the credentials come from another source, the <em><strong>Username</strong></em>, <em><strong>Domain</strong></em>, and <em><strong>Password</strong></em> fields of the <em><strong>General</strong></em> tab are unavailable.</td></tr></tbody></table>

### General

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Type</strong></td><td><p>How the remote computer is identified. The label of the host field changes to match the selected type:</p><ul><li><strong>Computer name</strong> — The host field is labeled <em><strong>Host</strong></em>.</li><li><strong>Connection URI</strong> — The host field is labeled <em><strong>URL</strong></em>.</li><li><strong>VM name</strong> — The host field is labeled <em><strong>VM name</strong></em>.</li><li><strong>VM ID</strong> — The host field is labeled <em><strong>VM ID</strong></em>.</li><li><strong>SSH</strong> — Connect over SSH. This type always runs with <em><strong>PowerShell 7</strong></em>.</li></ul></td></tr><tr><td><strong>Host</strong></td><td>The computer name, connection URL, virtual machine name, or virtual machine ID to connect to, depending on the selected <em><strong>Type</strong></em>. Required, unless the host comes from a linked host entry. The browse button is available when <em><strong>Type</strong></em> is set to <em><strong>Computer name</strong></em>.</td></tr><tr><td><strong>Port</strong></td><td>The port used to connect to the remote computer.</td></tr><tr><td><strong>Use SSL</strong></td><td>Use SSL for the connection. Does not apply when <em><strong>Type</strong></em> is set to <em><strong>SSH</strong></em>.</td></tr><tr><td><strong>Skip TLS certificate validation</strong></td><td><p>Whether to skip the validation of the TLS certificate of the remote computer:</p><ul><li><strong>Default</strong></li><li><strong>Yes</strong></li><li><strong>No</strong></li></ul></td></tr><tr><td><strong>Configuration name</strong></td><td>The name of the session configuration to use on the remote computer. Does not apply when <em><strong>Type</strong></em> is set to <em><strong>SSH</strong></em>.</td></tr><tr><td><strong>Username</strong></td><td>The username used to connect. Unavailable when the credentials come from another source.</td></tr><tr><td><strong>Domain</strong></td><td>The domain of the user. Unavailable when the credentials come from another source.</td></tr><tr><td><strong>Password</strong></td><td>The password of the user. Unavailable when the credentials come from another source, or when the <em><strong>Disable password saving in vaults</strong></em> system setting is enabled.</td></tr></tbody></table>

### Terminal

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Application</strong></td><td><p>The terminal application that hosts the session:</p><ul><li><strong>Default (Windows Terminal)</strong></li><li><strong>Classic</strong></li><li><strong>Windows Terminal</strong></li><li><strong>Let Windows decide</strong></li></ul></td></tr><tr><td><strong>Configuration</strong></td><td>An optional Windows Terminal entry whose profile the session uses. Select an entry to use its profile instead of the default profile configured on your machine. On Windows, click the browse button to pick an entry. Click the clear button to remove the selection. Available when <em><strong>Application</strong></em> is set to <em><strong>Default (Windows Terminal)</strong></em> or <em><strong>Windows Terminal</strong></em>. The selected entry is saved only when <em><strong>Application</strong></em> is set to <em><strong>Windows Terminal</strong></em>.</td></tr></tbody></table>

### Parameters

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Parameter name</strong></td><td>The name of the parameter. Click the name to rename the parameter in a window.</td></tr><tr><td><strong>#</strong></td><td>The token that identifies the parameter on the command line.</td></tr><tr><td><strong>Type</strong></td><td><p>The type of the parameter:</p><ul><li><strong>Unused</strong></li><li><strong>Text</strong></li><li><strong>Secured</strong> — The default value is masked.</li><li><strong>Env. variable</strong></li></ul></td></tr><tr><td><strong>Default value</strong></td><td>The value assigned to the parameter. Unavailable when the type is <em><strong>Unused</strong></em>.</td></tr><tr><td><strong>Add</strong></td><td>Add a parameter row at the end of the list.</td></tr><tr><td><strong>Delete</strong></td><td><p>Remove the last parameter row added with <em><strong>Add</strong></em>. The first five parameter rows cannot be removed. The delete button at the end of a row clears that parameter and sets its type to <em><strong>Unused</strong></em>.</p><p>On Linux, parameter names are edited directly in the list, the <em><strong>Add parameter</strong></em> button below the list adds a parameter, and the delete button of a row removes it.</p></td></tr><tr><td><strong>Prompt for parameters on open</strong></td><td>Prompt for the parameter values each time the session opens.</td></tr></tbody></table>

### Run as

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Run as administrator</strong></td><td>Run the session with administrator privileges. When selected, the credential fields below are unavailable.</td></tr><tr><td><strong>Credentials</strong></td><td><p>The credentials used to run the session:</p><ul><li><strong>None</strong></li><li><strong>Current session</strong></li><li><strong>Username and password</strong> — Enter the <em><strong>Username</strong></em>, <em><strong>Domain</strong></em>, and <em><strong>Password</strong></em>. Select <em><strong>Always ask for password</strong></em> to be prompted for the password instead of saving it.</li><li><strong>Linked</strong> — Select the vault in the <em><strong>Vault</strong></em> list, then select the <em><strong>Credential</strong></em> entry to use. Selecting the user vault from an entry in a shared vault lets you enter the <em><strong>Entry name</strong></em> of a credential entry to find in each user's user vault.</li><li><strong>My personal credentials</strong> — Click the button next to the list to edit them.</li><li><strong>My privileged account</strong> — Click the button next to the list to edit it.</li></ul></td></tr></tbody></table>

### Advanced

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>PowerShell version</strong></td><td><p>The PowerShell version that runs the session:</p><ul><li><strong>Default</strong> — Use the version set in the application settings. The item shows that version in parentheses.</li><li><strong>Windows PowerShell (2.0) [Deprecated]</strong></li><li><strong>Windows PowerShell (5.1)</strong></li><li><strong>PowerShell 7</strong></li></ul></td></tr><tr><td><strong>Threading</strong></td><td><p>The apartment state of the PowerShell thread:</p><ul><li><strong>Default</strong> — Use the threading set in the application settings. The item shows that value in parentheses.</li><li><strong>MTA (multithreaded apartment)</strong></li><li><strong>STA (single-threaded apartment)</strong></li></ul></td></tr><tr><td><strong>Other parameters</strong></td><td>Additional parameters appended to the command that opens the remote session.</td></tr><tr><td><strong>No exit</strong></td><td>Keep PowerShell open after the command or script completes.</td></tr><tr><td><strong>Resize window</strong></td><td>Resize the PowerShell window and buffer to the sizes set in the application settings when the session starts.</td></tr><tr><td><strong>No profile</strong></td><td>Start PowerShell without loading the PowerShell profile.</td></tr><tr><td><strong>No logo</strong></td><td>Hide the PowerShell startup banner.</td></tr><tr><td><strong>Edit embedded script</strong></td><td>Open the script editor to write or modify a script stored in the entry. To pass arguments to the script, add parameters to it and set their values on the <em><strong>Parameters</strong></em> tab. Available on Windows only.</td></tr></tbody></table>

### See also

* [Use custom Windows terminal over console host in PowerShell session entries](https://docs.devolutions.net/rdm/knowledge-base/how-to-articles/use-custom-windows-terminal-over-console-host-in-powershell-session-entries.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/rdm/knowledge-base/knowledge-base-articles/entry-settings/powershell-terminal-remote.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
