Documentazione dei prodotti

Installare i VDA usando SCCM

May 31, 2026
Grazie al contributo di: 
C

Panoramica

Microsoft Endpoint Configuration Manager, precedentemente 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 per 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 l’installer VDA in una sequenza di passaggi.

  • Citrix non consiglia di utilizzare la VDA Cleanup Utility come parte di un’installazione o di un aggiornamento VDA. Utilizzare la VDA Cleanup Utility solo nel caso limitato in cui l’installer 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 precedenti installazioni software.
  • I file precedentemente bloccati da altri processi potrebbero richiedere aggiornamenti, forzando un riavvio aggiuntivo.
  • Alcuni componenti opzionali nell’installer 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, l’installer VDA utilizzato viene copiato su quella macchina. Per maggiori informazioni sull’installazione VDA, vedere Installer.

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 VDA autonomi:

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

    Per maggiori informazioni sugli installer 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 di dispositivi per creare l’OU. Immettere il Nome della Raccolta.

    Raccolta di dispositivi

  10. Seguire le istruzioni della procedura guidata.

    Regole di appartenenza

    L’OU è stata creata.

    Creazione OU

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

    1. Fare clic con il pulsante destro del mouse sulla VM. Selezionare Aggiungi elementi selezionati > Aggiungi elementi selezionati a raccolta di 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 Risorse e conformità > Panoramica > Raccolte 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, vedere 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. Crea un pacchetto

  2. Distribuisci contenuto

Crea 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 del pacchetto e la Riga di comando.

    Specifica dettagli 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 il 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 un codice di ritorno è 3, riavviare la macchina e quindi passare il controllo a Installazione VDA secondo tentativo.

        Riavvia la 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 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 arrestarsi.

    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 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 un 0 o un 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, consultare Codici restituiti dell’installazione Citrix.

Esempi di comandi di installazione VDA

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

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 seguente comando 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 usando 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.