> 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/how-to-articles/command-line-arguments.md).

# Command line arguments

Launch Remote Desktop Manager from the command line using parameters to retrieve entry IDs, control startup, and automate operations.

Remote Desktop Manager can be launched using a command line.

{% hint style="info" %}
Some features are only available in the Team Edition. Remote Desktop Manager also offers a Web Protocol Handler.
{% endhint %}

## Retrieve ID and create an executable

It is possible to get the IDs of a ***database***, ***workspace***, ***entry***, and ***vault***.

1. Right-click on the entry and select ***Properties***.
2. Navigate to ***Common*** – ***Entry information***.
3. Click the ***Copy*** button.
4. Paste the command line into a Windows command prompt and press <kbd>Enter</kbd> to create an executable.

### Retrieve a workspace ID

Here is another way to get only workspace IDs:

1. Go to ***File*** – ***Workspaces***. Alternatively, click on the ellipsis next to the workspace name in the ***navigation pane***.
2. Select a workspace and click on ***Edit workspace***.
3. Click on ***ID*** to copy it into the Windows clipboard.

## RemoteDesktopManager.exe parameters

### Application control (startup and lifecycle)

<table data-search="false"><thead><tr><th>Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>/Help</code><br><code>/?</code></td><td>Display this help message.</td></tr><tr><td><code>/Silent</code></td><td>Start the application minimized in the system tray.</td></tr><tr><td><code>/NoSplashScreen</code></td><td>Disable the startup splash screen for this instance.</td></tr><tr><td><code>/MultiInstance</code></td><td>Allow multiple instances to run simultaneously.</td></tr><tr><td><code>/Language:{code}</code></td><td>Override the UI language for this instance only. Saved settings remain unchanged.</td></tr><tr><td><code>/ConfigPath:{path}</code></td><td>Override the configuration directory location. Enables portable installations and multi-instance scenarios.</td></tr><tr><td><code>/CloseApp</code></td><td>Close the application after the operation completes.</td></tr><tr><td><code>/Profiler[:{level}]</code></td><td>Profile application startup and display the profiler window.</td></tr><tr><td><code>/AutoClear:on|off</code></td><td>Enable or disable auto-clear. Use with <code>/Profiler</code>.</td></tr><tr><td><code>/AutoMode:on|off</code></td><td>Enable or disable auto-mode profiling. Use with <code>/Profiler</code>.</td></tr><tr><td><code>/Threshold:{ms}</code></td><td>Set the auto-mode threshold in milliseconds. Use with <code>/Profiler</code>.</td></tr><tr><td><code>/Verbose</code></td><td>Show verbose output with detailed operation steps.</td></tr><tr><td><code>/Quiet</code></td><td>Suppress all output except errors.</td></tr></tbody></table>

### User interface interaction (shortcuts and navigation)

#### Workspaces and navigation

| Parameter             | Description                                                                                                                                                                        |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/DataSource:{guid}`  | Select a data source in the UI.                                                                                                                                                    |
| `/Database:{guid}`    | Select a data source in the UI using the database ID.                                                                                                                              |
| `/Vault:{id}`         | Navigate to a vault.                                                                                                                                                               |
| `/DashboardTab:{tab}` | Select a dashboard tab. Supported values: `documentation`, `tools`, `automation`, `remotetools`, `subconnections`, `permissions`, `asset`, `attachments`, `logs`, and `recording`. |
| `/CloseOnDisconnect`  | Close the application when the last session closes.                                                                                                                                |
| `/Filter:{text}`      | Apply a text filter to the connection tree.                                                                                                                                        |

#### Session operations

| Parameters              | Description                                  |
| ----------------------- | -------------------------------------------- |
| `/Session:{guid}[;...]` | Open session(s) by ID (semicolon-separated). |
| `/Close`                | Close specified session(s).                  |
| `/ChangePassword:{pwd}` | Change password for specified session.       |
| `/MacroScript:{guid}`   | Execute macro script with playlist.          |

#### Quick connect (interactive)

<table data-search="false"><thead><tr><th>Parameters</th><th>Description</th></tr></thead><tbody><tr><td><code>/Template:{type}</code></td><td>Template ID (e.g., RDP, SSH, VNC, or a template ID).</td></tr><tr><td><code>/Host:{hostname}</code></td><td>Hostname or IP address (required with /Template).</td></tr><tr><td><code>/Port:{port}</code></td><td>Port number.</td></tr><tr><td><code>/Username:{user}</code></td><td>Username for authentication.</td></tr><tr><td><code>/Domain:{domain}</code></td><td>Domain for authentication.</td></tr><tr><td><code>/Password:{password}</code></td><td>Password for authentication.</td></tr><tr><td><code>/ConnectionFileName:{file}</code></td><td>Load connection from file.</td></tr></tbody></table>

#### Session display options

<table data-search="false"><thead><tr><th>Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>/TabTitle:{title}</code></td><td>Set the display title text for the embedded session tab.</td></tr><tr><td><code>/OpenConnectionMode:{mode}</code></td><td>How to open: Default, Embedded, or External.</td></tr><tr><td><code>/CustomField1:{value}</code></td><td>Pass a value to custom field 1.</td></tr><tr><td><code>/CustomField2:{value}</code></td><td>Pass a value to custom field 2.</td></tr><tr><td><code>/CustomField3:{value}</code></td><td>Pass a value to custom field 3.</td></tr><tr><td><code>/CustomField4:{value}</code></td><td>Pass a value to custom field 4.</td></tr><tr><td><code>/CustomField5:{value}</code></td><td>Pass a value to custom field 5.</td></tr></tbody></table>

#### Automation (headless/scripting – no GUI required)

| Parameter                                  | Description                                                               |
| ------------------------------------------ | ------------------------------------------------------------------------- |
| `/Report:{id\|name}`                       | Export a report by ID or name.                                            |
| `/ReportOutput:{path}`                     | Output file path for the exported report.                                 |
| `/ReportSettings:{path}`                   | Report settings file path.                                                |
| `/SecurityProviderPassphrase:{passphrase}` | Set the security provider passphrase. Requires a data source or database. |

{% hint style="info" %}
These switches can be combined with `/CloseApp` for fully automated workflows.
{% endhint %}

### Examples

Example #1 - Open a template and connect to a host `RemoteDesktopManager.exe /DataSource:178c2fda-dab4-4f41-98df-6e3205c0a011 /Template:a666b21b-1479-4eee-b482-0a3d561d2411 /Host:Windjammer-PC1`

Example #2 - Open a session `RemoteDesktopManager.exe /DataSource:178c2fda-dab4-4f41-98df-6e3205c0a011 /Session:474bcbcf-d507-435b-8c0a-a9e868781910`

Example #3 - Start Remote Desktop Manager with the profiler `RemoteDesktopManager.exe /Profiler`

Example #4 - Set a passphrase on the Database `RemoteDesktopManager64.exe /Database:B26638B2-7957-466C-192B-6621DA12179A /SecurityProviderPassphrase:Password`

### Notes

* All switches are case-insensitive (except `/Help` which can be in uppercase).
* GUIDs can be found in the ***Advanced*** tab of a session or workspace ***Properties***.
* Multiple sessions: separate GUIDs with semicolons (;) in the `/Session` parameter.
* Special characters in passwords: escape with ^ (e.g., Pass^^word for Pass^word)
* Line continuation in CMD: use ^ at end of line
* Exit codes:
  * 0 = Success
  * -1 = Error


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/rdm/knowledge-base/how-to-articles/command-line-arguments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.