> 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

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.

   ![](https://cdnweb.devolutions.net/docs/INTERFACE0001_2024_3.png)

#### 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.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW0005_2024_3.png" alt=""><figcaption></figcaption></figure>

### RemoteDesktopManager.exe parameters

#### Application control (startup and lifecycle)

| Parameters                                              | Description                                                                        |
| ------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| <p><code>/Help</code><br><code>/?</code></p>            | Display all the information pertaining to the parameters, with examples and notes. |
| `/Silent`                                               | Start Remote Desktop Manager minimized in the system tray.                         |
| <p><code>/CloseApp</code><br><code>/CloseRdm</code></p> | Close Remote Desktop Manager after the operation is completed.                     |
| `/CloseOnDisconnect`                                    | Close application when last session closes.                                        |
| `/Profiler:{level}`                                     | Start with profiler enabled (performance diagnostics).                             |

#### User interface interaction (shortcuts and navigation)

| Parameters           | Description                                    |
| -------------------- | ---------------------------------------------- |
| `/DataSource:{guid}` | Select a workspace in the UI.                  |
| `/Database:{guid}`   | Select a database (alternative to DataSource). |
| `/Repository:{id}`   | Navigate to repository.                        |
| `/Department:{name}` | Navigate to department.                        |
| `/Filter:{text}`     | Apply text filter to 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)

| Parameters                   | Description                                       |
| ---------------------------- | ------------------------------------------------- |
| `/Template:{type}`           | Template ID (e.g., RDP, SSH, VNC).                |
| `/Host:{hostname}`           | Hostname or IP address (required with /Template). |
| `/Port:{port}`               | Port number.                                      |
| `/Username:{user}`           | Username for authentication.                      |
| `/Domain:{domain}`           | Domain for authentication.                        |
| `/Password:{password}`       | Password for authentication.                      |
| `/ConnectionFileName:{file}` | Load connection from file.                        |

#### Session display options

| Parameters                   | Description                                  |
| ---------------------------- | -------------------------------------------- |
| `/TabTitle:{title}`          | Tab title for embedded session.              |
| `/TabPage:{page}`            | Tab page name.                               |
| `/OpenConnectionMode:{mode}` | How to open: Default, Embedded, or External. |
| `/CustomField1:{value}`      | Pass value to custom field 1.                |
| `/CustomField2:{value}`      | Pass value to custom field 2.                |
| `/CustomField3:{value}`      | Pass value to custom field 3.                |
| `/CustomField4:{value}`      | Pass value to custom field 4.                |
| `/CustomField5:{value}`      | Pass value to custom field 5.                |

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

| Parameters                           | Description                           |
| ------------------------------------ | ------------------------------------- |
| \`/Report:{id                        | name}\`                               |
| `/ReportOutput:{path}`               | Output file path for exported report. |
| `/ReportSettings:{path}`             | Report settings file path.            |
| `/SecurityProviderPassphrase:{pass}` | Set security provider passphrase.     |

{% 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:

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

The question should be specific, self-contained, and written in natural language.
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.