Distribuire Devolutions Agent in modo silenzioso

Il programma di installazione di Devolutions Agent è un pacchetto standard di Windows Installer (MSI). Può essere installato in modo silenzioso dalla riga di comando, tramite PowerShell o tramite qualsiasi strumento di distribuzione software (Microsoft Intune, Configuration Manager, criteri di gruppo, piattaforme RMM e così via).

Durante un'installazione silenziosa, scelga quali componenti di Devolutions Agent vengono installati con la proprietà MSI standard ADDLOCAL. È utile quando si distribuisce Devolutions Agent su molti computer, ad esempio per sostituire l'agente RDM Jump deprecato con Devolutions Agent sui jump host, oppure per escludere componenti che non servono in un determinato ambiente.

Prerequisiti

• Un computer Windows con diritti di amministratore locale (o uno strumento di distribuzione in esecuzione come SYSTEM).
• .NET Framework 4.8 o versione successiva.
• Il file MSI di Devolutions Agent per l'architettura di destinazione, x64 o arm64 (ad esempio DevolutionsAgent-2026.3.0-x64.msi).

Il programma di installazione non consente i downgrade. Se è già installata una versione più recente, l'installazione non riesce con il codice di uscita 1603.

Componenti del programma di installazione

Ogni componente del programma di installazione corrisponde a un ID di funzionalità. Usi questi ID in ADDLOCAL (per installare) o REMOVE (per rimuovere). Gli ID di funzionalità rispettano la distinzione tra maiuscole e minuscole.

ID funzionalità	Nome nel programma di installazione	Predefinito	Descrizione
F.Agent	Devolutions Agent	Installato (obbligatorio)	Installa il servizio Devolutions Agent. Sempre obbligatorio. Elemento padre di F.Updater, F.Tunnel e F.PsuAgent.
F.Session	RDP Extension	Installato	Abilita funzionalità di sessione RDP come l'esecuzione remota, le sessioni jump e la disconnessione remota. Obbligatorio quando il computer è usato come jump host.
F.Updater	Devolutions Gateway Updater	Installato	Il modulo di aggiornamento di Devolutions Agent. Gestisce gli aggiornamenti di Devolutions Gateway e di Devolutions Cloud Services, nonché l'aggiornamento automatico di Devolutions Agent. Senza di esso, Devolutions Agent non può aggiornarsi. Non aggiunge un carico apprezzabile, quindi si consiglia di mantenerlo.
F.Tunnel	Agent Tunnel	Non installato	Connette Devolutions Agent a un Devolutions Gateway. Un'installazione silenziosa con questo componente non riesce se non vengono passate proprietà aggiuntive, come la stringa di registrazione dell'operatore del gateway. Non trattato in questo articolo. Consulti Agent tunnel.
F.PsuAgent	PowerShell Universal Agent	Non installato	Abilita l'agent remoto di PowerShell Universal. Sperimentale. Un'installazione silenziosa con questo componente non riesce se non vengono passate proprietà aggiuntive, come l'URL e il token di PowerShell Universal. Non trattato in questo articolo.
F.Pedm	Devolutions PEDM	Non installato	Abilita le funzionalità PEDM e installa l'estensione della shell. Sperimentale.

Se esegue un'installazione silenziosa senza ADDLOCAL, vengono installati i componenti predefiniti: Devolutions Agent, RDP Extension e Devolutions Gateway Updater.

Installazione silenziosa

Componenti predefiniti

Per installare Devolutions Agent con i componenti predefiniti, esegua il comando seguente da un prompt con privilegi elevati:

msiexec /i "DevolutionsAgent-2026.3.0-x64.msi" /qn /norestart /l*v "C:\Windows\Temp\DevolutionsAgent_install.log"

Opzione	Scopo
/i	Installare o aggiornare il pacchetto.
/qn	Nessuna interfaccia utente (silenziosa).
/norestart	Non riavviare il computer automaticamente.
/l*v <path>	Scrivere un registro di installazione dettagliato. Consigliato per la risoluzione dei problemi.

Componenti selezionati

Per scegliere i componenti, passi ADDLOCAL con un elenco di ID di funzionalità separati da virgole. F.Agent deve essere sempre incluso. Qualsiasi componente non elencato non viene installato.

L'esempio seguente è una configurazione tipica per un jump host. Installa Devolutions Agent con RDP Extension e il modulo di aggiornamento.

msiexec /i "DevolutionsAgent-2026.3.0-x64.msi" /qn /norestart ADDLOCAL="F.Agent,F.Updater,F.Session" /l*v "C:\Windows\Temp\DevolutionsAgent_install.log"

L'esempio seguente installa Devolutions Agent con RDP Extension, senza il modulo di aggiornamento. Lo utilizzi solo se la sua organizzazione non vuole che Devolutions Agent aggiorni se stesso o altri componenti Devolutions.

msiexec /i "DevolutionsAgent-2026.3.0-x64.msi" /qn /norestart ADDLOCAL="F.Agent,F.Session" /l*v "C:\Windows\Temp\DevolutionsAgent_install.log"

Senza F.Updater, Devolutions Agent non può aggiornarsi. Gli aggiornamenti devono quindi essere distribuiti con i propri strumenti.

Non aggiunga F.Tunnel o F.PsuAgent a ADDLOCAL senza le proprietà richieste. In caso contrario, l'installazione silenziosa non riesce.

Aggiornare un'installazione esistente

Quando si installa una versione più recente su una esistente senza ADDLOCAL, il programma di installazione mantiene i componenti già installati.

Quando si passa ADDLOCAL, il programma di installazione usa l'elenco indicato al posto di quello precedente. Lo stesso comando può quindi essere usato per le nuove installazioni e per gli aggiornamenti. Ad esempio, l'aggiornamento con ADDLOCAL="F.Agent,F.Session" rimuove il modulo di aggiornamento (F.Updater) se era stato installato in precedenza.

Passi sempre ADDLOCAL nel pacchetto di distribuzione. In questo modo ogni computer avrà gli stessi componenti, indipendentemente da ciò che era installato in precedenza.

Rimuovere un componente da un Devolutions Agent installato

Per rimuovere un componente da un Devolutions Agent installato, esegua il file MSI della versione installata. Elenchi i componenti che mantiene in ADDLOCAL e quelli che rimuove in REMOVE:

msiexec /i "DevolutionsAgent-2026.3.0-x64.msi" /qn /norestart ADDLOCAL="F.Agent,F.Session" REMOVE="F.Updater"

Non usi REMOVE da solo. Ad esempio, REMOVE="F.Updater" da solo disattiva anche RDP Extension. Questo ha effetto solo dopo il successivo riavvio del servizio o il riavvio del computer, quindi il problema non è subito visibile.

Script di distribuzione PowerShell

Lo script seguente può essere usato così com'è oppure come comando di installazione di uno strumento di distribuzione. Installa o aggiorna Devolutions Agent, controlla il codice di uscita e indica quali componenti sono abilitati.

# Deploy-DevolutionsAgent.ps1
# Installs or updates Devolutions Agent silently with the selected components.
# Run as administrator (or as SYSTEM through your deployment tool).

$msi      = "\\fileserver\share\DevolutionsAgent-2026.3.0-x64.msi"
$features = "F.Agent,F.Updater,F.Session"   # Agent service + update module + RDP Extension
$log      = "C:\Windows\Temp\DevolutionsAgent_install.log"

$arguments = "/i `"$msi`" /qn /norestart ADDLOCAL=`"$features`" /l*v `"$log`""
$process = Start-Process -FilePath "msiexec.exe" -ArgumentList $arguments -Wait -PassThru

if ($process.ExitCode -notin 0, 1641, 3010) {
    Write-Error "Devolutions Agent installation failed (exit code $($process.ExitCode)). See $log"
    exit $process.ExitCode
}

# Verify which components are enabled
$config = Get-Content "C:\ProgramData\Devolutions\Agent\agent.json" -Raw | ConvertFrom-Json
Write-Output "Service status          : $((Get-Service DevolutionsAgent).Status)"
Write-Output "RDP Extension enabled   : $($config.Session.Enabled)"
Write-Output "Update module enabled   : $($config.Updater.Enabled)"

exit $process.ExitCode

Per distribuire su più computer da una workstation di gestione con la comunicazione remota di PowerShell abilitata:

$computers = Get-Content "C:\Deploy\computers.txt"
$msiShare  = "\\fileserver\share\DevolutionsAgent-2026.3.0-x64.msi"

Invoke-Command -ComputerName $computers -ArgumentList $msiShare -ScriptBlock {
    param($source)
    $local = "C:\Windows\Temp\DevolutionsAgent.msi"
    Copy-Item $source $local -Force
    $arguments = "/i `"$local`" /qn /norestart ADDLOCAL=`"F.Agent,F.Updater,F.Session`" /l*v C:\Windows\Temp\DevolutionsAgent_install.log"
    $p = Start-Process msiexec.exe -ArgumentList $arguments -Wait -PassThru
    [pscustomobject]@{ Computer = $env:COMPUTERNAME; ExitCode = $p.ExitCode }
}

La copia da una condivisione di rete all'interno di una sessione remota può non riuscire a causa della delega delle credenziali (double hop). In tal caso, copi prima il file MSI nei computer di destinazione oppure lasci che lo distribuisca lo strumento di distribuzione.

Codici di uscita

Codice di uscita	Significato
0	Installazione riuscita.
3010	Installazione riuscita. È necessario un riavvio per completarla.
1641	Installazione riuscita ed è stato avviato un riavvio.
1603	Errore irreversibile durante l'installazione. Controlli il registro dettagliato. Questo è anche il codice restituito quando è già installata una versione più recente (il registro mostra "A newer version of this product is already installed.").
1618	È in corso un'altra installazione. Riprovi più tardi.

Verificare l'installazione

• Verifichi che il servizio Devolutions Agent sia in esecuzione con Get-Service DevolutionsAgent.
• Apra C:\ProgramData\Devolutions\Agent\agent.json. Il programma di installazione scrive un valore Enabled per ogni componente facoltativo. Ad esempio, con ADDLOCAL="F.Agent,F.Session", Session mostra "Enabled": true e Updater mostra "Enabled": false.
• Se qualcosa non sembra corretto, apra il registro di installazione dettagliato (il file /l*v). Elenca ogni funzionalità e il relativo stato di installazione.

Dopo l'installazione

Non è necessario riavviare né disconnettersi dopo l'installazione di Devolutions Agent.

La comunicazione tra Remote Desktop Manager e Devolutions Agent avviene tramite la connessione RDP e questo canale viene configurato quando viene stabilita la connessione RDP. Se Devolutions Agent viene installato mentre è aperta una sessione RDP verso quel computer, chiuda la sessione RDP e la riapra. Le nuove connessioni RDP effettuate dopo l'installazione funzionano subito.

Le sessioni jump, la disconnessione remota e l'esecuzione remota richiedono RDP Extension (F.Session). Lo includa in ADDLOCAL su ogni computer in cui vengono usate queste funzionalità.

Disinstallazione silenziosa

Per disinstallare Devolutions Agent in modo silenzioso, cerchi il codice prodotto ed esegua msiexec /x:

$app = Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*" |
    Where-Object { $_.DisplayName -eq "Devolutions Agent" }

$arguments = "/x $($app.PSChildName) /qn /norestart /l*v C:\Windows\Temp\DevolutionsAgent_uninstall.log"
Start-Process msiexec.exe -ArgumentList $arguments -Wait

La disinstallazione non rimuove C:\ProgramData\Devolutions\Agent (incluso agent.json) né la chiave del Registro di sistema HKLM\SOFTWARE\Devolutions\Agent. Li elimini manualmente se serve uno stato pulito, ad esempio prima di una reinstallazione da zero.

Vedere anche

• Jump host
• Devolutions Blog – Sostituire RDM Agent con Devolutions Agent