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

Gestire i cataloghi di macchine

January 23, 2026
Grazie al contributo di: 
C

Nota:

È possibile gestire la distribuzione di Citrix Virtual Apps and Desktops™ utilizzando due console di gestione: Web Studio (basata sul Web) e Citrix Studio (basata su Windows). Questo articolo tratta solo Web Studio. Per informazioni su Citrix Studio, consultare l’articolo equivalente in Citrix Virtual Apps and Desktops 7 2212 o versioni precedenti.

Introduzione

È possibile aggiungere o rimuovere macchine da un catalogo di macchine, rinominare, modificare la descrizione o gestire gli account computer di Active Directory di un catalogo.

La gestione dei cataloghi può includere anche l’assicurarsi che ogni macchina disponga degli ultimi aggiornamenti del sistema operativo. Inclusi aggiornamenti antivirus, aggiornamenti del sistema operativo o modifiche alla configurazione.

  • I cataloghi contenenti macchine casuali in pool create utilizzando Machine Creation Services™ (MCS) gestiscono le macchine aggiornando l’immagine master utilizzata nel catalogo e quindi aggiornando le macchine. Questo metodo consente di aggiornare in modo efficiente un gran numero di macchine utente.
  • Per i cataloghi contenenti macchine statiche, assegnate in modo permanente, e per i cataloghi di macchine Remote PC Access, la gestione degli aggiornamenti delle macchine degli utenti avviene al di fuori di Web Studio. Eseguire questa attività individualmente o collettivamente utilizzando strumenti di distribuzione software di terze parti.

Per informazioni sulla creazione e la gestione delle connessioni agli hypervisor host, consultare Connessioni e risorse.

Nota:

MCS non supporta Windows 10 IoT Core e Windows 10 IoT Enterprise. Per maggiori informazioni, consultare il sito Microsoft.

Informazioni sulle istanze persistenti

Quando si aggiorna un catalogo MCS creato utilizzando istanze persistenti o dedicate, tutte le nuove macchine create per il catalogo utilizzano l’immagine aggiornata. Le istanze preesistenti continuano a utilizzare l’istanza originale. Il processo di aggiornamento di un’immagine viene eseguito allo stesso modo per qualsiasi altro tipo di catalogo. Considerare quanto segue:

  • Con i cataloghi di dischi persistenti, le macchine preesistenti non vengono aggiornate alla nuova immagine, ma tutte le nuove macchine aggiunte al catalogo utilizzano la nuova immagine.
  • Per i cataloghi di dischi non persistenti, l’immagine della macchina viene aggiornata al successivo ripristino della macchina.
  • Con i cataloghi di macchine persistenti, l’aggiornamento dell’immagine aggiorna anche le istanze del catalogo che la utilizzano.
  • Per i cataloghi che non persistono, se si desiderano immagini diverse per macchine diverse, le immagini devono risiedere in cataloghi separati.

Gestire i cataloghi di macchine

È possibile gestire un catalogo di macchine in due modi:

Utilizzare Web Studio

Questa sezione descrive come è possibile gestire i cataloghi utilizzando Web Studio:

  1. Utilizzare la funzione di ricerca per individuare un catalogo di macchine specifico. Per istruzioni, consultare Cercare istanze.
  2. Dai risultati della ricerca, selezionare un catalogo, se necessario.
  3. Fare riferimento alla seguente tabella per le descrizioni delle colonne del catalogo.
  4. Fare clic su una scheda nel riquadro dei dettagli inferiore per maggiori informazioni su questo catalogo.
Colonna Descrizione
Catalogo macchine

Il nome e il tipo di allocazione del catalogo. I tipi di allocazione includono:
  • Casuale: Le macchine nel catalogo vengono allocate a un utente in modo casuale.
  • Permanente: Le macchine nel catalogo vengono allocate a un utente in modo permanente.
    		•
    Tipo di macchina




    		Il tipo di sessione supportato delle macchine nel catalogo. I valori possibili includono:
  • Tipo di sistema operativo: SO multi-sessione (virtuale); Dati utente: Scartati.
  • Tipo di sistema operativo: SO multi-sessione (virtuale); Dati utente: Su disco locale
  • Tipo di sistema operativo: SO a sessione singola (Remote PC Access)
  • Tipo di sistema operativo: SO a sessione singola (virtuale); Dati utente: Scartati
  • Tipo di sistema operativo: SO a sessione singola (virtuale); Dati utente: Su disco locale
    		•
    Conteggio macchine Il conteggio delle macchine nel catalogo e il metodo di provisioning. I metodi di provisioning possibili includono: Servizi di creazione macchine (macchina MCS), Manuale e Servizi di provisioning Citrix™.
    Conteggio allocato Il numero di macchine nel catalogo assegnate a un gruppo di consegna.
    Cartella La posizione del catalogo all’interno dell’albero Cataloghi macchine. Visualizza il nome della cartella in cui si trova il catalogo (inclusa la barra rovesciata finale), o - se il catalogo si trova a livello radice.
    Aggiornamento VDA Stato di aggiornamento VDA. I valori possibili includono: Non configurato, Pianificato, Disponibile e Aggiornato.
    Stato immagine Lo stato di aggiornamento dell’immagine del catalogo. Applicabile solo ai cataloghi di macchine non persistenti. I valori possibili includono: Completamente aggiornato, Parzialmente aggiornato, Aggiornamenti in sospeso, Preparazione

    Prima di iniziare:

    • Assicurarsi che l’host di virtualizzazione disponga di processori, memoria e spazio di archiviazione sufficienti per ospitare le macchine aggiuntive.
    • Assicurarsi di disporre di un numero sufficiente di account computer di Active Directory non utilizzati. Se si utilizzano account esistenti, il numero di macchine che è possibile aggiungere è limitato dal numero di account disponibili.
    • Se si utilizza Web Studio per creare account computer di Active Directory per le macchine aggiuntive, è necessario disporre delle autorizzazioni appropriate di amministratore di dominio.

    Per aggiungere macchine a un catalogo:

    1. Accedere a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro sinistro.
    3. Selezionare un catalogo di macchine e quindi selezionare Aggiungi macchine nella barra delle azioni.
    4. Selezionare il numero di macchine virtuali da aggiungere.
    5. Se gli account Active Directory esistenti non sono sufficienti per il numero di VM che si stanno aggiungendo, selezionare il dominio e la posizione in cui vengono creati gli account. Specificare uno schema di denominazione degli account, utilizzando i segni di hash per indicare dove appaiono numeri o lettere sequenziali. Non utilizzare una barra (/) in un nome di OU. Un nome non può iniziare con un numero. Ad esempio, uno schema di denominazione PC-Sales-## (con 0-9 selezionato) produce account computer denominati PC-Sales-01, PC-Sales-02, PC-Sales-03 e così via.
    6. Se si utilizzano account Active Directory esistenti, sfogliare gli account o fare clic su Importa e specificare un file .csv contenente i nomi degli account. Assicurarsi che ci siano abbastanza account per tutte le macchine che si stanno aggiungendo. Web Studio gestisce questi account. Consentire a Web Studio di reimpostare le password per tutti gli account, oppure specificare la password dell’account, che deve essere la stessa per tutti gli account.

    Le macchine vengono create come processo in background e la creazione di molte macchine può richiedere molto tempo. La creazione delle macchine continua anche se si chiude Web Studio.

    Dopo aver eliminato una macchina da un catalogo di macchine, gli utenti non possono più accedervi, quindi prima di eliminare una macchina, assicurarsi che:

    • I dati utente siano stati sottoposti a backup o non siano più necessari.
    • Tutti gli utenti siano disconnessi. L’attivazione della modalità di manutenzione impedisce nuove connessioni a una macchina.
    • Le macchine siano spente.

    Per eliminare macchine da un catalogo:

    1. Accedere a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro sinistro.
    3. Selezionare un catalogo e quindi selezionare Visualizza macchine nella barra delle azioni.
    4. Selezionare una o più macchine e quindi selezionare Elimina nella barra delle azioni.

    Scegliere se eliminare le macchine che vengono rimosse. Se si sceglie di eliminare le macchine, indicare se gli account Active Directory per tali macchine vengono mantenuti, disabilitati o eliminati.

    1. Nella pagina Descrizione, modificare la descrizione del catalogo.
    2. Selezionare Cataloghi macchine nel riquadro sinistro.
    3. Selezionare un catalogo e quindi selezionare Modifica catalogo macchine nella barra delle azioni.
    4. Nella pagina Ambiti, modificare gli ambiti.

    5. Nella pagina NIC, eseguire le seguenti azioni:

      • Per modificare la mappatura della subnet di una NIC, selezionare una rete dal campo Rete associata.
      • Per aggiungere una mappatura della subnet, selezionare Aggiungi NIC, selezionare una rete dal campo Rete associata e fare clic su Salva.

      Solo le subnet presenti nell’host associato al catalogo appaiono nel campo Rete associata.

      È possibile aggiungere NIC solo ai cataloghi di macchine Azure senza profili macchina.

      Nota:

      • Per i cataloghi di macchine AWS, non è possibile mappare la stessa subnet a più di una NIC.
      • Per i cataloghi di macchine con profili macchina, il numero di NIC sul catalogo deve essere uguale al numero di NIC sul profilo macchina.
      • Questa funzionalità non è supportata per gli hypervisor IBM Cloud.
      • Questa funzionalità è supportata solo per Nutanix Prism Element nel caso di hypervisor Nutanix.

    6. Potrebbero essere visualizzate altre pagine a seconda del tipo di catalogo.

      Per i cataloghi creati utilizzando un’immagine di Azure Resource Manager, sono visibili le seguenti pagine. Tenere presente che le modifiche apportate si applicano solo alle macchine che verranno aggiunte al catalogo in seguito. Le macchine esistenti rimangono invariate.

      • Nella pagina Macchine virtuali, modificare le dimensioni della macchina e le zone di disponibilità in cui si desidera creare le macchine.

        Nota:

        • Vengono visualizzate solo le dimensioni delle macchine supportate dal catalogo.
        • Se necessario, selezionare Mostra solo le dimensioni delle macchine utilizzate in altri cataloghi di macchine per filtrare l’elenco delle dimensioni delle macchine.

      • Nella pagina Profilo macchina, scegliere se utilizzare o modificare un profilo macchina.

      • (Visibile solo quando il catalogo è configurato con un host di gruppo dedicato) Nella pagina Gruppo host dedicato, scegliere se modificare un gruppo host.

      • Nella pagina Tipi di archiviazione e licenza, scegliere se modificare il tipo di archiviazione, il tipo di licenza e le impostazioni di Azure Computer Gallery (disponibile solo quando è in uso Posiziona immagine preparata in Azure Gallery).

      Nota:

      Se l’impostazione appena selezionata non supporta le dimensioni attuali della macchina, viene visualizzata una finestra di dialogo di avviso che informa che la modifica dell’impostazione reimposta l’impostazione delle dimensioni della macchina. Se si sceglie di continuare, un punto rosso appare accanto al menu Macchine virtuali, invitando a selezionare una nuova dimensione della macchina.

      • Nella pagina Tipo di licenza, scegliere se modificare l’impostazione della licenza Windows o Linux.

      Per i cataloghi Remote PC Access, sono visibili le seguenti pagine:

      • Nella pagina Gestione alimentazione, modificare le impostazioni di gestione dell’alimentazione e selezionare una connessione di gestione dell’alimentazione.
      • Nella pagina Unità organizzative, aggiungere o rimuovere OU di Active Directory.
    7. Fare clic su Applica per applicare le modifiche apportate e fare clic su Salva per uscire.
    1. Accedere a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro sinistro.
    3. Selezionare un catalogo e quindi selezionare Rinomina catalogo macchine nella barra delle azioni.
    4. Immettere il nuovo nome.

    Spostare un catalogo in una zona diversa

    Se la distribuzione ha più di una zona, è possibile spostare un catalogo da una zona all’altra.

    Lo spostamento di un catalogo in una zona diversa, diversa dall’hypervisor contenente le VM in quel catalogo, influisce sulle prestazioni.

    1. Accedere a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro sinistro.
    3. Selezionare un catalogo e quindi selezionare Sposta nella barra delle azioni.
    4. Selezionare la zona in cui si desidera spostare il catalogo.

    Prima di eliminare un catalogo, assicurarsi che:

    • Tutti gli utenti siano disconnessi e che non siano in esecuzione sessioni disconnesse.
    • La modalità di manutenzione sia attivata per tutte le macchine nel catalogo in modo che non possano essere stabilite nuove connessioni.
    • Tutte le macchine nel catalogo siano spente.
    • Il catalogo non sia associato a un gruppo di consegna. In altre parole, il gruppo di consegna non contiene macchine dal catalogo.

    Per eliminare un catalogo:

    1. Accedere a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro sinistro.
    3. Selezionare un catalogo e quindi selezionare Elimina catalogo macchine nella barra delle azioni.
    4. Indicare se le macchine nel catalogo vengono eliminate. Se si sceglie di eliminare le macchine, indicare se gli account Active Directory per tali macchine vengono mantenuti, disabilitati o eliminati.

    Convertire i cataloghi MCS legacy in Azure in cataloghi basati su profili macchina

    Per convertire un catalogo di macchine non basato su profili macchina in un catalogo di macchine basato su profili, completare i seguenti passaggi:

    1. Nella pagina Cataloghi macchine, fare clic con il pulsante destro del mouse sul nome del Catalogo macchine che si desidera convertire, quindi selezionare Modifica catalogo macchine.
    2. Nella pagina Modifica catalogo macchine > Profilo macchina, selezionare la casella di controllo Usa un profilo macchina (obbligatorio per Azure Active Directory).
    3. Fare clic su Seleziona un profilo macchina.
    4. Nella pagina Seleziona un profilo macchina, selezionare una macchina virtuale o un modello di avvio da utilizzare come profilo macchina.
    5. Se alcune impostazioni attuali differiscono dalle nuove impostazioni del profilo macchina, selezionare l’opzione richiesta per le impostazioni che si desidera utilizzare e fare clic su Continua.
    6. Fare clic su Applica.

    Nota:

    Attualmente, questa funzionalità è supportata solo per Azure, AWS e VMware.

    Per gestire gli account Active Directory in un catalogo di macchine, è possibile:

    • Liberare account macchina non utilizzati rimuovendo gli account computer di Active Directory dai cataloghi di SO a sessione singola e SO multi-sessione. Tali account possono quindi essere utilizzati per altre macchine.
    • Aggiungere account in modo che quando vengono aggiunte più macchine al catalogo, gli account computer siano già presenti. Non utilizzare una barra (/) in un nome di OU.

    Per gestire gli account Active Directory:

    1. Accedere a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro sinistro.
    3. Selezionare un catalogo e quindi selezionare Gestisci account AD nella barra delle azioni.
    4. Scegliere se aggiungere o eliminare account computer. Se si aggiungono account, specificare cosa fare con le password degli account: reimpostarle tutte o immettere una password che si applica a tutti gli account.

    È possibile reimpostare le password se non si conoscono le password degli account correnti; è necessario disporre dell’autorizzazione per eseguire una reimpostazione della password. Quando si immette una password, la password viene modificata sugli account man mano che vengono importati. Quando si elimina un account, scegliere se l’account in Active Directory viene mantenuto, disabilitato o eliminato.

    Indicare se gli account Active Directory vengono mantenuti, disabilitati o eliminati quando si rimuovono macchine da un catalogo o si elimina un catalogo.

    Si consiglia di salvare copie o snapshot delle immagini master prima di aggiornare le macchine nel catalogo. Il database mantiene una cronologia delle immagini master utilizzate con ogni catalogo di macchine. Eseguire il rollback, o ripristino, delle macchine in un catalogo per utilizzare la versione precedente dell’immagine master. Eseguire questa attività se gli utenti riscontrano problemi con gli aggiornamenti distribuiti ai loro desktop. Ciò riduce al minimo i tempi di inattività degli utenti. Non eliminare, spostare o rinominare le immagini master. Non è possibile ripristinare un catalogo per utilizzarle.

    Dopo l’aggiornamento di una macchina, questa si riavvia automaticamente.

    Aggiornare o creare un’immagine master

    Prima di aggiornare il catalogo di macchine, aggiornare un’immagine master esistente o crearne una sull’hypervisor host.

    1. Sull’hypervisor, acquisire uno snapshot della VM corrente e assegnare allo snapshot un nome significativo. Questo snapshot può essere utilizzato per ripristinare (eseguire il rollback) le macchine nel catalogo, se necessario.
    2. Se necessario, accendere l’immagine master e accedere.
    3. Installare gli aggiornamenti o apportare le modifiche richieste all’immagine master.
    4. Spegnere la VM.
    5. Acquisire uno snapshot della VM. Assegnargli un nome significativo che venga riconosciuto quando il catalogo viene aggiornato in Web Studio. Sebbene Web Studio possa creare uno snapshot, Citrix consiglia di crearlo utilizzando la console di gestione dell’hypervisor. Quindi selezionare quello snapshot in Web Studio. Questo processo consente di fornire un nome e una descrizione significativi anziché un nome generato automaticamente. Per le immagini master GPU, è possibile modificare l’immagine master solo tramite la console XenServer®.

    Modificare l’immagine master

    Per preparare e distribuire l’aggiornamento a tutte le macchine in un catalogo:

    1. Accedere a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro sinistro.
    3. Selezionare un catalogo e quindi selezionare Modifica immagine master nella barra delle azioni.
    4. Nella pagina Immagine, selezionare l’host e l’immagine che si desidera distribuire.

      Suggerimento:

      Per un catalogo creato con MCS, è possibile annotare la sua immagine aggiungendo una nota per l’immagine. Una nota può contenere fino a 500 caratteri. Ogni volta che si modifica l’immagine master, viene creata una voce relativa alla nota, indipendentemente dal fatto che si aggiunga una nota. Se si aggiorna un catalogo senza aggiungere una nota, la voce appare come null (-). Per visualizzare la cronologia delle note per l’immagine, selezionare il catalogo, fare clic su Proprietà modello nel riquadro inferiore e quindi fare clic su Visualizza cronologia note.

    5. Nella pagina Strategia di distribuzione, scegliere quando le macchine nel catalogo di macchine vengono aggiornate con la nuova immagine master: al successivo spegnimento o immediatamente.

      Nota:

      La pagina Strategia di distribuzione non è disponibile per le VM persistenti perché la distribuzione è applicabile solo alle VM non persistenti.

    6. Verificare le informazioni nella pagina Riepilogo e quindi fare clic su Fine. Ogni macchina si riavvia automaticamente dopo essere stata aggiornata.

    Per tenere traccia dell’avanzamento dell’aggiornamento, individuare il catalogo in Cataloghi macchine per visualizzare la barra di avanzamento in linea e il grafico di avanzamento passo-passo.

    Quando si aggiorna un catalogo utilizzando direttamente PowerShell SDK, anziché Web Studio, specificare un modello di hypervisor (VMTemplates). Utilizzare questo come alternativa a un’immagine o a uno snapshot di un’immagine.

    Per distribuire una nuova immagine master a un catalogo di macchine basato su Azure:

    1. Da Web Studio, selezionare Cataloghi macchine nel riquadro sinistro.
    2. Selezionare un catalogo Azure e quindi selezionare Modifica immagine master nella barra delle azioni.
    3. Nella pagina Modifica immagine master, selezionare un’immagine sotto Immagine master. Il pannello elenca tutte le immagini che appartengono alla stessa regione di quelle delle Risorse.

    Strategia di distribuzione:

    L’aggiornamento delle immagini al successivo spegnimento influenzerà immediatamente tutte le macchine non attualmente in uso, ovvero le macchine che non hanno una sessione utente attiva. Un sistema in uso riceve l’aggiornamento quando la sessione attiva corrente termina. Considerare quanto segue:

    • Le nuove sessioni non possono essere avviate finché l’aggiornamento non è stato completato sulle macchine applicabili.
    • Per le macchine con SO a sessione singola, le macchine vengono immediatamente aggiornate quando la macchina non è in uso o quando gli utenti non sono connessi.
    • Per un SO multi-sessione con macchine figlie, i riavvii non avvengono automaticamente. Per applicare l’immagine master aggiornata, riavviare le macchine utilizzando Studio, PowerShell o Workspace. Il riavvio dalle macchine o dall’hypervisor non applica l’aggiornamento.

    Suggerimento:

    Limitare il numero di macchine riavviate utilizzando le impostazioni avanzate per una connessione host. Utilizzare queste impostazioni per modificare le azioni intraprese per un determinato catalogo; le impostazioni avanzate variano a seconda dell’hypervisor.

    Eseguire il rollback dell’immagine master

    Dopo aver distribuito un’immagine master aggiornata o nuova, è possibile eseguirne il rollback. Questo processo potrebbe essere necessario se si verificano problemi con le macchine appena aggiornate. Quando si esegue il rollback, le macchine nel catalogo vengono ripristinate all’ultima immagine funzionante. Tutte le nuove funzionalità che richiedono l’immagine più recente non sono più disponibili. Come per la distribuzione, il rollback di una macchina include un riavvio.

    1. Accedere a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro sinistro.
    3. Selezionare il catalogo e quindi selezionare Esegui rollback immagine master nella barra delle azioni.
    4. Specificare quando applicare l’immagine master precedente alle macchine, come descritto nella sezione precedente per l’operazione di distribuzione.

    Il rollback viene applicato solo alle macchine che devono essere ripristinate. Le macchine che non sono aggiornate con l’immagine master nuova o aggiornata non ricevono messaggi di notifica e non sono costrette a disconnettersi.

    Per tenere traccia dell’avanzamento del rollback, individuare il catalogo in Cataloghi macchine per visualizzare la barra di avanzamento in linea e il grafico di avanzamento passo-passo.

    Modificare il livello funzionale o annullare la modifica

    Modificare il livello funzionale per il catalogo di macchine dopo aver aggiornato i VDA sulle macchine a una versione più recente. Citrix consiglia di aggiornare tutti i VDA all’ultima versione per abilitare l’accesso a tutte le funzionalità più recenti.

    Prima di modificare il livello funzionale per un catalogo di macchine:

    • Avviare le macchine aggiornate in modo che si registrino con il Controller. Questo processo consente a Web Studio di determinare che le macchine nel catalogo necessitano di aggiornamento.

    Per modificare il livello funzionale per un catalogo:

    1. Accedere a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro sinistro.
    3. Selezionare il catalogo. La scheda Dettagli nel riquadro inferiore visualizza le informazioni sulla versione.
    4. Selezionare Modifica livello funzionale. Se Web Studio rileva che il catalogo necessita di aggiornamento, visualizza un messaggio. Seguire le istruzioni. Se una o più macchine non possono essere aggiornate, un messaggio spiega il motivo. Per garantire che tutte le macchine funzionino correttamente, Citrix consiglia di risolvere i problemi delle macchine prima di fare clic su Modifica per procedere.

    Dopo il completamento della modifica del catalogo, è possibile ripristinare le macchine alle versioni VDA precedenti selezionando il catalogo e quindi selezionando Annulla modifica livello funzionale nella barra delle azioni.

    Prima di clonare un catalogo, tenere presente le seguenti considerazioni:

    Nota:

    Se si seleziona un catalogo Azure da clonare e si seleziona un’immagine master, il pannello elenca tutte le immagini che appartengono alla stessa regione di quelle delle Risorse.

    • La clonazione di un catalogo può richiedere del tempo per essere completata. Se necessario, selezionare Nascondi avanzamento per eseguire la clonazione in background.
    • Il catalogo clonato eredita il nome dell’originale e ha un suffisso Copia. È possibile modificare il nome. Vedere Rinominare un catalogo.
    • Dopo il completamento della clonazione, assicurarsi di assegnare il catalogo clonato a un gruppo di consegna.
    1. Accedere a Web Studio, quindi selezionare Cataloghi macchine nel riquadro sinistro.
    2. Selezionare un catalogo e quindi selezionare Clona nella barra delle azioni.
    3. Nella finestra Clona catalogo macchine selezionato, visualizzare le impostazioni per il catalogo clonato e configurare le impostazioni come applicabile. Selezionare Avanti per procedere alla pagina successiva.
    4. Nella pagina Riepilogo, visualizzare un riepilogo delle impostazioni e selezionare Fine per avviare la clonazione.
    5. Se necessario, selezionare Nascondi avanzamento per eseguire la clonazione in background.

    Organizzare i cataloghi utilizzando le cartelle

    È possibile creare cartelle per organizzare i cataloghi per un facile accesso. Ad esempio, è possibile organizzare i cataloghi per tipo di immagine o per struttura organizzativa.

    Suggerimento:

    È possibile impostare la visualizzazione predefinita preferita (visualizzazione cartella o elenco) per il nodo Cataloghi macchine facendo clic sull’icona Cartella nell’angolo in alto a destra della barra delle azioni.

    Prima di iniziare, pianificare prima come organizzare i cataloghi. Considerare quanto segue:

    • È possibile annidare le cartelle fino a cinque livelli di profondità (esclusa la cartella radice predefinita).
    • Una cartella di catalogo può contenere cataloghi e sottocartelle.
    • Tutti i nodi in Web Studio (come Cataloghi macchine, Gruppi di consegna, Applicazioni e Gruppi di applicazioni) condividono lo stesso albero di cartelle nel back-end. Per evitare conflitti di nomi durante la ridenominazione o lo spostamento di cartelle, utilizzare nomi univoci per le cartelle di primo livello tra i diversi nodi.

    Se si crea una cartella utilizzando il cmdlet SDK New-BrokerAdminFolder e si desidera che appaia sotto il nodo Cataloghi macchine, è necessario aggiungere i metadati ContainsMachineCatalogs utilizzando il cmdlet Set-BrokerAdminFolderMetadata.

    Esempio:

    Set-BrokerAdminFolderMetadata -AdminFolderId {adminFolderUid} -Name ContainsMachineCatalogs -Value true
<!--NeedCopy-->

    Per creare una cartella di catalogo, seguire questi passaggi:

    1. Selezionare Cataloghi macchine nel riquadro sinistro.
    2. Nella gerarchia delle cartelle, selezionare una cartella e quindi selezionare Crea cartella nella barra Azioni.
    3. Immettere un nome per la nuova cartella, quindi fare clic su Fine.

    Suggerimento:

    Se si crea una cartella in una posizione non intenzionale, è possibile trascinarla nella posizione corretta.

    È possibile spostare un catalogo tra le cartelle. I passaggi dettagliati sono i seguenti:

    1. Selezionare Cataloghi macchine nel riquadro sinistro.
    2. Visualizzare i cataloghi per cartella. È anche possibile attivare Visualizza tutto sopra la gerarchia delle cartelle per visualizzare tutti i cataloghi contemporaneamente.
    3. Fare clic con il pulsante destro del mouse su un catalogo e quindi selezionare Sposta catalogo macchine.
    4. Selezionare la cartella in cui si desidera spostare il catalogo, quindi fare clic su Fine.

    Suggerimento:

    È possibile trascinare un catalogo in una cartella.

    È possibile eliminare, rinominare e spostare le cartelle di catalogo.

    È possibile eliminare una cartella solo se essa e le sue sottocartelle non contengono cataloghi.

    Per gestire una cartella, seguire i passaggi seguenti:

    1. Selezionare Cataloghi macchine nel riquadro sinistro.

    2. Nella gerarchia delle cartelle, selezionare una cartella e quindi selezionare un’azione nella barra Azioni come necessario:

      • Per rinominare la cartella, selezionare Rinomina cartella.
      • Per eliminare la cartella, selezionare Elimina cartella.
      • Per spostare la cartella, selezionare Sposta cartella.
    3. Seguire le istruzioni visualizzate per completare i passaggi rimanenti.

    Aggiornare i VDA

    È possibile utilizzare l’interfaccia di Studio per aggiornare i VDA con facilità. Per maggiori informazioni e una guida passo-passo, consultare la documentazione di Citrix VDA Upgrade Service.

    Nota:

    Questa funzionalità si applica solo ai cataloghi MCS.

    I cataloghi non riusciti sono contrassegnati da un’icona di errore. Per visualizzare i dettagli, andare alla scheda Risoluzione dei problemi di ogni catalogo. Prima di riprovare la creazione del catalogo, tenere presente le seguenti considerazioni:

    • Controllare prima le informazioni sulla risoluzione dei problemi e risolvere i problemi. Le informazioni descrivono i problemi riscontrati e forniscono raccomandazioni per risolverli.
    • Non è possibile modificare le impostazioni associate a Sistema operativo e gestione macchine. Il catalogo eredita tali impostazioni dall’originale.
    • La creazione può richiedere del tempo per essere completata. Se necessario, selezionare Nascondi avanzamento per eseguire la creazione in background.

    Per riprovare a creare un catalogo, eseguire quanto segue:

    1. Da Web Studio, selezionare Cataloghi macchine nel riquadro sinistro.
    2. Selezionare il catalogo e quindi andare alla sua scheda Risoluzione dei problemi.
    3. Fare clic sul collegamento ipertestuale di riprova per riprovare a creare il catalogo.
    4. Nella procedura guidata che appare, modificare le impostazioni dove necessario. Se non è necessario apportare modifiche, è possibile andare direttamente alla pagina Riepilogo.
    5. Dopo aver terminato, selezionare Fine per avviare la creazione.

    Registrare VDA non forniti da MCS utilizzando token

    È ora possibile generare e gestire token di registrazione per VDA non forniti da MCS. Questa implementazione consente la registrazione VDA tramite WebSocket senza il provisioning dei VDA con MCS. Questa funzionalità supporta anche Linux Virtual Delivery Agent, Citrix Virtual Delivery Agent per macOS e VDA non uniti a un dominio con Citrix Virtual Apps and Desktops.

    Prima di iniziare

    1. Configurare il sito. Per maggiori informazioni, consultare Creare un sito.
    2. Installare i certificati TLS sui Delivery Controller. Per maggiori informazioni, consultare Installare i certificati server TLS sui Controller.
    3. Installare la CA radice e la CA intermedia sul VDA per considerare attendibile il Delivery Controller.

    4. Abilitare la connessione WebSocket sul Delivery Controller. Eseguire il seguente comando su ogni Delivery Controller presente nel sito:

      New-ItemProperty "HKLM:\SOFTWARE\Citrix\DesktopServer\WorkerProxy" -Name "WebSocket_Enabled" -PropertyType "DWord" -Value 1 -Force
<!--NeedCopy-->

      Nota:

      Assicurarsi di riavviare i Delivery Controller dopo aver abilitato il WebSocket.

    Generare token di registrazione

    Dopo aver deciso di abilitare la registrazione basata su token per le macchine non fornite da Citrix, è necessario prima generare i token per ogni catalogo di macchine e quindi condividerli con gli amministratori dell’installazione VDA.

    Un token di registrazione presenta le seguenti caratteristiche:

    • Intervallo di registrazione: 1–5000 macchine VDA
    • Periodo di validità: fino a 14 giorni

    Per generare un token per un catalogo utilizzando Web Studio, seguire questi passaggi:

    1. In Web Studio > Cataloghi macchine, individuare un catalogo non fornito da MCS, che abbia Metodo di provisioning: Manuale visualizzato nella colonna Conteggio macchine.
    2. Fare clic con il pulsante destro del mouse sul catalogo, quindi selezionare Gestisci token di registrazione.
    3. Nella pagina Genera token di registrazione che appare, fornire le seguenti informazioni sul token:
      • Digitare un nome per il token.
      • Immettere il suo periodo di validità. Il periodo non deve superare i 14 giorni. Il token è valido solo per il periodo specificato.
      • (Facoltativo) Selezionare una connessione host per la gestione dell’alimentazione dei VDA registrati con il token. Le opzioni includono tutte le connessioni host sotto la zona di questo catalogo.
      • Immettere i limiti di utilizzo del token (tra 1 e 5000).
    4. Fare clic su Genera.

    5. Nella finestra Token generato con successo che appare, copiare il token e salvarlo in un luogo sicuro, oppure fare clic su Scarica per scaricarlo nella cartella Download.

      Un record del token appare nell’elenco dei token.

      Token generation

    6. Condividere il token con gli amministratori dell’installazione VDA.

      Per maggiori informazioni su come installare VDA e un token sulle macchine, consultare Installare i VDA.

    Gestire i token

    Si hanno due opzioni per revocare un token e renderlo non disponibile per la registrazione VDA:

    • Revoca: Revocare il token ma mantenerlo nell’elenco per scopi di registrazione.
    • Elimina: Revocare il token ed eliminarlo dall’elenco.

    Nota:

    I token scaduti vengono eliminati automaticamente entro 14 giorni.

    Registrare macchine nei cataloghi utilizzando lo strumento di registrazione VDA WebSocket

    Lo strumento di registrazione VDA WebSocket facilita la registrazione basata su token per le macchine VDA. Questo strumento aiuta a convertire una connessione in una connessione WebSocket aggiungendo il VDA al catalogo di macchine utilizzando il token di registrazione.

    Nota:

    Questo strumento è progettato per registrare macchine VDA che non sono state registrate in alcun catalogo di macchine.

    Seguire le istruzioni per eseguire lo strumento di registrazione:

    1. Accedere al VDA.
    2. Individuare lo strumento EnrollMachine.exe, in C:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Tool.
    3. Eseguire lo strumento con i parametri di input appropriati. Ad esempio, EnrollMachine.exe -websocket_token_string:xxxxxxxxx

    La seguente tabella descrive i parametri di input dello strumento di registrazione:

    Nome parametro Obbligatorio Descrizione Esempio
    -websocket_token_stdin Sì

    		Legge il token di registrazione. .\EnrollMachine.exe -websocket_token_stdin
    -websocket_token_string Legge il token di registrazione direttamente dal parametro della riga di comando. .\EnrollMachine.exe -websocket_token_string:<token>
    -websocket_token_file:[token-file-path] Legge il token di registrazione dal percorso fornito. .\EnrollMachine.exe -websocket_token_file:C:\token\test2.txt
    log:[log-file-path] No Mostra i log dello strumento di registrazione. .\EnrollMachine.exe log:[C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt]
    -help No Mostra un breve testo di aiuto. .\EnrollMachine.exe -help

    Dopo la registrazione riuscita, si riceverà un messaggio di successo sullo strumento e nei log. Assicurarsi di accedere a Web Studio per verificare che la macchina VDA sia stata aggiunta al catalogo e che lo stato della macchina sia registrato.

    Risoluzione dei problemi

    Per impostazione predefinita, è possibile trovare i log dello strumento di registrazione in:

    C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt

    Se è stato specificato un percorso diverso per i log, è possibile utilizzare log:[log-file-path] per recuperare i log.

    La seguente tabella elenca i codici restituiti dallo strumento di registrazione:

    Codice Stringa Descrizione
    0 Successo Il VDA è stato aggiunto con successo al catalogo di macchine.
    -1 Argomento non valido Il parametro di input nel token di registrazione non è valido.
    -2 BrokerAgentNotFound Il servizio dell’agente broker non è stato trovato.
    -3 Token non valido Il token immesso non è valido.
    -4 TokenMissingRequiredClaims I claim richiesti per il token sono mancanti, ad esempio CustomerId o URI di registrazione.
    -5 Errore interno Si è verificato un errore generale.
    -6 Timeout L’attività è scaduta.
    -7 FailedToDetermineMachineADJoinedStatus Il servizio che restituisce lo stato di unione AD della macchina non è riuscito.
    -8 ADMachineFailedToFindSid Il servizio che restituisce il SID della macchina AD non è riuscito.
    -9 EnrollRequestFailed La richiesta non è riuscita a causa di un errore HTTP.
    -10 EnrollResponseMissingRequiredFields La risposta dello strumento di registrazione manca del parametro VirtualSiteId.
    -11 Autorizzazione insufficiente Non si dispone dell’autorizzazione richiesta per eseguire l’attività.
    -12 FailedToDetermineMachineAadJoinedStatus Il servizio che controlla lo stato di unione AD della macchina genera un errore.
    -13 AadMachineFailedToFindDeviceId Il parametro aggiuntivo AAD device id aggiunto dal sistema è vuoto.
    -14 AadDeviceIdNotValid Il parametro aggiuntivo AAD device id aggiunto dal sistema non è un GUID valido.
    -15 NoValidMacAddress Indirizzo MAC non valido.
    -16 FailedToGetComputerHostNameForVdaInstanceName Impossibile ottenere il nome host del computer per impostare il parametro aggiuntivo VdaInstanceName.
    -17 VirtualDesktopAgentRegistryKeyFailedToOpen Impossibile aprire la chiave di registro VDA per scrivere l’elenco dei Delivery Controller.
    -18 Il token non è riuscito a raggiungere il conteggio massimo Il token non è riuscito a raggiungere il conteggio massimo.

    Utilizzare PowerShell

    Questa sezione descrive come è possibile gestire i cataloghi utilizzando PowerShell:

    È possibile ottenere errori e avvisi storici per comprendere i problemi con il catalogo di macchine MCS e risolverli.

    Utilizzando i comandi PowerShell, è possibile:

    • Ottenere un elenco di errori o avvisi
    • Modificare lo stato di avviso da Nuovo a Riconosciuto
    • Eliminare gli errori o gli avvisi

    Per eseguire i comandi PowerShell:

    1. Aprire una finestra PowerShell.
    2. Eseguire asnp citrix* per caricare i moduli PowerShell specifici di Citrix.

    Per ottenere un elenco di errori e avvisi:

    Eseguire il comando Get-ProvOperationEvent.

    • Senza parametri: Ottiene tutti gli errori e gli avvisi
    • Con i parametri LinkedObjectType e LinkedObjectUid: Ottiene tutti gli errori e gli avvisi associati a uno schema di provisioning specifico
    • Con il parametro EventId: Ottiene un errore o un avviso specifico che corrisponde a questo ID evento
    • Con il parametro Filter: Ottiene errori o avvisi tramite filtro personalizzato

    Per modificare lo stato degli errori o degli avvisi da Nuovo a Riconosciuto:

    Eseguire il comando Confirm-ProvOperationEvent.

    • Con il parametro EventId: Imposta lo stato di un errore o avviso specifico che corrisponde a questo ID evento. È possibile ottenere l’EventId di un errore o avviso specifico come output dal comando Get-ProvOperationEvent
    • Con i parametri LinkedObjectType e LinkedObjectUid: Imposta lo stato di tutti gli errori e gli avvisi associati a uno schema di provisioning specifico
    • Con il parametro All: Imposta lo stato di tutti gli errori e gli avvisi come Riconosciuto

    Per eliminare gli errori o gli avvisi:

    Eseguire il comando Remove-ProvOperationEvent.

    • Con il parametro EventId: Rimuove un errore o un avviso specifico che corrisponde a questo ID evento. È possibile ottenere l’EventId di un errore o avviso specifico come output dal comando Get-ProvOperationEvent
    • Con i parametri LinkedObjectType e LinkedObjectUid: Rimuove tutti gli errori e gli avvisi associati a uno schema di provisioning specifico
    • Con il parametro All: Rimuove tutti gli errori e gli avvisi

    Per maggiori informazioni, consultare Citrix PowerShell SDK.

    Eliminare macchine senza accesso all’hypervisor

    Quando si elimina una VM o uno schema di provisioning, MCS deve rimuovere i tag dalla VM, e talvolta anche dal disco di base, in modo che le risorse incluse nelle opzioni di eliminazione non siano più tracciate o identificate da MCS. Tuttavia, alcune di queste risorse sono accessibili solo tramite hypervisor. Utilizzare l’opzione PurgeDBOnly in Remove-ProvVM PowerShell per eliminare oggetti risorsa VM come VM, disco di base, immagine in ACG e così via dal database anche quando non c’è accesso all’hypervisor.

    Questa opzione è abilitata su:

    • tutti gli hypervisor supportati
    • VM persistenti e non persistenti

    Limitazioni

    Non è possibile utilizzare i comandi -PurgeDBOnly e -ForgetVM contemporaneamente.

    Utilizzare il comando PurgeDBOnly

    Quando si esegue il comando PowerShell Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -ForgetVM, l’operazione di eliminazione potrebbe fallire nei seguenti scenari:

    • La connessione host è in modalità di manutenzione
    • Credenziali non valide
    • Errore di autenticazione
    • Operazione non autorizzata
    • L’hypervisor non è raggiungibile

    Nota:

    Remove-provVM -ForgetVM si rivolge solo alle VM persistenti. Se una delle VM nell’elenco non è persistente, l’operazione fallisce.

    Quando l’operazione fallisce perché l’hypervisor non è raggiungibile, appare il seguente prompt:

    Try to use -PurgeDBOnly option to clean DDC database.

    Utilizzare l’opzione -PurgeDBOnly nel comando PowerShell Remove-ProvVM per eliminare i riferimenti di una VM dal database MCS. Ad esempio,

    Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -PurgeDBOnly

    Aggiungere descrizioni a un’immagine

    È possibile aggiungere descrizioni informative sulle modifiche relative agli aggiornamenti delle immagini per i cataloghi di macchine. Utilizzare questa funzionalità per aggiungere una descrizione durante la creazione di un catalogo o quando si aggiorna un’immagine master esistente per un catalogo. È anche possibile visualizzare le informazioni per ogni immagine master nel catalogo. Utilizzare i seguenti comandi per aggiungere o visualizzare le descrizioni delle immagini:

    • Per aggiungere una nota durante la creazione di un catalogo di macchine con un’immagine master, utilizzare il parametro MasterImageNote nel comando NewProvScheme. Ad esempio:

       C:\PS>New-ProvScheme -ProvisioningSchemeName <name> -HostingUnitName <name> -IdentityPoolName <name> -MasterImageVM
 XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\Base.snapshot -MasterImageNote "Note"
 <!--NeedCopy-->

    • Per aggiornare l’immagine master associata a un catalogo di macchine, utilizzare il parametro MasterImageNote nel comando Publish-ProvMasterVMImage. Ad esempio:

       C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName <name> -MasterImageVM XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\base.snapshot -MasterImageNote "Note"
 <!--NeedCopy-->

    • Per visualizzare le informazioni per ogni immagine, utilizzare il comando Get-ProvSchemeMasterVMImageHistory. Ad esempio:

       C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall
 <!--NeedCopy-->

    Per tenere traccia dell’avanzamento del rollback, individuare il catalogo in Cataloghi macchine per visualizzare la barra di avanzamento in linea e il grafico di avanzamento passo-passo.

    Non è possibile eseguire il rollback in determinati scenari, inclusi i seguenti. (L’opzione Esegui rollback immagine master non è visibile).

    • Non si dispone dell’autorizzazione per eseguire il rollback.
    • Il catalogo non è stato creato utilizzando MCS.
    • Il catalogo è stato creato utilizzando un’immagine del disco del sistema operativo.
    • Lo snapshot utilizzato per creare il catalogo è danneggiato.
    • Le modifiche utente alle macchine nel catalogo non persistono.
    • Le macchine nel catalogo sono in esecuzione.

    Ripristinare il disco del sistema operativo

    Utilizzare il comando PowerShell Reset-ProvVMDisk per ripristinare il disco del sistema operativo di una VM persistente in un catalogo di macchine creato con MCS. Attualmente, questa funzionalità è applicabile agli ambienti di virtualizzazione AWS, Azure, XenServer, Google Cloud, SCVMM e VMware.

    Per eseguire correttamente il comando PowerShell, assicurarsi che:

    • Le VM di destinazione si trovino in un catalogo MCS persistente.
    • Il catalogo di macchine MCS funzioni correttamente.
    • Ciò implica che lo schema di provisioning e l’host esistano e che lo schema di provisioning abbia voci corrette.
    • L’hypervisor non sia in modalità di manutenzione.
    • Le VM di destinazione siano spente e in modalità di manutenzione.

    Eseguire i seguenti passaggi per ripristinare il disco del sistema operativo:

    1. Aprire una finestra PowerShell.
    2. Eseguire asnp citrix* per caricare i moduli PowerShell specifici di Citrix.

    3. Eseguire il comando PowerShell Reset-ProvVMDisk in uno dei seguenti modi:

      • Specificare l’elenco delle VM come elenco separato da virgole ed eseguire il ripristino su ogni VM:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
 <!--NeedCopy-->

      • Specificare l’elenco delle VM come output dal comando Get-ProvVM ed eseguire il ripristino su ogni VM:

         (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
 <!--NeedCopy-->

      • Specificare una singola VM per nome:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
 <!--NeedCopy-->

      • Creare attività di ripristino separate per ciascuna delle VM restituite dal comando Get-ProvVM. Questo è meno efficiente perché ogni attività eseguirà gli stessi controlli ridondanti, come il controllo delle capacità dell’hypervisor, il controllo della connessione per ogni VM.

         Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
 <!--NeedCopy-->

    4. Appare un prompt di conferma che elenca le VM da ripristinare insieme a un messaggio di avviso che si tratta di un’operazione irreversibile. Se non si fornisce una risposta e si preme Invio, non viene intrapresa alcuna ulteriore azione.

      Nota:

      Non disattivare la modalità di manutenzione delle VM o accenderle fino al completamento del processo di ripristino.

      È possibile eseguire il comando PowerShell -WhatIf per stampare l’azione che verrebbe intrapresa e uscire senza eseguire l’azione.

      È anche possibile ignorare il prompt di conferma utilizzando uno dei seguenti metodi:

      • Fornire il parametro -Force:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
 <!--NeedCopy-->

      • Fornire il parametro -Confirm:$false:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
 <!--NeedCopy-->

      • Prima di eseguire Reset-ProvVMDisk, modificare $ConfirmPreference in None:

         PS C:\Windows\system32> $ConfirmPreference='None'
 PS C:\Windows\system32> $ConfirmPreference
 None
 PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
 <!--NeedCopy-->
    5. Eseguire Get-ProvTask per ottenere lo stato delle attività restituite dal comando Reset-ProvVMDisk.

    Modificare l’impostazione di rete per uno schema di provisioning esistente

    È possibile modificare l’impostazione di rete per uno schema di provisioning esistente in modo che le nuove VM vengano create sulla nuova sottorete. Utilizzare il parametro -NetworkMapping nel comando Set-ProvScheme per modificare l’impostazione di rete.

    Nota:

    Questa funzionalità è supportata su Citrix Virtual Apps and Desktops 2203 LTSR CU3 e versioni successive.

    Per modificare l’impostazione di rete per uno schema di provisioning esistente, eseguire quanto segue:

    1. Nella finestra PowerShell, eseguire il comando asnp citrix* per caricare i moduli PowerShell.
    2. Eseguire (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps per accedere al percorso di rete che si desidera modificare.

    3. Assegnare una variabile alla nuova impostazione di rete. Ad esempio:

      $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
<!--NeedCopy-->
    4. Eseguire Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap.
    5. Eseguire (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps per verificare la nuova impostazione di rete per lo schema di provisioning esistente.

    Gestire le versioni di un catalogo di macchine

    Quando un catalogo di macchine MCS viene aggiornato con il comando Set-ProvScheme, la configurazione corrente viene salvata come versione. È quindi possibile gestire le varie versioni del catalogo di macchine utilizzando i comandi PowerShell. È possibile:

    • Visualizzare l’elenco delle versioni di un catalogo di macchine
    • Utilizzare qualsiasi versione precedente per aggiornare il catalogo di macchine
    • Eliminare manualmente una versione se non è utilizzata da una VM di quel catalogo di macchine
    • Modificare il numero massimo di versioni da conservare dal catalogo di macchine (il valore predefinito è 99)

    Una versione include le seguenti informazioni di un catalogo di macchine:

    • VMCpuCount
    • VMMemoryMB
    • CustomProperties
    • ServiceOffering
    • MachineProfile
    • NetworkMapping
    • SecurityGroup

    Eseguire i seguenti comandi (forniti come esempi) per gestire le varie versioni di un catalogo di macchine.

    • Per visualizzare i dettagli di configurazione delle varie versioni di un catalogo di macchine:

       Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog
 <!--NeedCopy-->

    • Per visualizzare i dettagli di configurazione di una particolare versione di un catalogo di macchine:

       Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2
 <!--NeedCopy-->

    • Per visualizzare il numero totale di versioni associate a un catalogo di macchine:

       (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count
 <!--NeedCopy-->

    • Per utilizzare qualsiasi versione precedente per aggiornare il catalogo di macchine:

       Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
 <!--NeedCopy-->

    • Per eliminare manualmente una versione se non è utilizzata da una VM di quel catalogo di macchine:

       Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
 <!--NeedCopy-->

    • Per impostare il numero massimo di versioni da conservare dal catalogo di macchine (il valore predefinito è 99). Questa impostazione viene applicata a tutti i cataloghi. Ad esempio, in questo caso, un massimo di 15 versioni verranno conservate per tutti i cataloghi forniti da MCS.

       Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15
 <!--NeedCopy-->

    Se il numero di versioni raggiunge il numero massimo di versioni, non è possibile creare una nuova versione se le versioni precedenti sono in uso da una qualsiasi delle VM nel catalogo di macchine. In tal caso, eseguire una delle seguenti operazioni:

    • Aumentare il limite del numero massimo di versioni da conservare dal catalogo di macchine.
    • Aggiornare alcune VM che si trovano su versioni precedenti in modo che tali versioni precedenti non siano più referenziate da alcuna VM e possano essere eliminate.

    Convertire un catalogo di macchine non basato su profili macchina in un catalogo di macchine basato su profili macchina

    È possibile utilizzare una VM, una specifica di modello (nel caso di Azure), un modello di avvio (nel caso di AWS) o un modello VMware (nel caso di VMware) come input del profilo macchina per convertire un catalogo di macchine non basato su profili macchina in un catalogo di macchine basato su profili macchina. Le nuove VM aggiunte al catalogo assumono i valori delle proprietà dal profilo macchina a meno che non vengano sovrascritti da una proprietà personalizzata esplicita.

    Nota:

    Un catalogo di macchine basato su profili macchina esistente non può essere modificato in un catalogo di macchine non basato su profili macchina.

    Per fare ciò:

    1. Creare un catalogo di macchine persistente o non persistente con VM e senza un profilo macchina.
    2. Aprire la finestra PowerShell.

    3. Eseguire il comando Set-ProvScheme per applicare i valori delle proprietà dal profilo macchina alle nuove VM aggiunte al catalogo di macchine. Ad esempio:

      • Nel caso di Azure:

         Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\machineprofile.folder\<ResourceGroupName>\<TemplateSpecName>\<VersionName>
 <!--NeedCopy-->

      • Nel caso di AWS:

         Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\<launch-template>.launchtemplate\<launch-template-version>.launchtemplateversion"
 <!--NeedCopy-->

      • Nel caso di VMware:

          Set-ProvScheme -ProvisioningSchemeName "my-prov-scheme" -MachineProfile "XDHyp:\HostingUnits\my-hosting-unit\my-template.template"
 <!--NeedCopy-->

        Nota:

        Impostare FolderID come proprietà personalizzata per evitare di derivare FolderID dal modello VMware.

    Ripristinare le informazioni sull’identità degli account computer attivi

    È possibile reimpostare le informazioni sull’identità degli account computer attivi che presentano problemi relativi all’identità. È possibile scegliere di reimpostare solo la password della macchina e le chiavi di fiducia, oppure reimpostare tutta la configurazione del disco di identità. Questa implementazione è applicabile sia ai cataloghi di macchine MCS persistenti che non persistenti.

    Nota:

    Attualmente, la funzionalità è supportata per gli ambienti di virtualizzazione AWS, GCP, Azure, SCVMM, XenServer e VMware.

    Condizioni

    Assicurarsi di quanto segue per ripristinare correttamente il disco di identità:

    • Spegnere e impostare la VM in modalità di manutenzione
    • Non includere il parametro -OS nel comando PowerShell

    Ripristinare il disco di identità

    Per ripristinare il disco di identità:

    1. Aprire la finestra PowerShell.
    2. Eseguire asnp citrix* per caricare i moduli PowerShell specifici di Citrix.

    3. Reimpostare le informazioni sull’identità.

      • Per reimpostare solo la password della macchina e le chiavi di fiducia, eseguire il seguente comando:

         Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 <!--NeedCopy-->

        La descrizione dei parametri utilizzati nel comando è la seguente:

        • IdentityAccountName: Il nome dell’account di identità che deve essere ripristinato.
        • PrivilegedUserName: Account utente che ha l’autorizzazione di scrittura sul provider di identità (AD o AzureAD).
        • PrivilegedUserPassword: Password per PrivilegedUserName.
        • Target: Destinazione per l’azione di ripristino. Può essere IdentityInfo per ripristinare la password dell’account/chiave di fiducia, e UserCertificate per ripristinare gli attributi del certificato utente delle identità di macchine unite a Hybrid AzureAD.

      • Per reimpostare tutta la configurazione del disco di identità, eseguire i seguenti comandi nel seguente ordine:

         Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 <!--NeedCopy-->

         Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
 <!--NeedCopy-->

      • Per ricreare completamente il disco di identità:

         Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate
 <!--NeedCopy-->

    4. Digitare y per confermare l’azione. È anche possibile ignorare il prompt di conferma utilizzando il parametro -Force. Ad esempio:

      Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
<!--NeedCopy-->
    5. Eseguire Get-ProvVM -ProvisioningSchemeName <name> -VMName <name> per controllare l’impostazione aggiornata del disco di identità. Gli attributi del disco di identità (ad esempio, IdentityDiskId) devono essere aggiornati. StorageId e IdentityDiskIndex non devono cambiare.

    Modificare la configurazione della cache su un catalogo di macchine esistente

    Dopo aver creato un catalogo non persistente con MCSIO abilitato, è possibile utilizzare il comando Set-ProvScheme per modificare i seguenti parametri:

    • WriteBackCacheMemorySize
    • WriteBackCacheDiskSize

    Questa funzionalità è attualmente applicabile a:

    • Ambienti GCP e Microsoft Azure, e
    • un catalogo non persistente con MCSIO abilitato

    Requisiti

    I requisiti per modificare la configurazione della cache sono:

    • Aggiornare alla versione più recente di VDA (2308 o successiva).

    • Abilitare il parametro UseWriteBackCache per il catalogo di macchine esistente. Utilizzare New-ProvScheme per creare un catalogo di macchine con UseWriteBackCache abilitato. Ad esempio:

       New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
 -IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
 -MasterImageVM $MasterImage `
 -ServiceOffering $ServiceOffering `
 -NetworkMap $NetworkMap `
 -SecurityGroup $SecurityGroup `
 -UseWriteBackCache -WriteBackCacheDiskSize 8
 <!--NeedCopy-->

    Modificare la configurazione della cache

    Eseguire il comando Set-ProvScheme. Ad esempio:

    Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128
<!--NeedCopy-->

    Nota:

    • Il valore di WriteBackCacheDiskSize deve essere maggiore di zero perché è richiesto almeno 1 GB di spazio di archiviazione su disco cache.
    • Il valore di WriteBackCacheMemorySize deve essere inferiore alla dimensione della memoria del catalogo di macchine.
    • Queste modifiche influiscono solo sulle nuove VM aggiunte al catalogo dopo che la modifica è stata apportata. Le VM esistenti non sono interessate da queste modifiche.

    Supporto per l’aggiornamento VDA tramite accesso a condivisione file locale

    Specificare la posizione del programma di installazione VDA tramite cmdlet PowerShell, il che riduce lo sforzo di fornire regole di rete per consentire a ogni VDA di recuperare il nuovo programma di installazione VDA dal CDN Azure gestito da Citrix.

    Cmdlet PowerShell

    Due nuovi parametri opzionali aggiunti ai cmdlet New-VusCatalogSchedule e New-VusMachineUpgrade che consentono di utilizzare i programmi di installazione da una condivisione file locale

    • VdaWorkstationPackageUri - per specificare il percorso UNC del programma di installazione VDA del sistema operativo workstation
    • VdaServerPackageUri - per specificare il percorso UNC del programma di installazione VDA del sistema operativo server

    Prerequisiti

    • Programma di installazione dell’agente VUS fornito con VDA 2311
    • Agente di aggiornamento VDA alla versione 7.40.0.35 o successiva (utilizzando il programma di installazione VDA versione 2311 o successiva)
    • SDK PowerShell remoto di Virtual Apps and Desktops versione 7.40 o successiva (rilasciato il 10 gennaio 2024 o successivamente)

    Come impostare le autorizzazioni di condivisione file

    Le condivisioni di rete contenenti i pacchetti del programma di installazione VDA devono avere accesso in lettura per il servizio VDA Upgrade Agent che viene eseguito come Sistema locale (principale NT AUTHORITY\SYSTEM).

    • Autorizzazione di condivisione file unita a dominio

      Quando la macchina VDA è unita a un dominio, l’account Sistema locale (VUA viene eseguito come Sistema locale) utilizza le credenziali del computer quando accede alle condivisioni di rete.

      L’autorizzazione con privilegi minimi può essere impostata concedendo l’accesso in Lettura ai computer di dominio.

      1. Scegliere le persone sulla rete con cui si desidera condividere il file.
      2. Fare clic su Impostazioni di condivisione avanzate e attivare Condivisione file e stampanti.

    • Autorizzazione di condivisione file non unita a dominio

      Quando la macchina VDA non è unita a un dominio, l’account Sistema locale (VUA viene eseguito come Sistema locale) utilizza ACCESSO ANONIMO quando accede alle condivisioni di rete.

      1. Selezionare una cartella condivisa.
      2. Disabilitare la protezione con password.
        1. Andare a Proprietà della cartella.
        2. Selezionare Centro connessioni di rete e condivisione.
        3. Disattivare Condivisione protetta da password.
      3. Fare clic su Condivisione avanzata per concedere un’autorizzazione di condivisione.
        1. Selezionare Autorizzazioni.
        2. Concedere un’autorizzazione di condivisione in Lettura a ACCESSO ANONIMO.
      4. Selezionare la Scheda Sicurezza per concedere le autorizzazioni della cartella
        1. Fare clic su Modifica per aggiungere autorizzazioni alla cartella condivisa
        2. Selezionare la cartella condivisa per concedere le autorizzazioni della cartella a ACCESSO ANONIMO.
      5. Fare clic su Avanzate per attivare Condivisione file e stampanti.
      6. Aggiungere il nome della cartella condivisa a Criteri di sicurezza per l’accesso alla rete.

      Nota:

      Riavviare la macchina affinché la modifica abbia effetto immediatamente.

    Aggiornamenti VDA da una condivisione file locale

    1. Scaricare il programma di installazione VDA e posizionarlo nel file condiviso.

      Nota:

      Con Virtual Upgrade Service, è possibile selezionare tra il ramo Current Release o il ramo LTSR.

      Ad esempio: Se il catalogo di macchine è impostato su Current Release, ovvero 2311, e la versione VDA è 2305, è necessario aggiornare il VDA alla versione 2311.

      1. Andare alla pagina Download sul nostro sito web.
      2. Selezionare Citrix Virtual Apps and Desktops come prodotto.
      3. Selezionare Citrix Virtual Apps and Desktops 7 2311, Tutte le edizioni.
      4. Selezionare il programma di installazione VDA da Componenti presenti nell’ISO del prodotto ma anche pacchettizzati separatamente espandibile.

    2. Selezionare il programma di installazione VDA pertinente in base al tipo di catalogo.

      • Scaricare il programma di installazione VDA del sistema operativo multi-sessione se il tipo di catalogo è multi-sessione
      • Scaricare il programma di installazione VDA del sistema operativo a sessione singola se il tipo di catalogo è sessione singola
      • Scaricare il programma di installazione VDA dei servizi core del sistema operativo a sessione singola se il tipo di catalogo è Remote PC Access

    Nota:

    La versione del programma di installazione della condivisione file deve corrispondere esattamente alla versione dell’ultima versione del programma di installazione pubblicata da VUS sul cloud.

    Migrazione dello storage delle VM

    È possibile spostare lo storage su disco delle VM esistenti da un vecchio storage a un nuovo storage negli ambienti VMware e XenServer. Durante la migrazione, MCS mantiene le capacità della VM come la gestione dell’alimentazione, il ripristino del disco del sistema operativo e così via. È anche possibile aggiungere nuove VM al catalogo di macchine utilizzando il nuovo storage su disco. Per fare ciò, utilizzare il comando PowerShell Move-ProvVMDisk.

    È possibile migrare VM persistenti full clone e VM non persistenti.

    • Per VM persistenti Full Clone: Disco del sistema operativo, Disco di identità e dischi non forniti da MCS.
    • Per VM non persistenti: Disco del sistema operativo, Disco di identità e disco Write-back Cache (WBC).

    Il nuovo storage deve soddisfare le seguenti condizioni:

    • Deve trovarsi all’interno dello stesso cluster del vecchio storage.
    • L’host su cui è in esecuzione la VM deve avere accesso sia ai vecchi che ai nuovi datastore.

    Migrare lo storage su disco

    Per migrare lo storage su disco:

    1. Aggiungere uno storage di destinazione a un’unità di hosting esistente. È possibile eseguire il comando PowerShell Add-Hyphostingunitstorage per aggiungere lo storage di destinazione:

      Se non si desidera aggiungere nuove VM al vecchio storage, modificare il vecchio storage in Sostituito. È possibile farlo utilizzando Studio o i comandi PowerShell. Per Studio, consultare Modifica storage. In alternativa, eseguire Set-Hyphostingunitstorage e impostare Superseded su true per disabilitare la creazione di nuove VM nel vecchio storage.

      Nota:

      Per le VM non persistenti:

      • Se viene utilizzato WBC, configurare lo storage di destinazione WBC nell’unità di hosting.
      • Se lo storage di destinazione del sistema operativo è configurato, WBC (se utilizzato) deve essere compatibile con lo storage di destinazione del sistema operativo.
      • Se lo storage di destinazione del sistema operativo non è configurato, WBC (se utilizzato) deve essere compatibile con lo storage del sistema operativo corrente.
    2. Spegnere le VM e attivare la Modalità di manutenzione.

    3. Ottenere le informazioni sullo schema di provisioning, l’unità di hosting, lo storage del disco del sistema operativo e lo storage del disco WBC.

      • Eseguire ProvResourceInStorage per le informazioni sullo storage del sistema operativo. Ad esempio:

         $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.ProvResourceInStorage | Format-List -Property *
 <!--NeedCopy-->

      • Eseguire TemporaryStorageInfo per le informazioni sullo storage WBC. Ad esempio:

         $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.TemporaryStorageInfo | Format-List -Property *
 <!--NeedCopy-->

    4. Migrare il disco del sistema operativo, il disco di identità e il disco WBC (applicabile alle VM non persistenti) allo storage di destinazione utilizzando il comando PowerShell Move-ProvVMDisk.

      Nota:

      • Fornire sempre i dischi del sistema operativo e di identità nei parametri DiskType e DestinationStorageId.
      • Il DestinationStorageId per il disco del sistema operativo e il disco di identità deve essere lo stesso.

      Esempio:

      VM persistenti:

      (Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myFullCloneProvScheme" -VMName "machine01" -DiskType OS,Identity -DestinationStorageId datastore1,datastore1
<!--NeedCopy-->

      Importante:

      Per le VM persistenti, tutti i dischi vengono spostati. Non è possibile selezionare quali dischi spostare.

      VM non persistenti:

      (Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myCleanOnBootProvScheme" -VMName "machine01" -DiskType OS,Identity,WBC -DestinationStorageId None,None,datastore1
<!--NeedCopy-->

      Importante:

      • Se non si desidera migrare un disco specifico, impostare il valore su None per il parametro DestinationStorageId.
      • Se la VM ha un disco WBC, aggiungere il disco WBC nel parametro DiskType e aggiungere le informazioni richieste nel parametro DestinationStorageId.

    Migrare i cataloghi esistenti forniti da MCS a un catalogo di macchine con immagine preparata

    È possibile convertire un catalogo di macchine esistente fornito da MCS in un catalogo di macchine con immagine preparata utilizzando un comando PowerShell Set-ProvSchemeImage. Tuttavia, non è possibile tornare al catalogo legacy dopo la migrazione. Attualmente, questa funzionalità è applicabile agli ambienti di virtualizzazione Azure e VMware.

    Limitazioni

    Considerare le seguenti limitazioni:

    • Se il catalogo MCS utilizza un disco dati persistente, il catalogo non può essere migrato per utilizzare un’immagine preparata.
    • Se il catalogo MCS utilizza dischi non gestiti, il catalogo non può essere migrato per utilizzare un’immagine preparata.

    Migrare a un catalogo di macchine con immagine preparata

    Per migrare, eseguire quanto segue:

    1. Creare una definizione di immagine e versioni di immagine utilizzando Studio o i comandi PowerShell. Vedere i passaggi per creare definizioni di immagine e versioni di immagine in:

    2. Eseguire il comando Get-ProvScheme per ottenere l’UID dello schema di provisioning. Ad esempio:

      Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid
<!--NeedCopy-->

    3. Eseguire il comando Get-ProvImageVersionSpec per ottenere il nome della definizione dell’immagine, l’UID della specifica della versione dell’immagine. Ad esempio:

      Get-ProvImageVersionSpec -ImageDifinitionName <name> -Filter {IsPrepared -eq $true} | select ImageDefinitionName ImageVersionSpecUId
<!--NeedCopy-->

    4. Eseguire il comando Set-ProvSchemeImage per migrare un catalogo di macchine esistente fornito da MCS in un catalogo di macchine con immagine preparata. Ad esempio:

      Set-ProvSchemeImage -ProvisioningSchemeName [ProvisioningSchemeName] -ImageVersionSpecUid [ImageVersionSpecUid]
<!--NeedCopy-->

    5. Eseguire il comando Get-ProvScheme per verificare che il catalogo sia stato migrato. Ad esempio:

      Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid, ImageVersionSpecUid
<!--NeedCopy-->

    Risoluzione dei problemi

    Prossimi passi

    Per informazioni sulla gestione di cataloghi di servizi cloud specifici, consultare:

    Gestire i cataloghi di macchine
    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.