> 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/convert-virtual-folders-in-remote-desktop-manager.md).

# Convert virtual folders in Remote Desktop Manager

### Manual method

Deleting virtual folders can be done by manually editing each virtual folder, saving the changes and converting them into real folders. However, this process becomes time-consuming when dealing with a significant number of virtual folders, as it requires converting each one manually.

### PowerShell method

{% hint style="danger" %}
Before proceeding with the PowerShell method, please take note of the following:

* This method deletes all virtual folders in the workspace vaults.
* Delete duplicate folders before running the PowerShell script from the new entry.
  {% endhint %}

1. Launch Remote Desktop Manager as an administrator by right-clicking on the application and choosing ***Run as administrator***.
2. Select the workspace vaults from which you want to convert all virtual folders in the ***navigation pane***.
3. Add a new entry.
4. Go to ***Session – PowerShell*** to create a PowerShell session entry.

   <figure><img src="https://cdnweb.devolutions.net/docs/docs_en_kb_KB6014.png" alt=""><figcaption></figcaption></figure>
5. Name the entry and choose the folder in which you want to create it.
6. Set the entry to ***Embedded Script***.

   <figure><img src="https://cdnweb.devolutions.net/docs/docs_en_kb_KB6020.png" alt=""><figcaption></figcaption></figure>
7. Click on ***Edit embedded script***.

   <figure><img src="https://cdnweb.devolutions.net/docs/docs_en_kb_KB6019.png" alt=""><figcaption></figcaption></figure>
8. Add the following script:

   ```powershell
   # Check if Remote Desktop Manager PS module is installed

   if (-not (Get-Module Devolutions.PowerShell -ListAvailable)) {

      Install-Module Devolutions.PowerShell -Scope CurrentUser

   }

   $beforeAllGroups = Get-Date

   $vaults = Get-RDMVault

   foreach ($vault in $vaults) {

      Set-RDMCurrentRepository -Repository $vault

      $vaultname = $vault.Name

      Write-Host "Current Vault is $vaultname"

      # Get all entries' folder path

      $sessions = Get-RDMSession

      $allGroups = @()

      foreach ($session in $sessions) {

          # Split the group folder location for each shortcut

          $tempFolder = $session.Group

          $shortcuts = $tempFolder.split(';')

          foreach ($shortcut in $shortcuts) {

              $folder = $shortcut

              if ($folder) {

                  $levels = $folder.split('\')

                  $nblevels = 1

                  $Groupfolder = ""

                  foreach ($level in $levels) {

                     $name = $level

                      if ($nblevels -eq 1) {

                          $Groupfolder = $name

                      } else {

                          $Groupfolder = "$Groupfolder\$name"

                      }

                      $item = New-Object PSObject -Property @{

                          Name = $name

                          Group = $Groupfolder

                          Levels = $nbLevels

                      }

                      $allGroups += $item

                      $nblevels++

                  }

              }

          }

      }

      # Get all folders that exist in the database

      $groups = Get-RDMSession | Where-Object { $_.ConnectionType -eq "Group" }

      $realGroups = @()

      foreach ($group in $groups) {

          # Split the group folder location for each shortcut

          $tempFolder = $group.Group

          $shortcuts = $tempFolder.split(';')

          foreach ($shortcut in $shortcuts) {

              $folder = $group.Group

              if ($folder) {

                  $levels = $folder.split('\')

                  $nbLevels = $levels.Count

                  $name = $group.Name

                  $item = New-Object PSObject -Property @{

                      Name = $name

                      Group = $folder

                      Levels = $nbLevels

                  }

                  $realGroups += $item

              }

          }

      }

      # Sort arrays and extract virtual folders

      $realGroups = $realGroups | Sort-Object -Property Levels, Name, Group -Unique

      $allGroups = $allGroups | Sort-Object -Property Levels, Name, Group -Unique

      $results = $allGroups | Where-Object { $realGroups.Group -notcontains $_.Group }

      $results = $results | Sort-Object -Property Levels, Name, Group -Unique

      # Convert virtual folders in the database

      foreach ($group in $results) {

          $name = $group.Name

          $folder = $group.Group

          try {

              $session = New-RDMSession -Name $name -Group $folder -Type Group -SetSession -ErrorAction Stop

              Update-RDMUI

          } catch {

              # Split the parent folder

              $tempFolder = $folder.Replace("\$name", '')

              $parents = $tempFolder.split('\')

              foreach ($parent in $parents) {

                  try {

                      $exist = Get-RDMSession -Name $parent -ErrorAction Stop

                  } catch {

                      $name = $parent

                      $index = $parents.IndexOf($parent)

                      $folder = ""

                      for ($item = 0; $item -le $index; $item++) {

                          if ($item -gt 0) {

                              $folder += "\"

                          }

                          $folder += $parents[$item]

                      }

                      $session = New-RDMSession -Name $name -Group $folder -Type Group -SetSession

                      Update-RDMUI

                      Write-Host "Virtual folder $name has been successfully created in the database!"

                  }

              }

              $name = $group.Name

              $folder = $group.Group

              $session = New-RDMSession -Name $name -Group $folder -Type Group -SetSession

              Update-RDMUI

          }

          Write-Host "Virtual folder $name has been successfully created in the database!"

      }

   }

   $afterCreatingGroups = Get-Date

   Write-Host "Time taken to convert virtual folders: $(($afterCreatingGroups).Subtract($beforeAllGroups).Seconds) second(s)"
   ```
9. Click ***OK*** to apply the script.
10. Click ***OK*** the save the entry settings and close the window.
11. Click on ***Open Session*** to run the entry.

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

The script will now convert all virtual folders in the workspace vaults.


---

# 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/convert-virtual-folders-in-remote-desktop-manager.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.
