Citrix DaaS™

Installare i VDA tramite riga di comando

May 4, 2026

Grazie al contributo di:

C C

Introduzione

Questo articolo si applica all’installazione, all’aggiornamento e alla personalizzazione dei Virtual Delivery Agent (VDA) su macchine con sistemi operativi Windows.

Questo articolo descrive come emettere i comandi di installazione VDA. Prima di iniziare un’installazione, consultare Installare i VDA per informazioni sulle considerazioni sull’installazione, sui programmi di installazione e su ciò che si specifica durante l’installazione.

Installare un VDA dalla riga di comando

-  Per installare un VDA (e visualizzare l'avanzamento dell'esecuzione del comando e i valori restituiti), è necessario disporre di autorizzazioni amministrative elevate o utilizzare **Esegui come amministratore**.

-  1.  Sulla macchina in cui si sta installando il VDA, accedere a [Citrix Cloud](https://citrix.cloud.com).

Nel menu in alto a sinistra, selezionare Soluzioni > DaaS.
- 1. Nella parte in alto a destra, fare clic su Download e selezionare Scarica VDA. Si verrà reindirizzati alla pagina di download del VDA. Trovare il programma di installazione VDA desiderato e fare clic su Scarica file.

1. Al termine del download, eseguire il file scaricato. Utilizzare le opzioni descritte in questo articolo.
- Per il Virtual Delivery Agent del sistema operativo multi-sessione, eseguire VDAServerSetup.exe
- Per il Virtual Delivery Agent del sistema operativo a sessione singola, eseguire VDAWorkstationSetup.exe
- Per il Virtual Delivery Agent dei servizi core del sistema operativo a sessione singola, eseguire VDAWorkstationCoreSetup.exe

Per estrarre i file prima di installarli, utilizzare /extract con il percorso assoluto, ad esempio .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. (La directory deve esistere. In caso contrario, l’estrazione non riesce.) Quindi, in un comando separato, eseguire il comando appropriato, utilizzando le opzioni valide elencate in questo articolo.

-  Per `VDAServerSetup_XXXX.exe`, eseguire `<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe`

-  Per `VDAWorkstationCoreSetup_XXXX.exe`, eseguire `<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe`

Per VDAWorkstationSetup_XXXX.exe, eseguire <extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe

Opzioni della riga di comando per installare un VDA

Le seguenti opzioni sono valide con uno o più dei comandi: VDAServerSetup.exe, VDAWorkstationSetup.exe e VDAWorkstationCoreSetup.exe.
/components componente[,componente]

Elenco di componenti da installare o rimuovere, separati da virgole. I valori validi sono:
- VDA: Virtual Delivery Agent
- PLUGINS: app Citrix Workspace™ per Windows
- Per installare il VDA e l’app Citrix Workspace, specificare /components vda,plugins.
Se l’opzione plugins viene omessa, viene installato solo il VDA (non l’app Citrix Workspace).

Questa opzione non è valida quando si utilizza il programma di installazione VDAWorkstationCoreSetup.exe. Tale programma di installazione non può installare l’app Citrix Workspace.
/controllers “controller [controller]…”
- FQDN dei Citrix Cloud Connector separati da spazi con cui il VDA può comunicare, racchiusi tra virgolette diritte. Non specificare contemporaneamente le opzioni /site_guid e /controllers.
- /disableexperiencemetrics
- Impedisce il caricamento automatico delle analisi raccolte durante l’installazione, l’aggiornamento o la rimozione a Citrix.
/enable_hdx_ports

Apre le porte nel firewall di Windows richieste dal VDA e dalle funzionalità abilitate (eccetto Assistenza remota di Windows), se il servizio Firewall di Windows viene rilevato, anche se il firewall non è abilitato. Se si utilizza un firewall diverso o nessun firewall, è necessario configurare il firewall manualmente. Per informazioni sulle porte, vedere Porte di rete.

Per aprire le porte UDP che il trasporto adattivo HDX richiede, specificare l’opzione /enable_hdx_udp_ports, oltre all’opzione /enable_hdx_ports.
- /enable_hdx_udp_ports
Apre le porte UDP nel firewall di Windows richieste dal trasporto adattivo HDX, se il servizio Firewall di Windows viene rilevato, anche se il firewall non è abilitato. Se si utilizza un firewall diverso o nessun firewall, è necessario configurare il firewall manualmente. Per informazioni sulle porte, vedere Porte di rete.
- Per aprire le porte utilizzate dal VDA, specificare l’opzione /enable_hdx_ports, oltre all’opzione /enable_hdx_udp_ports.
- /enable_real_time_transport
- Abilita o disabilita l’uso di UDP per i pacchetti audio (RealTime Audio Transport per l’audio). L’abilitazione di questa funzionalità può migliorare le prestazioni audio. Includere l’opzione /enable_hdx_ports se si desidera che le porte UDP vengano aperte automaticamente quando viene rilevato il servizio Firewall di Windows.
- /enable_remote_assistance
Abilita la funzionalità di shadowing in Assistenza remota di Windows per l’uso con le funzioni di Monitoraggio. Se si specifica questa opzione, Assistenza remota di Windows apre le porte dinamiche nel firewall.
- /enablerestore o /enablerestorecleanup
(Valido solo per i VDA a sessione singola) Abilita il ritorno automatico al punto di ripristino, se l’installazione o l’aggiornamento del VDA non riesce.

Se l’installazione/aggiornamento viene completato correttamente:
- /enablerestorecleanup indica al programma di installazione di rimuovere il punto di ripristino.
- /enablerestore indica al programma di installazione di mantenere il punto di ripristino, anche se non è stato utilizzato.
Per i dettagli, vedere Ripristino in caso di errore di installazione o aggiornamento.
- /enable_ss_ports
- Apre le porte nel Firewall di Windows necessarie per la condivisione dello schermo, se il servizio Firewall di Windows viene rilevato, anche se il firewall non è abilitato. Se si utilizza un firewall diverso o nessun firewall, è necessario configurare il firewall manualmente.
- /exclude “componente”[,”componente”]
- Impedisce l’installazione di uno o più componenti opzionali separati da virgole, ciascuno racchiuso tra virgolette diritte. Ad esempio, l’installazione o l’aggiornamento di un VDA su un’immagine gestita da MCS richiede il componente Machine Identity Service. I valori validi sono:
- Machine Identity Service
- Citrix Profile Management
- Citrix Profile Management WMI Plug-in
- Citrix Personalization for App-V - VDA
- Citrix MCS IODriver
- Citrix VDA Upgrade Agent
- Citrix Rendezvous V2
L’esclusione di Citrix Profile Management dall’installazione (/exclude "Citrix Profile Management") influisce sul monitoraggio e sulla risoluzione dei problemi dei VDA dalla console Monitor. Nelle pagine User details (Dettagli utente) ed EndPoint, il pannello Personalization (Personalizzazione) e il pannello Logon Duration (Durata accesso) non funzionano. Nelle pagine Dashboard e Trends (Tendenze), il pannello Average Logon Duration (Durata media accesso) visualizza i dati solo per le macchine su cui è installato Profile Management.
Anche se si utilizza una soluzione di Profile Management di terze parti, Citrix consiglia di installare ed eseguire il servizio Citrix Profile Management. L’abilitazione del servizio Citrix Profile Management non è obbligatoria.
Se si prevede di utilizzare MCS per il provisioning delle VM, non escludere Machine Identity Service.

Se si specificano sia /exclude che /includeadditional con lo stesso nome di componente, il componente non viene installato.

Questa opzione non è valida quando si utilizza il programma di installazione VDAWorkstationCoreSetup.exe. Tale programma di installazione esclude automaticamente molti di questi elementi.
/h o /help

Visualizza la guida del comando.
/includeadditional “componente”[,”componente”] …

Include l’installazione di uno o più componenti opzionali separati da virgole, ciascuno racchiuso tra virgolette diritte. I nomi dei componenti fanno distinzione tra maiuscole e minuscole.

Questa opzione può essere utile quando si crea una distribuzione Remote PC Access e si desidera installare componenti che non sono inclusi per impostazione predefinita. I valori validi sono:
- Citrix Profile Management
- Citrix Profile Management WMI Plug-in
- Citrix Personalization for App-V - VDA
- Citrix MCS IODriver
- Citrix VDA Upgrade Agent
- Citrix Rendezvous V2
- User personalization layer
- Citrix Web Socket VDA Registration Tool
Se si specificano sia /exclude che /includeadditional con lo stesso nome di componente, tale componente non viene installato.
/installdir directory
Directory vuota esistente in cui verranno installati i componenti. Valore predefinito = c:\Program Files\Citrix.
/install_mcsio_driver

Non utilizzare. Utilizzare invece /includeadditional "Citrix MCS IODriver" o /exclude "Citrix MCS IODriver".
/logpath percorso
Posizione del file di log. La cartella specificata deve esistere. Il programma di installazione non la crea. Valore predefinito = “%TEMP%\Citrix\XenDesktop Installer”
Questa opzione non è disponibile nell’interfaccia grafica.
/masterimage
Valido solo quando si installa un VDA su una VM. Configura il VDA come immagine. Questa opzione è equivalente a /mastermcsimage.
Questa opzione non è valida quando si utilizza il programma di installazione VDAWorkstationCoreSetup.exe.
/mastermcsimage

Specifica che questa macchina verrà utilizzata come immagine con Machine Creation Services. Questa opzione è equivalente a /masterimage.
/masterpvsimage

Specifica che questa macchina verrà utilizzata come immagine con Citrix Provisioning™ o con uno strumento di provisioning di terze parti (ad esempio Microsoft System Center Configuration Manager).
/no_mediafoundation_ack

Riconosce che Microsoft Media Foundation non è installato e che diverse funzionalità multimediali HDX™ non sono installate e non funzionano. Se questa opzione viene omessa e Media Foundation non è installato, l’installazione del VDA fallisce. La maggior parte delle edizioni di Windows supportate include Media Foundation già installato, ad eccezione delle edizioni N.
/nodesktopexperience

Valido solo quando si installa un VDA per OS multi-sessione. Impedisce l’abilitazione della funzionalità Enhanced Desktop Experience. Questa funzionalità è controllata anche dall’impostazione dei criteri Citrix Enhanced Desktop Experience.
/noreboot

Impedisce il riavvio dopo l’installazione. Il VDA non può essere utilizzato prima di un riavvio.
/noresume

Per impostazione predefinita, quando è necessario un riavvio della macchina durante un’installazione, il programma di installazione riprende automaticamente al termine del riavvio. Per ignorare l’impostazione predefinita, specificare /noresume. Ciò può essere utile se è necessario rimontare il supporto o si desidera acquisire informazioni durante un’installazione automatica.
/portnumber porta

Valido solo quando è specificata l’opzione /reconfig. Numero di porta da abilitare per le comunicazioni tra il VDA e il Controller. La porta configurata in precedenza viene disabilitata, a meno che non sia la porta 80.
/proxyconfig “indirizzo o percorso file PAC”

Valido solo se il comando contiene /includeadditional "Citrix Rendezvous V2". L’indirizzo o il percorso del file PAC del proxy da utilizzare con il protocollo Rendezvous. Per i dettagli sulle funzionalità, vedere protocollo Rendezvous.
- Formato indirizzo proxy: http://<url-o-ip>:<porta>
- Formato file PAC: http://<url-o-ip>:<porta>/<percorso>/<nomefile>.pac
/quiet o /passive

Durante l’installazione non viene visualizzata alcuna interfaccia utente. L’unica prova del processo di installazione e configurazione è in Windows Task Manager. Se questa opzione viene omessa, viene avviata l’interfaccia grafica.
/reconfigure

Personalizza le impostazioni VDA configurate in precedenza se utilizzato con le opzioni /portnumber, /controllers o /enable_hdx_ports. Se si specifica questa opzione senza specificare anche l’opzione /quiet, viene avviata l’interfaccia grafica per la personalizzazione del VDA.
/remotepc

Valido solo per le distribuzioni di accesso remoto al PC (sistema operativo a sessione singola) o per le connessioni mediate (sistema operativo a sessione multipla).

Questa opzione non è valida quando si utilizza il programma di installazione VDAWorkstationCoreSetup.exe. Tale programma di installazione esclude automaticamente l’installazione di questi componenti.
/remove_appdisk_ack

Autorizza il programma di installazione VDA a disinstallare il plug-in VDA AppDisks™ se è installato.
/remove_pvd_ack

Autorizza il programma di installazione VDA a disinstallare Personal vDisk se è installato.
/remove

Rimuove i componenti specificati con l’opzione /components.
/removeall

Rimuove il VDA. Non rimuove l’app Citrix Workspace (se installata).
/sendexperiencemetrics

Invia automaticamente a Citrix i dati analitici raccolti durante l’installazione, l’aggiornamento o la rimozione. Se questa opzione viene omessa (o viene specificata l’opzione /disableexperiencemetrics), i dati analitici vengono raccolti localmente, ma non inviati automaticamente.
/servervdi

Installa un VDA per sistema operativo a sessione singola su un server Windows supportato. Omettere questa opzione quando si installa un VDA a sessione multipla su un server Windows. Prima di utilizzare questa opzione, consultare Server VDI.
/site_guid guid

Identificatore univoco globale (GUID) dell’unità organizzativa (OU) di Active Directory del sito. Questo associa un desktop virtuale a un sito quando si utilizza Active Directory per il rilevamento (l’aggiornamento automatico è il metodo di rilevamento consigliato e predefinito). Il GUID del sito è una proprietà del sito visualizzata in Studio. Non specificare contemporaneamente le opzioni /site_guid e /controllers.
/tempdir directory

Directory in cui archiviare i file temporanei durante l’installazione. Predefinito = c:\Windows\Temp.

Questa opzione non è disponibile nell’interfaccia grafica.
/virtualmachine

Valido solo quando si installa un VDA su una VM. Ignora il rilevamento da parte del programma di installazione di una macchina fisica, dove le informazioni del BIOS passate alle VM le fanno apparire come macchine fisiche.

Questa opzione non è disponibile nell’interfaccia grafica.
/xendesktopcloud

Indica che il VDA è installato in una distribuzione Citrix DaaS (Citrix Cloud™).

Esempi: Installare un VDA

Installare un VDA su un sistema operativo a sessione multipla. Il comando seguente installa un VDA su un sistema operativo a sessione multipla.

[[CODE_BLOCK_0]]

Il VDA verrà utilizzato come immagine.
Installare un VDA per sistema operativo a sessione multipla o un VDA per sistema operativo a sessione singola. Il comando seguente installa un VDA per sistema operativo a sessione multipla o un VDA per sistema operativo a sessione singola.

[[CODE_BLOCK_1]]

Separare ogni FQDN del delivery controller™ con una virgola. Si noti che XXXX rappresenta la versione del VDA.
Installare un VDA per servizi di base su un sistema operativo a sessione singola. Il comando seguente installa un VDA per servizi di base su un sistema operativo a sessione singola da utilizzare in una distribuzione di accesso remoto al PC o VDA.

[[CODE_BLOCK_2]]

L’app Citrix Workspace e altri servizi non di base non vengono installati. Viene specificato l’indirizzo di un Cloud Connector e le porte nel servizio Windows Firewall vengono aperte automaticamente. L’amministratore gestisce i riavvii.

Personalizzare un VDA dalla riga di comando

Dopo aver installato un VDA, è possibile personalizzare diverse impostazioni. Eseguire XenDesktopVDASetup.exe, utilizzando una o più delle seguenti opzioni.

/reconfigure (obbligatorio quando si personalizza un VDA)
/h o /help
/quiet
/noreboot
/controllers
/portnumber port
/enable_hdx_ports

Dove andare dopo

Creare cataloghi di macchine
Per rivedere l’intero processo di configurazione, consultare Pianificare e creare una distribuzione.

La versione ufficiale di questo contenuto è in inglese. Per alcuni dei contenuti della documentazione Cloud Software Group è stata impiegata la traduzione automatica solo per comodità. Cloud Software Group non ha alcun controllo sui contenuti tradotti in modo automatico, che possono contenere errori, imprecisioni o linguaggio inadatto. Non viene offerta alcuna garanzia di alcun tipo, espressa o implicita, circa l'accuratezza, l'affidabilità, l'idoneità o la correttezza di qualsiasi traduzione dall'originale inglese in qualsiasi altra lingua, o che il prodotto o servizio Cloud Software Group sia conforme a qualsiasi contenuto in traduzione automatica, e qualsiasi garanzia fornita ai sensi del contratto di licenza per l'utente finale applicabile o i termini di servizio, o qualsiasi altro accordo con Cloud Software Group che il prodotto o il servizio sia conforme a qualsiasi documentazione non si applicheranno nella misura in cui tale documentazione sia in traduzione automatica. Cloud Software Group non sarà ritenuta responsabile per eventuali danni o problemi che potrebbero derivare dall'utilizzo di contenuti per cui si è impiegata la traduzione automatica.

È stato utile?

Installare i VDA tramite riga di comando

May 4, 2026

Grazie al contributo di:

C C

May 4, 2026

Grazie al contributo di:

C C

In questo articolo

Introduzione
Installare un VDA dalla riga di comando
Opzioni della riga di comando per installare un VDA
Esempi: Installare un VDA
Personalizzare un VDA dalla riga di comando
Dove andare dopo

È stato utile?