Citrix Virtual Apps and Desktops

Installazione tramite riga di comando

January 23, 2026

Grazie al contributo di:

Importante:

Se si sta eseguendo l’aggiornamento e la versione corrente utilizza o ha installato il software Personal vDisk o AppDisks, consultare Rimozione di PvD, AppDisks e host non supportati.

Citrix raccoglie i dati di licenza di base come necessario per i suoi legittimi interessi, inclusa la conformità delle licenze. Per maggiori informazioni, consultare Dati di licenza Citrix.

Introduzione

Questo articolo si applica all’installazione di componenti su macchine con sistemi operativi Windows. Per informazioni sui VDA per sistemi operativi Linux, consultare Agenti di consegna virtuale Linux.

Questo articolo descrive come emettere i comandi di installazione del prodotto. Prima di iniziare qualsiasi installazione, consultare Preparazione all’installazione. Tale articolo include descrizioni dei programmi di installazione disponibili.

Per visualizzare l’avanzamento dell’esecuzione dei comandi e i valori restituiti, è necessario essere l’amministratore originale o utilizzare Esegui come amministratore. Per maggiori informazioni, consultare la documentazione dei comandi Microsoft.

A complemento dell’utilizzo diretto dei comandi di installazione, sull’ISO del prodotto sono forniti script di esempio che installano, aggiornano o rimuovono i VDA su macchine in Active Directory. Per i dettagli, consultare Installare i VDA utilizzando script.

Se si tenta di installare o aggiornare su una versione del sistema operativo Windows non supportata per questa versione di Citrix Virtual Apps and Desktops, un messaggio guiderà l’utente alle informazioni sulle opzioni disponibili. Consultare Sistemi operativi precedenti.

Per informazioni su come Citrix segnala i risultati delle installazioni dei componenti, consultare Codici di ritorno dell’installazione Citrix.

Utilizzare il programma di installazione completo del prodotto

Per accedere all’interfaccia a riga di comando del programma di installazione completo del prodotto:

Scaricare il pacchetto del prodotto da Citrix. Sono necessarie le credenziali dell’account Citrix per accedere al sito di download.
Decomprimere il file. Facoltativamente, masterizzare un DVD del file ISO.
Accedere al server in cui si stanno installando i componenti, utilizzando un account amministratore locale.
Inserire il DVD nell’unità o montare il file ISO.
Dalla directory \x64\XenDesktop Setup sul supporto, eseguire il comando appropriato.

Per installare i componenti principali: Eseguire XenDesktopServerSetup.exe, con le opzioni elencate in Opzioni della riga di comando per l’installazione dei componenti principali.

Per installare un VDA: Eseguire XenDesktopVDASetup.exe con le opzioni elencate in Opzioni della riga di comando per l’installazione di un VDA.

Per installare StoreFront: Eseguire CitrixStoreFront-x64.exe nella cartella x64 > StoreFront sul supporto di installazione.

Per installare Universal Print Server: Seguire le indicazioni in Opzioni della riga di comando per l’installazione di un Universal Print Server.

Per installare Federated Authentication Service: Citrix consiglia di utilizzare l’interfaccia grafica.

Per installare Session Recording: Seguire le indicazioni in Session Recording.

Per installare Workspace Environment Management: Seguire le indicazioni in Workspace Environment Management.

Per installare Secure Private Access: Eseguire XenDesktopSPASetup.exe nella cartella x64 > XenDesktop Setup sul supporto di installazione. Seguire le indicazioni in Opzioni della riga di comando per l’installazione di Secure Private Access.

Opzioni della riga di comando per l’installazione dei componenti principali

Le seguenti opzioni di parametro sono valide quando si installano i componenti principali con il comando XenDesktopServerSetup.exe. Per maggiori dettagli sulle opzioni, consultare Installare i componenti principali.

Nota:

Non utilizzare /exclude quando si utilizzano le opzioni della riga di comando per l’installazione dei componenti principali.

Se si aggiorna un componente utilizzando /components, anche altri componenti potrebbero essere aggiornati. Questo per evitare potenziali problemi di compatibilità tra i diversi componenti.

Se si desidera aggiornare un solo componente, utilizzare il programma di installazione individuale di tale componente. Consultare Aggiornare una distribuzione.

/ceipoptin ceipoptin [,ceipoptin] …

Abilita la raccolta dei dati Call Home e dei dati del Customer Experience Improvement Program (CEIP). I valori validi sono:
- DIAGNOSTIC: Scegliere questo valore per consentire a Citrix Licensing di raccogliere i dati Call Home.
- ANONYMOUS: Scegliere questo valore per consentire a Citrix Licensing di raccogliere dati CEIP non identificati (che non identificano gli utenti).
- NONE: Scegliere questo valore per disabilitare la raccolta dei dati CEIP da parte di Citrix Licensing.
Per maggiori informazioni sulla raccolta dei dati Call Home, consultare Citrix Licensing Call Home.

Per maggiori dettagli sulla raccolta dei dati CEIP, consultare Citrix Licensing Customer Experience Improvement Program.

Per maggiori dettagli sui dati CEIP, consultare Elementi dati CEIP di Citrix Licensing.

Per maggiori dettagli sui dati di licenza del License Server, consultare Dati di licenza Citrix.
/components component [,component] …

Elenco di componenti separati da virgole da installare o rimuovere. I valori validi sono:
- CONTROLLER: Controller
- DESKTOPSTUDIO: Studio
- WEBSTUDIO: Web Studio
- DESKTOPDIRECTOR: Director
- LICENSESERVER: Citrix License Server
- SECUREPRIVATEACCESS: Secure Private Access
Se questa opzione viene omessa, tutti i componenti vengono installati (o rimossi, se viene specificata anche l’opzione /remove).

(Nelle versioni precedenti al 2003, i valori validi includevano STOREFRONT. Per la versione 2003 e successive, utilizzare il comando di installazione di StoreFront dedicato menzionato in Utilizzare il programma di installazione completo del prodotto).
/configure_firewall

Apre tutte le porte nel firewall di Windows utilizzate dai componenti in fase di installazione, se il servizio Windows Firewall è in esecuzione, anche se il firewall non è abilitato. Se si utilizza un firewall di terze parti o nessun firewall, è necessario aprire manualmente le porte.
/disableexperiencemetrics

Impedisce il caricamento automatico delle analisi raccolte durante l’installazione, l’aggiornamento o la rimozione a Citrix.
/help o /h

Visualizza la guida del comando.
/ignore_hw_check_failure

Consente all’installazione o all’aggiornamento del Delivery Controller di continuare, anche se i controlli hardware falliscono (ad esempio, a causa di RAM insufficiente). Per maggiori informazioni, consultare Controllo hardware.
/ignore_site_test_failure

Valido solo durante l’aggiornamento del Controller. Di solito, eventuali errori di test del sito vengono ignorati e l’aggiornamento procede. Se omesso (o impostato su false), qualsiasi errore di test del sito causa il fallimento del programma di installazione, senza eseguire l’aggiornamento. Predefinito = false

Durante un aggiornamento, questa opzione viene ignorata se viene rilevata una versione di SQL Server non supportata. Per i dettagli, consultare Controllo della versione di SQL Server.
/installdir directory

Directory vuota esistente in cui verranno installati i componenti. Predefinito = c:\Program Files\Citrix.
/logpath path

Posizione del file di log. La cartella specificata deve esistere. Il programma di installazione non la crea. Predefinito = TEMP%\Citrix\XenDesktop Installer
/no_remote_assistance

Valido solo durante l’installazione di Director. Disabilita la funzionalità di shadowing dell’utente che utilizza Assistenza remota di Windows.
/noreboot

Impedisce un riavvio dopo l’installazione. (Per la maggior parte dei componenti principali, un riavvio non è abilitato per impostazione predefinita.)
/noresume

Per impostazione predefinita, quando è necessario un riavvio della macchina durante un’installazione, il programma di installazione riprende automaticamente dopo il completamento del riavvio. Per ignorare l’impostazione predefinita, specificare /noresume. Questo può essere utile se è necessario rimontare il supporto o si desidera acquisire informazioni durante un’installazione automatizzata.
/nosql

Impedisce l’installazione di Microsoft SQL Server Express sul server in cui si sta installando il Controller. Se questa opzione viene omessa, SQL Server Express viene installato per essere utilizzato come database del sito.

Questa opzione non influisce sull’installazione di SQL Server Express LocalDB utilizzato per la cache host locale.
/quiet o /passive

Durante l’installazione non viene visualizzata alcuna interfaccia utente. L’unica prova del processo di installazione si trova in Gestione attività di Windows. Se questa opzione viene omessa, viene avviata l’interfaccia grafica.
/remove

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

Rimuove tutti i componenti principali installati.
/SKIPHDXDRIVERCHECK

Ignora il controllo dei driver HDX™ per il Meta-installer VDA.
/sendexperiencemetrics

Invia automaticamente a Citrix le analisi raccolte durante l’installazione, l’aggiornamento o la rimozione. Se questa opzione viene omessa (o viene specificato /disableexperiencemetrics), le analisi vengono raccolte localmente, ma non inviate automaticamente.
/tempdir directory

Directory che contiene i file temporanei durante l’installazione. Predefinito = c:\Windows\Temp.
/xenapp

Installa Citrix Virtual Apps. Se questa opzione viene omessa, viene installato Citrix Virtual Apps and Desktops™.

Esempi di installazione dei componenti principali

Il seguente comando installa un Delivery Controller™, Studio, Citrix Licensing e SQL Server Express su un server. Le porte del firewall richieste per le comunicazioni dei componenti vengono aperte automaticamente.

\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall

Il seguente comando installa un Controller Citrix Virtual Apps™, Studio e SQL Server Express sul server. Le porte del firewall richieste per la comunicazione dei componenti vengono aperte automaticamente.

\x64\XenDesktop Setup\\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall

Il seguente comando installa un Delivery Controller, Secure Private Access e SQL Server Express su un server. Le porte del firewall richieste per la comunicazione dei componenti vengono aperte automaticamente.

\x64\XenDesktop Setup XenDesktopServerSetup.exe /xenapp /components controller,secureprivateaccess /configure_firewall

Utilizzare un programma di installazione VDA autonomo

Sono necessarie le credenziali dell’account Citrix per accedere al sito di download. È necessario disporre di privilegi amministrativi elevati prima di avviare l’installazione o utilizzare Esegui come amministratore.

Scaricare il pacchetto appropriato da Citrix:
- Agente di consegna virtuale per OS multi-sessione: VDAServerSetup_xxxx.exe
- Agente di consegna virtuale per OS a sessione singola: VDAWorkstationSetup_xxxx.exe
- Agente di consegna virtuale per servizi core OS a sessione singola: VDAWorkstationCoreSetup_xxxx.exe
Estrarre i file dal pacchetto in una directory esistente e quindi eseguire il comando di installazione, oppure semplicemente eseguire il pacchetto.

Per estrarre i file prima di installarli, utilizzare /extract con il percorso assoluto, ad esempio C:\YourExtractFolder\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. La directory deve esistere. In caso contrario, l’estrazione fallisce. 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
Per eseguire il pacchetto scaricato, eseguire il suo nome: VDAServerSetup.exe, VDAWorkstationSetup.exe o VDAWorkstationCoreSetup.exe. Utilizzare le opzioni valide elencate in questo articolo.

Se si ha familiarità con il programma di installazione completo del prodotto:

Eseguire il programma di installazione autonomo VDAServerSetup.exe o VDAWorkstationSetup.exe come se fosse il comando XenDesktopVdaSetup.exe in tutto tranne il suo nome.
Il programma di installazione VDAWorkstationCoreSetup.exe è diverso, perché supporta un sottoinsieme delle opzioni disponibili per gli altri programmi di installazione.

Opzioni della riga di comando per l’installazione di un VDA

Le seguenti opzioni sono valide con uno o più dei seguenti comandi (programmi di installazione): VDAServerSetup_xxxx.exe, VDAWorkstationSetup_xxxx.exe e VDAWorkstationCoreSetup_xxxx.exe.

Per maggiori dettagli sulle opzioni, consultare Installare i VDA.

/components component[,component]

Elenco di componenti separati da virgole da installare o rimuovere. I valori validi sono:
- VDA: Virtual Delivery Agent
- PLUGINS: app Citrix Workspace™ per Windows
Per installare il VDA e l’app Citrix Workspace per Windows, specificare /components vda,plugins o non specificare alcun componente. Se non vengono specificati componenti, per impostazione predefinita verrà installato solo il VDA.

Per installare solo il VDA ed escludere l’installazione dell’app Citrix Workspace, specificare /components vda.

Questa opzione non è valida quando si utilizza il programma di installazione VDAWorkstationCoreSetup_xxxx.exe. Tale programma di installazione non può installare l’app Citrix Workspace.
/controllers “controller [controller]”

FQDN dei Controller separati da spazi con cui il VDA può comunicare, racchiusi tra virgolette diritte. Non specificare entrambe 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 Windows Firewall 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, consultare Porte di rete.

Per aprire le porte UDP utilizzate dal trasporto adattivo HDX, specificare l’opzione /enable_hdx_udp_ports, oltre a questa opzione /enable_hdx_ports.
/enable_hdx_udp_ports

Apre le porte UDP nel firewall di Windows utilizzate dal trasporto adattivo HDX, se il servizio Windows Firewall 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, consultare Porte di rete.

Per aprire porte aggiuntive utilizzate dal VDA, specificare l’opzione /enable_hdx_ports, oltre a questa opzione /enable_hdx_udp_ports.
/enable_hdx_tls_dtls

Apre le porte TCP e UDP 443 per HDX Direct V1.
/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 Windows Firewall.
/enable_remote_assistance

Abilita la funzionalità di shadowing in Assistenza remota di Windows per l’utilizzo con Director. Se si specifica questa opzione, Assistenza remota di Windows apre le porte dinamiche nel firewall.
/enablerestore o /enablerestorecleanup

(Valido solo per VDA a sessione singola) Abilita il ritorno automatico al punto di ripristino, se l’installazione o l’aggiornamento del VDA fallisce.

Se l’installazione/aggiornamento viene completato con successo:
- /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, consultare Ripristino in caso di errore di installazione o aggiornamento.
/enable_ss_ports

Apre le porte nel firewall di Windows richieste per la condivisione dello schermo, se il servizio Windows Firewall viene rilevato, anche se il firewall non è abilitato. Se si utilizza un firewall diverso o nessun firewall, è necessario configurare il firewall manualmente.

/exclude “component”[,”component”]

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 non gestita da MCS non richiede il componente Machine Identity Service. I valori validi sono i seguenti:

OS multi-sessione	OS a sessione singola	Servizi core OS a sessione singola
`Citrix App Protection Component`	`Citrix App Protection Component`	`Citrix App Protection Component`
`Citrix Authentication Identity Assertion VDA Plug-in`	`Citrix Authentication Identity Assertion VDA Plug-in`	`Citrix Authentication Identity Assertion VDA Plug-in`
`Citrix Backup and Restore`	`Citrix Backup and Restore`
`Citrix Browser Content Redirection`	`Citrix Browser Content Redirection`	`Citrix Browser Content Redirection`
`Citrix HyperV Filter Driver`	`Citrix HyperV Filter Driver`
`Citrix MCS IODriver`	`Citrix MCS IODriver`
`Citrix Personalization for App-V - VDA`	`Citrix Personalization for App-V - VDA`	`Citrix Personalization for App-V - VDA`
`Citrix Profile Management`	`Citrix Profile Management`
`Citrix Profile Management WMI Plug-in`	`Citrix Profile Management WMI Plug-in`
`Citrix Rendezvous V2`	`Citrix Rendezvous V2`
`Citrix Telemetry Service`	`Citrix Telemetry Service`	`Citrix Telemetry Service`
`Citrix Universal Print Client`	`Citrix Universal Print Client`	`Citrix Universal Print Client`
`Citrix Vda Log Capture Service`	`Citrix Vda Log Capture Service`	`Citrix Vda Log Capture Service`
`Citrix VDA Upgrade Agent`	`Citrix VDA Upgrade Agent`
`CSE Component`	`CSE Component`	`CSE Component`
`Director VDA Plug-in`	`Director VDA Plug-in`	`Director VDA Plug-in`
`Machine Identity Service`	`Machine Identity Service`
`Machine Management Provider`	`Machine Management Provider`	`Machine Management Provider`
	`User Personalization Layer`
`VDA Monitor Plug-in`	`VDA Monitor Plug-in`	`VDA Monitor Plug-in`
`VDA WMI Proxy Plug-in`	`VDA WMI Proxy Plug-in`	`VDA WMI Proxy Plug-in`

L’esclusione di Citrix Profile Management dall’installazione (/exclude "Citrix Profile Management") influisce sul monitoraggio e sulla risoluzione dei problemi dei VDA con Citrix Director. Nelle pagine Dettagli utente ed EndPoint, il pannello Personalizzazione e il pannello Durata accesso non funzionano. Nelle pagine Dashboard e Tendenze, il pannello Durata accesso media visualizza i dati solo per le macchine che hanno Profile Management installato.

Anche se si utilizza una soluzione di gestione dei profili utente di terze parti, Citrix consiglia di installare ed eseguire il servizio Citrix Profile Management. L’abilitazione del servizio Citrix Profile Management non è richiesta.

Se si specificano sia /exclude che /includeadditional con lo stesso nome di componente, tale 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 “component”[,”component”]

Include l’installazione di uno o più componenti opzionali separati da virgole, ciascuno racchiuso tra virgolette diritte. Questa opzione può essere utile quando si crea una distribuzione Remote PC Access e si desidera installare altri componenti non inclusi per impostazione predefinita. I valori validi sono i seguenti:

OS multi-sessione	OS a sessione singola
`Citrix Backup and Restore`	`Citrix Backup and Restore`
`Citrix MCS IODriver`	`Citrix MCS IODriver`
`Citrix Personalization for App-V - VDA`	`Citrix Personalization for App-V - VDA`
`Citrix Profile Management`	`Citrix Profile Management`
`Citrix Profile Management WMI Plug-in`	`Citrix Profile Management WMI Plug-in`
`Citrix Rendezvous V2`	`Citrix Rendezvous V2`
`Citrix VDA Upgrade Agent`	`Citrix VDA Upgrade Agent`
`Citrix Web Socket Vda Registration Tool`	`Citrix Web Socket Vda Registration Tool`
`Machine Identity Service`	`Machine Identity Service`
	`User Personalization Layer`

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. Predefinito = c:\Program Files\Citrix.
/install_mcsio_driver

Non utilizzare. Utilizzare invece /includeadditional "Citrix MCS IODriver" o /exclude "Citrix MCS IODriver"
/logpath path

Posizione del file di log. La cartella specificata deve esistere. Il programma di installazione non la crea. 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 da utilizzare per creare altre macchine. Questa opzione è equivalente a /mastermcsimage.

Questa opzione non è valida quando si utilizza il programma di installazione VDAWorkstationCoreSetup_xxxx.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 (come Microsoft System Center Configuration Manager) per il provisioning delle VM.
/websockettoken WebSocketToken

Crea un VDA Web Socket. Il WebSocketToken è per il token richiesto.
/no_mediafoundation_ack

Riconosce che Microsoft Media Foundation non è installato e che diverse funzionalità multimediali HDX non verranno installate e non funzioneranno. Se questa opzione viene omessa e Media Foundation non è installato, l’installazione del VDA viene interrotta poiché le precondizioni non sono soddisfatte. La maggior parte delle edizioni di Windows supportate include Media Foundation già installato, ad eccezione delle edizioni N. Se si abilitano le funzionalità di Windows > Funzionalità multimediali manualmente, la chiave di registro cercata dal Citrix Meta Installer potrebbe non avere un valore impostato. Controllare la chiave di registro SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersion prima di avviare il processo di installazione per confermare che il valore esiste e non è vuoto.
/nodesktopexperience

La funzionalità Esperienza desktop avanzata non è più disponibile. Questa opzione (e l’impostazione dei criteri) viene ignorata, se specificata.

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

Impedisce un riavvio dopo l’installazione. Il VDA non può essere utilizzato fino a dopo un riavvio.
/noresume

Per impostazione predefinita, quando è necessario un riavvio della macchina durante un’installazione, il programma di installazione riprende automaticamente dopo il completamento del riavvio. Per ignorare l’impostazione predefinita, specificare /noresume. Questo può essere utile se è necessario rimontare il supporto o si desidera acquisire informazioni durante un’installazione automatizzata.
/physicalmachine

Utilizzare questo argomento insieme a /remotepc per l’installazione di RemotePC. In caso contrario, il VDA potrebbe non comportarsi come previsto in determinati scenari utente.
/portnumber port

Valido solo quando viene 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”

Se si prevede di utilizzare il protocollo Rendezvous V2 con un servizio come Gateway Service nel proprio ambiente e si dispone di un proxy non trasparente nella propria rete per le connessioni in uscita, specificare il proxy qui. Sono supportati solo i proxy HTTP. L’indirizzo o il percorso del file PAC del proxy da utilizzare con il protocollo Rendezvous. Per i dettagli sulle funzionalità, consultare Protocollo Rendezvous.
- Formato indirizzo proxy: http://<url-or-ip>:<port>
- Formato file PAC: http://<url-or-ip>:<port>/<path>/<filename>.pac
/quiet o /passive

Durante l’installazione non viene visualizzata alcuna interfaccia utente. L’unica prova del processo di installazione e configurazione si trova in Gestione attività di Windows. Se questa opzione viene omessa, viene avviata l’interfaccia grafica.
/reconfigure

Personalizza le impostazioni VDA configurate in precedenza quando utilizzata 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 distribuzioni Remote PC Access (OS a sessione singola) o connessioni mediate (OS multi-sessione). Esclude l’installazione di eventuali componenti aggiuntivi (vedere gli elenchi di componenti con le opzioni /exclude e /includeadditional).

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

/remotepc non è compatibile con l’opzione /servervdi.
/remove

Rimuove i componenti specificati con l’opzione /components.
/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.
/removeall

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

Rimuove CWA insieme al VDA.
/sendexperiencemetrics

Invia automaticamente a Citrix le analisi raccolte durante l’installazione, l’aggiornamento o la rimozione. Se questa opzione viene omessa (o viene specificata l’opzione /disableexperiencemetrics), le analisi vengono raccolte localmente, ma non inviate automaticamente.
/servervdi

Installa un VDA per OS a sessione singola su una macchina Windows multi-sessione supportata. Omettere questa opzione quando si installa un VDA per OS multi-sessione su una macchina Windows multi-sessione.

Prima di utilizzare questa opzione, consultare Server VDI.

Utilizzare questa opzione solo con il programma di installazione VDA completo del prodotto.
/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 entrambe le opzioni /site_guid e /controllers.
/tempdir directory

Directory per contenere 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 di installazione di un VDA

Installare un VDA con il programma di installazione completo del prodotto:

Il seguente comando installa un VDA per OS a sessione singola e l’app Citrix Workspace nella posizione predefinita su una VM. Questo VDA verrà utilizzato come immagine e utilizzerà MCS per il provisioning delle VM. Il VDA si registrerà inizialmente con il Controller sul server denominato Contr-Main nel dominio mydomain. Il VDA utilizzerà il livello di personalizzazione utente e Assistenza remota di Windows.

\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /includeadditional "user personalization layer" /mastermcsimage /enable_remote_assistance

Installare un VDA per OS a sessione singola con il programma di installazione autonomo VDAWorkstationCoreSetup:

Il seguente comando installa un VDA per servizi core su un OS a sessione singola per l’utilizzo in una distribuzione Remote PC Access o VDI. L’app Citrix Workspace e altri servizi non core non vengono installati. Viene specificato l’indirizzo di un Controller e le porte nel servizio Windows Firewall verranno aperte automaticamente. L’amministratore gestirà i riavvii.

VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot

Personalizzare un VDA

Dopo aver installato un VDA, è possibile personalizzare diverse impostazioni. Dalla directory \x64\XenDesktop Setup sul supporto del prodotto, eseguire XenDesktopVdaSetup.exe, utilizzando una o più delle seguenti opzioni, descritte in Opzioni della riga di comando per l’installazione di un VDA.

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

Risoluzione dei problemi dei VDA

Nella visualizzazione di Studio per un gruppo di consegna, la voce Versione VDA installata nel riquadro Dettagli potrebbe non essere la versione installata sulle macchine. La visualizzazione Programmi e funzionalità di Windows della macchina mostra la versione VDA effettiva.
Dopo l’installazione di un VDA, non può fornire app o un desktop agli utenti finché non si registra con un Delivery Controller.

Per informazioni sui metodi di registrazione VDA e su come risolvere i problemi di registrazione, consultare Registrazione VDA.

Opzioni della riga di comando per l’installazione di un Universal Print Server

La seguente opzione è valida con il comando XenDesktopPrintServerSetup.exe.

/enable_upsserver_port

Quando questa opzione non è specificata, il programma di installazione visualizza la pagina Firewall dall’interfaccia grafica. Selezionare Automaticamente per consentire al programma di installazione di aggiungere automaticamente le regole del firewall di Windows, oppure Manualmente per consentire all’amministratore di configurare manualmente il firewall.

Dopo aver installato il software sui server di stampa, configurare Universal Print Server utilizzando le indicazioni in Provisioning delle stampanti.

Opzioni della riga di comando per l’installazione di Secure Private Access

Le seguenti opzioni sono valide con:

Programma di installazione CVAD: XenDesktopSPASetup.exe
Programma di installazione SPA on-prem: SecurePrivateAccessSetup_XXXX.exe

/enable_spa_ports

Apre le porte nel firewall di Windows richieste da Secure Private Access, se il servizio Windows Firewall 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, consultare Porte di rete.
/nosql

Impedisce l’installazione di Microsoft SQL Server Express sul server in cui si sta installando Secure Private Access. Se questa opzione viene omessa, SQL Server Express viene installato per essere utilizzato come database del sito.
/help o /h o /?

Visualizza la guida del comando
/noreboot

Impedisce un riavvio dopo l’installazione. Secure Private Access non può essere utilizzato fino a dopo un riavvio.
/quiet o /passive

Durante l’installazione non viene visualizzata alcuna interfaccia utente. L’unica prova del processo di installazione e configurazione si trova in Gestione attività di Windows. Se questa opzione viene omessa, viene avviata l’interfaccia grafica.
/remove

Rimuove Secure Private Access.

Per maggiori dettagli sulle opzioni, consultare Programma di installazione di Secure Private Access.

Maggiori informazioni

Per informazioni su come Citrix segnala il risultato delle installazioni dei componenti, consultare Codici di ritorno dell’installazione Citrix.

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?

Installazione tramite riga di comando

January 23, 2026

Grazie al contributo di:

January 23, 2026

Grazie al contributo di:

In questo articolo

Introduzione
Utilizzare il programma di installazione completo del prodotto
Opzioni della riga di comando per l’installazione dei componenti principali
Esempi di installazione dei componenti principali
Utilizzare un programma di installazione VDA autonomo
Opzioni della riga di comando per l’installazione di un VDA
Esempi di installazione di un VDA
Personalizzare un VDA
Risoluzione dei problemi dei VDA
Opzioni della riga di comando per l’installazione di un Universal Print Server
Opzioni della riga di comando per l’installazione di Secure Private Access
Maggiori informazioni

È stato utile?