Documentazione dei prodotti

Installare i VDA tramite SCCM

May 31, 2026
Grazie al contributo di: 
C

Panoramica

Microsoft Endpoint Configuration Manager, in precedenza System Center Configuration Manager (SCCM), è un prodotto Windows che consente la gestione, la distribuzione e la sicurezza di dispositivi e applicazioni in un’azienda.

Nota:

L’articolo seguente descrive solo le raccomandazioni basate su come Citrix® ha testato l’ambiente. È possibile personalizzare questi passaggi in base alle proprie esigenze. Citrix non è responsabile di eventuali aggiornamenti o modifiche necessarie per adattare questo alle esigenze del cliente.

Raccomandazioni

  • Per distribuire correttamente un Virtual Delivery Agent (VDA) utilizzando SCCM o strumenti di distribuzione software simili, Citrix consiglia di utilizzare il programma di installazione VDA in una sequenza di passaggi.

  • Citrix sconsiglia di utilizzare l’utilità di pulizia VDA come parte di un’installazione o di un aggiornamento VDA. Utilizzare l’utilità di pulizia VDA solo nel caso limitato in cui il programma di installazione VDA abbia precedentemente fallito.

Prima di iniziare

Il numero di riavvii richiesti durante l’installazione del VDA dipende dall’ambiente. Ad esempio:

  • Potrebbe essere necessario un riavvio per aggiornamenti in sospeso o riavvii da installazioni software precedenti.
  • I file precedentemente bloccati da altri processi potrebbero richiedere aggiornamenti, forzando un riavvio aggiuntivo.
  • Alcuni componenti opzionali nel programma di installazione VDA (come Citrix Profile Management e Citrix Files) potrebbero richiedere un riavvio.
  • Quando si aggiorna un VDA, la macchina su cui è installato deve essere in modalità di manutenzione, senza sessioni.
  • Quando un’installazione VDA viene eseguita per la prima volta su una macchina, il programma di installazione VDA utilizzato viene copiato su tale macchina. Per maggiori informazioni sull’installazione VDA, vedere Programmi di installazione.

SCCM Task Sequencer gestisce tutti i riavvii richiesti.

Passaggi chiave per distribuire il VDA utilizzando SCCM

I seguenti passaggi descrivono come distribuire il VDA utilizzando SCCM sulla macchina virtuale.

  1. Installare il VDA.
  2. Creare un’unità organizzativa (OU).
  3. Verificare le macchine.
  4. Utilizzare il VDA per distribuire il contenuto.

Passaggio 1: Installare il VDA

Dopo aver identificato tutti i prerequisiti, utilizzare SCCM Task Sequencer per completare le seguenti attività:

  1. Installare il VDA da una copia accessibile del supporto di installazione o da uno degli installer standalone del VDA:

    • VDAWorkstationSetup_XXXX.exe
    • VDAServerSetup_XXXX.exe
    • VDAWorkstationCoreSetup_XXXX.exe

    Per maggiori informazioni sugli installer del VDA, vedere Installer.

    Nota:

    Quando si aggiorna un VDA, la macchina su cui è installato deve essere in modalità di manutenzione, senza sessioni.

  2. Quando un’installazione VDA viene eseguita per la prima volta su una macchina, il programma di installazione VDA utilizzato viene copiato su tale macchina.
    • Quando si utilizza un programma di installazione VDA diverso da VDAWorkstationCoreSetup_XXXX.exe, il programma di installazione VDA viene copiato in %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe.
    • Quando si utilizza VDAWorkstationCoreSetup_XXXX.exe, il programma di installazione VDA viene copiato in %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe.

  3. La posizione della directory del programma di installazione VDA viene anche memorizzata nel registro HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”.

  4. Aggiungere le opzioni della riga di comando /NOREBOOT, /NORESUME e /QUIET alle opzioni della riga di comando.

    • /QUIET: Non mostrare l’interfaccia utente durante l’installazione, in modo che SCCM abbia il controllo del processo di installazione.
    • /NOREBOOT: Impedire al programma di installazione VDA di riavviarsi automaticamente. SCCM attiva i riavvii quando necessario.
    • /NORESUME: Di solito, quando è necessario un riavvio durante l’installazione, il programma di installazione VDA imposta una chiave di registro runonce (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce). Windows utilizza la chiave per aprire il programma di installazione VDA al riavvio della macchina. Questo è un problema per SCCM, perché SCCM non può monitorare l’installazione e acquisire il codice di uscita.

Passaggio 2: Creare un’unità organizzativa (OU)

  1. Creare due macchine virtuali unite al dominio che si desidera aggiungere all’OU. Quando le macchine virtuali vengono create inizialmente, si trovano nella cartella Computers. Spostare le macchine virtuali nella cartella SCCM. Esempio: WIN10EN-BB80MJ4.cseblr.com W2K19ST-EBPR3UG.cseblr.com

    VDA SCCM

  2. In Microsoft Configuration Manager, andare a \Administration\Overview\Hierarchy Configuration\Discovery Methods\.

  3. Fare clic su Active Directory System Discovery e selezionare la casella di controllo Enable Active Directory System Discovery per abilitare il rilevamento automatico delle macchine virtuali appena create.

  4. Fare clic sull’icona icona per selezionare nuovi contenitori.

  5. Nella sezione Posizione, aggiungere il Percorso in cui si trovano le macchine virtuali SCCM.

  6. Andare a \Administration\Overview\Site Configuration\Sites e fare clic con il pulsante destro del mouse sul VDA SCCM.

  7. Selezionare Impostazioni installazione client > Installazione push client. Si apre la finestra Proprietà installazione push client.

  8. Una volta che le VM sono impostate su Enabled, è possibile visualizzare l’elenco delle VM come illustrato nelle immagini seguenti.

    SCCM

    SCCM-2

  9. Creare la Raccolta dispositivi per creare l’OU. Immettere il Nome della raccolta.

    Raccolta dispositivi

  10. Seguire le istruzioni della procedura guidata.

    Regole di appartenenza

    L’OU è stata creata.

    Creazione OU

  11. Aggiungere le VM create alla Raccolta dispositivi appena creata.

    1. Fare clic con il pulsante destro del mouse sulla VM. Selezionare Aggiungi elementi selezionati > Aggiungi elementi selezionati a raccolta dispositivi esistente.

      Aggiungi elemento

    2. Nella finestra Seleziona raccolta, selezionare il nome del dispositivo richiesto. In questo esempio, è Devices-SCCM.

      Elenco dispositivi

    Devices-SCCM è elencato in Asset e conformità > Panoramica > Raccolte di dispositivi.

    Dispositivo elencato

  12. Selezionare Installa client su Raccoglitore dispositivi.

    Installa client

  13. Selezionare il sito di installazione richiesto.

    Sito di installazione

  14. Seguire le istruzioni della procedura guidata. La Procedura guidata di installazione del client di Configuration Manager è stata completata correttamente.

    Installazione completata

Per informazioni dettagliate, consultare Gestire le raccolte nella documentazione Microsoft.

Passaggio 3: Verificare le macchine

  1. Sulla macchina client, verificare che il client sia installato controllando se il processo CCMExec è in esecuzione.

    CCMexe.exe

  2. Verificare se il client è in esecuzione per le VM su SCCM.

Passaggio 4: Utilizzare il VDA per distribuire il contenuto

I seguenti passaggi descrivono come è possibile utilizzare il VDA distribuito per distribuire il contenuto sulle macchine virtuali associate.

  1. Creare un pacchetto

  2. Distribuire il contenuto

Creare un pacchetto

  1. Per creare un pacchetto, fare clic con il pulsante destro del mouse sul VDA desiderato e fare clic su Crea pacchetto.

    Crea pacchetto

  2. Specificare la posizione dei file di origine per questo pacchetto facendo clic su Sfoglia.

    Sfoglia pacchetto

  3. Selezionare il tipo di pacchetto desiderato.

    Creazione guidata pacchetto e programma

  4. Immettere il Nome e la Riga di comando del pacchetto.

    Specificare i dettagli del pacchetto

  5. Fare clic su Avanti.

    Pacchetto riuscito

Per informazioni dettagliate, consultare Pacchetti e programmi in Configuration Manager nella documentazione Microsoft.

Distribuisci contenuto

  1. Fare clic con il pulsante destro del mouse sul nome del pacchetto creato.

  2. Selezionare Distribuisci contenuto.

    Distribuisci contenuto

  3. Nella finestra Distribute Content Wizard, selezionare la posizione dei file di origine per il pacchetto creato. In questo esempio, è 2019-SCCM. Fare clic su Avanti.

    Specifica posizione

  4. Verificare che il pacchetto (in questo esempio, Zodiac) sia disponibile per la distribuzione.

    Verifica

    L’immagine seguente mostra che il pacchetto è disponibile per la distribuzione.

    Pacchetto da distribuire

Per informazioni dettagliate, consultare Distribuire e gestire il contenuto per Configuration Manager nella documentazione Microsoft.

Esempio di sequenza di installazione tramite SCCM

L’esempio seguente mostra la sequenza di installazione.

  1. Riavvia computer: Preparare la macchina riavviandola.

    Riavvia computer

  2. Installazione VDA - Primo tentativo: Avviare l’installazione del VDA.

    1. Aggiungere le opzioni /quiet, /noreboot e /noresume alle opzioni della riga di comando.

    2. Eseguire il programma di installazione VDA scelto (immagine locale o uno dei programmi di installazione minimi).

      Installazione VDA - Primo tentativo

    3. SCCM deve acquisire il codice di ritorno.

      • Se il codice di ritorno è 0 o 8, l’installazione è completa ed è necessario un riavvio.

        SCCM acquisisce il codice di ritorno

      • Se il codice di ritorno è 3, riavviare la macchina e quindi passare il controllo a Installazione VDA - Secondo tentativo.

        Riavvia macchina

  3. Installazione VDA - Secondo tentativo: Continuare l’installazione del VDA.

    1. Dopo Installazione VDA - Primo tentativo se il file %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml esiste, l’installazione non è completa e deve essere continuata dopo il completamento del riavvio.

      Installazione VDA - Secondo tentativo

    2. Installazione VDA - Secondo tentativo si ripete finché il file %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml non esiste o non viene restituito un codice di ritorno diverso da 0 o 8. Qualsiasi altro codice di ritorno deve essere trattato come un errore e INSTALLAZIONE VDA - SECONDO TENTATIVO deve segnalare un errore e interrompersi.

    3. Riprendere l’installazione del VDA eseguendo il programma di installazione VDA appropriato (XenDesktopVdaSetup.exe nella maggior parte dei casi, o XenDesktopRemotePCSetup.exe se è stato utilizzato VDAWorkstationCoreSetup_XXXX.exe) dalla directory del file %programdata%\ Citrix\XenDesktopSetup\ senza parametri della riga di comando. (Il programma di installazione VDA utilizza i parametri salvati durante la prima esecuzione del programma di installazione.)

      Editor sequenza di attività di aggiornamento

    4. Controllare il codice restituito dal programma di installazione VDA.

      • 0 o 8: Successo, installazione completata, riavvio richiesto.

        Installazione completata con successo

      • 3: L’installazione non è completa. Riavviare la macchina e ripetere INSTALL VDA SECOND ATTEMPT finché il file %programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml non esiste o finché non viene restituito 0 o 8. Trattare qualsiasi altro codice restituito come un errore, e INSTALL VDA SECOND ATTEMPT dovrebbe segnalare un errore e terminare.

Per maggiori informazioni sui codici restituiti, vedere Codici restituiti dell’installazione Citrix.

Esempi di comandi di installazione VDA

Le opzioni di installazione disponibili variano a seconda del programma di installazione utilizzato. Per i dettagli sulle opzioni della riga di comando, consultare i seguenti articoli.

Comandi di installazione per l’accesso remoto al PC

  • Il seguente comando utilizza il programma di installazione VDA core a sessione singola (VDAWorkstationCoreSetup.exe):

    VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

  • Il seguente comando utilizza il programma di installazione VDA completo a sessione singola (VDAWorkstationSetup.exe):

    VDAWorkstationSetup.exe /quiet /remotepc /physicalmachine /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

Comando di installazione per VDI dedicato

  • Il comando seguente utilizza il programma di installazione VDA completo a sessione singola (VDAWorkstationSetup.exe):

    VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot

Installare i VDA tramite SCCM
May 31, 2026
Grazie al contributo di: 
C
May 31, 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.