> 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/export-and-import-entries.md).

# Export and import entries

{% embed url="<https://youtu.be/jipoCzhIEs8>" %}

Export and import entries from one type of workspace to another. There are many ways of exporting entries with Remote Desktop Manager.

{% hint style="warning" %}
If you have users who override entry properties with ***User-specific settings***, they will be required to export and import their ***User-specific settings List***. See [Export and Import User-specific settings](https://docs.devolutions.net/rdm/kb/how-to-articles/export-import-user-specific-settings/).
{% endhint %}

The first method is done directly in Remote Desktop Manager, while the second one uses a PowerShell script.

### Export/Import Through Remote Desktop Manager

1. In Remote Desktop Manager, select your workspace in the ***navigation pane***.

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>To export the entire vault, go to <em><strong>File</strong></em> – <em><strong>Export</strong></em> – <em><strong>Export vault (.rdm)</strong></em> and skip to step 4.</p></div>
2. Select the entries and/or folders you wish to export. Use the <kbd>Ctrl</kbd>+click shortcut to select multiple items at once.
3. Right-click on the selection. In the contextual menu, select ***Export*** – ***Export Selection (.rdm)***.

   <figure><img src="https://cdnweb.devolutions.net/docs/docs_en_kb_KB4998.png" alt=""><figcaption></figcaption></figure>
4. In the ***Export Entries*** window, check the options that you want to enable. For a typical migration, check the ***Include credentials, Include attachments and documents***, and ***Encrypt with master key*** options.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>By default, credentials are <strong>not</strong> included. It is critical to check the <em><strong>Include credentials</strong></em> option for the exported data to include them.</p></div>

   <div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p>Specifying a master key will encrypt the entire content of the <strong>.rdm</strong> file to protect it. It is highly recommended as a backup measure, but the key is absolutely necessary for decryption. Store it in a separate storage device for added security.</p></div>

   <figure><img src="https://cdnweb.devolutions.net/docs/docs_en_kb_KB4839.png" alt=""><figcaption></figcaption></figure>
5. Click ***OK***.
6. Save the **.rdm** file on your computer.
7. In the ***navigation pane***, select the workspace and vault in which to import the entries.
8. Right-click on the folder and select ***Import*** – ***Import (.rdm)***.

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>You can import the entire vault in <em><strong>File</strong></em> – <em><strong>Import</strong></em> – <em><strong>Import (.rdm)</strong></em>.</p></div>
9. Locate the **.rdm** file saved on your computer and click ***Open***.
10. Select if you wish to ***Import in root***, ***Import in current folder***, or ***Import in specific folder***.

    <figure><img src="https://cdnweb.devolutions.net/docs/docs_en_kb_KB5000.png" alt=""><figcaption></figcaption></figure>
11. Click ***OK***.
12. In the next dialog, you will be presented with a list of all the entries that are in the data file. You can select specific entries you wish to import or ***Select All*** to import all your entries.

    <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>If you have users who override entry properties with <em><strong>User-specific settings</strong></em> , uncheck <em><strong>Change ID</strong></em>.</p></div>
13. Click ***OK***.

### Export/Import Using PowerShell

The following PowerShell script is intended for exporting all entries from a workspace into **.rdm** files. One file per repository will be created. Before being able to export the entries from the workspace, some preparations are required.

1. Install Remote Desktop Manager on the machine where the PowerShell script will be running.
2. Install the [Devolutions.PowerShell module](https://docs.devolutions.net/powershell/rdm-powershell/rdm-powershell-core-module/#installation).
3. Create a new workspace configuration in Remote Desktop Manager within the user's Windows profile.
4. Set up proper permissions on the destination folder for the user account that will run the script.
5. Update the password in the script.
6. Adapt the destination path in the script where the **.rdm** files will be saved.
7. Save the PowerShell script in a **.ps1** file on the computer on which it will run.
8. Create a scheduled task to run the script on a regular basis.

   ```powershell
   $ds = Get-RDMDataSource -Name "NameOfYourWorkspaceHere"
   Set-RDMCurrentDataSource $ds

   # Update the password
   $passwd = ConvertTo-SecureString -AsPlainText -Force "YourPasswordHere"

   $repos = Get-RDMRepository

   foreach ($repo in $repos)
   {
       Set-RDMCurrentRepository $repo
       Update-RDMUI

       $sessions = Get-RDMSession
       $reponame = $repo.name

       # Adapt the destination path for the .rdm files
       Export-RDMSession -Path "C:\temp\$reponame.rdm" -Sessions $sessions -IncludeCredentials -XML -Password $passwd
   }
   ```


---

# 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/export-and-import-entries.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.
