Installazione tramite riga di comando
Importante:
Se si sta eseguendo l’aggiornamento e la versione corrente utilizza o ha installato il software Personal vDisk o AppDisks, vedere 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, vedere 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, vedere Virtual Delivery Agent Linux.
Questo articolo descrive come emettere i comandi di installazione del prodotto. Prima di iniziare qualsiasi installazione, consultare Preparazione 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’uso diretto dei comandi di installazione, sull’ISO del prodotto sono forniti script di esempio che installano, aggiornano o rimuovono i VDA sulle macchine in Active Directory. Per i dettagli, vedere Installare i VDA tramite 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 guida l’utente alle informazioni sulle opzioni disponibili. Vedere Sistemi operativi precedenti.
Per informazioni su come Citrix riporta i risultati delle installazioni dei componenti, vedere Codici di ritorno dell’installazione di 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 Setupsul 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.execon le opzioni elencate in Opzioni della riga di comando per l’installazione di un VDA.Per installare StoreFront: Eseguire
CitrixStoreFront-x64.exenella cartellax64 > StoreFrontsul supporto di installazione.Per installare Universal Print Server: Seguire le istruzioni in Opzioni della riga di comando per l’installazione di Universal Print Server.
Per installare Federated Authentication Service: Citrix consiglia di utilizzare l’interfaccia grafica.
Per installare Session Recording: Seguire le istruzioni in Session Recording.
Per installare Workspace Environment Management: Seguire le istruzioni in Workspace Environment Management.
Per installare Secure Private Access: Eseguire
XenDesktopSPASetup.exenella cartella di installazionex64 > XenDesktopsul supporto di installazione. Seguire le istruzioni 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, vedere Installare i componenti principali.
Nota:
- Non utilizzare
/excludequando si usano 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 adesione al CEIP [,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, vedere Citrix Licensing Call Home.
Per maggiori dettagli sulla raccolta dei dati CEIP, vedere Citrix Licensing Customer Experience Improvement Program.
Per maggiori dettagli sui dati CEIP, vedere Citrix Licensing CEIP data elements.
Per maggiori dettagli sui dati di licenza del License Server, vedere Citrix Licensing Data.
-
-
/components componente [,component] …
Elenco di componenti da installare o rimuovere, separati da virgole. 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 al 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).
-
solo prerequisiti
Verranno installati solo i prerequisiti per i componenti selezionati. Non verranno installati componenti del prodotto Citrix.
-
/configure_firewall
Apre tutte le porte nel firewall di Windows utilizzate dai componenti in fase di installazione, se il servizio Firewall di Windows è in esecuzione, anche se il firewall non è abilitato. Se si utilizza un firewall di terze parti o nessun firewall, è necessario aprire manualmente le porte.
-
disabilita metriche dell’esperienza
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, vedere Controllo hardware.
-
/ignore_site_test_failure
Valido solo durante l’aggiornamento del Controller. Di solito, eventuali errori del test del sito vengono ignorati e l’aggiornamento procede. Se omesso (o impostato su false), qualsiasi errore del test del sito causa l’interruzione dell’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, vedere Controllo della versione di SQL Server.
-
/directoryinstallazione directory
Directory vuota esistente in cui verranno installati i componenti. Predefinito = c:\Program Files\Citrix.
-
/percorsolog path
Posizione del file di registro. 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 funzione di shadowing utente che utilizza Assistenza remota di Windows.
-
/nessunriavvio
Impedisce un riavvio dopo l’installazione. (Per la maggior parte dei componenti principali, un riavvio non è abilitato per impostazione predefinita.)
-
/nessunariapresa
Per impostazione predefinita, quando è necessario riavviare una macchina durante un’installazione, il programma di installazione riprende automaticamente al 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. -
/nessunSQL
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.
-
/rimuovi
Rimuove i componenti principali specificati con l’opzione
/components. -
/rimuovitutto
Rimuove tutti i componenti principali installati.
-
/inviaesperienzametriche
Invia automaticamente a Citrix i dati analitici raccolti durante l’installazione, l’aggiornamento o la rimozione. Se questa opzione viene omessa (o viene specificato
/disableexperiencemetrics), i dati analitici vengono raccolti localmente, ma non inviati automaticamente. -
/dirtemp cartella
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 necessarie 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 necessarie 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 necessarie 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. La mancata esecuzione di questa operazione comporta il fallimento delle installazioni e degli aggiornamenti da riga di comando. Eseguire i seguenti comandi per aggiornare il License server e componenti come Delivery Controller, Web Studio e Citrix Director (supponendo di trovarsi 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, oppure utilizzare Esegui come amministratore.
- Scaricare il pacchetto appropriato da Citrix:
- Agente di distribuzione virtuale SO multi-sessione:
VDAServerSetup_xxxx.exe - Agente di distribuzione virtuale SO a sessione singola:
VDAWorkstationSetup_xxxx.exe - Agente di distribuzione virtuale Servizi Core SO a sessione singola:
VDAWorkstationCoreSetup_xxxx.exe
- Agente di distribuzione virtuale SO multi-sessione:
-
Estrarre prima i file dal pacchetto in una directory esistente e quindi eseguire il comando di installazione, oppure eseguire semplicemente il pacchetto.
Per estrarre i file prima di installarli, utilizzare
/extractcon il percorso assoluto, ad esempioC:\YourExtractFolder\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. La directory deve esistere. In caso contrario, l’estrazione non riesce. 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.exeoVDAWorkstationCoreSetup.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.exeoVDAWorkstationSetup.execome se fosse il comandoXenDesktopVdaSetup.exein 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 separato da virgole di componenti da installare o rimuovere. I valori validi sono:
-
VDA: Agente di distribuzione virtuale -
CSA: Citrix Secure Access™ Client -
PLUGINS: app Citrix Workspace™ per Windows -
UPL: Citrix User Personalization Layer (solo per WS VDA) -
SRAGENT: Agente di registrazione sessione -
ASSISTANTAPP: App Citrix Assistant (solo per WS VDA) -
CEAL: Citrix Elastic App Layering (solo per TS VDA)
Per installare il VDA e l’app Citrix Workspace per Windows, specificare /components vda,plugins o non specificare affatto 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 automaticamente 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.
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.
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, vedere Installare i VDA.
-
/components componente[,componente]
Elenco di componenti da installare o rimuovere, separati da virgole. I valori validi sono:
-
VDA: Virtual Delivery Agent -
PLUGINS: Citrix Workspace app per Windows -
CSA: Citrix Secure Access Client -
UPL: Citrix User Personalization Layer (solo per VDA WS) -
SRAGENT: Session Recording Agent -
ASSISTANTAPP: Citrix Assistant App (solo per VDA WS) -
CEAL: Citrix Elastic App Layering (solo per VDA TS)
-
Per installare il VDA e Citrix Workspace app per Windows, specificare /components vda, plugins, CSA, UPL o non specificare alcun componente. Se non viene specificato alcun componente, per impostazione predefinita verranno installati solo VDA, SRAGENT e ASSISTANTAPP.
Per installare solo il VDA ed escludere l’installazione di Citrix Workspace app e altri componenti, specificare /components vda.
Questa opzione non è valida quando si utilizza il programma di installazione VDAWorkstationCoreSetup_xxxx.exe. Tale programma di installazione non può installare Citrix Workspace app.
-
/soloprerquisiti
Verranno installati solo i prerequisiti per i componenti selezionati. Non verranno installati componenti di prodotti Citrix.
-
/controllori “controller [controller]”
FQDN dei Controller separati da spazi con cui il VDA può comunicare, racchiusi tra virgolette diritte. Non specificare entrambe le opzioni
/site_guide/controllers. -
/disabilitaesperienzametriche
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 viene rilevato il servizio Firewall di Windows, anche se il firewall non è abilitato. Se si utilizza un firewall diverso o nessun firewall, è necessario configurare il firewall manualmente. 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 a questa opzione/enable_hdx_ports. -
/enable_hdx_udp_ports
Apre le porte UDP nel firewall di Windows utilizzate dal trasporto adattivo HDX, se viene rilevato il servizio Firewall di Windows, anche se il firewall non è abilitato. Se si utilizza un firewall diverso o nessun firewall, è necessario configurare il firewall manualmente. Per informazioni sulle porte, vedere 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_portsse si desidera che le porte UDP vengano aperte automaticamente quando viene rilevato il servizio Firewall di Windows. -
/enable_remote_assistance
Abilita la funzionalità 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 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 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 i dettagli, vedere 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 predefinita più sicura. Le funzionalità pertinenti sono: reindirizzamento unità client, reindirizzamento cartelle speciali, trascinamento della selezione (drag and drop), reindirizzamento dispositivi TWAIN client, reindirizzamento dispositivi 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 necessarie per la condivisione dello schermo, se viene rilevato il servizio Firewall di Windows, anche se il firewall non è abilitato. Se si utilizza un firewall diverso o nessun firewall, è necessario configurare il firewall manualmente.
-
/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:
SO multi-sessione SO a sessione singola Servizi principali del sistema operativo a sessione singola Citrix Authentication Identity Assertion VDA Plug-inCitrix Authentication Identity Assertion VDA Plug-inCitrix Authentication Identity Assertion VDA Plug-inCitrix Backup and RestoreCitrix Backup and RestoreCitrix Browser Content RedirectionCitrix deviceTRUST®Citrix deviceTRUSTCitrix deviceTRUSTuberAgent®uberAgentuberAgentCitrix Secure Access ClientCitrix Secure Access ClientCitrix Secure Access ClientCitrix Workspace Environment Management™ AgentCitrix Workspace Environment Management AgentCitrix Workspace Environment Management AgentCitrix Browser Content RedirectionCitrix Browser Content RedirectionCitrix Personalization for App-V - VDACitrix MCS IODriverCitrix MCS IODriverCitrix Telemetry ServiceCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Universal™ Print ClientCitrix Profile ManagementCitrix Profile ManagementCitrix Vda Log Capture ServiceCitrix Profile Management WMI Plug-inCitrix Profile Management WMI Plug-inCSE ComponentCitrix Rendezvous V2Citrix Rendezvous V2Director VDA Plug-inCitrix Telemetry ServiceCitrix Telemetry ServiceMachine Management ProviderCitrix Universal Print ClientCitrix Universal Print ClientVDA Monitor Plug-inCitrix Vda Log Capture ServiceCitrix Vda Log Capture ServiceVDA WMI Proxy Plug-inCitrix VDA Upgrade AgentCitrix VDA Upgrade AgentCSE ComponentCSE ComponentDirector VDA Plug-inDirector VDA Plug-inMachine Identity ServiceMachine Identity ServiceMachine Management ProviderMachine Management ProviderVDA Monitor Plug-inUser Personalization LayerVDA WMI Proxy Plug-inVDA Monitor Plug-inVDA WMI Proxy Plug-inCitrix App Protection ComponentCitrix App Protection ComponentCitrix App Protection ComponentCitrix HyperV Filter DriverCitrix HyperV Filter DriverCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Personalization for App-V - VDASession Recording AgentSession Recording AgentElastic App LayeringCitrix Assistant AppL’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 su cui è installato Profile Management.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
/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 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 di Remote PC Access e si desidera installare altri componenti non inclusi per impostazione predefinita. I valori validi sono i seguenti:
Sistema operativo multi-sessione Sistema operativo a sessione singola Citrix Backup and RestoreCitrix Backup and RestoreCitrix MCS IODriverCitrix MCS IODriverCitrix Personalization for App-V - VDACitrix Personalization for App-V - VDACitrix Profile ManagementCitrix Profile ManagementCitrix Profile Management WMI Plug-inCitrix Profile Management WMI Plug-inCitrix Rendezvous V2Citrix Rendezvous V2Citrix VDA Upgrade AgentCitrix VDA Upgrade AgentCitrix Web Socket Vda Registration ToolCitrix Web Socket Vda Registration ToolMachine Identity ServiceMachine Identity ServiceUser Personalization LayerSe si specificano sia
/excludeche/includeadditionalcon lo stesso nome di componente, tale componente non viene installato. -
/installdir cartella
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 percorso
Posizione del file di registro. La cartella specificata deve esistere. Il programma di installazione non la crea. Predefinito = “%TEMP%\Citrix\XenDesktop Installer”
Questa opzione non è disponibile nell’interfaccia grafica.
-
/immagine master
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. -
immagine master MCS
Specifica che questa macchina verrà utilizzata come immagine con Machine Creation Services. Questa opzione è equivalente a
/masterimage. -
immagine master PVS
Specifica che questa macchina verrà utilizzata come immagine con Citrix Provisioning™ o con uno strumento di provisioning di terze parti (ad esempio Microsoft System Center Configuration Manager) per il provisioning delle VM.
-
/websockettoken TokenWebSocket
Crea un VDA Web Socket. Il WebSocketToken è per il token richiesto.
-
/websockettokenfile FileContenenteTokenWebSock
Crea un VDA Web Socket. Il FileContainingWebSockToken è per il file che contiene il token richiesto.
-
/tokenwebsocketstdin <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 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 da Citrix Meta Installer potrebbe non avere un valore impostato. Controllare la chiave di registro
SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersionprima di avviare il processo di installazione per confermare che il valore esista e non sia vuoto. -
/nessunaesperienzadesktop
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 sistemi operativi multi-sessione. Impedisce l’abilitazione della funzionalità Esperienza desktop avanzata. Questa funzionalità è controllata anche dall’impostazione dei criteri Citrix Esperienza desktop avanzata.
-
/nessunriavvio
Impedisce un riavvio dopo l’installazione. Il VDA non può essere utilizzato prima di un riavvio.
-
/nessunripresa
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. -
/macchinafisica
Utilizzare questo argomento insieme a
/remotepcper l’installazione di RemotePC. Altrimenti il VDA potrebbe non comportarsi come previsto in determinati scenari utente. -
/numerodiporta porta
Valido solo quando l’opzione
/reconfigè specificata. 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 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 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. Questa riga di comando installa automaticamente Citrix Rendezvous V2 come se fosse stato utilizzato /includeadditional “Citrix Rendezvous V2”. Per i dettagli sulla 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:
-
/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.
-
/riconfigura
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. -
/PC remoto
Valido solo per distribuzioni Remote PC Access (OS a sessione singola) o connessioni mediate (OS a sessione multipla). Esclude l’installazione di eventuali componenti aggiuntivi (vedere gli elenchi di componenti con le opzioni
/excludee/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./remotepcnon è compatibile con l’opzione/servervdi. -
/rimuovi
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.
-
rimuovi tutto
Rimuove il VDA. Non rimuove l’app Citrix Workspace (se installata).
-
/REMOVEALLWITHCWA
Rimuove CWA insieme al VDA.
-
invia metriche sull’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), i dati analitici vengono raccolti localmente, ma non inviati automaticamente. -
server VDI
Installa un VDA per SO a sessione singola su una macchina Windows multi-sessione supportata. Omettere questa opzione quando si installa un VDA per SO multi-sessione su una macchina Windows multi-sessione.
Prima di utilizzare questa opzione, vedere Server VDI.
Utilizzare questa opzione solo con il programma di installazione VDA del prodotto completo.
-
GUID del sito 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 entrambe le opzioni
/site_guide/controllers. -
/tempdir cartella
Directory per contenere 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. 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.
-
/xendesktopnuvola
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 sistema operativo a sessione singola e l’app Citrix Workspace nella posizione predefinita su una VM. Questo VDA verrà utilizzato come immagine e userà 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 l’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 sistema operativo a sessione singola con il programma di installazione standalone VDAWorkstationCoreSetup:
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 VDI. L’app Citrix Workspace e altri servizi non essenziali 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) -
/ho/help /quiet/noreboot/controllers/portnumber port/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 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, vedere 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, oppure Manualmente per consentire all’amministratore di configurare manualmente il firewall.
Dopo aver installato il software sui server di stampa, configurare il 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 Firewall di Windows 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, vedere Porte di rete.
-
nessun sql
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
-
nessun riavvio
Impedisce un riavvio dopo l’installazione. Secure Private Access non può essere utilizzato prima di 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.
-
rimuovi
Rimuove Secure Private Access.
Per maggiori dettagli sulle opzioni, vedere Secure Private Access installer.
Ulteriori informazioni
Per informazioni su come Citrix riporta il risultato delle installazioni dei componenti, vedere Citrix installation return codes.
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
- Ulteriori informazioni