Gestire i cataloghi di macchine

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 manutenzione dei cataloghi può anche includere l’assicurarsi che ogni macchina abbia gli 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) mantengono 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 con accesso remoto al PC, si gestiscono gli aggiornamenti delle macchine degli utenti 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, vedere Connessioni e risorse.

Nota:

MCS non supporta Windows 10 IoT Core e Windows 10 IoT Enterprise. Per maggiori informazioni, fare riferimento al 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 la prossima volta che la macchina viene reimpostata.
• Con i cataloghi di macchine persistenti, l’aggiornamento dell’immagine aggiorna anche le istanze del catalogo che la utilizzano.
• Per i cataloghi non persistenti, 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:

• Utilizzo di Web Studio
• Utilizzo di PowerShell

Utilizzare Web Studio

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

• Gestire i cataloghi di macchine
  • Introduzione
  • Informazioni sulle istanze persistenti
• Gestire i cataloghi di macchine
• Utilizzare Web Studio
• Visualizzare i dettagli del catalogo
  • Aggiungere macchine a un catalogo
  • Eliminare macchine da un catalogo
• Modificare un catalogo
• Rinominare un catalogo
• Spostare un catalogo in una zona diversa
• Eliminare un catalogo
• Convertire cataloghi MCS legacy in cataloghi basati su profili macchina
• Gestire gli account computer di Active Directory in un catalogo
• Aggiornare un catalogo
  • Aggiornare o creare un’immagine master
  • Modificare l’immagine master
  • Eseguire il rollback dell’immagine master
• Modificare il livello funzionale o annullare la modifica
• Clonare un catalogo
• Organizzare i cataloghi usando le cartelle
  • Creare una cartella di catalogo
  • Spostare un catalogo
  • Gestire le cartelle del catalogo
• Riprovare la creazione del catalogo
• Registrare VDA non sottoposti a provisioning MCS utilizzando i token
• Usare PowerShell
• Recuperare avvisi ed errori associati a un catalogo
• Aggiungere descrizioni a un’immagine
• Reimpostare il disco del sistema operativo
• Modificare l’impostazione di rete per uno schema di provisioning esistente
• Gestire le versioni di un catalogo macchine
• Convertire un catalogo macchine non basato su profilo macchina in un catalogo macchine basato su profilo macchina
• Ripristinare le informazioni sull’identità degli account computer attivi
  • Condizioni
  • Reimpostare il disco di identità
• Modificare la configurazione della cache su un catalogo macchine esistente
  • Requisiti
  • Modificare la configurazione della cache
• Supporto per l’aggiornamento VDA tramite accesso a condivisione file locale
  • Cmdlet PowerShell
  • Prerequisiti
  • Come impostare le autorizzazioni di condivisione file
  • Aggiornamenti VDA da una condivisione file locale
• Risoluzione dei problemi
• Dove andare dopo

Visualizzare i dettagli del catalogo

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

Aggiungere macchine a un catalogo

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 macchine e quindi selezionare Aggiungi macchine nella barra delle azioni.
4. Selezionare il numero di macchine virtuali da aggiungere.
5. Se non ci sono account Active Directory esistenti 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 compaiono numeri o lettere sequenziali. Non utilizzare una barra (/) in un nome di unità organizzativa. Un nome non può iniziare con un numero. Ad esempio, uno schema di denominazione PC-Sales-## (con 0-9 selezionato) genera account computer denominati PC-Sales-01, PC-Sales-02, PC-Sales-03 e così via.
6. Se si utilizzano account Active Directory esistenti, cercare 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 possono richiedere molto tempo quando si creano molte macchine. La creazione della macchina continua anche se si chiude Web Studio.

Eliminare macchine da un catalogo

Dopo aver eliminato una macchina da un catalogo 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 sono disconnessi. L’attivazione della modalità di manutenzione impedisce nuove connessioni a una macchina.
• Le macchine sono spente.

Per eliminare le 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 di Active Directory per tali macchine vengono mantenuti, disabilitati o eliminati.

Modificare un catalogo

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 il mapping della subnet di una NIC, selezionare una rete dal campo Rete associata.
   • Per aggiungere una mappatura di 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 vengono visualizzate nel campo Rete associata.

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

   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 di macchine, il numero di NIC sul catalogo deve essere uguale al numero di NIC sul profilo di 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 la dimensione corrente della macchina, viene visualizzata una finestra di dialogo di avviso che informa che la modifica dell’impostazione reimposta l’impostazione della dimensione 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 della licenza Linux.

   Per i cataloghi di accesso remoto al PC, 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 unità organizzative di Active Directory.
7. Fare clic su Applica per applicare le modifiche apportate e fare clic su Salva per uscire.

Rinominare un catalogo

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 tua distribuzione ha più di una zona, puoi spostare un catalogo da una zona all’altra.

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

1. Accedi a Web Studio.
2. Seleziona Cataloghi macchine nel riquadro sinistro.
3. Seleziona un catalogo e quindi seleziona Sposta nella barra delle azioni.
4. Seleziona la zona in cui desideri spostare il catalogo.

Eliminare un catalogo

Prima di eliminare un catalogo, assicurati 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 contenga macchine dal catalogo.

Per eliminare un catalogo:

1. Accedi a Web Studio.
2. Seleziona 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 computer di Active Directory per tali macchine vengono mantenuti, disabilitati o eliminati.

Convertire i cataloghi MCS legacy in cataloghi basati su profili macchina

Per convertire un catalogo macchine non basato su profili macchina in un catalogo macchine basato su profili macchina, 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 correnti differiscono dalle nuove impostazioni del profilo macchina, selezionare l’opzione desiderata per le impostazioni che si desidera utilizzare e fare clic su Continua.
6. Fare clic su Applica.

Nota:

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

Gestire gli account computer di Active Directory in un catalogo

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

• Liberare gli account macchina inutilizzati rimuovendo gli account computer di Active Directory dai cataloghi di sistemi operativi a sessione singola e a sessione multipla. Tali account possono quindi essere utilizzati per altre macchine.
• Aggiungere account in modo che quando vengono aggiunte altre macchine al catalogo, gli account del computer siano già presenti. Non utilizzare una barra (/) nel nome di un’unità organizzativa.

Per gestire gli account di 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 applichi a tutti gli account.

   È possibile reimpostare le password se non si conoscono le password degli account correnti; è necessario disporre dell’autorizzazione per eseguire un ripristino 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 di Active Directory vengono mantenuti, disabilitati o eliminati quando si rimuovono macchine da un catalogo o si elimina un catalogo.

Aggiornare un catalogo

Si consiglia di salvare copie o snapshot delle immagini master prima di aggiornare le macchine nel catalogo. Il database conserva una cronologia delle immagini master utilizzate con ogni catalogo macchine. È possibile ripristinare le macchine in un catalogo per utilizzare la versione precedente dell’immagine master. Eseguire questa operazione 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 macchine, aggiornare un’immagine master esistente o crearne una sul proprio hypervisor host.

1. Sul proprio hypervisor, acquisire uno snapshot della VM corrente e assegnargli un nome significativo. Questo snapshot può essere utilizzato per ripristinare (rollback) le macchine nel catalogo, se necessario.
2. Se necessario, accendere l’immagine master e accedere.
3. Installare gli aggiornamenti o apportare le modifiche necessarie 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 macchine vengono aggiornate con la nuova immagine master: al prossimo 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 l’aggiornamento.

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). Utilizzarlo 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 Cambia immagine master nella barra delle azioni.
3. Nella pagina Cambia immagine master, selezionare un’immagine in Immagine master. Il pannello elenca tutte le immagini che appartengono alla stessa regione delle risorse.

Strategia di distribuzione:

L’aggiornamento delle immagini al successivo arresto influirà immediatamente su tutte le macchine non attualmente in uso, ovvero le macchine che non hanno una sessione utente attiva. Un sistema in uso riceve l’aggiornamento al termine della sessione attiva corrente. Considerare quanto segue:

• Le nuove sessioni non possono essere avviate finché l’aggiornamento non è stato completato sulle macchine applicabili.
• Per le macchine OS a sessione singola, le macchine vengono aggiornate immediatamente quando la macchina non è in uso o quando gli utenti non sono connessi.
• Per un sistema operativo multi-sessione con macchine figlio, 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 Roll Back Master Image (Ripristina 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 rollout.

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 macchine dopo aver aggiornato i VDA sulle macchine a una versione più recente. Citrix consiglia di aggiornare tutti i VDA all’ultima versione per consentire l’accesso a tutte le funzionalità più recenti.

Prima di modificare il livello funzionale per un catalogo 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 un aggiornamento.

Per modificare il livello funzionale di 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 un aggiornamento, visualizza un messaggio. Seguire le istruzioni. Se una o più macchine non possono essere aggiornate, un messaggio ne 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.

Clonare un catalogo

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

• Non è possibile modificare le impostazioni associate a sistema operativo e gestione delle macchine. Il catalogo clonato eredita tali impostazioni dall’originale.

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 stato di avanzamento per eseguire la clonazione in background.
• Il catalogo clonato eredita il nome dell’originale e ha un suffisso Copy. È 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 se necessario. Selezionare Avanti per passare alla pagina successiva.
4. Nella pagina Riepilogo, visualizzare un riepilogo delle impostazioni e selezionare Fine per avviare la clonazione.
5. Se necessario, selezionare Nascondi stato di avanzamento per eseguire la clonazione in background.

Organizzare i cataloghi utilizzando le cartelle

È possibile creare cartelle per organizzare i cataloghi e facilitarne l’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.

Creare una cartella di catalogo

Prima di iniziare, pianificare 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 la stessa struttura 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.

Spostare un catalogo

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

Gestire le cartelle dei cataloghi

È possibile eliminare, rinominare e spostare le cartelle dei cataloghi.

È 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, quindi selezionare un’azione nella barra Azione secondo necessità:

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

Riprova creazione catalogo

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 ciascun 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 delle macchine. Il catalogo eredita tali impostazioni dall’originale.
• La creazione potrebbe richiedere del tempo per essere completata. Se necessario, selezionare Nascondi avanzamento per eseguire la creazione in background.

Per riprovare a creare un catalogo, effettuare le seguenti operazioni:

1. Da Web Studio, selezionare Cataloghi macchine nel riquadro a sinistra.
2. Selezionare il catalogo e quindi andare alla 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. Al termine, selezionare Fine per avviare la creazione.

Registrare i VDA non forniti da MCS utilizzando i token

È ora possibile generare e gestire i token di registrazione per i VDA non forniti da MCS. Questa implementazione consente la registrazione dei 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 aggiunti a un dominio con Citrix Virtual Apps and Desktops.

Prima di iniziare

1. Configurare il sito. Per maggiori informazioni, vedere Creare un sito.
2. Installare i certificati TLS sui Delivery Controller. Per maggiori informazioni, vedere 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 > Machine Catalogs, individuare un catalogo non sottoposto a provisioning MCS, che ha Provisioning method: Manual visualizzato nella colonna Conteggio macchine.
2. Fare clic con il pulsante destro del mouse sul catalogo, quindi selezionare Manage Enrollment Tokens.
3. Nella pagina Generate enrollment token visualizzata, fornire le seguenti informazioni sul token:
   • Digitare un nome per il token.
   • Immettere il 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 nella zona di questo catalogo.
   • Immettere i limiti di utilizzo del token (tra 1 e 5000).
4. Fare clic su Generate.

5. Nella finestra Token successfully generated visualizzata, copiare il token e salvarlo in un luogo sicuro, oppure fare clic su Download per scaricarlo nella cartella Download.

   Un record del token viene visualizzato nell’elenco dei token.

   

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

   Per ulteriori informazioni su come installare VDA e un token sulle macchine, vedere Installare i VDA.

Gestisci token

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

• Revoca: Revoca il token ma mantienilo nell’elenco a scopo di registrazione.
• Elimina: Revoca il token ed eliminalo dall’elenco.

Nota:

I token scaduti vengono eliminati automaticamente entro 14 giorni.

Registra macchine ai 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 ti aiuta a convertire una connessione in una connessione WebSocket aggiungendo il VDA al catalogo macchine utilizzando il token di registrazione.

Nota:

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

Segui le istruzioni per eseguire lo strumento di registrazione:

1. Accedi al VDA.
2. Individua lo strumento EnrollMachine.exe, in C:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Tool.
3. Esegui 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:

Dopo la corretta registrazione, 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, i log dello strumento di registrazione si trovano in:

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

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

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

Usa PowerShell

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

• Recuperare avvisi ed errori associati a un catalogo
• Aggiungere descrizioni a un’immagine
• Reimpostare il disco del sistema operativo
• Modificare l’impostazione di rete per uno schema di provisioning esistente
• Gestire le versioni di un catalogo macchine
• Convertire un catalogo macchine non basato su profilo macchina in un catalogo macchine basato su profilo macchina
• Ripristinare le informazioni sull’identità degli account computer attivi
• Modificare la configurazione della cache su un catalogo macchine esistente
• Supporto per l’aggiornamento VDA tramite accesso a condivisione file locale

Recuperare avvisi ed errori associati a un catalogo

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

Utilizzando i comandi PowerShell, è possibile:

• Ottenere un elenco di errori o avvisi
• Modificare lo stato dell’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 di errori o 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 il 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 su 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 il 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 ulteriori informazioni, vedere Citrix PowerShell SDK.

Eliminare le 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 è presente alcun 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 non riuscire 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, viene visualizzato il seguente messaggio:

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. È inoltre 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 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 dell’utente alle macchine nel catalogo non persistono.
• Le macchine nel catalogo sono in esecuzione.

Reimposta disco SO

Utilizzare il comando PowerShell Reset-ProvVMDisk per reimpostare 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 trovano in un catalogo MCS persistente.
• Il catalogo di macchine MCS funzioni correttamente.
• Ciò implica che lo schema di provisioning e l’host esistono e che lo schema di provisioning ha voci corrette.
• L’hypervisor non è in modalità di manutenzione.
• Le VM di destinazione sono spente e in modalità di manutenzione.

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

1. Aprire una finestra di 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 di VM come elenco separato da virgole ed eseguire il ripristino su ciascuna VM:

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

   • Specificare l’elenco di VM come output dal comando Get-ProvVM ed eseguire il ripristino su ciascuna 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 e il controllo della connessione per ciascuna VM.

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

4. Viene visualizzato un prompt di conferma che elenca le VM da reimpostare 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 né accenderle prima del completamento del processo di ripristino.

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

   È anche possibile ignorare la richiesta 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, procedere come segue:

1. Nella finestra di 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 nel 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 nel 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 verrà conservato per tutti i cataloghi con provisioning 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 nel 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 basato su profilo non macchina in un catalogo di macchine basato su profilo 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 basato su profilo non macchina in un catalogo di macchine basato su profilo macchina. Le nuove VM aggiunte al catalogo acquisiscono 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 profilo macchina esistente non può essere modificato in un catalogo di macchine basato su profilo non 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 di PowerShell.

3. Eseguire il comando Set-ProvScheme per applicare i valori delle proprietà dal profilo della macchina alle nuove VM aggiunte al catalogo 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 attendibilità, oppure di reimpostare tutta la configurazione del disco di identità. Questa implementazione è applicabile sia ai cataloghi 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 reimpostare correttamente il disco di identità:

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

Reimposta disco identità

Per reimpostare il disco identità:

1. Aprire la finestra di 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 identità che deve essere riparato.
     • PrivilegedUserName: Account utente che dispone dell’autorizzazione di scrittura sul provider di identità (AD o AzureAD).
     • PrivilegedUserPassword: Password per PrivilegedUserName.
     • Target: Destinazione per l’azione di riparazione. Può essere IdentityInfo per riparare la password dell’account/chiave di fiducia e UserCertificate per riparare gli attributi del certificato utente delle identità macchina unite a Hybrid AzureAD.

   • Per reimpostare tutte le configurazioni del disco 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 identità:

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

4. Digitare y per confermare l’azione. È anche possibile saltare la richiesta 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 identità. Gli attributi del disco 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 della cache.
• Il valore di WriteBackCacheMemorySize deve essere inferiore alla dimensione della memoria del catalogo macchine.
• Queste modifiche influiscono solo sulle nuove VM aggiunte al catalogo dopo l’applicazione della modifica. 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 i 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 dalla CDN di Azure gestita 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 è aggiunta al 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 del dominio.

  1. Scegli le persone sulla tua rete con cui desideri condividere il file.
  2. Fai clic su Impostazioni di condivisione avanzate e attiva la Condivisione file e stampanti.

• Autorizzazione di condivisione file non aggiunta al dominio

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

  1. Seleziona una cartella condivisa.
  2. Disabilita la protezione con password.
     1. Vai a Proprietà della cartella.
     2. Seleziona Centro connessioni di rete e condivisione.
     3. Disattiva la Condivisione protetta da password.
  3. Fai clic su Condivisione avanzata per concedere un’autorizzazione di condivisione.
     1. Seleziona Autorizzazioni.
     2. Concedi un’autorizzazione di condivisione in Lettura a ACCESSO ANONIMO.
  4. Seleziona la scheda Sicurezza per concedere le autorizzazioni della cartella
     1. Fai clic su Modifica per aggiungere le autorizzazioni alla cartella condivisa
     2. Seleziona la cartella condivisa per concedere le autorizzazioni alla cartella a ANONYMOUS LOGON.
  5. Fai clic su Avanzate per attivare Condivisione file e stampanti.
  6. Aggiungi il nome della cartella condivisa a Criteri di sicurezza per l’accesso alla rete.

  Nota:

  Riavvia la macchina affinché la modifica abbia effetto immediatamente.

Aggiornamenti VDA da una condivisione file locale

1. Scarica il programma di installazione VDA e posizionalo nel file condiviso.

   Nota:

   Con Virtual Upgrade Service, puoi selezionare tra il canale Current Release o il canale LTSR.

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

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

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 è Accesso remoto PC

Nota:

La versione del programma di installazione della condivisione file deve corrispondere esattamente alla versione più recente del programma di installazione pubblicata da VUS sul cloud.

Migrazione dello storage delle VM

È possibile spostare lo storage su disco delle VM esistenti da uno storage precedente a uno nuovo negli ambienti VMware e XenServer. Durante la migrazione, MCS mantiene le funzionalità delle VM come la gestione dell’alimentazione, il ripristino del disco del sistema operativo e così via. È inoltre possibile aggiungere nuove VM al catalogo macchine utilizzando il nuovo storage su disco. A tale scopo, utilizzare il comando PowerShell Move-ProvVMDisk.

È possibile migrare VM persistenti con clone completo e VM non persistenti.

• Per le VM persistenti con clone completo: disco del sistema operativo, disco di identità e dischi non forniti da MCS.
• Per le VM non persistenti: disco del sistema operativo, disco di identità e disco di cache di write-back (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 datastore vecchi che a quelli nuovi.

Migrare lo storage su disco

Per migrare l’archiviazione su disco:

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

   Se non si desidera aggiungere nuove VM alla vecchia archiviazione, modificare la vecchia archiviazione in Superseded. È possibile farlo utilizzando Studio o i comandi PowerShell. Per Studio, vedere Modifica archiviazione. In alternativa, eseguire Set-Hyphostingunitstorage e impostare Superseded come true per disabilitare la creazione di nuove VM nella vecchia archiviazione.

   Nota:

   Per le VM non persistenti:

   • Se viene utilizzato WBC, configurare l’archiviazione di destinazione WBC nell’unità di hosting.
   • Se l’archiviazione di destinazione del sistema operativo è configurata, allora WBC (se utilizzato) deve essere compatibile con l’archiviazione di destinazione del sistema operativo.
   • Se l’archiviazione di destinazione del sistema operativo non è configurata, allora WBC (se utilizzato) deve essere compatibile con l’archiviazione corrente del sistema operativo.

2. Spegnere le VM e attivare la Modalità di manutenzione.

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

   • Eseguire ProvResourceInStorage per le informazioni sull’archiviazione del sistema operativo. Ad esempio:

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

   • Eseguire TemporaryStorageInfo per le informazioni sull’archiviazione 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) all’archiviazione 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 di macchine esistenti con provisioning MCS a un catalogo di macchine con immagine preparata

È possibile convertire un catalogo di macchine esistente con provisioning 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 eseguire la migrazione, procedere come segue:

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

   • Azure:

     • Web Studio
     • PowerShell

   • VMware:

     • Web Studio
     • PowerShell

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 e 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 con provisioning 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

• Per le macchine con stato “Power State Unknown”, consultare CTX131267 per indicazioni.
• Per risolvere il problema delle VM che mostrano continuamente uno stato di alimentazione sconosciuto, vedere Come risolvere il problema delle VM che mostrano continuamente uno stato di alimentazione sconosciuto.

Dove andare dopo

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

• Gestire un catalogo AWS
• Gestire un catalogo XenServer
• Gestire un catalogo Google Cloud Platform
• Gestire un catalogo Microsoft Azure
• Gestire un catalogo Microsoft System Center Virtual Machine Manager
• Gestire un catalogo VMware