Citrix Virtual Apps and Desktops

Installazione tramite riga di comando

January 23, 2026

Grazie al contributo di:

Importante:

Se si sta eseguendo un 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 Linux Virtual Delivery Agents.

Questo articolo descrive come eseguire i comandi di installazione del prodotto. Prima di iniziare qualsiasi installazione, consultare Prepararsi all’installazione. Tale articolo include le 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. Vedere 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 un 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. Vedere 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 componente [,componente] …

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

Per installare solo il VDA ed escludere l’installazione di altri componenti Citrix, 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 o altri componenti Citrix.

Se questa opzione viene omessa, tutti i componenti vengono installati (o rimossi, se viene specificata anche l’opzione /remove).

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

/onlyprereqs

Verranno installati solo i prerequisiti per i componenti selezionati. Nessun componente del prodotto Citrix verrà installato.
/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.
/precheckonly

Esegue tutti i controlli preliminari e genera i risultati dei controlli preliminari senza avviare l’installazione o l’aggiornamento.
/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 fa sì che il programma di installazione fallisca, senza eseguire l’aggiornamento. Valore 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 esistente e vuota in cui verranno installati i componenti. Valore predefinito = c:\Program Files\Citrix.
/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
/no_remote_assistance

Valido solo durante l’installazione di Director. Disabilita la funzione di shadowing 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 automatica.
/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 Local Host Cache.
/quiet o /passive

Nessuna interfaccia utente viene visualizzata durante l’installazione. L’unica prova del processo di installazione è 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.
/sendexperiencemetrics

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

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

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

Esegue tutti i controlli preliminari e genera i risultati dei controlli preliminari senza avviare l’installazione o l’aggiornamento.

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

Se si esegue l’aggiornamento da Citrix Virtual Apps and Desktops versione 2407 alla 2411 o successiva, o si esegue una nuova installazione della versione 2411 o successiva, aggiornare il License Server all’ultima versione (versione 11.2.17 build 51000) come primo passaggio. Quindi, aggiornare il Delivery Controller. In caso contrario, le installazioni e gli aggiornamenti da riga di comando falliranno. Eseguire i seguenti comandi per aggiornare il License Server e i componenti come Delivery Controller, Web Studio e Citrix Director (supponendo di essere all’interno della cartella \x64 nell’ISO montata).

Eseguire quanto segue:

\x64\Licensing\CitrixLicensing.exe /quiet
<!--NeedCopy-->

Se sono stati copiati i binari di Licensing su una delle unità locali, eseguire il seguente comando:

\x64\Licensing\CitrixLicensing.exe /quiet /l install.log
<!--NeedCopy-->

Eseguire quanto segue:

\x64\XenDesktop Setup\XenDesktopServerSetup.exe  /components "CONTROLLER,DESKTOPSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL
<!--NeedCopy-->

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:
- Virtual Delivery Agent per OS multi-sessione: VDAServerSetup_xxxx.exe
- Virtual Delivery Agent per OS single-sessione: VDAWorkstationSetup_xxxx.exe
- Virtual Delivery Agent per servizi core di OS single-sessione: 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 <cartella di estrazione>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe
- Per VDAWorkstationCoreSetup_XXXX.exe, eseguire <cartella di estrazione>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe
- Per VDAWorkstationSetup_XXXX.exe, eseguire <cartella di estrazione>\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.

Elenco di componenti separati da virgole da installare o rimuovere. I valori validi sono:

VDA: Virtual Delivery Agent
CSA: Citrix Secure Access™ Client
PLUGINS: app Citrix Workspace™ per Windows
UPL: Citrix User Personalization Layer

Per installare il VDA e l’app Citrix Workspace per Windows, specificare /components vda,plugins o non specificare alcun componente.

A partire da questa versione, Citrix Device Trust, Citrix uberAgent e Citrix Workspace Environment Management™ (WEM) Agent sono integrati nell’installazione predefinita del VDA. Questi componenti vengono installati silenziosamente come parte della configurazione del VDA e non sono più gestiti come componenti separati.

Nota:

Se nell’ambiente viene rilevata una versione autonoma esistente di Citrix uberAgent®, non verrà installata, aggiornata o disinstallata dal programma di installazione.

Per installare solo il VDA ed escludere l’installazione di altri componenti Citrix, specificare /components vda.

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 componente[,componente]

Elenco di componenti separati da virgole da installare o rimuovere. I valori validi sono:
- VDA: Virtual Delivery Agent
- PLUGINS: app Citrix Workspace per Windows
- CSA: Citrix Secure Access Client
- UPL: Citrix User Personalization Layer

Per installare il VDA e l’app Citrix Workspace per Windows, specificare /components vda, plugins, CSA, UPL 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.

/onlyprereqs

Verranno installati solo i prerequisiti per i componenti selezionati. Nessun componente del prodotto Citrix verrà installato.
/controllers “controller [controller]”

FQDN dei Controller separati da spazi con cui il VDA può comunicare, racchiusi tra virgolette diritte. Non specificare sia le opzioni /site_guid che /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 manualmente il firewall. 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 manualmente il firewall. 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 funzione 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 funzione di shadowing in Assistenza remota di Windows per l’uso con Director. Se si specifica questa opzione, Assistenza remota di Windows apre le porte dinamiche nel firewall.
/enablerestore o /enablerestorecleanup

(Valido solo per VDA single-sessione) 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 istruisce il programma di installazione a rimuovere il punto di ripristino.
- /enablerestore istruisce il programma di installazione a mantenere il punto di ripristino, anche se non è stato utilizzato.
Per i dettagli, consultare Ripristino in caso di errore di installazione o aggiornamento.
/ENABLE_SECURE_DEFAULTS

Modifica l’impostazione predefinita per varie funzionalità da abilitata a disabilitata per una configurazione più sicura pronta all’uso. Le funzionalità pertinenti sono: reindirizzamento unità client, reindirizzamento cartelle speciali, trascinamento della selezione, reindirizzamento dispositivo TWAIN client, reindirizzamento dispositivo USB Plug and Play client, reindirizzamento stampante client, reindirizzamento appunti client e reindirizzamento microfono client.
/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 manualmente il firewall.
/SKIPHDXDRIVERCHECK

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

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

OS multi-sessione	OS single-sessione	Servizi core OS single-sessione
`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 deviceTRUST`	`Citrix deviceTRUST`	`Citrix deviceTRUST`
`uberAgent`	`uberAgent`	`uberAgent`
`Citrix Secure Access Client`	`Citrix Secure Access Client`	`Citrix Secure Access Client`
`Citrix Workspace Environment Management Agent`	`Citrix Workspace Environment Management Agent`	`Citrix Workspace Environment Management Agent`
`Citrix Browser Content Redirection`	`Citrix Browser Content Redirection`	`Citrix Personalization for App-V - VDA`
`Citrix MCS IODriver`	`Citrix MCS IODriver`	`Citrix Telemetry Service`
`Citrix Personalization for App-V - VDA`	`Citrix Personalization for App-V - VDA`	`Citrix Universal Print Client`
`Citrix Profile Management`	`Citrix Profile Management`	`Citrix Vda Log Capture Service`
`Citrix Profile Management WMI Plug-in`	`Citrix Profile Management WMI Plug-in`	`CSE Component`
`Citrix Rendezvous V2`	`Citrix Rendezvous V2`	`Director VDA Plug-in`
`Citrix Telemetry Service`	`Citrix Telemetry Service`	`Machine Management Provider`
`Citrix Universal Print Client`	`Citrix Universal Print Client`	`VDA Monitor Plug-in`
`Citrix Vda Log Capture Service`	`Citrix Vda Log Capture Service`	`VDA WMI Proxy Plug-in`
`Citrix VDA Upgrade Agent`	`Citrix VDA Upgrade Agent`
`CSE Component`	`CSE Component`
`Director VDA Plug-in`	`Director VDA Plug-in`
`Machine Identity Service`	`Machine Identity Service`
`Machine Management Provider`	`Machine Management Provider`
`VDA Monitor Plug-in`	`User Personalization Layer`
`VDA WMI Proxy Plug-in`	`VDA WMI Proxy Plug-in`
	`VDA WMI Proxy Plug-in`
`Citrix App Protection Component`	`Citrix App Protection Component`	`Citrix App Protection Component`
`Citrix HyperV Filter Driver`	`Citrix HyperV Filter Driver`
`Citrix Personalization for App-V - VDA`	`Citrix Personalization for App-V - VDA`	`Citrix Personalization for App-V - VDA`

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 falliscono. 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 è obbligatoria.

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 “componente”[,”componente”]

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 single-sessione
`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 esistente e vuota 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 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 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.
/websockettokenfile FileContainingWebSockToken

Crea un VDA Web Socket. Il FileContainingWebSockToken è per il file che contiene il token richiesto.
/websockettokenstdin <WebSocketToken

Crea un VDA Web Socket. Il <WebSocketToken è per il token richiesto che viene passato tramite STDIN.
/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 viene fornita con 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à Enhanced Desktop Experience 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à Enhanced Desktop Experience. Questa funzionalità è controllata anche dall’impostazione dei criteri Citrix Enhanced Desktop Experience.
/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 automatica.
/physicalmachine

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

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 servizi come Gateway Service nel proprio ambiente e si dispone di un proxy non trasparente nella propria rete per le connessioni in uscita, specificare qui il proxy. Sono supportati solo i proxy HTTP. L’indirizzo o il percorso del file PAC del proxy da utilizzare con il protocollo Rendezvous. Questa riga di comando installa automaticamente Citrix Rendezvous V2 come se fosse stato utilizzato /includeadditional “Citrix Rendezvous V2”. Per i dettagli sulle funzionalità, consultare Protocollo Rendezvous.
- Formato indirizzo proxy: http://<url-o-ip>:<porta>
- Formato file PAC: http://<url-o-ip>:<porta>/<percorso>/<nomefile>.pac
/quiet o /passive

Nessuna interfaccia utente viene visualizzata durante l’installazione. L’unica prova del processo di installazione e configurazione è in Gestione attività di Windows. Se questa opzione viene omessa, viene avviata l’interfaccia grafica.
/reconfigure

Personalizza le impostazioni VDA configurate in precedenza se utilizzate 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 Remote PC Access (OS single-sessione) o le 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 del VDA a disinstallare il plug-in VDA di AppDisks™ se è installato.
/remove_pvd_ack

Autorizza il programma di installazione del 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 le analisi raccolte durante l’installazione, l’aggiornamento o la rimozione a Citrix. 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 single-sessione 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 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 sia le opzioni /site_guid che /controllers.
/tempdir directory

Directory per contenere i file temporanei durante l’installazione. Valore 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 single-sessione 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 single-sessione con il programma di installazione autonomo VDAWorkstationCoreSetup:

Il seguente comando installa un VDA Core Services su un OS single-sessione per l’uso 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 (obbligatorio quando si personalizza un VDA)
/h o /help
/quiet
/noreboot
/controllers
/portnumber porta
/enable_hdx_ports

Risoluzione dei problemi dei VDA

Nella visualizzazione 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 effettiva del VDA.
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 del 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 fare in modo che il programma di installazione aggiunga automaticamente le regole del firewall di Windows, o 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 Citrix Universal Print Server (UPS).

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

Le seguenti opzioni sono valide con entrambi:

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 manualmente il firewall. 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

Nessuna interfaccia utente viene visualizzata durante l’installazione. L’unica prova del processo di installazione e configurazione è 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 un Secure Private Access
Maggiori informazioni

È stato utile?