Citrix DaaS™

Gestire i cataloghi di macchine

May 4, 2026

Grazie al contributo di:

C C

Nota:

Questo articolo descrive come gestire i cataloghi utilizzando Studio e i comandi PowerShell. Se il catalogo è stato creato utilizzando il nodo Quick Deploy e si continua a utilizzare tale nodo per gestire il catalogo, seguire Gestire i cataloghi in Quick Deploy.

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 del catalogo può includere anche le attività di verifica che ogni macchina disponga degli ultimi aggiornamenti del sistema operativo, degli aggiornamenti del software antivirus, degli aggiornamenti del sistema operativo o delle modifiche alla configurazione.

I cataloghi contenenti macchine casuali in pool create utilizzando Machine Creation Services™ (MCS) mantengono le macchine aggiornando l’immagine 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, è possibile gestire l’immagine o il modello attualmente utilizzati da tali cataloghi, ma solo le macchine aggiunte successivamente ai cataloghi vengono create utilizzando la nuova immagine o il nuovo modello.
Per i cataloghi Remote PC Access, si gestiscono gli aggiornamenti delle macchine degli utenti al di fuori di Studio. Eseguire questa attività individualmente o collettivamente utilizzando strumenti di distribuzione software di terze parti.
Per informazioni sulla creazione e gestione delle connessioni agli hypervisor host e ai servizi cloud, vedere Creare e gestire connessioni e risorse.
Nota:

MCS non supporta Windows 10 IoT Core e Windows 10 IoT Enterprise. Per ulteriori informazioni, fare riferimento al sito Microsoft.
Informazioni sulle istanze persistenti

Quando si aggiorna l’immagine master per un catalogo MCS contenente macchine persistenti, tutte le nuove macchine aggiunte al catalogo utilizzano l’immagine aggiornata. Le macchine esistenti continuano a utilizzare l’immagine master 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 volta successiva solo se la macchina viene riavviata all’interno di Studio o PowerShell. Se la macchina viene riavviata dall’hypervisor al di fuori di Studio, il disco non viene reimpostato.
Per i cataloghi che non persistono, se si desiderano immagini diverse per macchine diverse, le immagini devono risiedere in cataloghi separati.
Gestire i cataloghi di macchine
È possibile gestire un catalogo di macchine in due modi:
Utilizzo di Studio
Utilizzo di PowerShell
Utilizzo di Studio
Questa sezione descrive in dettaglio come è possibile gestire i cataloghi utilizzando Studio:
Visualizzare i dettagli del catalogo
Aggiungere macchine a un catalogo
Eliminare macchine da un catalogo
Modificare un catalogo
Rinominare un catalogo
Eliminare un catalogo
Gestire gli account computer di Active Directory in un catalogo
Modificare l’immagine master per un catalogo
Convertire i cataloghi con provisioning MCS dall’utilizzo di immagini master all’utilizzo di immagini preparate.
Modificare il livello funzionale o annullare la modifica
Clonare un catalogo
- Organizzare i cataloghi utilizzando le cartelle
- Aggiornare i VDA
- Gestire le impostazioni di ottimizzazione dell’esperienza per un catalogo
- Riprovare la creazione del catalogo
- (Solo VDA con provisioning non Citrix®) Generare e gestire i token di registrazione

Visualizzare i dettagli del catalogo

Utilizzare la funzione di ricerca per individuare un catalogo di macchine specifico. Per istruzioni, fare riferimento a Cercare istanze.
Dai risultati della ricerca, selezionare un catalogo, se necessario.

Fare riferimento alla tabella seguente per le descrizioni delle colonne del catalogo.

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


Tipo di macchina	Il tipo di sessione supportato delle macchine nel catalogo. I valori possibili includono • Tipo di sistema operativo: Sistema operativo multi-sessione (virtuale); Dati utente: Scartati. • Tipo di sistema operativo: Sistema operativo multi-sessione (virtuale); Dati utente: Su disco locale • Tipo di sistema operativo: Sistema operativo a sessione singola (Remote PC Access) • Tipo di sistema operativo: Sistema operativo a sessione singola (virtuale); Dati utente: Scartati • Tipo di sistema operativo: Sistema operativo a sessione singola (virtuale); Dati utente: Su disco locale





Conteggio macchine	Il conteggio delle macchine nel catalogo e il metodo di provisioning. I metodi di provisioning possibili includono: Machine Creation Services (macchina MCS), Manuale e Citrix Provisioning™ Services.
Conteggio allocato	Il numero di macchine nel catalogo assegnate a un gruppo di consegna.
Cartella	La posizione del catalogo all’interno dell’albero Cataloghi macchine. Visualizza il nome della cartella in cui si trova il catalogo (inclusa la barra rovesciata finale), o `-` se il catalogo si trova a livello radice.
Aggiornamento VDA	Stato di aggiornamento VDA. I valori possibili includono: Non configurato, Pianificato, Disponibile e Aggiornato.
Stato immagine	Lo stato dell’aggiornamento dell’immagine del catalogo. Applicabile solo ai cataloghi di macchine non persistenti. I valori possibili includono: Completamente aggiornato, Parzialmente aggiornato, Aggiornamenti in sospeso, Preparazione

Fare clic su una scheda nel riquadro dei dettagli inferiore per ulteriori informazioni su un catalogo selezionato.

Scheda Descrizione

|——|——–|

Dettagli

Riepiloga le impostazioni chiave del catalogo macchine, come il tipo di macchina, il metodo di provisioning, l’account di servizio, il sistema operativo e la versione VDA, consentendo di visualizzare e gestire rapidamente le risorse.

Proprietà modello	Disponibile solo per i cataloghi con provisioning MCS. Visualizza informazioni dettagliate sul provisioning per il catalogo selezionato, inclusi • Proprietà del modello di macchina • Dettagli specifici dell’hypervisor • Proprietà del profilo macchina




Macchine	Visualizza un elenco paginato di nomi di macchine nel catalogo selezionato.
Gruppi di consegna	Disponibile per i cataloghi Remote PC. Visualizza i gruppi di consegna associati al catalogo selezionato. Visualizza il nome del gruppo di consegna e l’associazione al catalogo.

Tag	Non disponibile negli ambienti multi-tenant.

^^ ^^ Visualizza il nome del tag e la descrizione dei tag assegnati al catalogo di macchine selezionato.

Workspace Environment Management	Visibile solo quando il servizio WEM è sottoposto a provisioning e accessibile. Visualizza le impostazioni di ottimizzazione del sistema Workspace Environment Management.

Approfondimenti sui costi	Applicabile solo ai cataloghi Azure MCS, visualizza

^^ ^^ • Costo totale sostenuto negli ultimi 30 giorni.
^^ ^^ • Un confronto tra il costo totale attuale di 30 giorni e il periodo precedente di 30 giorni.

^^	^^ L’accesso richiede l’autorizzazione Citrix Gestione costi > Gestisci > Leggi costo (predefinita per gli amministratori cloud) per visualizzare la scheda e l’autorizzazione Azure `Microsoft.CostManagement/query/read` per visualizzare i dettagli dei costi.
Risoluzione dei problemi	Visualizza errori o avvisi del catalogo con azioni consigliate.

Aggiungere macchine a un catalogo

Prima di iniziare:

-  Assicurarsi che l'host di virtualizzazione (hypervisor o provider di servizi cloud) 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 Studio per creare account computer di Active Directory per le macchine aggiuntive, è necessario disporre delle autorizzazioni appropriate di amministratore di dominio.

Suggerimento:

Se l’account Citrix DaaS utilizzato per aggiungere macchine al catalogo macchine ha autorizzazioni AD limitate, aggiungere tutti i Cloud Connector che si intendono utilizzare nella schermata Accedi a….

Per aggiungere macchine a un catalogo:

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
Selezionare un catalogo macchine e quindi selezionare Aggiungi macchine nella barra delle azioni.
Nella pagina Macchine virtuali, selezionare il numero di macchine virtuali da aggiungere.
Nella pagina Identità macchina, configurare le impostazioni come segue:
- Selezionare un’identità dall’elenco.
- Se applicabile, indicare se creare account o utilizzare quelli esistenti e la posizione (dominio) per tali account.
- 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.
- Se si utilizzano account Active Directory esistenti, cercare gli account o selezionare 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. Studio gestisce questi account. Consentire a tale interfaccia di reimpostare le password per tutti gli account o specificare la password dell’account, che deve essere la stessa per tutti gli account.
- Se questo pool di identità è utilizzato da altri cataloghi, non è possibile modificarlo in un pool diverso utilizzando Studio. Utilizzare invece il cmdlet PowerShell Set-ProvScheme. Per maggiori informazioni, consultare la documentazione SDK di Citrix Virtual Apps and Desktops.
- Specificare uno schema di denominazione degli account, utilizzando i segni di hash per indicare dove compaiono numeri o lettere sequenziali. Ad esempio, uno schema di denominazione PC-Sales-## (con 0-9 selezionato) produce account computer denominati PC-Sales-01, PC-Sales-02, PC-Sales-03 e così via.
- Facoltativamente, è possibile specificare con cosa iniziano i nomi degli account.
  
  Quando si specifica con cosa iniziano i nomi degli account, tenere presente il seguente scenario: se i numeri o le lettere iniziali sono già in uso, il primo account creato viene denominato utilizzando i numeri o le lettere non utilizzati più vicini.
  
  Vedere Gestire il numero di sequenza del nome della macchina per personalizzare il numero di sequenza delle macchine, distribuite tramite MCS, utilizzando i comandi PowerShell.
- 1. Nella pagina Credenziali di dominio, selezionare Immetti credenziali e immettere le credenziali utente con autorizzazioni sufficienti per creare account macchina.

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

Utilizzare i file CSV per aggiungere macchine in blocco a un catalogo

È possibile aggiungere macchine in blocco utilizzando i file CSV. La funzionalità è disponibile per tutti i cataloghi, ad eccezione dei cataloghi di cui è stato eseguito il provisioning tramite MCS.

Per aggiungere macchine in blocco a un catalogo, completare i seguenti passaggi:

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
Selezionare un catalogo macchine e quindi selezionare Aggiungi macchine nella barra delle azioni. Viene visualizzata la finestra Aggiungi macchine.
Selezionare Aggiungi file CSV. Viene visualizzata la finestra Aggiungi macchine in blocco.
Selezionare Scarica modello CSV.
Compilare il file modello.
Trascinare o sfogliare il file per caricarlo.
Selezionare Convalida per eseguire controlli di convalida sull’importazione.
Selezionare Importa per completare il processo.

Considerazioni sull’utilizzo dei file CSV per aggiungere macchine

Nota:

Per gli utenti non Active Directory, è necessario digitare i nomi nel formato: <provider di identità>:<nome utente>. Esempio: AzureAD:username.

I nomi delle VM fanno distinzione tra maiuscole e minuscole. Quando si immettono i percorsi delle VM, assicurarsi di immettere correttamente i nomi delle VM.

Quando si modifica il file modello CSV, tenere presente quanto segue:

La funzionalità offre maggiore flessibilità per aggiungere macchine in blocco tramite un file CSV. Nel file, è possibile aggiungere solo macchine (da utilizzare con assegnazioni automatiche utente) o aggiungere macchine insieme alle assegnazioni utente. Digitare i dati nel formato seguente:
- Per le coppie account macchina e nome utente (samName):
- Domain\ComputerName1, Domain\Username1
- Domain\ComputerName2, Domain\Username1;Domain\Username2
- Domain\ComputerName3, AzureAD:username
- Solo per gli account macchina:
- Domain\ComputerName1
- Domain\ComputerName2
- Per le coppie VM e nome utente:
- XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName1.vm,Domain\ComputerName1,Domain\Username1
- XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName2.vm,Domain\ComputerName2,Domain\Username2
- Solo per le VM:
- XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName1.vm,Domain\ComputerName1
- XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName2.vm,Domain\ComputerName2
  
  Ad esempio: XDHyp:\Connections\xpace-scale\East US.region\vm.folder\wsvdaV3-2.vm
  
  dove,
- xpace-scale è il ConnectionName: il nome della connessione immesso in Hosting > Aggiungi connessioni e risorse. Per ulteriori informazioni, vedere Creare una connessione e risorse.
- East US.region è il RegionName: il nome della regione con .region come estensione.
- wsvdaV3-2.vm è il VMName: il nome della macchina virtuale con .vm come estensione.
- Il numero massimo di macchine che un file può contenere è 1.000. Per importare più di 1.000 macchine, distribuirle su file diversi e quindi importare tali file uno per uno. Si consiglia di non importare più di 1.000 macchine. In caso contrario, la creazione del catalogo potrebbe richiedere molto tempo per essere completata.
È inoltre possibile esportare le macchine da un catalogo nella stessa pagina Aggiungi macchine. Il CSV esportato delle macchine può quindi essere utilizzato come modello quando si aggiungono macchine in blocco. Per esportare le macchine:

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
Selezionare un catalogo macchine e quindi selezionare Aggiungi macchine nella barra delle azioni. Viene visualizzata la finestra Aggiungi macchine.
Selezionare Esporta in file CSV. Viene scaricato un file CSV contenente un elenco delle macchine.
Aprire il file CSV per aggiungere o modificare le macchine secondo necessità. Per aggiungere macchine in blocco utilizzando il file CSV salvato, vedere la sezione precedente, Utilizzare i file CSV per aggiungere macchine in blocco a un catalogo.

Nota:

Questa funzionalità non è disponibile per i cataloghi Remote PC Access e con provisioning MCS.

L’esportazione e l’importazione di macchine in file CSV è supportata solo tra cataloghi dello stesso tipo.

Registrare le macchine nei cataloghi utilizzando lo strumento di registrazione VDA WebSocket

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

Nota:

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

Seguire le istruzioni per eseguire lo strumento di registrazione:

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

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

| Nome parametro | Obbligatorio | Descrizione | Esempio | |–|–|–|–|

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

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

Risoluzione dei problemi

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

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

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

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

Codice	Stringa	Descrizione
0	Successo	Il VDA è stato aggiunto correttamente al catalogo macchine.

-1 Argomento non valido Il parametro di input nel token di registrazione non è valido.
-2 BrokerAgent non trovato Il servizio dell’agente broker non è stato trovato.
-3 Token non valido Il token inserito non è valido.

-4	Claims obbligatori del token mancanti	I claims obbligatori per il token sono mancanti, ad esempio CustomerId o URI di registrazione.
-5	Errore interno	Si è verificato un errore generale.
-6	Timeout	L’attività è scaduta.
-7	Impossibile determinare lo stato di unione AD della macchina	Il servizio che restituisce lo stato di unione AD della macchina non è riuscito.
-8	Impossibile trovare il SID della macchina AD	Il servizio che restituisce il SID della macchina AD non è riuscito.
-9	Richiesta di registrazione non riuscita	La richiesta non è riuscita a causa di un errore HTTP.
-10	Campi obbligatori della risposta di registrazione mancanti	La risposta dello strumento di registrazione non contiene il parametro `VirtualSiteId`.
-11	Autorizzazioni insufficienti	Non si dispone delle autorizzazioni necessarie per eseguire l’attività.
-12	Impossibile determinare lo stato di unione Aad della macchina	Il servizio che verifica lo stato di unione AD della macchina genera un errore.
-13	Impossibile trovare l’ID dispositivo Aad della macchina	Il parametro aggiuntivo `ID dispositivo AAD` aggiunto dal sistema è vuoto.
-14	ID dispositivo Aad non valido	Il parametro aggiuntivo `ID dispositivo AAD` aggiunto dal sistema non è un GUID valido.
-15	Indirizzo MAC non valido	Indirizzo MAC non valido.
-16	Impossibile ottenere il nome host del computer per VdaInstanceName	Impossibile ottenere il nome host del computer per impostare il parametro aggiuntivo `VdaInstanceName`.

-17

Impossibile aprire la chiave di registro dell’agente desktop virtuale

Impossibile aprire la chiave di registro VDA per scrivere l’elenco dei Delivery Controller.

-18 Il token non è riuscito a raggiungere il conteggio massimo Il token non è riuscito a raggiungere il conteggio massimo.

Eliminare le macchine da un catalogo

Dopo aver eliminato una macchina da un catalogo macchine, gli utenti non potranno 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 alla macchina.
Le macchine siano spente.

Per eliminare le macchine da un catalogo:

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
Selezionare un catalogo e quindi selezionare Visualizza macchine nella barra delle azioni.
Selezionare una o più macchine e quindi selezionare Elimina nella barra delle azioni.
Se si stanno eliminando macchine persistenti dal catalogo, scegliere se eliminarle anche dall’hypervisor o dal servizio cloud. Se si sceglie di eliminarle, indicare se mantenere, disabilitare o eliminare i loro account Active Directory.

Quando si eliminano macchine persistenti da un catalogo Azure Resource Manager, le macchine e i gruppi di risorse associati vengono eliminati da Azure, anche se si sceglie di mantenerli.

Quando si eliminano macchine non persistenti da un catalogo, queste vengono automaticamente eliminate dall’hypervisor o dal servizio cloud.

Modificare un catalogo

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
Selezionare un catalogo e quindi selezionare Modifica catalogo macchine nella barra delle azioni.
Nella pagina Ambiti, modificare gli ambiti.
Nella pagina NIC, eseguire le seguenti azioni:
- Per modificare la mappatura della subnet di una NIC, selezionare una rete dal campo Rete associata.
- Per aggiungere una mappatura della subnet, selezionare Aggiungi NIC, selezionare una rete dal campo Rete associata e fare clic su Salva.
Solo le subnet presenti nell’host associato al catalogo vengono visualizzate nel campo Rete associata.

È possibile aggiungere NIC solo ai cataloghi macchine Azure senza profili macchina.
Nota:
- Per i cataloghi macchine AWS, non è possibile mappare la stessa subnet a più di una NIC.
- Per i cataloghi macchine con profili macchina, il numero di NIC sul catalogo deve essere uguale al numero di NIC sul profilo macchina.
- Questa funzionalità non è supportata per gli hypervisor IBM Cloud.
- Questa funzionalità è supportata solo per Nutanix Prism Element negli hypervisor Nutanix.
Nella pagina Aggiornamento VDA, modificare o selezionare la versione VDA a cui eseguire l’aggiornamento. Per maggiori informazioni, vedere Aggiornamento VDA.
Potrebbero essere visualizzate pagine aggiuntive a seconda del tipo di catalogo.

Per i cataloghi creati utilizzando un’immagine Azure Resource Manager, sono visibili le seguenti pagine. Tenere presente che le modifiche apportate si applicano solo alle macchine che si aggiungono 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.
  - Per i cataloghi Azure, se ZRS è la ridondanza di archiviazione nella pagina Tipi di archiviazione e licenza, viene visualizzato un avviso che suggerisce di deselezionare la zona e lasciare che Azure gestisca le zone di disponibilità delle VM.
- Nella pagina Profilo macchina, scegliere se utilizzare o modificare un profilo macchina.
  
  Nota:
  
  Per i cataloghi Azure, quando si modifica un profilo macchina che include zone di disponibilità e si sceglie ZRS per la ridondanza di archiviazione, viene visualizzato un avviso che suggerisce di deselezionare la zona.
- (Solo quando il catalogo è configurato con un gruppo host 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 ridondanza di archiviazione (per il catalogo Azure), il tipo di archiviazione, il tipo di licenza e le impostazioni di Azure Computer Gallery (disponibili solo quando è in uso Posiziona immagine preparata in Azure Gallery).
  
  Nota:
  
  Se l’impostazione appena selezionata non supporta le dimensioni della macchina attuali, viene visualizzata una finestra di dialogo di avviso che informa che la modifica dell’impostazione reimposta l’impostazione delle dimensioni della macchina. Se si sceglie di continuare, un punto rosso appare accanto al menu Macchine virtuali, invitando a selezionare una nuova dimensione della macchina.
Per maggiori informazioni sulle impostazioni disponibili nelle pagine, vedere Creare un catalogo macchine utilizzando un’immagine Azure Resource Manager.

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

Sulla pagina Gestione alimentazione, modificare le impostazioni di gestione dell’alimentazione e selezionare una connessione di gestione dell’alimentazione.
- Sulla pagina Unità organizzative, aggiungere o rimuovere le OU di Active Directory.
1. Sulla pagina Descrizione, modificare la descrizione del catalogo.
1. Fare clic su Applica per applicare le modifiche apportate e fare clic su Salva per uscire.
Rinominare un catalogo

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
Selezionare un catalogo e quindi selezionare Rinomina catalogo macchine nella barra delle azioni.

1. Immettere il nuovo nome.

Eliminare un 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 contenga macchine dal catalogo.

Per eliminare un catalogo:

-  1.  Da Studio, selezionare **Cataloghi macchine** nel riquadro sinistro.
-  1.  Selezionare un catalogo e quindi selezionare **Elimina catalogo macchine** nella barra delle azioni.
-  1.  Se il catalogo contiene macchine persistenti, indicare se eliminare anche tali macchine dall'hypervisor o dal servizio cloud. Se si sceglie di farlo, scegliere se mantenere, disabilitare o eliminare i relativi account computer di Active Directory.

Se necessario, selezionare Nascondi stato di avanzamento per eseguire l’eliminazione in background.

Nota:
-  Quando si elimina un catalogo di Azure Resource Manager, le macchine e i gruppi di risorse associati vengono eliminati da Azure, anche se si sceglie di mantenerli.
Quando si elimina un catalogo contenente macchine non persistenti, tali macchine vengono eliminate dall’hypervisor o dal servizio cloud.

Se l’hypervisor o il servizio cloud non è raggiungibile durante l’eliminazione del catalogo, l’eliminazione del catalogo e della VM non riesce. Se necessario, è possibile scegliere di eliminare i record delle VM solo dal database del sito Citrix. A tale scopo, selezionare il catalogo macchine nel nodo Cataloghi macchine e quindi eseguire l’eliminazione mostrata nella scheda Risoluzione dei problemi. Tenere presente che questa azione lascia le VM intatte sull’host.

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 a sessione singola e multisessione. Tali account possono quindi essere utilizzati per altre macchine.
Aggiungere account in modo che, quando vengono aggiunte altre macchine al catalogo, gli account computer siano già presenti. Non utilizzare una barra (/) in un nome di unità organizzativa (OU).
Per gestire gli account di Active Directory:

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
Selezionare un catalogo e quindi selezionare Gestisci account AD nella barra delle azioni.
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 una reimpostazione della password. Se si immette una password, la password viene modificata sugli account man mano che vengono importati. Se si elimina un account, scegliere se l’account in un Active Directory deve essere mantenuto, disabilitato o eliminato.

È inoltre possibile indicare se gli account di Active Directory devono essere mantenuti, disabilitati o eliminati quando si rimuovono macchine da un catalogo o si elimina un catalogo.

Modificare l’immagine master per un catalogo

Si consiglia di salvare copie o snapshot delle immagini prima di modificare l’immagine master per un catalogo. Il database mantiene una cronologia delle immagini utilizzate con ogni catalogo macchine. Se gli utenti riscontrano problemi con la nuova immagine distribuita sui loro desktop, è possibile ripristinare la versione precedente, riducendo al minimo i tempi di inattività degli utenti. Non eliminare, spostare o rinominare le immagini. In caso contrario, non sarà possibile ripristinare l’immagine master.

Importante:

Quando si modifica l’immagine master per un catalogo persistente, considerare quanto segue: solo le macchine aggiunte al catalogo in seguito vengono create utilizzando la nuova immagine. Non distribuiamo la nuova immagine alle macchine esistenti nel catalogo.

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

Convertire i cataloghi con provisioning MCS dall’utilizzo di immagini master all’utilizzo di immagini preparate

Per convertire un catalogo con provisioning MCS dall’utilizzo di un’immagine master all’utilizzo di un’immagine preparata, seguire questi passaggi:

Fare clic su Cataloghi macchine nel riquadro sinistro e selezionare un catalogo macchine che si desidera convertire. Fare clic con il pulsante destro del mouse e selezionare Converti in immagine preparata.
Nella pagina Immagine, selezionare un’immagine preparata.
Nella pagina Strategia di distribuzione, selezionare quando si desidera aggiornare questo catalogo con l’immagine preparata selezionata.
Nella pagina Riepilogo, verificare i dettagli e fare clic su Fine.
Verificare i dettagli del catalogo macchine convertito in Proprietà modello.
- Attualmente, questa funzionalità è disponibile solo per gli ambienti di virtualizzazione Azure e VMware.

Aggiornare o creare un’immagine

Prima di modificare l’immagine master per un catalogo, preparare una nuova immagine sull’hypervisor host aggiornando un’immagine esistente o creandone una nuova.

Sull’hypervisor o sul provider di servizi cloud, acquisire uno snapshot della VM corrente e assegnargli un nome significativo. Questo snapshot può essere utilizzato per ripristinare l’immagine master.
Se necessario, accendere l’immagine ed effettuare l’accesso.
Installare gli aggiornamenti o apportare le modifiche necessarie all’immagine.
Se l’immagine utilizza un Personal vDisk, aggiornare l’inventario.
Spegnere la VM.
Acquisire uno snapshot della VM e assegnargli un nome significativo che venga riconosciuto quando si modifica l’immagine master.

Nota:

Sebbene sia possibile creare uno snapshot utilizzando l’interfaccia di gestione, si consiglia di creare uno snapshot utilizzando la console di gestione dell’hypervisor e quindi selezionare tale snapshot in Studio. Ciò consente di fornire un nome e una descrizione significativi anziché un nome generato automaticamente. Per le immagini GPU, è possibile modificare l’immagine solo tramite la console XenServer XenCenter®.

Modificare l’immagine master

Per distribuire una nuova immagine master a tutte le macchine in un catalogo:

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
Selezionare un catalogo e quindi selezionare Cambia immagine master nella barra delle azioni.
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.

Nella pagina Strategia di distribuzione, scegliere quando le macchine nel catalogo macchine vengono modificate con la nuova immagine: 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.

Verificare le informazioni nella pagina Riepilogo e quindi selezionare Fine. Ogni macchina si riavvia automaticamente dopo l’aggiornamento.

Per monitorare l’avanzamento dell’aggiornamento, individuare il catalogo in Cataloghi macchine per visualizzare la barra di avanzamento in linea e il grafico di avanzamento dettagliato. Per un catalogo non persistente, è possibile monitorare gli stati di aggiornamento dell’immagine tramite la colonna Aggiornamento immagine, che include Completamente aggiornato, Parzialmente aggiornato, Aggiornamento in sospeso e Preparazione immagine.

Suggerimento:

Per visualizzare la colonna Aggiornamento immagine, selezionare l’icona Colonne da visualizzare nella barra delle azioni, selezionare Catalogo macchine > Stato immagine e quindi fare clic su Salva.

Se si sta aggiornando un catalogo utilizzando l’SDK PowerShell, è possibile specificare un modello di hypervisor (VMTemplates), in alternativa a un’immagine o a uno snapshot di un’immagine.

Per distribuire una nuova immagine master nel catalogo macchine basato su Azure:

1. Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.

Selezionare un catalogo Azure e quindi selezionare Cambia immagine master nella barra delle azioni.
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

-  La modifica dell'immagine al prossimo arresto interesserà immediatamente tutte le macchine non attualmente in uso, ovvero le macchine che non dispongono di una sessione utente attiva. Un sistema in uso riceve l'aggiornamento al termine della sessione attiva corrente.

-  > **Nota:** > > La strategia di distribuzione è applicabile solo alle VM non persistenti.

Considerare quanto segue:

Non è possibile avviare nuove sessioni finché l’aggiornamento non è stato completato sulle macchine applicabili.
Per le macchine a sessione singola, le macchine vengono aggiornate immediatamente quando non sono 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 dagli 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 aggiornata o nuova, è possibile eseguirne il rollback. Ciò 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. 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. Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
1. Selezionare il catalogo e quindi selezionare Esegui rollback immagine master nella barra delle azioni.
  - 1. Specificare quando applicare l’immagine precedente alle macchine, come descritto per l’operazione di distribuzione.
- Il rollback viene applicato solo alle macchine che devono essere ripristinate. Per le macchine che non sono state modificate con la nuova immagine o l’immagine aggiornata (ad esempio, macchine con utenti che non hanno eseguito la disconnessione), gli utenti non ricevono messaggi di notifica e non sono costretti 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.
- Non è possibile eseguire il rollback in determinati scenari, inclusi i seguenti. (L’opzione Esegui rollback immagine master non è visibile).
- Non si dispone dell’autorizzazione per eseguire il rollback.
- Il catalogo non è stato creato utilizzando MCS.
- Il catalogo è stato creato utilizzando un’immagine del disco del sistema operativo.
Lo snapshot utilizzato per creare il catalogo è danneggiato.
Le modifiche utente alle macchine nel catalogo non persistono.
- Le macchine nel catalogo sono in esecuzione.

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. Si 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 Citrix DaaS. Ciò consente all'interfaccia di gestione di determinare che le macchine nel catalogo necessitano di aggiornamento.

Per modificare il livello funzionale per un catalogo:

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro. - 1. Selezionare il catalogo. La scheda Dettagli nel riquadro inferiore visualizza le informazioni sulla versione.
Selezionare Cambia livello funzionale. Se l’interfaccia di gestione rileva che il catalogo deve modificare il livello funzionale, visualizza un messaggio. Seguire le istruzioni. Se una o più macchine non possono essere modificate, un messaggio ne spiega il motivo. Per garantire che tutte le macchine funzionino correttamente. Si consiglia di risolvere tali problemi prima di fare clic su Cambia.

Al termine dell’aggiornamento 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](/it-it/citrix-daas/install-configure/machine-catalogs-create.html#operating-system) e [gestione macchine](/it-it/citrix-daas/install-configure/machine-catalogs-create.html#machine-management). 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 delle risorse.

-  La clonazione di un catalogo può richiedere del tempo per essere completata. Se necessario, selezionare **Nascondi avanzamento** per eseguire la clonazione in background.
-  Il catalogo clonato eredita il nome dell'originale e ha un suffisso `Copy`. È possibile modificare il nome. Vedere [Rinominare un catalogo](/it-it/citrix-daas/install-configure/machine-catalogs-manage.html#rename-a-catalog).

Al termine della clonazione, assicurarsi di assegnare il catalogo clonato a un gruppo di consegna.
È possibile creare un catalogo vuoto tramite clonazione. Durante la clonazione del catalogo, è possibile impostare il numero di macchine su zero per i cataloghi con provisioning MCS e non aggiungere macchine per i cataloghi senza provisioning MCS.

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
- 1. Selezionare un catalogo e quindi selezionare Clona nella barra delle azioni.
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.
Nella pagina Riepilogo, visualizzare un riepilogo delle impostazioni e selezionare Fine per avviare la clonazione.
Se necessario, selezionare Nascondi avanzamento per eseguire la clonazione in background.

Organizzare i cataloghi utilizzando le cartelle

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

Suggerimento:

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

Ruoli richiesti

Per impostazione predefinita, è necessario disporre dei seguenti ruoli predefiniti per creare e gestire le cartelle del catalogo: Amministratore cloud, Amministratore completo o Amministratore del catalogo macchine. Se necessario, è possibile personalizzare i ruoli per la creazione e la gestione delle cartelle del catalogo. Per maggiori informazioni, vedere Autorizzazioni richieste.

Creare una cartella del catalogo

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

È possibile annidare le cartelle fino a cinque livelli di profondità (esclusa la cartella radice predefinita).
Una cartella del catalogo può contenere cataloghi e sottocartelle.
Tutti i nodi in Studio (ad esempio 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

 
```

Per creare una cartella del catalogo, seguire questi passaggi:

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
Nella gerarchia delle cartelle, selezionare una cartella e quindi selezionare Crea cartella nella barra delle Azioni.
Immettere un nome per la nuova cartella e quindi fare clic su Fatto.

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:

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
Visualizzare i cataloghi per cartella. È anche possibile attivare Visualizza tutto sopra la gerarchia delle cartelle per visualizzare tutti i cataloghi contemporaneamente.
Fare clic con il pulsante destro del mouse su un catalogo e quindi selezionare Sposta catalogo macchine.
Selezionare la cartella in cui si desidera spostare il catalogo e quindi fare clic su Fatto.
- Suggerimento:
  
  È possibile trascinare un catalogo in una cartella.

Gestire le cartelle del catalogo

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

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
Nella gerarchia delle cartelle, selezionare una cartella e quindi selezionare un’azione nella barra delle 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.
Seguire le istruzioni visualizzate per completare i passaggi rimanenti.

Autorizzazioni richieste

La tabella seguente elenca le autorizzazioni richieste per eseguire azioni sulle cartelle del catalogo.

Azione	Autorizzazioni richieste
Creare cartelle del catalogo	Crea cartella catalogo macchine
Eliminare cartelle del catalogo	Rimuovi cartella catalogo macchine
Spostare cartelle del catalogo	Sposta cartella catalogo macchine
Rinominare cartelle del catalogo	Modifica cartella catalogo macchine
Spostare cataloghi in cartelle	Modifica cartella catalogo macchine e Modifica proprietà catalogo macchine

Aggiornare i VDA

È possibile utilizzare l’interfaccia di Studio per aggiornare i VDA con facilità. Per maggiori informazioni e una guida dettagliata, consultare la documentazione del Servizio di aggiornamento VDA Citrix.

Gestire le impostazioni di ottimizzazione dell’esperienza per un catalogo

Prima di iniziare, assicurarsi che la distribuzione del servizio Workspace Environment Management (WEM) sia configurata. Per maggiori informazioni, vedere Introduzione al servizio Workspace Environment Management.

Autorizzazioni richieste

Per impostazione predefinita, la creazione e la gestione dei set di configurazione per i cataloghi macchine richiedono il ruolo di Amministratore completo WEM, insieme a uno dei seguenti ruoli:
Amministratore con accesso completo
Amministratore cloud
Amministratore del catalogo macchine
Per consentire ad altri ruoli di gestire i set di configurazione, assegnare loro sia l’autorizzazione Gestisci set di configurazione sia il ruolo di Amministratore completo WEM.
Modificare le impostazioni di ottimizzazione dell’esperienza
Selezionare un’opzione di Ottimizzazione dell’esperienza da applicare al catalogo:
Applica impostazioni predefinite: Selezionare questa opzione per applicare le impostazioni di ottimizzazione predefinite, inclusa la protezione automatica dai picchi di CPU e l’ottimizzazione intelligente della CPU.
Applica impostazioni personalizzate: Immettere un nome per creare un set di configurazione, quindi personalizzare le impostazioni di ottimizzazione in base alle proprie esigenze. In alternativa, è possibile selezionare un set di configurazione esistente.
Riprova la creazione del 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, accedere 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 può richiedere del tempo per essere completata. Se necessario, selezionare Nascondi avanzamento per eseguire la creazione in background.
- Per riprovare a creare un catalogo, procedere come segue:

Da Studio, selezionare Cataloghi macchine nel riquadro sinistro.
Selezionare il catalogo e quindi accedere alla relativa scheda Risoluzione dei problemi.
- 1. Fare clic sul collegamento ipertestuale di riprova per riprovare a creare il catalogo.
Nella procedura guidata visualizzata, modificare le impostazioni ove necessario. Se non è necessario apportare modifiche, è possibile passare direttamente alla pagina Riepilogo.
Al termine, selezionare Fine per avviare la creazione.

(Solo VDA non forniti da Citrix) Generare e gestire i token di registrazione

Nota:

Per eseguire questa attività, è necessario disporre del ruolo di Cloud Administrator.
Dopo aver deciso di adottare la registrazione basata su token per le macchine non fornite da Citrix, generare i token per ogni catalogo di macchine e quindi condividerli con gli amministratori dell’installazione VDA.
Un token di registrazione presenta:
Intervallo di registrazione: da 1 a 5000 macchine VDA
Periodo di validità: fino a 14 giorni
Per generare un token per un catalogo utilizzando Studio, seguire questi passaggi:

In Cataloghi macchine, individuare un catalogo non fornito da MCS, che abbia Metodo di provisioning: Manuale visualizzato nella colonna Conteggio macchine.
Fare clic con il pulsante destro del mouse sul catalogo, quindi selezionare Gestisci token di registrazione.
Nella pagina Genera token di registrazione 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).
Fare clic su Genera.
Nella finestra Token generato correttamente visualizzata, copiare il token e salvarlo in un luogo sicuro, oppure fare clic su Scarica per scaricarlo nella cartella Download.

Un record del token appare nell’elenco dei token.
Condividere il token con gli amministratori dell’installazione VDA.

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

Gestire i token

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

Revoca: Revoca il token ma lo mantiene nell’elenco a scopo di registrazione.
Elimina: Revoca il token e lo elimina dall’elenco.

Nota:

-  > I token scaduti vengono eliminati automaticamente entro 14 giorni.

Utilizzare PowerShell

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

Per personalizzare il numero di sequenza delle macchine, distribuite utilizzando MCS, tramite comandi PowerShell, procedere come segue:

Aprire PowerShell come amministratore sul Delivery Controller.
Eseguire il comando asnp citrix* per caricare i moduli Citrix.
Eseguire il comando seguente per controllare il conteggio iniziale per il pool di identità del catalogo:

Get-AcctIdentityPool -IdentityPoolName xxx
IdentityPoolName è il nome del catalogo.

Se si desidera impostare questo conteggio su un valore diverso, eseguire il comando seguente e specificare StartCount come X:

Set-AcctIdentityPool -IdentityPoolName xxx -StartCount X

Aggiungere le macchine al catalogo in modo che le macchine vengano create con il conteggio richiesto.
Dopo aver creato le macchine, eseguire il comando seguente per reimpostarlo sul valore originale Y:

Set-AcctIdentityPool -IdentityPoolName xxx -StartCount Y

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. Questa funzionalità è utile per gli amministratori che desiderano aggiungere etichette descrittive quando aggiornano un’immagine master utilizzata da un catalogo, ad esempio, Office 365 installato. Utilizzare i seguenti comandi per aggiungere o visualizzare le descrizioni delle immagini:

NewProvScheme. Un nuovo parametro, masterImageNote, consente di aggiungere una nota a un’immagine. Ad esempio:

C:\PS>New-ProvScheme -ProvisioningSchemeName XenPS -HostingUnitName XenHu -IdentityPoolName idPool1 -MasterImageVM XDHyp:\HostingUnits\XenHU\Base.vm\Base.snapshot -MasterImageNote "Office365 installed"

<!--NeedCopy-->

Publish-ProvMasterVMImage. Utilizzare questo parametro per pubblicare la nota. Ad esempio:
C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName MyScheme -MasterImageVM XDHyp:\HostingUnits\HostUnit1\RhoneCC_baseXP.vm\base.snapshot -MasterImageNote "Visual Studio 2019 installed"
Get-ProvSchemeMasterVMImageHistory. Visualizzare le informazioni per ogni immagine. Ad esempio:

`C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall

VMImageHistoryUid : 3cba3a75-89cd-4868-989b-27feb378fec5

ProvisioningSchemeUid : 7585f0de-192e-4847-a6d8-22713c3a2f42

ProvisioningSchemeName : MyScheme

MasterImageVM : /Base.vm/base.snapshot

-  Date : 17/05/2021 09:27:50

-  MasterImageNote : Office365 installed`

Reimpostare il disco del sistema operativo
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, Google Cloud, SCVMM, VMware e XenServer®.
Per eseguire correttamente il comando PowerShell, assicurarsi che:
Le VM di destinazione si trovino in un catalogo MCS persistente.
Il catalogo di macchine MCS funzioni correttamente. Ciò implica che lo schema di provisioning e l’host esistano e che lo schema di provisioning contenga 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:

Aprire una finestra PowerShell.
Eseguire asnp citrix* per caricare i moduli PowerShell specifici di Citrix.
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 ogni VM:
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS

 
```
- Specificare l’elenco di VM come output del comando Get-ProvVM ed eseguire il ripristino su ogni VM:
```
 (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS

 
```
  - Specificare una singola VM per nome:
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS

 
```
  - 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 ogni VM.
```
 Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS

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

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

È inoltre possibile ignorare il prompt di conferma utilizzando uno dei seguenti metodi:
- Fornire il parametro -Force:
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force

 
```
  - Fornire il parametro -Confirm:$false:
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false

 
```
  - Prima di eseguire Reset-ProvVMDisk, impostare $ConfirmPreference su ‘None’:
```
 PS C:\Windows\system32> $ConfirmPreference='None'
 PS C:\Windows\system32> $ConfirmPreference
 None
 PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS

 
```
Nota:

Non disattivare la modalità di manutenzione delle VM né accenderle prima del completamento del processo di ripristino.
Eseguire Get-ProvTask per ottenere lo stato delle attività restituite dal comando Reset-ProvVMDisk.

Riparare le informazioni sull’identità degli account computer attivi

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

Nota:

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

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

Reimpostare le informazioni sull’identità

Per reimpostare le informazioni sull’identità:

Aprire la finestra PowerShell.
Eseguire asnp citrix* per caricare i moduli PowerShell specifici di Citrix.
Reimpostare le informazioni sull’identità.
- Per reimpostare solo la password della macchina e le chiavi di fiducia, eseguire il comando seguente:
```
 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 di identità che deve essere riparato.
  - PrivilegedUserName: Account utente che dispone dell’autorizzazione di scrittura sul provider di identità (AD o Microsoft Entra ID).
  - PrivilegedUserPassword: Password per PrivilegedUserName.
  - Target: Destinazione per l’azione di ripristino. Può essere IdentityInfo per riparare la password dell’account/chiave di fiducia e UserCertificate per riparare gli attributi del certificato utente delle identità di macchina ibride di Microsoft Entra.
- Per reimpostare tutta la configurazione del disco di identità, eseguire i seguenti comandi nel seguente ordine:
```
 Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo

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

 
```
- Per ricreare completamente il disco di identità:
```
 Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate

 
```
  Nota:
  - > - > Se la macchina è su una versione VDA 2511 (Aggiornamento 1) o successiva e ha la chiave di registro impostata per abilitare `MachineGuid` univoco (`HKLM:\Software\Citrix\MachineIdentityServiceAgent\EnableUniqueMachineGuid`), continuerà a utilizzare lo stesso `MachineGuid` di prima indipendentemente dall'impostazione `-Recreate`
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


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

Modificare l’impostazione di rete per un catalogo di macchine esistente

È possibile modificare l’impostazione di rete per un catalogo di macchine 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.

-  Per modificare l'impostazione di rete per uno schema di provisioning esistente, procedere come segue:

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

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

$NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}

<!--NeedCopy-->

Eseguire Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap.
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 per il 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

 
```
Per visualizzare i dettagli di configurazione di una particolare versione di un catalogo di macchine:
```
 Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2

 
```

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

 
```
Per impostare il numero massimo di versioni da conservare per il 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 per il 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.
Modificare la configurazione della cache di 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 su disco per la cache.

Il valore di WriteBackCacheMemorySize deve essere inferiore alla dimensione della memoria del catalogo di macchine.

Queste modifiche influiscono solo sulle nuove VM aggiunte al catalogo dopo che la modifica è stata apportata. Le VM esistenti non sono interessate da queste modifiche.

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), o un modello VMware (nel caso di VMware) 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.

Nota:

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

Per fare ciò:

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

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>

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

Recuperare avvisi ed errori associati a un catalogo

È possibile recuperare errori e avvisi storici per comprendere i problemi del catalogo macchine MCS e risolverli.

Utilizzando i comandi PowerShell, è possibile:

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

Per eseguire i comandi PowerShell:

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

Per eliminare gli errori o gli avvisi:

Eseguire il comando Remove-ProvOperationEvent.

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

Per maggiori informazioni, consultare il Citrix PowerShell SDK.

Eliminare macchine senza accesso all’hypervisor

Quando si elimina una VM o uno schema di provisioning, MCS deve rimuovere i tag dalla VM e, a volte, 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 in assenza di accesso all’hypervisor.

Questa opzione è abilitata su:

tutti gli hypervisor supportati
VM persistenti e non persistenti

Limitazioni

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

Utilizzare il comando PurgeDBOnly

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

La connessione host è in modalità di manutenzione
Credenziali non valide
Autenticazione non riuscita
Operazione non autorizzata
L’hypervisor non è raggiungibile

Nota:

Remove-provVM -ForgetVM ha come destinazione solo le VM persistenti. Se una delle VM nell’elenco non è persistente, l’operazione non riesce.

Quando l’operazione non riesce perché l’hypervisor non è raggiungibile, viene visualizzato il seguente messaggio:

Provare a utilizzare l'opzione -PurgeDBOnly per pulire il database DDC.

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

Aggiornare le proprietà delle singole VM

È possibile aggiornare le proprietà delle singole VM in un catalogo di macchine MCS persistente utilizzando il comando PowerShell Set-ProvVM. Tuttavia, gli aggiornamenti non vengono applicati immediatamente. È necessario impostare la finestra temporale utilizzando il comando PowerShell Set-ProvVMUpdateTimeWindow affinché gli aggiornamenti vengano applicati.

Questa implementazione consente di gestire le singole VM in modo efficiente senza aggiornare l’intero catalogo di macchine. Attualmente, questa funzionalità è applicabile agli ambienti Azure e VMware.

Attualmente, le proprietà che è possibile aggiornare sono:

CustomProperties
ServiceOffering (Non applicabile a VMware)
MachineProfile
CpuCount
Memory

Utilizzando questa funzionalità, è possibile:

Aggiornare le proprietà di una VM
Mantenere le proprietà aggiornate su una VM dopo l’aggiornamento del catalogo di macchine
Ripristinare gli aggiornamenti di configurazione applicati a una VM

Prima di aggiornare le proprietà di una VM:

Aprire una finestra PowerShell.
Eseguire asnp citrix* per caricare i moduli PowerShell specifici di Citrix.
Controllare la configurazione del catalogo di macchine esistente. Ad esempio:
```
Get-ProvScheme -ProvisioningSchemeName <catalog name>


```
Controllare la configurazione della VM su cui si desidera applicare gli aggiornamenti. Ad esempio:
```
Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1


```

Aggiornare le proprietà di una VM

Eseguire le seguenti operazioni per aggiornare le proprietà di una VM:

Spegnere la VM su cui si desidera applicare gli aggiornamenti.

Aggiornare le proprietà della VM. Ad esempio, se si desidera aggiornare la proprietà personalizzata del tipo di archiviazione (StorageType) della VM, eseguire quanto segue:

Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."

<!--NeedCopy-->

È possibile aggiornare le proprietà di due VM in un catalogo di macchine contemporaneamente. Ad esempio:

Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."

<!--NeedCopy-->

Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine2 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."

<!--NeedCopy-->

Nota:

Gli aggiornamenti non vengono applicati immediatamente.

Ottenere l’elenco delle proprietà che devono essere aggiornate e la versione della configurazione. Ad esempio:
```
Get-ProvVMConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1


```
Controllare il valore della proprietà Version e le proprietà da aggiornare (in questo caso, StorageType).
Controllare la versione della configurazione. Ad esempio:
```
Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1


```
Controllare il valore della proprietà ProvVMConfigurationVersion. L’aggiornamento non è ancora stato applicato. La VM è ancora nella vecchia configurazione.
Richiedere l’aggiornamento pianificato. Ad esempio:
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -StartsNow -DurationInMinutes -1

 
```
Per ulteriori informazioni sugli aggiornamenti pianificati, vedere Aggiornare le macchine con provisioning allo stato corrente dello schema di provisioning.

Nota:

Viene applicato anche qualsiasi aggiornamento dello schema di provisioning in sospeso.

Riavviare la VM. Ad esempio:

New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn

<!--NeedCopy-->

Verificare la versione della configurazione. Ad esempio:
```
Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1


```
Controllare il valore della proprietà ProvVMConfigurationVersion. L’aggiornamento è ora applicato. La VM ha ora la nuova configurazione.
Per applicare ulteriori aggiornamenti di configurazione alla VM, spegnere la VM e ripetere i passaggi.

Mantenere le proprietà aggiornate su una VM dopo l’aggiornamento del catalogo macchine

Eseguire le seguenti operazioni per mantenere le proprietà aggiornate su una VM:

Spegnere la VM su cui si desidera applicare gli aggiornamenti.

Aggiornare il catalogo macchine. Ad esempio, se si desidera modificare le dimensioni della VM (ServiceOffering) e il tipo di archiviazione (StorageType), eseguire quanto segue:

Set-ProvScheme -ProvisioningSchemeName <catalog name> -ServiceOffering Standard_E4_v3 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."

<!--NeedCopy-->

Ottenere i dettagli di configurazione del catalogo macchine. Ad esempio:
```
Get-ProvScheme -ProvisioningSchemeName <catalog name>


```
La ProvisioningSchemeVersion è ora incrementata di uno. Anche le dimensioni della VM e il tipo di archiviazione sono stati aggiornati.

Aggiornare le proprietà della VM. Ad esempio, fornire un profilo macchina alla VM.

Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1 -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<template-spec>.templatespec\<template-spec-version>.templatespecversion"

<!--NeedCopy-->

Nota:

L’input del profilo macchina ha un tag e una dimensione VM (ServiceOffering) diversa specificata.

Ottenere l’elenco delle proprietà che la VM avrà dopo aver unito gli aggiornamenti di configurazione sulla VM con gli aggiornamenti del catalogo macchine. Ad esempio:
```
Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName <catalog name> -VMName machine1


```
Nota:

Qualsiasi aggiornamento sulla VM sovrascriverà gli aggiornamenti eseguiti sul catalogo macchine.

Richiedere l’aggiornamento pianificato per la VM. Ad esempio:

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -VMName machine1 -StartsNow -DurationInMinutes -1

<!--NeedCopy-->

Riavviare la VM. Ad esempio:
```
New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn


```
La VM mantiene le sue dimensioni aggiornate derivate dal profilo macchina. I valori dei tag specificati nel profilo macchina vengono anch’essi applicati alla VM. Tuttavia, il tipo di archiviazione è derivato dallo schema di provisioning più recente.
Ottenere la versione della configurazione della VM. Ad esempio:
```
Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1


```
La ProvisioningSchemeVersion e la ProvVMConfigurationVersion mostrano ora la versione più recente.

Ripristinare gli aggiornamenti di configurazione applicati a una VM

Dopo aver applicato gli aggiornamenti a una VM, spegnere la VM.

Eseguire il comando seguente per rimuovere gli aggiornamenti applicati alla VM. Ad esempio:

Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1

<!--NeedCopy-->

Richiedere l’aggiornamento pianificato per la VM. Ad esempio:

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -VMName machine1 -StartsNow -DurationInMinutes -1

<!--NeedCopy-->

Riavviare la VM. Ad esempio:

New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn

<!--NeedCopy-->

Controllare la versione di configurazione della VM. Ad esempio:
```
Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1


```
Il valore ProvVMConfigurationVersion è ora la versione di configurazione del catalogo di macchine.

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à della VM come la gestione dell’alimentazione, il ripristino del disco del sistema operativo e così via. È inoltre possibile aggiungere nuove VM al catalogo di macchine utilizzando il nuovo storage su disco. A tale scopo, utilizzare il comando PowerShell Move-ProvVMDisk.

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

Per le VM persistenti Full Clone: 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 della cache di scrittura (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 lo storage su disco:

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

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

Per le VM non persistenti:
- Se viene utilizzata la WBC, configurare lo storage di destinazione WBC nell’unità di hosting.
- Se lo storage di destinazione del sistema operativo è configurato, la WBC (se utilizzata) deve essere compatibile con lo storage di destinazione del sistema operativo.
- Se lo storage di destinazione del sistema operativo non è configurato, la WBC (se utilizzata) deve essere compatibile con lo storage del sistema operativo corrente.
Spegnere le VM e attivare la Modalità di manutenzione.
Ottenere le informazioni sullo schema di provisioning, sull’unità di hosting, sullo storage del disco del sistema operativo e sullo storage del disco WBC.
- Eseguire ProvResourceInStorage per le informazioni sullo storage del sistema operativo. Ad esempio:
```
 $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.ProvResourceInStorage | Format-List -Property *

 
```
- Eseguire TemporaryStorageInfo per le informazioni sullo storage WBC. Ad esempio:
```
 $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.TemporaryStorageInfo | Format-List -Property *

 
```
Migrare il disco del sistema operativo, il disco di identità e il disco WBC (applicabile alle VM non persistenti) allo storage di destinazione utilizzando il comando PowerShell Move-ProvVMDisk.
Nota:
- Fornire sempre i dischi del sistema operativo e di identità nei parametri DiskType e DestinationStorageId.
- Il DestinationStorageId per il disco del sistema operativo e il disco di identità deve essere lo stesso.
Esempio:

VM persistenti:
```
(Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myFullCloneProvScheme" -VMName "machine01" -DiskType OS,Identity -DestinationStorageId datastore1,datastore1


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


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

Risoluzione dei problemi

Se uno dei dischi non riesce a migrare, nessuno dei dischi viene migrato allo storage di destinazione. È possibile ottenere il rapporto di errore utilizzando il seguente comando:

(Get-ProvTask -TaskID xxxxxxxxx).DiskMoveFailedVirtualMachines

<!--NeedCopy-->

Considerazioni importanti per la migrazione di VM non persistenti in VMware

Se si tenta di spostare il disco del sistema operativo e il disco di identità in un nuovo storage, anche i file specifici della VM vengono spostati nel nuovo storage.
VMware non supporta lo spostamento del disco se ha lo snapshot.

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

È possibile convertire un catalogo di macchine esistente di cui è stato eseguito il provisioning tramite MCS in un catalogo di macchine con immagine preparata utilizzando il comando PowerShell Set-ProvSchemeImage. Tuttavia, non è possibile ripristinare il 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:

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

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

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

<!--NeedCopy-->

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


```
Eseguire il comando Set-ProvSchemeImage per migrare un catalogo di macchine esistente di cui è stato eseguito il provisioning tramite MCS in un catalogo di macchine con immagine preparata. Ad esempio:
```
Set-ProvSchemeImage -ProvisioningSchemeName [ProvisioningSchemeName] -ImageVersionSpecUid [ImageVersionSpecUid]


```

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, consultare Come risolvere il problema delle VM che mostrano continuamente uno stato di alimentazione sconosciuto.
Se un Cloud Connector non funziona correttamente, le operazioni di provisioning MCS (come gli aggiornamenti del catalogo) richiedono più tempo del solito e le prestazioni della console di gestione si degradano in modo significativo.

Dove andare dopo

Per informazioni sulla gestione di cataloghi di hypervisor specifici, vedere:

La versione ufficiale di questo contenuto è in inglese. Per alcuni dei contenuti della documentazione Cloud Software Group è stata impiegata la traduzione automatica solo per comodità. Cloud Software Group non ha alcun controllo sui contenuti tradotti in modo automatico, che possono contenere errori, imprecisioni o linguaggio inadatto. Non viene offerta alcuna garanzia di alcun tipo, espressa o implicita, circa l'accuratezza, l'affidabilità, l'idoneità o la correttezza di qualsiasi traduzione dall'originale inglese in qualsiasi altra lingua, o che il prodotto o servizio Cloud Software Group sia conforme a qualsiasi contenuto in traduzione automatica, e qualsiasi garanzia fornita ai sensi del contratto di licenza per l'utente finale applicabile o i termini di servizio, o qualsiasi altro accordo con Cloud Software Group che il prodotto o il servizio sia conforme a qualsiasi documentazione non si applicheranno nella misura in cui tale documentazione sia in traduzione automatica. Cloud Software Group non sarà ritenuta responsabile per eventuali danni o problemi che potrebbero derivare dall'utilizzo di contenuti per cui si è impiegata la traduzione automatica.

È stato utile?

Gestire i cataloghi di macchine

May 4, 2026

Grazie al contributo di:

C C

May 4, 2026

Grazie al contributo di:

C C

In questo articolo

Introduzione
Informazioni sulle istanze persistenti
Gestire i cataloghi di macchine
Utilizzo di Studio
Visualizzare i dettagli del catalogo
Aggiungere macchine a un catalogo
Eliminare le macchine da un catalogo
Modificare un catalogo
Rinominare un catalogo
Eliminare un catalogo
Gestire gli account computer di Active Directory in un catalogo
Modificare l’immagine master per un catalogo
Convertire i cataloghi con provisioning MCS dall’utilizzo di immagini master all’utilizzo di immagini preparate
Modificare il livello funzionale o annullare la modifica
Clonare un catalogo
Organizzare i cataloghi utilizzando le cartelle
Aggiornare i VDA
Gestire le impostazioni di ottimizzazione dell’esperienza per un catalogo
Riprova la creazione del catalogo
(Solo VDA non forniti da Citrix) Generare e gestire i token di registrazione
Utilizzare PowerShell
Gestire il numero di sequenza del nome della macchina
Aggiungere descrizioni a un’immagine
Reimpostare il disco del sistema operativo
Riparare le informazioni sull’identità degli account computer attivi
Modificare l’impostazione di rete per un catalogo di macchine esistente
Gestire le versioni di un catalogo di macchine
Modificare la configurazione della cache di un catalogo di macchine esistente
Convertire un catalogo di macchine non basato su profilo macchina in un catalogo di macchine basato su profilo macchina
Recuperare avvisi ed errori associati a un catalogo
Eliminare macchine senza accesso all’hypervisor
Aggiornare le proprietà delle singole VM
Migrazione dello storage delle VM
Migrare i cataloghi di macchine esistenti con provisioning MCS a un catalogo di macchine con immagine preparata
Risoluzione dei problemi
Dove andare dopo

È stato utile?

Gestire i cataloghi di macchine

Introduzione

Informazioni sulle istanze persistenti