Installare VDA utilizzando la riga di comando
Introduzione
Questo articolo riguarda l’installazione, l’aggiornamento e la personalizzazione dei Virtual Delivery Agent (VDA) su computer con sistemi operativi Windows.
Questo articolo descrive come inviare comandi di installazione VDA. Prima di iniziare un’installazione, rivedere Installa VDA per informazioni sulle considerazioni relative all’installazione, sui programmi di installazione e su cosa specificare durante l’installazione.
Installare un VDA dalla riga di comando
Per installare un VDA (e visualizzare l’avanzamento dell’esecuzione dei comandi e i valori restituiti), è necessario disporre di autorizzazioni amministrative elevate oppure utilizzare Esegui come amministratore.
- Sul computer su cui stai installando il VDA, accedi a Citrix Cloud.
- Nel menu in alto a sinistra, seleziona I miei servizi > DaaS.
- In alto a destra, clicca su Download e seleziona Download VDA. Verrai reindirizzato alla pagina di download VDA . Trova il programma di installazione VDA che desideri e fai clic su Scarica file.
-
Una volta completato il download, esegui il relativo nome. Utilizzare le opzioni descritte in questo articolo.
-
Per l’agente di distribuzione virtuale del sistema operativo multisessione, eseguire
VDAServerSetup.exe
-
Per l’agente di consegna virtuale del sistema operativo a sessione singola, eseguire
VDAWorkstationSetup.exe
-
Per l’agente di distribuzione virtuale dei servizi core del sistema operativo a sessione singola, eseguire
VDAWorkstationCoreSetup.exe
-
Per estrarre i file prima di installarli, utilizzare /extract
con il percorso assoluto, ad esempio .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia
. (La directory deve esistere. Altrimenti 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ù comandi: VDAServerSetup.exe
, VDAWorkstationSetup.exe
e VDAWorkstationCoreSetup.exe
.
-
/componenti componente[,componente]
Elenco separato da virgole dei componenti da installare o rimuovere. I valori validi sono:
-
VDA: Agente di consegna virtuale
-
PLUGIN: App Citrix Workspace per Windows
Per installare l’app VDA e Citrix Workspace, specificare
/components vda,plugins
.Se si omette l’opzione
plugins
, verrà installato solo VDA (non l’app Citrix Workspace).Questa opzione non è valida se si utilizza il programma di installazione
VDAWorkstationCoreSetup.exe
. Quel programma di installazione non riesce a installare l’app Citrix Workspace. -
-
/controllori “controllore [controllore]…”
FQDN separati da spazi dei Citrix Cloud Connector con cui la VDA può comunicare, racchiusi tra virgolette dritte. Non specificare entrambe le opzioni
/site_guid
e/controllers
. -
/disabilitare le metriche dell’esperienza
Impedisce il caricamento automatico su Citrix delle analisi raccolte durante l’installazione, l’aggiornamento o la rimozione.
-
/abilita_porte_hdx
Apre le porte nel firewall di Windows richieste da 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 non esiste alcun firewall, è necessario configurare il firewall manualmente. Per informazioni sulle porte, vedere Porte di rete.
Per aprire le porte UDP per il trasporto adattivo HDX, specificare l’opzione
/enable_hdx_udp_ports
, oltre all’opzione/enable_hdx_ports
. -
/abilita_porte_udp_hdx
Apre le porte UDP nel firewall di Windows richieste dal trasporto adattivo HDX, se viene rilevato il servizio Windows Firewall, anche se il firewall non è abilitato. Se si utilizza un firewall diverso o non esiste alcun firewall, è necessario configurare il firewall manualmente. Per informazioni sulle porte, vedere Porte di rete.
Per aprire le porte utilizzate dal VDA, specificare l’opzione
/enable_hdx_ports
, oltre all’opzione/enable_hdx_udp_ports
. -
/abilita_trasporto_in\tempo\reale
Abilita o disabilita l’uso di UDP per i pacchetti audio (RealTime Audio Transport per l’audio). L’attivazione 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. -
/abilita_assistenza_remota
Abilita la funzionalità di shadowing in Assistenza remota di Windows per l’utilizzo con le funzioni Monitor ** . 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 VDA non riesce.
Se l’installazione/aggiornamento viene completato correttamente:
-
/enablerestorecleanup
indica al programma di installazione di rimuovere il punto di ripristino. -
/enablerestore
indica al programma di installazione di conservare il punto di ripristino, anche se non è stato utilizzato.
Per maggiori dettagli, vedere Ripristino in caso di errore di installazione o aggiornamento.
-
-
/abilita_ss_porte
Apre le porte nel firewall di 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 non esiste alcun firewall, è necessario configurare il firewall manualmente.
-
/escludi “componente”[,”componente”]
Impedisce l’installazione di uno o più componenti facoltativi separati da virgole, ciascuno racchiuso tra virgolette dritte. 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:
- Servizio di identità della macchina
- Gestione dei profili Citrix
- Plug-in WMI per la gestione dei profili Citrix
- Personalizzazione Citrix per App-V - VDA
- Driver Citrix MCS IO
- 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 console Monitor . Nelle pagine Dettagli utente e EndPoint , il pannello Personalizzazione e il pannello Durata accesso non funzionano. Nelle pagine Dashboard e Trends , il pannello Durata media di accesso visualizza i dati solo per i computer su cui è installata la Gestione profili.Anche se si utilizza una soluzione di gestione dei profili di terze parti, Citrix consiglia di installare ed eseguire Citrix Profile Management Service. Non è necessario abilitare il servizio Citrix Profile Management.
Se si prevede di utilizzare MCS per il provisioning delle VM, non escludere il servizio Machine Identity.
Se si specificano sia
/exclude
che/includeadditional
con lo stesso nome del componente, il componente non verrà installato.Questa opzione non è valida se si utilizza il programma di installazione
VDAWorkstationCoreSetup.exe
. Quel programma di installazione esclude automaticamente molti di questi elementi. -
/h o /aiuto
Visualizza la guida ai comandi.
-
/includeadditional “componente”[,”componente”] …
Include l’installazione di uno o più componenti opzionali separati da virgole, ciascuno racchiuso tra virgolette dritte. I nomi dei componenti sono sensibili alle maiuscole e alle minuscole.
Questa opzione può essere utile quando si crea una distribuzione di Accesso PC remoto e si desidera installare componenti non inclusi per impostazione predefinita. I valori validi sono:
- Gestione dei profili Citrix
- Plug-in WMI per la gestione dei profili Citrix
- Personalizzazione Citrix per App-V - VDA
- Driver Citrix MCS IO
- Agente di aggiornamento Citrix VDA
- Citrix Rendezvous V2
- Livello di personalizzazione dell’utente
- Strumento di registrazione Citrix Web Socket VDA
Se si specificano sia
/exclude
che/includeadditional
con lo stesso nome di componente, quel componente non verrà installato. -
/installdir directory
Directory vuota esistente in cui verranno installati i componenti. Predefinito = c:\Programmi\Citrix.
-
/installa_driver_mcsio
Non utilizzare. Invece, usa
/includeadditional "Citrix MCS IODriver"
o/exclude "Citrix MCS IODriver"
-
/logpath percorso
Posizione del file di registro. La cartella specificata deve esistere. Il programma di installazione non lo crea. Predefinito = “%TEMP%\Citrix\XenDesktop Installer”
Questa opzione non è disponibile nell’interfaccia grafica.
-
/immagine principale
Valido solo quando si installa un VDA su una VM. Imposta il VDA come immagine. Questa opzione equivale a
/mastermcsimage
.Questa opzione non è valida se si utilizza il programma di installazione
VDAWorkstationCoreSetup.exe
. -
/immaginemastermcs
Specifica che questa macchina verrà utilizzata come immagine con Machine Creation Services. Questa opzione equivale a
/masterimage
. -
/immaginemasterpvs
Specifica che questa 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 che diverse funzionalità multimediali HDX non sono installate e non funzionano. Se questa opzione viene omessa e Media Foundation non è installato, l’installazione di VDA fallisce. La maggior parte delle edizioni Windows supportate hanno Media Foundation già installato, ad eccezione delle edizioni N.
-
/esperienzanodesktop
Valido solo quando si installa un OS VDA multisessione. Impedisce l’abilitazione della funzionalità Esperienza desktop avanzata. Questa funzionalità è controllata anche tramite l’impostazione del criterio Citrix Enhanced Desktop Experience.
-
/non riavviare
Impedisce il riavvio dopo l’installazione. Il VDA non può essere utilizzato prima di un riavvio.
-
/non riprendere
Per impostazione predefinita, quando è necessario riavviare il computer durante un’installazione, il programma di installazione riprende automaticamente al termine del riavvio. Per sovrascrivere l’impostazione predefinita, specificare
/noresume
. Questa funzione può essere utile se è necessario rimontare il supporto o se si desidera acquisire informazioni durante un’installazione automatizzata. -
/numeroporta porta
Valido solo se è specificata l’opzione
/reconfig
. Numero di porta da abilitare per le comunicazioni tra VDA e 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 i dettagli sulle funzionalità, vedere Protocollo Rendezvous.- Formato indirizzo proxy:
http://<url-or-ip>:<port>
- Formato file PAC:
http://<url-or-ip>:<port>/<path>/<filename>.pac
- Formato indirizzo proxy:
-
/silenzioso o /passivo
Durante l’installazione non viene visualizzata alcuna interfaccia utente. L’unica prova del processo di installazione e configurazione si trova nel Task Manager di Windows. Se questa opzione viene omessa, viene avviata l’interfaccia grafica.
-
/riconfigurare
Personalizza le impostazioni VDA configurate in precedenza se utilizzato con le opzioni
/portnumber
,/controllers
o/enable_hdx_ports
. Se si specifica questa opzione senza specificare anche l’opzione/quiet
, viene avviata l’interfaccia grafica per la personalizzazione del VDA. -
/pc remoto
Valido solo per distribuzioni di accesso al PC remoto (sistema operativo a sessione singola) o connessioni negoziate (sistema operativo multisessione).
Questa opzione non è valida se si utilizza il programma di installazione
VDAWorkstationCoreSetup.exe
. Tale programma di installazione esclude automaticamente l’installazione di questi componenti. -
/rimuovi_appdisk_ack
Autorizza il programma di installazione VDA a disinstallare il plug-in VDA di AppDisks, se installato.
-
/rimuovi_pvd_ack
Autorizza il programma di installazione VDA a disinstallare Personal vDisk, se installato.
-
/rimuovere
Rimuove i componenti specificati con l’opzione
/components
. -
/rimuovi tutto
Rimuove il VDA. Non rimuove l’app Citrix Workspace (se installata).
-
/inviaremetrichedell’esperienza
Invia automaticamente a Citrix i dati analitici raccolti durante l’installazione, l’aggiornamento o la rimozione. Se questa opzione viene omessa (o viene specificata l’opzione
/disableexperiencemetrics
), le analisi vengono raccolte localmente, ma non inviate automaticamente. -
/servervdi
Installa un OS VDA 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 Server VDI.
-
/sito_guid guid
Identificatore univoco globale dell’unità organizzativa (OU) di Active Directory del sito. In questo modo, un desktop virtuale viene associato 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 Studio. Non specificare entrambe le opzioni
/site_guid
e/controllers
. -
/tempdir directory
Directory in cui conservare i file temporanei durante l’installazione. Predefinito = c:\Windows\Temp.
Questa opzione non è disponibile nell’interfaccia grafica.
-
/macchinavirtuale
Valido solo quando si installa un VDA su una VM. Sostituisce il rilevamento da parte dell’installatore di una macchina fisica, in cui le informazioni del BIOS passate alle VM le fanno apparire come macchine fisiche.
Questa opzione non è disponibile nell’interfaccia grafica.
-
/xendesktopcloud
Indica che VDA è installato in una distribuzione Citrix DaaS (Citrix Cloud).
Esempi: Installare un VDA
-
Installa 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 /masterimage
Il VDA verrà utilizzato come immagine.
-
Installa un OS VDA multi-sessione o un OS VDA mono-sessione. Il seguente comando installa un OS VDA multisessione o un OS VDA monosessione.
VDAServerSetup_XXXX.exe /quiet /controllers "ddc1.abc.com","ddc2.abc.com" /enable_hdx_ports /enable_Remote_Assistance /enable_real_time_transport /enable_ss_ports /noreboot
Separare ciascun FQDN del controller di consegna con una virgola. Si noti che
XXXX
rappresenta la versione VDA. -
Installa un VDA Core Services su un sistema operativo a sessione singola. Il seguente comando installa un VDA Core Services su un sistema operativo a sessione singola per l’utilizzo in una distribuzione Remote PC Access o VDA.
VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
L’app Citrix Workspace e altri servizi non essenziali non sono 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 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
(obbligatorio quando si personalizza un VDA) -
/h
or/help
/quiet
/non riavviare
/controllers
/portnumber port
/abilita_porte_hdx
Dove andare dopo
-
Per rivedere l’intero processo di configurazione, vedere Pianificare e creare una distribuzione.