Documentazione dei prodotti

Gestire i cataloghi di macchine

May 31, 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 manutenzione dei cataloghi può anche includere 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) 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 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 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:

Utilizzare Web Studio

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

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 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) genera 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 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. Potrebbero essere visualizzate pagine aggiuntive 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 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 reimposterà 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 della licenza Linux.

    Per i cataloghi di accesso remoto 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 le OU di Active Directory.
  6. 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 che contiene 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 computer di Active Directory per tali macchine vengono mantenuti, disabilitati o eliminati.

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

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 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. Installa gli aggiornamenti o apporta le modifiche necessarie all’immagine master.
  4. Spegni la VM.
  5. Crea uno snapshot della VM. Assegna 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 seleziona quello snapshot in Web Studio. Questo processo ti consente di fornire un nome e una descrizione significativi anziché un nome generato automaticamente. Per le immagini master GPU, puoi 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. Accedi a Web Studio.
  2. Seleziona Cataloghi macchine nel riquadro sinistro.
  3. Seleziona un catalogo e quindi seleziona Cambia immagine master nella barra delle azioni.
  4. Nella pagina Immagine master, seleziona l’host e l’immagine che desideri distribuire.

    Suggerimento:

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

  5. Nella pagina Strategia di distribuzione, scegli 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. Verifica le informazioni nella pagina Riepilogo e quindi fai 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.

Strategia di implementazione:

L’aggiornamento dell’immagine al prossimo spegnimento interesserà 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 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.

Ripristinare l’immagine master

Dopo aver implementato un’immagine master aggiornata o nuova, è possibile ripristinarla. 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 l’implementazione, 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 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 implementazione.

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

Per monitorare l’avanzamento del rollback, individuare il catalogo in Cataloghi macchine per visualizzare la barra di avanzamento in linea e il grafico di avanzamento dettagliato.

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 alla versione più recente per abilitare 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 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 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.

Una volta completata la 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:

  • Non è possibile modificare le impostazioni associate a sistema operativo e gestione delle macchine. Il catalogo clonato eredita tali impostazioni dall’originale.
  • 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 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 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 usando 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.

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 i nodi Cataloghi macchine e Applicazioni) condividono una struttura di cartelle nel backend. Per evitare conflitti di nomi con altri nodi durante la ridenominazione o lo spostamento di cartelle, si consiglia di assegnare nomi diversi alle cartelle di primo livello in nodi diversi.

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

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

Suggerimento:

È possibile trascinare un catalogo in una cartella.

Gestire le cartelle dei cataloghi

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

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

Per gestire una cartella, seguire questi passaggi:

  1. Selezionare Cataloghi macchine nel riquadro sinistro.

  2. Nella gerarchia delle cartelle, selezionare una cartella, quindi selezionare un’azione nella barra Azioni in base alle esigenze:

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

Utilizzare PowerShell

Questa sezione descrive come 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 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 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 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 come Riconosciuto

Per eliminare gli errori o gli avvisi:

Eseguire il comando Remove-ProvOperationEvent.

  • Con il parametro EventId: Rimuove 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: 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, vedere Citrix PowerShell SDK.

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 Roll Back Master Image 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.

Reimpostazione disco OS

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 trovino in un catalogo MCS persistente.
  • Il catalogo 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 reimpostare 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 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, 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 o 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.

    È inoltre 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 versione specifica 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

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

     Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2

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

     Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3

  • 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

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 parte di 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 non basato su profilo macchina in un catalogo di macchine basato su profilo macchina

È possibile utilizzare una VM, una specifica di modello (nel caso di Azure) o un modello di avvio (nel caso di AWS) come input del profilo macchina per convertire un catalogo di macchine non basato su profilo 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 macchine basato su profilo macchina esistente non può essere modificato in un catalogo macchine non basato su profilo macchina.

Per fare ciò:

  1. Creare un catalogo 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 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>

    • Nel caso di AWS:

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

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 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 solo per gli ambienti di virtualizzazione Azure 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

      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à di macchine aggiunte 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


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

    • Per ricreare completamente il disco identità:

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

  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
  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 in 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

Modificare la configurazione della cache

Eseguire il comando Set-ProvScheme. Ad esempio:

Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128

Nota:

  • Il valore di WriteBackCacheDiskSize deve essere maggiore di zero poiché è 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.

Risoluzione dei problemi

Passaggi successivi

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

Gestire i cataloghi di macchine
May 31, 2026
Grazie al contributo di: 
C
May 31, 2026
Grazie al contributo di: 
C

In questo articolo

Feedback sito | Your privacy choices footer linkScelte di privacy | Privacy e condizioni legali | Preferenze cookie | Impostazioni di consenso | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.