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 i 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 (precedentemente 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 sono memorizzati 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 controllare i risultati dell’esecuzione di uno script, esaminare la condivisione centrale dei log. 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 strumenti di ricerca di directory standard per trovare un’installazione o una rimozione fallita nella condivisione centrale dei log. 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. Il valore completo si trova sul supporto di installazione nel file ProductVersion.txt. Tuttavia, una corrispondenza completa non è richiesta.
    • 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 o 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 Installazione tramite riga di comando. Le opzioni /quiet e /noreboot sono incluse per impostazione predefinita nello script e sono obbligatorie: SET COMMANDLINEOPTIONS=/QUIET /NOBOOT /NORESUME.
  3. Utilizzando gli script di avvio di Criteri di gruppo, assegnare lo script all’unità organizzativa (OU) contenente le macchine. Questa unità organizzativa deve contenere solo le macchine su cui si desidera installare il VDA. Quando le macchine in tale unità organizzativa 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. Il valore completo si trova sul supporto di installazione nel file ProductVersion.txt (ad esempio 7.0.0.3018). Tuttavia, una corrispondenza completa non è richiesta.
    • 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’unità organizzativa (OU) contenente le macchine. Questa unità organizzativa deve contenere solo le macchine da cui si desidera rimuovere il VDA. Quando le macchine nell’unità organizzativa 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 centrale dei log entro pochi secondi dall’avvio della distribuzione. È possibile verificare che il processo generale funzioni. Se questo log non viene copiato nella condivisione centrale dei log 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:

    • Venga eseguito come previsto.
    • Rilevi correttamente il sistema operativo di destinazione.
    • Sia configurato correttamente per puntare alla ROOT della condivisione DEPLOYSHARE (contiene il file denominato AutoSelect.exe).
    • Sia 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 Versione VDA installata nel riquadro Dettagli potrebbe non corrispondere alla 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 del 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.