Export and import entries

It is possible to export and import entries from one type of data source to another. There are many ways of exporting entries with Remote Desktop Manager.

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.

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 data source in the Navigation pane.

    To export the entire vault, go to FileExportExport vault (.rdm) and skip to step 4.

  2. Select the entries and/or folders you wish to export. Use the Ctrl+click shortcut to select multiple items at once.

  3. Right-click on the selection. In the contextual menu, select ExportExport Selection (.rdm).

    Export Selection (.rdm)
    Export Selection (.rdm)

  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.

    By default, credentials are not included. It is critical to check the Include credentials option for the exported data to include them.

    Specifying a master key will encrypt the entire content of the .rdm 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.

    Entry Export Options
    Entry Export Options

  5. Click OK.

  6. Save the .rdm file on your computer.

  7. In the Navigation pane, select the data source and vault in which to import the entries.

  8. Right-click on the folder and select ImportImport (.rdm).

    Import (.rdm)
    Import (.rdm)

    You can import the entire vault in FileImportImport (.rdm).

  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.

    Location of Imported Entries
    Location of Imported Entries

  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.

    If you have users who override entry properties with User Specific Settings, uncheck Change ID.

  13. Click OK.

Export/Import Using PowerShell

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

  1. Install Remote Desktop Manager on the machine where the PowerShell script will be running.

  2. Create a new data source configuration in Remote Desktop Manager within the user's Windows profile.

  3. Set up proper permissions on the destination folder for the user account that will run the script.

  4. Update the password in the script.

  5. Adapt the destination path in the script where the .rdm files will be saved.

  6. Save the PowerShell script in a .ps1 file on the computer on which it will run.

  7. Create a scheduled task to run the script on a regular basis.

    Import-Module 'C:\Program Files (x86)\Devolutions\Remote Desktop Manager\RemoteDesktopManager.PowerShellModule.psd1'
    
    $ds = Get-RDMDataSource -Name "NameOfYourDataSourceHere"
    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
    }
    
Give us Feedback