Installare i VDA utilizzando la riga di comando
Introduzione
Questo articolo si applica all’installazione, all’aggiornamento e alla personalizzazione di Virtual Delivery Agent (VDA) su macchine con sistemi operativi Windows.
In questo articolo viene descritto come emettere i comandi di installazione VDA. Prima di iniziare un’installazione, consultare Installare i VDA per considerazioni sull’installazione, i programmi di installazione e le informazioni da specificare durante l’installazione.
Installare un VDA dalla riga di comando
Per installare un VDA (e vedere l’avanzamento dell’esecuzione dei comandi e i valori restituiti), è necessario disporre di autorizzazioni amministrative elevate o utilizzare Run as administrator (Esegui come amministratore).
- Sulla macchina su cui si sta installando il VDA, accedere a Citrix Cloud.
- Nel menu in alto a sinistra, selezionare My Services > DaaS (I miei servizi > DaaS).
- In alto a destra, fare clic su Downloads (Download) e selezionare Download VDA (Scarica VDA). Si viene reindirizzati alla pagina di download VDA. Trovare il programma di installazione VDA desiderato e fare clic su Download File (Scarica file).
-
Al termine del download, eseguirlo. Utilizzare le opzioni descritte in questo articolo.
-
Per Virtual Delivery Agent con sistema operativo multisessione, eseguire
VDAServerSetup.exe -
Per Virtual Delivery Agent con sistema operativo a sessione singola, eseguire
VDAWorkstationSetup.exe -
Per Core Services Virtual Delivery Agent per 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 andrà a buon fine). 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ù comandi: VDAServerSetup.exe, VDAWorkstationSetup.exe e VDAWorkstationCoreSetup.exe.
-
/componenti componente[,componente]
Elenco separato da virgole di componenti 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, 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 il programma di installazione
VDAWorkstationCoreSetup.exe. Tale programma di installazione non può installare l’app Citrix Workspace. -
-
/controllers “controller [*controller*]…”
Nomi di dominio completi separati da spazi dei connettori Citrix Cloud con cui il VDA può comunicare, racchiusi tra virgolette diritte. Non specificare entrambe le opzioni
/site_guide/controllers. -
/disableexperiencemetrics
Impedisce l’invio automatico a Citrix delle analisi raccolte durante l’installazione, l’aggiornamento o la rimozione.
-
/enable_hdx_ports
Apre le porte del firewall di Windows richieste dal VDA e dalle funzionalità abilitate (ad eccezione di Assistenza remota di Windows), se viene rilevato il servizio Windows Firewall, anche se il firewall non è abilitato. Se si utilizza un firewall diverso o nessun firewall, è necessario configurare manualmente il firewall. Per informazioni sulle porte, vedere Porte di rete.
Per aprire le porte UDP utilizzate 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 del firewall di Windows utilizzate dal trasporto adattivo HDX, se viene rilevato il servizio Windows Firewall, anche se il firewall non è abilitato. Se si utilizza un firewall diverso o nessun firewall, è necessario configurare manualmente il firewall. 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 audio). L’attivazione di questa funzione 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 utilizzarla con le funzioni Monitor (Monitoraggio). Se si specifica questa opzione, Assistenza remota di Windows apre le porte dinamiche del 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 non vanno a buon fine.
Se l’installazione/aggiornamento viene completato correttamente:
-
/enablerestorecleanupindica al programma di installazione di rimuovere il punto di ripristino. -
/enablerestoreindica al programma di installazione di mantenere il punto di ripristino, anche se non è stato utilizzato.
Per ulteriori informazioni, vedere Ripristino in caso di errore di installazione o aggiornamento.
-
-
/enable_ss_ports
Apre le porte del firewall Windows necessarie per la condivisione dello schermo, se viene rilevato il servizio Windows Firewall, anche se il firewall non è abilitato. Se si utilizza un firewall diverso o nessun firewall, è necessario configurare manualmente il firewall.
-
/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 richiede il componente Machine Identity Service. I valori validi sono:
- Machine Identity Service
- Citrix Profile Management:
- Plug-in WMI Citrix Profile Management
- Personalizzazione Citrix per App-V - VDA
- Strumenti di supportabilità Citrix
- Citrix MCS IODriver
- Agente di aggiornamento Citrix VDA
- 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 scheda Monitor (Monitoraggio). Nelle pagine User details (Dettagli utente) ed EndPoint, i pannelli Personalization e Logon Duration riportano errori. Nelle pagine Dashboard e Trends (Trend), il pannello Average Logon Duration (Durata media dell’accesso) visualizza i dati solo per le macchine su cui è installato Profile Management.Anche se si utilizza una soluzione di gestione dei profili di terze parti, Citrix consiglia di installare ed eseguire Citrix Profile Management Service. L’attivazione del servizio Citrix Profile Management non è necessaria.
Se si prevede di utilizzare MCS per il provisioning delle macchine virtuali, non escludere il servizio di identità della macchina.
Se si specificano sia
/excludeche/includeadditionalcon 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 dei comandi.
-
/includeadditional “component”[,”component”] …
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ò risultare utile quando si crea una distribuzione di Accesso remoto PC e si desidera installare altri componenti non inclusi per impostazione predefinita. I valori validi sono:
- Citrix Profile Management:
- Plug-in WMI Citrix Profile Management
- Personalizzazione Citrix per App-V - VDA
- Strumenti di supportabilità Citrix
- Citrix MCS IODriver
- Agente di aggiornamento Citrix VDA
- Citrix Rendezvous V2
- Livello di personalizzazione utente
- Strumento di registrazione Citrix Web Socket VDA
Se si specificano entrambi
/excludee/includeadditionalcon lo stesso nome di componente, tale componente non viene installato. -
/installdir directory
Directory vuota esistente in cui verranno installati i componenti. Impostazione predefinita= c:\Programmi\Citrix.
-
/install_mcsio_driver
Non utilizzare. Utilizzare invece
/includeadditional "Citrix MCS IODriver"o/exclude "Citrix MCS IODriver" -
/logpath percorso
Percorso del file di registro. La cartella specificata deve esistere. Il programma di installazione non la crea. Impostazione predefinita= “%TEMP%\Citrix\XenDesktop Installer”
Questa opzione non è disponibile nell’interfaccia grafica.
-
/masterimage
Valido solo quando si installa un VDA in una macchina virtuale. Imposta 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 la macchina verrà utilizzata come immagine con Citrix Provisioning o 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 diverse funzionalità multimediali HDX non sono installate e non funzionano. Se questa opzione viene omessa e Media Foundation non è installato, l’installazione del VDA non riesce. La maggior parte delle edizioni di Windows supportate ha Media Foundation già installato, ad eccezione delle edizioni N.
-
/nodesktopexperience
Valida solo quando si installa un VDA con sistema operativo multisessione. Impedisce l’attivazione della funzionalità Enhanced desktop experience. Questa funzione è inoltre controllata con l’impostazione dei criteri Enhanced Desktop Experience Citrix.
-
/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 al termine del riavvio. Per ignorare il valore predefinito, specificare
/noresume. Ciò può risultare utile se è necessario rimontare il supporto o 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 è disabilitata, a meno che non sia la porta 80. -
/proxyconfig “indirizzo o percorso del 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 dettagli delle funzionalità, vedere Protocollo Rendezvous.- Formato dell’indirizzo proxy:
http://<url-or-ip>:<port> - Formato del file PAC:
http://<url-or-ip>:<port>/<path>/<filename>.pac
- Formato dell’indirizzo proxy:
-
/quiet o /passive
Durante l’installazione non viene visualizzata alcuna interfaccia utente. L’unica prova del processo di installazione e configurazione è in Task Manager di Windows. Se questa opzione viene omessa, viene avviata l’interfaccia grafica.
-
/reconfigure
Consente di personalizzare le impostazioni del VDA configurate in precedenza se utilizzate 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 di Accesso remoto PC (sistema operativo a sessione singola) o per le connessioni mediate (sistema operativo multisessione).
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 del 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 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 con sistema operativo a sessione singola su un server Windows supportato. Omettere questa opzione quando si installa un VDA multisessione su un server Windows. Prima di utilizzare questa opzione, vedere VDI del server.
-
/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 l’individuazione (l’aggiornamento automatico è il metodo di individuazione consigliato e predefinito). Il GUID del sito è una proprietà del sito visualizzata in Manage > Full Configuration (Gestione > Configurazione completa). Non specificare entrambe le opzioni
/site_guide/controllers. -
/tempdir directory
Directory in cui contenere i file temporanei durante l’installazione. Impostazione predefinita= c:\Windows\Temp.
Questa opzione non è disponibile nell’interfaccia grafica.
-
/virtualmachine
Valido solo quando si installa un VDA in una macchina virtuale. Sovrascrive l’individuazione da parte del programma di installazione di una macchina fisica, in cui le informazioni del BIOS passate alle macchine virtuali le fanno apparire come macchine fisiche.
Questa opzione non è disponibile nell’interfaccia grafica.
-
/xendesktopcloud
Indica che il VDA è installato in una distribuzione di Citrix DaaS (Citrix Cloud).
Esempi: installare un VDA
-
Installare un VDA su un sistema operativo multisessione. Il seguente comando installa un VDA su un sistema operativo multisessione.
VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimageIl VDA verrà utilizzato come immagine.
-
Installare un VDA per sistema operativo multisessione o un VDA per sistema operativo a sessione singola. Il comando seguente installa un VDA per sistema operativo multisessione o un VDA per sistema operativo a sessione singola.
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 uno dall’altro i nomi di dominio completi di tutti i controller di consegna con una virgola. Notare che
XXXXrappresenta la versione del VDA. -
Installare un Core Services VDA su un sistema operativo a sessione singola. Il comando seguente installa un VDA di Core Services in un sistema operativo a sessione singola per l’utilizzo in una distribuzione VDA o Accesso remoto PC.
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 del servizio Windows Firewall vengono aperte automaticamente. L’amministratore gestisce i riavvii.
Personalizzare un VDA utilizzando la riga di comando
Dopo aver installato un VDA, è possibile personalizzare diverse impostazioni. Eseguire XenDesktopVDASetup.exe utilizzando una o più delle seguenti opzioni.
-
/reconfigure(necessario per la personalizzazione di un VDA) -
/ho/help /quiet/noreboot/controllers/portnumber port/enable_hdx_ports
Passaggi successivi
-
Per esaminare l’intero processo di configurazione, vedere Pianificare e creare una distribuzione.