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, 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 ulteriori 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 Virtual Delivery Agent Linux.

Questo articolo descrive come eseguire i comandi di installazione del prodotto. Prima di iniziare qualsiasi installazione, consultare Preparazione all’installazione. Tale articolo include descrizioni dei programmi di installazione disponibili.

Per visualizzare l’avanzamento dell’esecuzione del comando e i valori restituiti, è necessario essere l’amministratore originale o utilizzare Esegui come amministratore. Per ulteriori informazioni, consultare la documentazione dei comandi Microsoft.

A complemento dell’uso diretto dei comandi di installazione, sul file ISO del prodotto sono forniti script di esempio che installano, aggiornano o rimuovono i VDA sulle macchine in Active Directory. Per i dettagli, consultare Installare i VDA utilizzando gli 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 di Citrix.

Utilizzare il programma di installazione completo del prodotto

Per accedere all’interfaccia della riga di comando del programma di installazione completo del prodotto:

  1. Scaricare il pacchetto del prodotto da Citrix. Per accedere al sito di download sono necessarie le credenziali dell’account Citrix.
  2. Decomprimere il file. Facoltativamente, masterizzare un DVD del file ISO.
  3. Accedere al server in cui si stanno installando i componenti, utilizzando un account amministratore locale.
  4. Inserire il DVD nell’unità o montare il file ISO.
  5. 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 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.exe nella cartella di installazione x64 > XenDesktop sul 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 /exclude quando si usano le opzioni della riga di comando per l’installazione dei componenti principali.
  • Se si aggiorna un componente usando /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] ecc.

    Abilita la raccolta dei dati Call Home e dei dati del Programma di miglioramento dell’esperienza del cliente (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 component [,component] ecc.

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

    • CONTROLLER: Controller
    • DESKTOPSTUDIO: Studio
    • WEBSTUDIO: Web Studio
    • DESKTOPDIRECTOR: Director
    • LICENSESERVER: Citrix License Server
    • SECUREPRIVATEACCESS: Secure Private Access
    • VDA: Virtual Delivery Agent
    • CSA: Citrix Secure Access™ Client
    • DT: Citix Device Trust
    • PLUGINS: Citrix Workspace™ app per Windows
    • UBERAGENT: Citrix uberAgent
    • UPL: Citrix User Personalization Layer
    • WEM: Citrix Workspace Environment Management™ Agent

    Per installare il VDA e l’app Citrix Workspace per Windows, specificare /components vda,plugins o non specificare alcun componente. Se non vengono specificati componenti, il VDA, Citix Device Trust, Citrix uberAgent e Citrix Workspace Environment Management Agent verranno installati per impostazione predefinita. (Citrix uberAgent non verrà installato, aggiornato o disinstallato se l’uberAgent esistente nell’ambiente è autonomo e non distribuito da Citrix.)

    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 di StoreFront dedicato menzionato in Utilizzare il programma di installazione del prodotto completo).

  • 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 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.

  • Disabilita metriche esperienza

    Impedisce il caricamento automatico delle analisi raccolte durante l’installazione, l’aggiornamento o la rimozione a Citrix.

  • Solo pre-controllo

    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, vedere Controllo hardware.

  • /ignore_site_test_failure

    Valido solo durante l’aggiornamento del Controller. Di solito, eventuali errori nei test del sito vengono ignorati e l’aggiornamento procede. Se omesso (o impostato su false), qualsiasi errore nei test del sito causa il fallimento del programma di 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.

  • /directory-installazione cartella

    Directory vuota esistente in cui verranno installati i componenti. Predefinito = c:\Program Files\Citrix.

  • /percorso-log percorso

    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.

  • /no-riavvio

    Impedisce il riavvio dopo l’installazione. (Per la maggior parte dei componenti principali, il riavvio non è abilitato per impostazione predefinita.)

  • /no-ripristino

    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. Ciò può essere utile se è necessario rimontare il supporto o si desidera acquisire informazioni durante un’installazione automatica.

  • /no-SQL

    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.

  • /SKIPHDXDRIVERCHECK

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

  • /invia_metriche_esperienza

    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.

  • /tempdir cartella

    Directory che contiene i file temporanei durante l’installazione. Predefinito = c:\Windows\Temp.

  • /applicazione Xen

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

  • /solo_precontrollo

    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 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).

  1. 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-->
    
  2. 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.

  1. Scaricare il pacchetto appropriato da Citrix:
    • Virtual Delivery Agent per OS multi-sessione: VDAServerSetup_xxxx.exe
    • Virtual Delivery Agent SO a sessione singola: VDAWorkstationSetup_xxxx.exe
    • Virtual Delivery Agent Servizi principali SO a sessione singola: VDAWorkstationCoreSetup_xxxx.exe
  2. Estrarre prima 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. 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

    Per eseguire il pacchetto scaricato, eseguirne il 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 standalone VDAServerSetup.exe o VDAWorkstationSetup.exe come se fosse il comando XenDesktopVdaSetup.exe in tutto tranne che nel suo nome.

  • Il programma di installazione VDAWorkstationCoreSetup.exe è diverso, perché supporta un sottoinsieme delle opzioni disponibili per gli altri programmi di installazione.

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.

  • /componenti 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

    Per installare il VDA e Citrix Workspace app per Windows, specificare /components vda,plugins o non specificare alcun componente. Se non viene specificato alcun componente, per impostazione predefinita verrà installato solo il VDA.

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

  • /soloprequisiti

    Verranno installati solo i prerequisiti per i componenti selezionati. Non verranno installati componenti di prodotti Citrix.

  • /controllercontroller [controller]”

    FQDN dei Controller separati da spazi con cui il VDA può comunicare, racchiusi tra virgolette diritte. Non specificare entrambe le opzioni /site_guid e /controllers.

  • /disabilitametricheespeienza

    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 (ad eccezione dell’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 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 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, 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 la porta 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_ports se 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 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:

    • /enablerestorecleanup indica al programma di installazione di rimuovere il punto di ripristino.
    • /enablerestore indica 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, reindirizzamento dispositivi TWAIN client, reindirizzamento dispositivi USB Plug and Play client, reindirizzamento stampanti client, reindirizzamento appunti client e reindirizzamento microfono client.

  • /enable_ss_ports

    Apre le porte nel Windows Firewall necessarie 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.

  • /excludecomponente”[,”componente”]

    Impedisce l’installazione di uno o più componenti opzionali separati da virgola, 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 del servizio di identità della macchina. I valori validi sono i seguenti:

    OS multi-sessione OS a sessione singola Servizi core di OS a sessione singola
    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 Monitor 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 non funzionano. Nelle pagine Dashboard e Tendenze, il pannello Durata media accesso 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 è 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.

  • /includeadditionalcomponente”[,”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:

    SO multi-sessione SO a sessione singola
    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 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.

  • /immaginePVSmaster

    Specifica che questa macchina verrà utilizzata come immagine con Citrix Provisioning™ o con uno strumento di provisioning di terze parti (come Microsoft System Center Configuration Manager) per il provisioning delle VM.

  • /tokenwebsocket TokenWebSocket

    Crea un VDA Web Socket. Il WebSocketToken è per il token richiesto.

  • /filetokenwebsocket File contenente il token WebSocket

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

  • /tokenwebsocketstdin <Token WebSocket

    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\WindowsMediaVersion prima di avviare il processo di installazione per confermare che il valore esista e non sia vuoto.

  • /nessunaesperienzadesktop

    La funzionalità Enhanced Desktop Experience non è più disponibile. Questa opzione (e impostazione di policy) 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 di policy Citrix Enhanced Desktop Experience.

  • /nessunriavvio

    Impedisce un riavvio dopo l’installazione. Il VDA non può essere utilizzato prima di un riavvio.

  • /nessunripristino

    Per impostazione predefinita, quando è necessario riavviare una macchina durante un’installazione, il programma di installazione riprende automaticamente al termine 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.

  • /macchinafisica

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

  • /numerodiporta porta

    Valido solo quando è 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.

  • /proxyconfigindirizzo o percorso del 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 sulle funzionalità, vedere Protocollo Rendezvous.

    • Formato indirizzo proxy: http://<url-or-ip>:<port>
    • Formato file PAC: http://<url-or-ip>:<port>/<path>/<filename>.pac
  • /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, /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.

  • /pcremoto

    Valido solo per distribuzioni di 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 /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.

  • /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.

  • /rimuovitutto

    Rimuove il VDA. Non rimuove l’app Citrix Workspace (se installata).

  • /REMOVEALLWITHCWA

    Rimuove CWA insieme al VDA.

  • /invia metriche 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.

  • /serviziovdi

    Installa un VDA per OS a sessione singola 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, vedere Server VDI.

    Utilizzare questa opzione solo con il programma di installazione VDA completo.

  • /site_guid identificatore

    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_guid e /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.

  • /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:

Il seguente comando installa un VDA per SO 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 SO a sessione singola con il programma di installazione autonomo VDAWorkstationCoreSetup:

Il seguente comando installa un VDA per servizi core su un SO a sessione singola da utilizzare 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 port
  • /enable_hdx_ports

Risolvere i 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, questo 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, 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

Se questa opzione non è specificata, il programma di installazione visualizza la pagina Firewall dall’interfaccia grafica. Selezionare Automaticamente affinché 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 l’Universal Print Server utilizzando le indicazioni in Provisioning delle stampanti.

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

Le seguenti opzioni sono valide con entrambi:

  1. Programma di installazione CVAD: XenDesktopSPASetup.exe
  2. 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 viene rilevato il servizio Windows Firewall, 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.

  • /senza 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.

  • guida o /h o /?

    Visualizza la guida del comando

  • nessun riavvio

    Impedisce il riavvio dopo l’installazione. Secure Private Access non può essere utilizzato prima di un riavvio.

  • silenzioso o passivo

    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 Programma di installazione di Secure Private Access.

Ulteriori informazioni

Per informazioni su come Citrix segnala il risultato delle installazioni dei componenti, vedere Codici di ritorno dell’installazione di Citrix.