Installare i VDA dalla riga di comando
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 del VDA. Prima di iniziare un’installazione, consultare Installare i VDA per informazioni sulle considerazioni sull’installazione, sugli installer e su cosa specificare 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.
- Sulla macchina in cui si sta installando il VDA, accedere a Citrix Cloud.
- Nel menu in alto a sinistra, selezionare Solutions > DaaS.
- In alto a destra, fare clic su Downloads e selezionare Download VDA. Si verrà reindirizzati alla pagina di download del VDA. Trovare l’installer VDA desiderato e fare clic su Download File.
-
Una volta completato il download, eseguire il file. 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 single-sessione, eseguire
VDAWorkstationSetup.exe -
Per il Virtual Delivery Agent dei servizi core del sistema operativo single-sessione, 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 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
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
pluginsviene omessa, viene installato solo il VDA (non l’app Citrix Workspace).Questa opzione non è valida quando si utilizza l’installer
VDAWorkstationCoreSetup.exe. Tale installer non può installare l’app Citrix Workspace. -
-
/controllers “controller [controller]…”
FQDN dei Citrix Cloud Connector con cui il VDA può comunicare, separati da spazi e racchiusi tra virgolette. Non specificare contemporaneamente le opzioni
/site_guide/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 richieste dal trasporto adattivo HDX, 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 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 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_portsse 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 le funzioni di Monitor. 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 ripristino automatico al punto di ripristino, se l’installazione o l’aggiornamento del VDA fallisce.
Se l’installazione/aggiornamento viene completato con successo:
-
/enablerestorecleanupindica all’installer di rimuovere il punto di ripristino. -
/enablerestoreindica all’installer 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 “componente”[,”componente”]
Impedisce l’installazione di uno o più componenti opzionali separati da virgole, ciascuno racchiuso tra virgolette. 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 che hanno Profile Management installato.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 il Machine Identity Service.
Se si specificano sia
/excludeche/includeadditionalcon lo stesso nome di componente, il componente non viene installato.Questa opzione non è valida quando si utilizza l’installer
VDAWorkstationCoreSetup.exe. Tale installer 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. 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
/excludeche/includeadditionalcon lo stesso nome di componente, tale componente non viene installato. -
/installdir directory
Directory esistente e vuota 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 percorso
Posizione del file di log. La cartella specificata deve esistere. L’installer 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. Questa opzione è equivalente a
/mastermcsimage.Questa opzione non è valida quando si utilizza l’installer
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 uno strumento di provisioning di terze parti (come 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 sistema operativo 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 prima di un riavvio.
-
/noresume
Per impostazione predefinita, quando è necessario un riavvio della macchina durante un’installazione, l’installer riprende automaticamente dopo il completamento 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 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”
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à, consultare Protocollo Rendezvous.- Formato indirizzo proxy:
http://<url-o-ip>:<porta> - Formato file PAC:
http://<url-o-ip>:<porta>/<percorso>/<nomefile>.pac
- Formato indirizzo proxy:
-
/quiet o /passive
Nessuna interfaccia utente appare durante l’installazione. 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 se utilizzato con le opzioni
/portnumber,/controllerso/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 (sistema operativo single-sessione) o le connessioni mediate (sistema operativo multi-sessione).
Questa opzione non è valida quando si utilizza l’installer
VDAWorkstationCoreSetup.exe. Tale installer esclude automaticamente l’installazione di questi componenti. -
/remove_appdisk_ack
Autorizza l’installer VDA a disinstallare il plug-in VDA di AppDisks™ se è installato.
-
/remove_pvd_ack
Autorizza l’installer 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 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 sistema operativo single-sessione su un server Windows supportato. Omettere questa opzione quando si installa un VDA multi-sessione su un server Windows. Prima di utilizzare questa opzione, consultare Server VDI.
-
/site_guid guid
Globally Unique Identifier dell’unità organizzativa (OU) di Active Directory del sito. Questo associa un desktop virtuale a un sito quando si utilizza Active Directory per la rilevazione (l’aggiornamento automatico è il metodo di rilevazione consigliato e predefinito). Il GUID del sito è una proprietà del sito visualizzata in Studio. Non specificare contemporaneamente le opzioni
/site_guide/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 dell’installer 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 multi-sessione. Il seguente comando installa un VDA su un sistema operativo multi-sessione.
VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimageIl VDA verrà utilizzato come immagine.
-
Installare un VDA per sistema operativo multi-sessione o un VDA per sistema operativo single-sessione. Il seguente comando installa un VDA per sistema operativo multi-sessione o un VDA per sistema operativo single-sessione.
VDAServerSetup_XXXX.exe /quiet /controllers "ddc1.abc.com","ddc2.abc.com" /enable_hdx_ports /enable_Remote_Assistance /enable_real_time_transport /enable_ss_ports /norebootSeparare ogni FQDN del delivery controller™ con una virgola. Si noti che
XXXXrappresenta la versione del VDA. -
Installare un VDA Core Services su un sistema operativo single-sessione. Il seguente comando installa un VDA Core Services su un sistema operativo single-sessione per l’utilizzo in una distribuzione Remote PC Access o VDA.
VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /norebootL’app Citrix Workspace e altri servizi non core 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) -
/ho/help /quiet/noreboot/controllers/portnumber porta/enable_hdx_ports
Passaggi successivi
-
Per rivedere l’intero processo di configurazione, consultare Pianificare e creare una distribuzione.