Effettuare il bootstrap della versione portatile di Remote Desktop Manager

A volte gli utenti non dispongono dei privilegi necessari per installare Remote Desktop Manager sulla propria macchina. Questo ostacolo può essere aggirato installando una versione portatile di Remote Desktop Manager e affidandosi a una variabile d'ambiente per impostare il percorso del runtime .NET richiesto.

Si noti che questo metodo non è stato testato completamente e potrebbe pertanto risultare instabile.

Ecco i passaggi:

1. Scarichi il runtime .NET e il runtime .NET Windows Desktop in formato compresso. Non sono disponibili nella pagina di download di Microsoft, ma devono essere scaricati tramite le release ufficiali del progetto.
2. Estragga gli archivi dei runtime nella stessa directory.
3. Imposti la variabile d'ambiente DOTNET_ROOT in modo che punti alla directory del runtime .NET estratto.
4. Avvii RemoteDesktopManager.exe con la variabile d'ambiente correttamente impostata (dallo stesso terminale/prompt).

Ecco un semplice script per configurarlo automaticamente: occorre fornire solo il runtime .NET, il runtime .NET Windows Desktop e la cartella di destinazione:

function BootstrapPortableRDM {
    <#
    .SYNOPSIS
        Bootstrap a portable installation of RDM 2025.x
    .DESCRIPTION
        You must provide the zipped .NET Runtime and .NET Windows Desktop Runtime. The
        zip releases are not available on the Microsoft download page but can be found
        in the project releases at https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/10.0/releases.json.
        Additionally you must provide the zipped Remote Desktop Manager and a location to
        create the portable package root.
        A launch script will be generated in the packaged `RDM` directory.
    .EXAMPLE
        $PackageRoot=Join-Path $Env:USERPROFILE "portable"
        ./setup-environment.ps1 -DotNetRuntimeArchiveFilePath "dotnet-runtime-10.0.3-win-x64.zip" -DotNetDesktopRuntimeArchiveFilePath "windowsdesktop-runtime-10.0.3-win-x64.zip" -RemoteDesktopManagerArchiveFilePath "Devolutions.RemoteDesktopManager.Bin.2025.1.31.0.zip" -PackageRootDirectory $PackageRoot
        & $(Join-Path $PackageRoot "RDM/launch-rdm.ps1")
    #>
    param(
        [Parameter(Mandatory, HelpMessage="The .NET Runtime .zip archive")]
        [string] $DotNetRuntimeArchiveFilePath,
        [Parameter(Mandatory, HelpMessage="The .NET Windows Desktop Runtime .zip archive")]
        [string] $DotNetDesktopRuntimeArchiveFilePath,
        [Parameter(Mandatory, HelpMessage="The Remote Desktop Manager .zip archive")]
        [string] $RemoteDesktopManagerArchiveFilePath,
        [Parameter(Mandatory, HelpMessage="The root packaging folder")]
        [string] $PackageRootDirectory
    )
    $ErrorActionPreference = "stop"
    $DotNetRuntimeArchiveFilePath = Resolve-Path $DotNetRuntimeArchiveFilePath
    $DotNetDesktopRuntimeArchiveFilePath= Resolve-Path $DotNetDesktopRuntimeArchiveFilePath
    $RemoteDesktopManagerArchiveFilePath= Resolve-Path $RemoteDesktopManagerArchiveFilePath
    New-Item -Path $PackageRootDirectory -Type Directory -Force
    Push-Location $PackageRootDirectory
    Expand-Archive $RemoteDesktopManagerArchiveFilePath -DestinationPath "RDM"
    Expand-Archive $DotNetRuntimeArchiveFilePath -DestinationPath "dotnet"
    Expand-Archive $DotNetDesktopRuntimeArchiveFilePath -DestinationPath "dotnet"
    $LaunchScript = @'
$DotNetRoot = Join-Path $(Get-Item $PSScriptRoot).Parent.FullName "dotnet"
$Env:DOTNET_ROOT=$DotNetRoot
$RdmDir = Join-Path $(Get-Item $PSScriptRoot).Parent.FullName "RDM"
$Rdm = Join-Path $RdmDir "RemoteDesktopManager.exe"
& "$Rdm"
'@
    $LaunchScript | Out-File $(Join-Path RDM "launch-rdm.ps1")
    Pop-Location
}
BootstrapPortableRDM @args