Documentazione dei prodotti
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Visualizza PDF

Installare i VDA tramite script

January 23, 2026
Grazie al contributo di: 
C

Nota:

Citrix non è responsabile per problemi causati da script adattati per corrispondere agli ambienti di produzione dei clienti. Per qualsiasi problema di installazione relativo a Citrix, aprire un caso di supporto tecnico con i log di installazione pertinenti utilizzando il portale di supporto Citrix.

Questo articolo si applica all’installazione di VDA su macchine con sistemi operativi Windows. Per informazioni sui VDA per sistemi operativi Linux, consultare la documentazione di Linux Virtual Delivery Agent.

Il supporto di installazione contiene script di esempio che installano, aggiornano o rimuovono i Virtual Delivery Agent (VDA) per le macchine in Active Directory. È inoltre possibile utilizzare gli script per gestire le immagini master utilizzate da Machine Creation Services™ e Citrix Provisioning (in precedenza Provisioning Services).

Accesso richiesto:

  • Gli script richiedono l’accesso in lettura (Everyone Read) alla condivisione di rete in cui si trova il comando di installazione del VDA. Il comando di installazione è XenDesktopVdaSetup.exe nell’ISO del prodotto completo, oppure VDAWorkstationSetup.exe o VDAServerSetup.exe in un programma di installazione autonomo.
  • I dettagli di logging vengono archiviati su ogni macchina locale. Per registrare i risultati centralmente per la revisione e l’analisi, gli script richiedono l’accesso in lettura e scrittura (Everyone Read and Write) alla condivisione di rete appropriata.

Per verificare i risultati dell’esecuzione di uno script, esaminare la condivisione di log centrale. I log acquisiti includono il log dello script, il log del programma di installazione e i log di installazione MSI. Ogni tentativo di installazione o rimozione viene registrato in una cartella con timestamp. Il titolo della cartella indica il risultato dell’operazione con il prefisso PASS o FAIL. È possibile utilizzare gli strumenti di ricerca di directory standard per trovare un’installazione o una rimozione non riuscita nella condivisione di log centrale. Questi strumenti offrono un’alternativa alla ricerca locale sulle macchine di destinazione.

Prima di iniziare qualsiasi installazione, leggere e completare le attività in Preparazione all’installazione.

Installare o aggiornare i VDA tramite script

  1. Ottenere lo script di esempio InstallVDA.bat da \Support\AdDeploy\ sul supporto di installazione. Citrix consiglia di eseguire un backup dello script originale prima di personalizzarlo.
  2. Modificare lo script:
    • Specificare la versione del VDA da installare: SET DESIREDVERSION. Ad esempio, la versione 7 può essere specificata come 7.0. Il valore completo si trova sul supporto di installazione nel file ProductVersion.txt. Tuttavia, non è richiesta una corrispondenza completa.
    • Specificare la condivisione di rete da cui verrà richiamato il programma di installazione. Puntare alla radice del layout (il punto più alto dell’albero). La versione appropriata del programma di installazione (a 32 bit o a 64 bit) viene richiamata automaticamente all’esecuzione dello script. Ad esempio: SET DEPLOYSHARE=\\fileserver1\share1.
    • Facoltativamente, specificare una posizione di condivisione di rete per l’archiviazione dei log centralizzati. Ad esempio: SET LOGSHARE=\\fileserver1\log1).
    • Specificare le opzioni di configurazione del VDA come descritto in Installare tramite riga di comando. Le opzioni /quiet e /noreboot sono incluse per impostazione predefinita nello script e sono obbligatorie: SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT.
  3. Utilizzando gli script di avvio di Criteri di gruppo, assegnare lo script all’OU contenente le macchine. Questa OU deve contenere solo le macchine su cui si desidera installare il VDA. Quando le macchine in tale OU vengono riavviate, lo script viene eseguito su tutte. Un VDA viene installato su ogni macchina che dispone di un sistema operativo supportato.

Rimuovere i VDA tramite script

  1. Ottenere lo script di esempio UninstallVDA.bat da \Support\AdDeploy\ sul supporto di installazione. Citrix consiglia di eseguire un backup dello script originale prima di personalizzarlo.
  2. Modificare lo script.
    • Specificare la versione del VDA da rimuovere: SET CHECK\_VDA\_VERSION. Ad esempio, la versione 7 può essere specificata come 7.0. Il valore completo si trova sul supporto di installazione nel file ProductVersion.txt (ad esempio 7.0.0.3018). Tuttavia, non è richiesta una corrispondenza completa.
    • Facoltativamente, specificare una posizione di condivisione di rete per l’archiviazione dei log centralizzati.
  3. Utilizzando gli script di avvio di Criteri di gruppo, assegnare lo script all’OU contenente le macchine. Questa OU deve contenere solo le macchine da cui si desidera rimuovere il VDA. Quando le macchine nell’OU vengono riavviate, lo script viene eseguito su tutte. Il VDA viene rimosso da ogni macchina.

Risoluzione dei problemi

  • Lo script genera file di log interni che descrivono l’avanzamento dell’esecuzione dello script. Lo script copia un log Kickoff_VDA_Startup_Script nella condivisione di log centrale entro pochi secondi dall’avvio della distribuzione. È possibile verificare che il processo complessivo funzioni. Se questo log non viene copiato nella condivisione di log centrale come previsto, risolvere ulteriormente il problema ispezionando la macchina locale. Lo script inserisce due file di log di debug nella cartella %temp% su ogni macchina:

    • Kickoff_VDA_Startup_Script_<DateTimeStamp>.log
    • VDA_Install_ProcessLog_<DateTimeStamp>.log

    Esaminare questi log per assicurarsi che lo script sia:

    • In esecuzione come previsto.
    • In grado di rilevare correttamente il sistema operativo di destinazione.
    • Configurato correttamente per puntare alla ROOT della condivisione DEPLOYSHARE (contiene il file denominato AutoSelect.exe).
    • In grado di autenticarsi sia alle condivisioni DEPLOYSHARE che LOG.

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

  • Nella visualizzazione Studio per un gruppo di consegna, la voce Installed VDA version (Versione VDA installata) nel riquadro Details (Dettagli) potrebbe non essere la versione installata sulle macchine. La visualizzazione dei programmi e delle funzionalità della macchina mostra la versione effettiva del VDA.

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

Installare i VDA tramite script
January 23, 2026
Grazie al contributo di: 
C
January 23, 2026
Grazie al contributo di: 
C

In questo articolo

Feedback sito | Your privacy choices footer linkScelte di privacy | Privacy e condizioni legali | Preferenze cookie | Impostazioni di consenso | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.