Citrix DaaS™

Gestire i cataloghi di macchine

Nota:

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

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 assicurarsi 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 che tali cataloghi utilizzano attualmente, ma solo le macchine aggiunte successivamente ai cataloghi vengono create utilizzando la nuova immagine o il nuovo modello.
  • Per i cataloghi di accesso remoto al PC, 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 la gestione delle connessioni a hypervisor host e 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

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

  1. Utilizzare la funzione di ricerca per individuare un catalogo di macchine specifico. Fare riferimento a Cercare istanze per le istruzioni.
  2. Dai risultati della ricerca, selezionare un catalogo, se necessario.
  3. Fare riferimento alla seguente tabella per le descrizioni delle colonne del catalogo.
  4. Fare clic su una scheda nel riquadro dei dettagli inferiore per ulteriori informazioni su questo catalogo.
Colonna Descrizione
Catalogo di 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 multisessione (virtuale); Dati utente: scartati.
  • Tipo di sistema operativo: sistema operativo multisessione (virtuale); Dati utente: su disco locale
  • Tipo di sistema operativo: sistema operativo a sessione singola (accesso remoto al PC)
  • 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 di macchine. Visualizza il nome della cartella in cui si trova il catalogo (inclusa la barra rovesciata finale), o - se il catalogo si trova al livello radice.
    Aggiornamento VDA Stato di aggiornamento del 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

    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 di macchine ha autorizzazioni AD limitate, aggiungere tutti i Cloud Connector che si intendono utilizzare nella schermata Accedi a….

    Per aggiungere macchine a un catalogo:

    1. Da Studio, selezionare Cataloghi di macchine nel riquadro sinistro.
    2. Selezionare un catalogo di macchine e quindi selezionare Aggiungi macchine nella barra delle azioni.
    3. Nella pagina Macchine virtuali, selezionare il numero di macchine virtuali da aggiungere.
    4. Nella pagina Identità delle macchine, 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, sfogliare 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 ulteriori informazioni, vedere la Documentazione SDK di Citrix Virtual Apps and Desktops.

      • Specificare uno schema di denominazione degli account, utilizzando i segni di cancelletto per indicare dove appaiono 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, che vengono distribuite utilizzando MCS, tramite comandi PowerShell.

    5. 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 possono richiedere molto tempo quando si creano molte macchine. La creazione delle macchine continua anche se si chiude Studio.

    È possibile aggiungere macchine in blocco utilizzando file CSV. La funzionalità è disponibile per tutti i cataloghi, eccetto i cataloghi con provisioning tramite MCS.

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

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

    Considerazioni sull’utilizzo di file CSV per aggiungere macchine

    Nota:

    • Per gli utenti non Active Directory, è necessario digitare i loro nomi in questo formato: <identity provider>:<user name>. 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 seguente formato:

      • Per coppie account macchina e nome utente (samName):

      • Dominio\NomeComputer1, Dominio\NomeUtente1
      • Dominio\NomeComputer2, Dominio\NomeUtente1;Dominio\NomeUtente2
      • Dominio\NomeComputer3, AzureAD:nomeutente

      • Solo per account macchina:

      • Dominio\NomeComputer1
      • Dominio\NomeComputer2

      • Per coppie VM e nome utente:

      • XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName1.vm,Dominio\NomeComputer1,Dominio\NomeUtente1
      • XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName2.vm,Dominio\NomeComputer2,Dominio\NomeUtente2

      • Solo per VM:

      • XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName1.vm,Dominio\NomeComputer1
      • XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName2.vm,Dominio\NomeComputer2

        Ad esempio: XDHyp:\Connections\xpace-scale\East US.region\vm.folder\wsvdaV3-2.vm

        dove,

      • xpace-scale è ConnectionName: il nome della connessione immesso in Hosting > Aggiungi connessioni e risorse. Per ulteriori informazioni, vedere Creare una connessione e risorse.
      • East US.region è RegionName: il nome della regione con .region come estensione.
      • wsvdaV3-2.vm è 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 può richiedere molto tempo per essere completata.

    È anche possibile esportare 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 macchine:

    1. Da Studio, selezionare Cataloghi di macchine nel riquadro sinistro.
    2. Selezionare un catalogo di macchine e quindi selezionare Aggiungi macchine nella barra delle azioni. Viene visualizzata la finestra Aggiungi macchine.
    3. Selezionare Esporta in file CSV. Viene scaricato un file CSV contenente un elenco delle macchine.
    4. 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 file CSV per aggiungere macchine in blocco a un catalogo.

    Nota:

    • Questa funzionalità non è disponibile per i cataloghi di accesso remoto al PC e con provisioning MCS.

    • L’esportazione e l’importazione di macchine in file CSV sono supportate solo tra cataloghi dello stesso tipo.

    Registrare macchine nei cataloghi utilizzando lo strumento di registrazione VDA WebSocket

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

    Nota:

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

    Seguire le istruzioni per eseguire lo strumento di registrazione:

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

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

    Nome parametro Obbligatorio Descrizione Esempio
    -websocket_token_stdin

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

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

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

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

    Codice Stringa Descrizione
    0 Success Il VDA è stato aggiunto correttamente al catalogo di macchine.
    -1 InvalidArgument Il parametro di input nel token di registrazione non è valido.
    -2 BrokerAgentNotFound Il servizio broker agent non è stato trovato.
    -3 TokenInvalid Il token immesso non è valido.
    -4 TokenMissingRequiredClaims Le attestazioni richieste per il token sono mancanti, ad esempio CustomerId o Enrollment URIs.
    -5 InternalError Si è verificato un errore generico.
    -6 TimedOut L’attività è scaduta.
    -7 FailedToDetermineMachineADJoinedStatus Il servizio che restituisce lo stato di unione AD della macchina non è riuscito.
    -8 ADMachineFailedToFindSid Il servizio che restituisce il SID della macchina AD non è riuscito.
    -9 EnrollRequestFailed La richiesta non è riuscita a causa di un errore HTTP.
    -10 EnrollResponseMissingRequiredFields La risposta dello strumento di registrazione manca del parametro VirtualSiteId.
    -11 InsufficientPermission Non si dispone dell’autorizzazione richiesta per eseguire l’attività.
    -12 FailedToDetermineMachineAadJoinedStatus Il servizio che controlla lo stato di unione AD della macchina genera un errore.
    -13 AadMachineFailedToFindDeviceId Il parametro aggiuntivo AAD device id aggiunto dal sistema è vuoto.
    -14 AadDeviceIdNotValid Il parametro aggiuntivo AAD device id aggiunto dal sistema non è un GUID valido.
    -15 NoValidMacAddress Indirizzo MAC non valido.
    -16 FailedToGetComputerHostNameForVdaInstanceName Impossibile ottenere il nome host del computer per impostare il parametro aggiuntivo VdaInstanceName.
    -17 VirtualDesktopAgentRegistryKeyFailedToOpen Impossibile aprire la chiave di registro VDA per scrivere l’elenco dei controller di consegna.
    -18 Failed Token reached the max count Il token non è riuscito a raggiungere il conteggio massimo.

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

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

    Per eliminare macchine da un catalogo:

    1. Da Studio, selezionare Cataloghi di macchine nel riquadro sinistro.
    2. Selezionare un catalogo e quindi selezionare Visualizza macchine nella barra delle azioni.
    3. Selezionare una o più macchine e quindi selezionare Elimina nella barra delle azioni.
    4. 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, vengono automaticamente eliminate dall’hypervisor o dal servizio cloud.

    1. Da Studio, selezionare Cataloghi di macchine nel riquadro sinistro.
    2. Selezionare un catalogo e quindi selezionare Modifica catalogo di macchine nella barra delle azioni.
    3. Nella pagina Ambiti, modificare gli ambiti.
    4. Nella pagina NIC, eseguire le seguenti azioni:

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

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

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

      Nota:

      • Per i cataloghi di macchine AWS, non è possibile mappare la stessa sottorete a più di una NIC.
      • Per i cataloghi di macchine con profili di macchina, il numero di NIC sul catalogo deve essere uguale al numero di NIC sul profilo di macchina.
      • Questa funzionalità non è supportata per gli hypervisor IBM Cloud.
      • Questa funzionalità è supportata solo per Nutanix Prism Element negli hypervisor Nutanix.
    5. Nella pagina Aggiornamento VDA, modificare o selezionare la versione VDA a cui eseguire l’aggiornamento. Per ulteriori informazioni, vedere Aggiornamento VDA.
    6. 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 si aggiungono successivamente al catalogo. Le macchine esistenti rimangono invariate.

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

        Nota:

        • Vengono visualizzate solo le dimensioni delle macchine supportate dal catalogo.
        • Se necessario, selezionare Mostra solo le dimensioni delle macchine utilizzate in altri cataloghi di macchine per filtrare l’elenco delle dimensioni delle macchine.
      • Nella pagina Profilo macchina, scegliere se utilizzare o modificare un profilo macchina.

      • (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 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, che richiede di selezionare una nuova dimensione della macchina.

      Per ulteriori informazioni sulle impostazioni disponibili nelle pagine, vedere Creare un catalogo di macchine utilizzando un’immagine di Azure Resource Manager.

      Per i cataloghi di accesso remoto al PC, sono visibili le seguenti pagine:

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

    Prima di eliminare un catalogo, assicurarsi che:

    • Tutti gli utenti siano disconnessi e 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. Da Studio, selezionare Cataloghi di macchine nel riquadro sinistro.
    2. Selezionare un catalogo e quindi selezionare Elimina catalogo di macchine nella barra delle azioni.
    3. 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 loro account computer di Active Directory.
    4. Se necessario, selezionare Nascondi avanzamento per eseguire l’eliminazione in background.

    Nota:

    • Quando si elimina 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 elimina un catalogo contenente macchine non persistenti, tali macchine vengono eliminate dall’hypervisor o dal servizio cloud.
    • Quando l’hypervisor o il servizio cloud non è raggiungibile durante l’eliminazione del catalogo, sia l’eliminazione del catalogo che quella della VM falliscono. Se necessario, è possibile scegliere di eliminare i record della VM solo dal database del sito Citrix. Per farlo, selezionare il catalogo di macchine nel nodo Cataloghi di macchine e quindi eseguire l’eliminazione mostrata nella scheda Risoluzione dei problemi. Tenere presente che questa azione lascia le VM intatte sull’host.

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

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

    Per gestire gli account Active Directory:

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

      Potrebbe essere necessario 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 Active Directory devono essere 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 prima di modificare l’immagine master per un catalogo. Il database mantiene un record storico delle immagini utilizzate con ogni catalogo di macchine. Se gli utenti riscontrano problemi con la nuova immagine distribuita sui loro desktop, è possibile ripristinarla alla versione precedente, riducendo al minimo i tempi di inattività degli utenti. Non eliminare, spostare o rinominare le immagini. In caso contrario, non è possibile ripristinare l’immagine master.

    Importante:

    Quando si modifica l’immagine master per un catalogo persistente, considerare quanto segue: solo le macchine che si aggiungono successivamente al catalogo 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:

    1. Fare clic su Cataloghi di macchine nel riquadro sinistro e selezionare un catalogo di macchine che si desidera convertire. Fare clic con il pulsante destro del mouse e selezionare Converti in immagine preparata.
    2. Nella pagina Immagine, selezionare un’immagine preparata.
    3. Nella pagina Strategia di distribuzione, selezionare quando si desidera aggiornare questo catalogo con l’immagine preparata selezionata.
    4. Nella pagina Riepilogo, verificare i dettagli e fare clic su Fine.
    5. Verificare i dettagli del catalogo di 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.

    1. Sull’hypervisor o sul provider di servizi cloud, acquisire uno snapshot della VM corrente e assegnare allo snapshot un nome significativo. Questo snapshot può essere utilizzato per ripristinare l’immagine master.
    2. Se necessario, accendere l’immagine e accedere.
    3. Installare gli aggiornamenti o apportare le modifiche richieste all’immagine.
    4. Se l’immagine utilizza un vDisk personale, aggiornare l’inventario.
    5. Spegnere la VM.
    6. Acquisire uno snapshot della VM e assegnare allo snapshot 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 XenCenter® di XenServer.

    Modificare l’immagine master

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

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

    4. Nella pagina Strategia di distribuzione, scegliere quando le macchine nel catalogo di 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.

    5. Verificare le informazioni nella pagina Riepilogo e quindi selezionare Fine. Ogni macchina si riavvia automaticamente dopo essere stata aggiornata.

      Per tenere traccia dell’avanzamento dell’aggiornamento, individuare il catalogo in Cataloghi di macchine per visualizzare la barra di avanzamento in linea e il grafico di avanzamento passo-passo. Per un catalogo non persistente, è possibile tenere traccia degli stati di aggiornamento dell’immagine tramite la colonna Aggiornamento immagine, inclusi 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 di 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), come alternativa a un’immagine o a uno snapshot di un’immagine.

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

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

    Strategia di distribuzione

    La modifica dell’immagine al prossimo spegnimento influenzerà immediatamente tutte le macchine non attualmente in uso, ovvero le macchine che non hanno una sessione utente attiva. Un sistema in uso riceve l’aggiornamento quando la sessione attiva corrente termina.

    Nota:

    La strategia di distribuzione è applicabile solo alle VM non persistenti.

    Considerare quanto segue:

    • Le nuove sessioni non possono essere avviate finché l’aggiornamento non è stato completato sulle macchine applicabili.
    • Per le macchine 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 multisessione 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 da riavviare 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 distribuito un’immagine aggiornata o nuova, è possibile ripristinarla. Ciò potrebbe essere necessario se si verificano problemi con le macchine appena aggiornate. Quando si ripristina, 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 ripristino di una macchina include un riavvio.

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

    Il ripristino viene applicato solo alle macchine che devono essere ripristinate. Per le macchine che non sono state modificate nella nuova immagine o nell’immagine aggiornata (ad esempio, macchine con utenti che non si sono disconnessi), gli utenti non ricevono messaggi di notifica e non sono costretti a disconnettersi.

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

    Non è possibile eseguire il rollback in alcuni scenari, inclusi i seguenti. (L’opzione Ripristina 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 è stato danneggiato.
    • Le modifiche dell’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 di macchine dopo aver aggiornato i VDA sulle macchine a una versione più recente. Si consiglia di aggiornare tutti i VDA all’ultima versione per abilitare l’accesso a tutte le nuove funzionalità.

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

    Per modificare il livello funzionale per un catalogo:

    1. Da Studio, selezionare Cataloghi di macchine nel riquadro sinistro.
    2. Selezionare il catalogo. La scheda Dettagli nel riquadro inferiore visualizza le informazioni sulla versione.
    3. Selezionare Modifica 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 spiega il motivo. Per garantire che tutte le macchine funzionino correttamente. Si consiglia di risolvere tali problemi prima di fare clic su Modifica.

    Dopo il completamento 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.

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

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

      Nota:

      Se si seleziona un catalogo Azure da clonare e si seleziona un’immagine master, il blade 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 Copia. È possibile modificare il nome. Vedere Rinominare un catalogo.
    • Dopo il completamento della clonazione, assicurarsi di assegnare il catalogo clonato a un gruppo di consegna.
    • È possibile creare un catalogo vuoto clonando. Durante la clonazione del catalogo, è possibile impostare il numero di macchine a zero per i cataloghi con provisioning MCS e non aggiungere macchine per i cataloghi con provisioning non MCS.
    1. Da Studio, selezionare Cataloghi di macchine nel riquadro sinistro.
    2. Selezionare un catalogo e quindi selezionare Clona nella barra delle azioni.
    3. Nella finestra Clona catalogo di macchine selezionato, visualizzare le impostazioni per il catalogo clonato e configurare le impostazioni come applicabile. Selezionare Avanti per passare alla pagina successiva.
    4. Nella pagina Riepilogo, visualizzare un riepilogo delle impostazioni e selezionare Fine per avviare la clonazione.
    5. Se necessario, selezionare Nascondi 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 di macchine facendo clic sull’icona Cartella in alto a destra nella barra delle azioni.

    Ruoli richiesti

    Per impostazione predefinita, è necessario disporre del seguente ruolo predefinito per creare e gestire le cartelle del catalogo: Amministratore cloud, Amministratore completo o Amministratore del catalogo di macchine. Se necessario, è possibile personalizzare i ruoli per la creazione e la gestione delle cartelle del catalogo. Per ulteriori informazioni, vedere Autorizzazioni richieste.

    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 del catalogo può contenere cataloghi e sottocartelle.
    • Tutti i nodi in Studio (come Cataloghi di macchine, Gruppi di consegna, Applicazioni e Gruppi di applicazioni) condividono lo stesso albero di cartelle nel back-end. Per evitare conflitti di nomi durante la ridenominazione o lo spostamento di cartelle, utilizzare nomi univoci per le cartelle di primo livello tra i diversi nodi.

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

      Esempio:

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

    Per creare una cartella del catalogo, seguire questi passaggi:

    1. Da Studio, selezionare Cataloghi di 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 e quindi fare clic su Fine.

    Suggerimento:

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

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

    1. Da Studio, selezionare Cataloghi di 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 di macchine.
    4. Selezionare la cartella in cui si desidera spostare il catalogo e quindi fare clic su Fine.

    Suggerimento:

    È possibile trascinare un catalogo in una cartella.

    È 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. Da Studio, selezionare Cataloghi di macchine nel riquadro sinistro.
    2. Nella gerarchia delle cartelle, selezionare una cartella e quindi selezionare un’azione nella barra Azioni secondo necessità:

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

    Autorizzazioni richieste

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

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

    Aggiornare i VDA

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

    Prima di iniziare, assicurarsi di aver configurato la distribuzione del servizio WEM. Per ulteriori informazioni, vedere Iniziare a utilizzare il servizio Workspace Environment Management.

    Nota:

    Per impostazione predefinita, se si dispone del ruolo Amministratore cloud, Amministratore con accesso completo o Amministratore del catalogo di macchine, è possibile gestire i set di configurazione per i cataloghi. Se necessario, è possibile consentire ai ruoli di gestire i set di configurazione concedendo loro l’autorizzazione Gestisci set di configurazione.

    Associare un catalogo a un set di configurazione

    Importante:

    Se le istanze di Citrix DaaS e del servizio WEM non risiedono nella stessa regione, non è possibile associare un catalogo a un set di configurazione. In tal caso, migrare il servizio WEM nella stessa regione di Citrix DaaS.

    Per associare un catalogo a un set di configurazione, seguire questi passaggi:

    1. Da Studio, selezionare Cataloghi di macchine.

    2. Selezionare il catalogo di macchine e quindi Gestisci set di configurazione nella barra delle azioni. Viene visualizzata la finestra Gestisci set di configurazione.

    3. Selezionare un set di configurazione WEM a cui si desidera associare il catalogo.

      Nota:

      Se il set di configurazione selezionato non contiene impostazioni relative alla configurazione di base di WEM, viene visualizzata l’opzione Applica impostazioni di base al set di configurazione. Si consiglia di selezionare l’opzione per applicare le impostazioni di base al set di configurazione.

    4. Fare clic su Salva per salvare la modifica.

    Passare a un set di configurazione diverso

    Per passare a un set di configurazione diverso per un catalogo, seguire questi passaggi:

    1. Da Studio, selezionare Cataloghi di macchine.
    2. Selezionare il catalogo di macchine e quindi Gestisci set di configurazione nella barra delle azioni. Viene visualizzata la finestra Gestisci set di configurazione.
    3. Selezionare un set di configurazione WEM diverso a cui si desidera associare il catalogo.
    4. Fare clic su Salva per salvare la modifica.

    Disassociare un catalogo dal set di configurazione

    Per disassociare un catalogo dal set di configurazione, seguire questi passaggi:

    1. Da Studio, selezionare Cataloghi di macchine.
    2. Selezionare il catalogo di macchine e quindi Gestisci set di configurazione nella barra delle azioni. Viene visualizzata la finestra Gestisci set di configurazione.
    3. Fare clic sull’icona X sul lato destro del set di configurazione selezionato.
    4. Fare clic su Salva per salvare la modifica.

    Nota:

    Questa funzionalità si applica solo ai cataloghi MCS.

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

    • Controllare prima le informazioni sulla risoluzione dei problemi e risolvere i problemi. Le informazioni descrivono i problemi riscontrati e forniscono raccomandazioni per risolverli.
    • Non è possibile modificare le impostazioni associate al sistema operativo e alla 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, eseguire le seguenti operazioni:

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

    (Solo VDA con provisioning non Citrix) Generare e gestire i token di registrazione

    Nota:

    Per eseguire questa attività, è necessario disporre del ruolo di Amministratore cloud.

    Dopo aver deciso di adottare la registrazione basata su token per le macchine con provisioning non 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:

    1. In Cataloghi di macchine, individuare un catalogo con provisioning non MCS, che ha Metodo di provisioning: Manuale visualizzato nella colonna Conteggio macchine.
    2. Fare clic con il pulsante destro del mouse sul catalogo e quindi selezionare Gestisci token di registrazione.
    3. Nella pagina Genera token di registrazione che appare, fornire le seguenti informazioni sul token:
      • Digitare un nome per il token.
      • Immettere il suo periodo di validità. Il periodo non deve superare i 14 giorni. Il token è valido solo per il periodo specificato.
      • (Facoltativo) Selezionare una connessione host per la gestione dell’alimentazione dei VDA registrati con il token. Le opzioni includono tutte le connessioni host nella zona di questo catalogo.
      • Immettere i limiti di utilizzo del token (tra 1 e 5000).
    4. Fare clic su Genera.
    5. Nella finestra Token generato correttamente che appare, copiare il token e salvarlo in un luogo sicuro, oppure fare clic su Scarica per scaricarlo nella cartella Download.

      Un record del token appare nell’elenco dei token.

      Generazione token

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

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

    Gestire i token

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

    • Revoca: revoca il token ma lo mantiene nell’elenco per scopi di registrazione.
    • Elimina: revoca il token e lo elimina dall’elenco.

    Nota:

    I token scaduti vengono eliminati automaticamente entro 14 giorni.

    Utilizzo di PowerShell

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

    Gestire il numero di sequenza del nome della macchina

    Per personalizzare il numero di sequenza delle macchine, che vengono distribuite utilizzando MCS, tramite comandi PowerShell, eseguire le seguenti operazioni:

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

      Get-AcctIdentityPool -IdentityPoolName xxx

      IdentityPoolName è il nome del catalogo.

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

      Set-AcctIdentityPool -IdentityPoolName xxx -StartCount X

    5. Aggiungere le macchine al catalogo in modo che le macchine vengano create con il conteggio richiesto.
    6. Dopo aver creato le macchine, eseguire il seguente comando per ripristinarlo al 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 durante l’aggiornamento di 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. Visualizza 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 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 delle VM come elenco separato da virgole ed eseguire il ripristino su ogni VM:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
         <!--NeedCopy-->
        
      • Specificare l’elenco delle VM come output del comando Get-ProvVM ed eseguire il ripristino su ogni VM:

         (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
         <!--NeedCopy-->
        
      • Specificare una singola VM per nome:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
         <!--NeedCopy-->
        
      • Creare attività di ripristino separate per ciascuna delle VM restituite dal comando Get-ProvVM. Questo è meno efficiente perché ogni attività eseguirà gli stessi controlli ridondanti, come il controllo delle capacità dell’hypervisor, il controllo della connessione per ogni VM.

         Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
         <!--NeedCopy-->
        
    4. 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 eseguita alcuna ulteriore azione.

      È possibile eseguire il comando PowerShell -WhatIf per stampare l’azione che verrebbe eseguita 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
         <!--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-->
        

      Nota:

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

    5. Eseguire Get-ProvTask per ottenere lo stato delle attività restituite dal comando Reset-ProvVMDisk.

    Ripristinare le informazioni sull’identità degli account computer attivi

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

    Nota:

    Attualmente, la funzionalità è supportata 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à:

    1. Aprire la finestra PowerShell.
    2. Eseguire asnp citrix* per caricare i moduli PowerShell specifici di Citrix.
    3. Reimpostare le informazioni sull’identità.

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

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

        La descrizione dei parametri utilizzati nel comando è la seguente:

        • IdentityAccountName: il nome dell’account di identità che deve essere riparato.
        • PrivilegedUserName: account utente che ha l’autorizzazione di scrittura sul provider di identità (AD o Azure AD).
        • 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 unite a Hybrid Azure AD.
      • Per reimpostare tutta la configurazione del disco di identità, eseguire i seguenti comandi nel seguente ordine:

         Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
         <!--NeedCopy-->
        
         Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
         <!--NeedCopy-->
        
      • Per ricreare completamente il disco di identità:

         Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate
         <!--NeedCopy-->
        
    4. Digitare y per confermare l’azione. È anche possibile ignorare il prompt di conferma utilizzando il parametro -Force. Ad esempio:

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

    Modificare 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, eseguire le seguenti operazioni:

    1. Nella finestra PowerShell, eseguire il comando asnp citrix* per caricare i moduli PowerShell.
    2. Eseguire (Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps per accedere al percorso di rete che si desidera modificare.
    3. Assegnare una variabile alla nuova impostazione di rete. Ad esempio:

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

    Gestire le versioni di un catalogo di macchine

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

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

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

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

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

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

       Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog
       <!--NeedCopy-->
      
    • Per visualizzare i dettagli di configurazione di una particolare versione di un catalogo di macchine:

       Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2
       <!--NeedCopy-->
      
    • Per visualizzare il numero totale di versioni associate a un catalogo di macchine:

       (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count
       <!--NeedCopy-->
      
    • Per utilizzare qualsiasi versione precedente per aggiornare il catalogo di macchine:

       Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
       <!--NeedCopy-->
      
    • Per eliminare manualmente una versione se non è utilizzata da una VM di quel catalogo di macchine:

       Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
       <!--NeedCopy-->
      
    • Per impostare il numero massimo di versioni da conservare dal catalogo di macchine (il valore predefinito è 99). Questa impostazione viene applicata a tutti i cataloghi. Ad esempio, in questo caso, un massimo di 15 versioni verranno conservate per tutti i cataloghi con provisioning MCS.

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

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

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

    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 all’ultima versione del VDA (2308 o successiva).
    • Abilitare il parametro UseWriteBackCache per il catalogo di macchine esistente. Utilizzare New-ProvScheme per creare un catalogo di macchine con UseWriteBackCache abilitato. Ad esempio:

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

    Modificare la configurazione della cache

    Eseguire il comando Set-ProvScheme. Ad esempio:

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

    Nota:

    • Il valore di WriteBackCacheDiskSize deve essere maggiore di zero perché è richiesto almeno 1 GB di spazio di archiviazione su disco della cache.
    • Il valore di WriteBackCacheMemorySize deve essere inferiore alla dimensione della memoria del catalogo di macchine.
    • Queste modifiche influiscono solo sulle nuove VM aggiunte al catalogo dopo la modifica. 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 assumono i valori delle proprietà dal profilo macchina.

    Nota:

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

    Per fare ciò:

    1. Creare un catalogo di macchine persistente o non persistente con VM e senza un profilo macchina.
    2. Aprire la finestra PowerShell.
    3. Eseguire il comando Set-ProvScheme per applicare i valori delle proprietà dal profilo macchina alle nuove VM aggiunte al catalogo di macchine. Ad esempio:

      • Nel caso di Azure:

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

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

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

        Nota:

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

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

    Utilizzando i comandi PowerShell, è possibile:

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

    Per eseguire i comandi PowerShell:

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

    Per ottenere un elenco di errori e avvisi:

    Eseguire il comando Get-ProvOperationEvent.

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

    Per eliminare gli errori o gli avvisi:

    Eseguire il comando Remove-ProvOperationEvent.

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

    Per ulteriori informazioni, vedere l’SDK PowerShell di Citrix.

    Eliminare macchine senza accesso all’hypervisor

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

    Questa opzione è abilitata su:

    • tutti gli hypervisor supportati
    • VM persistenti e non persistenti

    Limitazioni

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

    Utilizzare il comando PurgeDBOnly

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

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

    Nota:

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

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

    Try to use -PurgeDBOnly option to clean DDC database.

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

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

    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 in modo efficiente le singole VM 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:

    Prima di aggiornare le proprietà di una VM:

    1. Aprire una finestra PowerShell.
    2. Eseguire asnp citrix* per caricare i moduli PowerShell specifici di Citrix.
    3. Controllare la configurazione del catalogo di macchine esistente. Ad esempio:

      Get-ProvScheme -ProvisioningSchemeName <catalog name>
      <!--NeedCopy-->
      
    4. Controllare la configurazione della VM su cui si desidera applicare gli aggiornamenti. Ad esempio:

      Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
      <!--NeedCopy-->
      

    Aggiornare le proprietà di una VM

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

    1. Spegnere la VM su cui si desidera applicare gli aggiornamenti.
    2. 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.

    3. Ottenere l’elenco delle proprietà che devono essere aggiornate e la versione della configurazione. Ad esempio:

      Get-ProvVMConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1
      <!--NeedCopy-->
      

      Controllare il valore della proprietà Version e le proprietà da aggiornare (in questo caso, StorageType).

    4. Controllare la versione della configurazione. Ad esempio:

      Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
      <!--NeedCopy-->
      

      Controllare il valore della proprietà ProvVMConfigurationVersion. L’aggiornamento non è ancora stato applicato. La VM è ancora nella vecchia configurazione.

    5. Richiedere l’aggiornamento pianificato. Ad esempio:

       Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -StartsNow -DurationInMinutes -1
       <!--NeedCopy-->
      

      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.

    6. Riavviare la VM. Ad esempio:

      New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
      <!--NeedCopy-->
      
    7. Controllare la versione della configurazione. Ad esempio:

      Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
      <!--NeedCopy-->
      

      Controllare il valore della proprietà ProvVMConfigurationVersion. L’aggiornamento è ora applicato. La VM ora ha la nuova configurazione.

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

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

    1. Spegnere la VM su cui si desidera applicare gli aggiornamenti.
    2. Aggiornare il catalogo di 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-->
      
    3. Ottenere i dettagli di configurazione del catalogo di macchine. Ad esempio:

      Get-ProvScheme -ProvisioningSchemeName <catalog name>
      <!--NeedCopy-->
      

      Il ProvisioningSchemeVersion è ora incrementato di uno. Le dimensioni della VM e il tipo di archiviazione sono anch’essi aggiornati.

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

    5. Ottenere l’elenco delle proprietà che la VM avrà dopo aver unito gli aggiornamenti di configurazione sulla VM con gli aggiornamenti del catalogo di macchine. Ad esempio:

      Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName <catalog name> -VMName machine1
      <!--NeedCopy-->
      

      Nota:

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

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

      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -VMName machine1 -StartsNow -DurationInMinutes -1
      <!--NeedCopy-->
      
    7. Riavviare la VM. Ad esempio:

      New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
      <!--NeedCopy-->
      

      La VM mantiene le sue dimensioni VM aggiornate come derivate dal profilo macchina. I valori dei tag specificati nel profilo macchina vengono applicati anche alla VM. Tuttavia, il tipo di archiviazione è derivato dall’ultimo schema di provisioning.

    8. Ottenere la versione della configurazione della VM. Ad esempio:

      Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
      <!--NeedCopy-->
      

      I valori ProvisioningSchemeVersion e ProvVMConfigurationVersion mostrano ora l’ultima versione.

    Ripristinare gli aggiornamenti di configurazione applicati a una VM

    1. Dopo aver applicato gli aggiornamenti a una VM, spegnere la VM.
    2. Eseguire il seguente comando per rimuovere gli aggiornamenti applicati alla VM. Ad esempio:

      Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1
      <!--NeedCopy-->
      
    3. Richiedere l’aggiornamento pianificato per la VM. Ad esempio:

      Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -VMName machine1 -StartsNow -DurationInMinutes -1
      <!--NeedCopy-->
      
    4. Riavviare la VM. Ad esempio:

      New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
      <!--NeedCopy-->
      
    5. Controllare la versione della configurazione della VM. Ad esempio:

      Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
      <!--NeedCopy-->
      

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

    Migrazione dell’archiviazione delle VM

    È possibile spostare l’archiviazione su disco delle VM esistenti da una vecchia archiviazione a una nuova archiviazione negli ambienti VMware e XenServer. Durante la migrazione, MCS mantiene le funzionalità della VM come la gestione dell’alimentazione, la reimpostazione del disco del sistema operativo e così via. È inoltre possibile aggiungere nuove VM al catalogo di macchine utilizzando la nuova archiviazione su disco. Per fare ciò, utilizzare il comando PowerShell Move-ProvVMDisk.

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

    • Per VM Full Clone persistenti: disco del sistema operativo, disco di identità e dischi con provisioning non MCS.
    • Per VM non persistenti: disco del sistema operativo, disco di identità e disco di cache di scrittura (WBC).

    La nuova archiviazione deve soddisfare le seguenti condizioni:

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

    Migrare l’archiviazione su disco

    Per migrare l’archiviazione su disco:

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

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

      Nota:

      Per le VM non persistenti:

      • Se viene utilizzato WBC, configurare l’archiviazione di destinazione WBC nell’unità di hosting.
      • Se l’archiviazione di destinazione del sistema operativo è configurata, WBC (se utilizzato) deve essere compatibile con l’archiviazione di destinazione del sistema operativo.
      • Se l’archiviazione di destinazione del sistema operativo non è configurata, WBC (se utilizzato) deve essere compatibile con l’archiviazione del sistema operativo corrente.
    2. Spegnere le VM e attivare la Modalità di manutenzione.
    3. Ottenere le informazioni sullo schema di provisioning, l’unità di hosting, l’archiviazione del disco del sistema operativo e l’archiviazione del disco WBC.

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

         $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
         $result
         $result.ProvResourceInStorage | Format-List -Property *
         <!--NeedCopy-->
        
      • Eseguire TemporaryStorageInfo per le informazioni sull’archiviazione WBC. Ad esempio:

         $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
         $result
         $result.TemporaryStorageInfo | Format-List -Property *
         <!--NeedCopy-->
        
    4. Migrare il disco del sistema operativo, il disco di identità e il disco WBC (applicabile alle VM non persistenti) all’archiviazione di destinazione utilizzando il comando PowerShell Move-ProvVMDisk.

      Nota:

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

      Esempio:

      VM persistenti:

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

      Importante:

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

      VM non persistenti:

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

      Importante:

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

    Risoluzione dei problemi

    Se uno dei dischi non riesce a migrare, nessuno dei dischi viene migrato all’archiviazione 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 una nuova archiviazione, anche i file specifici della VM vengono spostati nella nuova archiviazione.
    • VMware non supporta lo spostamento del disco se ha lo snapshot.

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

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

    Limitazioni

    Considerare le seguenti limitazioni:

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

    Migrare a un catalogo di macchine con immagine preparata

    Per migrare, eseguire le seguenti operazioni:

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

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

      Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid
      <!--NeedCopy-->
      
    3. Eseguire il comando Get-ProvImageVersionSpec per ottenere il nome della definizione dell’immagine, l’UID della specifica della versione dell’immagine. Ad esempio:

      Get-ProvImageVersionSpec -ImageDifinitionName <name> -Filter {IsPrepared -eq $true} | select ImageDefinitionName ImageVersionSpecUId
      <!--NeedCopy-->
      
    4. Eseguire il comando Set-ProvSchemeImage per migrare un catalogo di macchine con provisioning MCS esistente a un catalogo di macchine con immagine preparata. Ad esempio:

      Set-ProvSchemeImage -ProvisioningSchemeName [ProvisioningSchemeName] -ImageVersionSpecUid [ImageVersionSpecUid]
      <!--NeedCopy-->
      
    5. Eseguire il comando Get-ProvScheme per verificare che il catalogo sia stato migrato. Ad esempio:

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

    Risoluzione dei problemi

    Dove andare dopo

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

    Gestire i cataloghi di macchine

    In questo articolo