Documentazione dei prodotti
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Visualizza PDF

Gestire i cataloghi delle macchine

January 24, 2025
Grazie al contributo di: 
C

Nota:

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

Introduzione

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

La manutenzione dei cataloghi può includere anche la verifica che ogni macchina disponga degli ultimi aggiornamenti del sistema operativo. Inclusi aggiornamenti antivirus, upgrade del sistema operativo o modifiche alla configurazione.

  • I cataloghi contenenti macchine casuali raggruppate, create utilizzando Machine Creation Services (MCS), gestiscono le macchine aggiornando l’immagine master utilizzata nel catalogo e quindi aggiornando le macchine stesse. Questo metodo consente di aggiornare in modo efficiente un gran numero di macchine utente.
  • Per i cataloghi contenenti macchine statiche assegnate in modo permanente e per i cataloghi di macchine con accesso remoto al PC, gli aggiornamenti alle macchine degli utenti vengono gestiti all’esterno di Web Studio. Eseguire questa attività individualmente o collettivamente utilizzando strumenti di distribuzione software di terze parti.

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

Nota:

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

Informazioni sulle istanze persistenti

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

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

Gestire i cataloghi delle macchine

È possibile gestire un catalogo macchine in due modi:

Utilizzare Web Studio

Questa sezione descrive in dettaglio come gestire i cataloghi utilizzando Web Studio:

  1. Utilizzare la funzione di ricerca per individuare un catalogo di macchine specifico. Per istruzioni, fare riferimento a Cerca istanze .
  2. Dai risultati della ricerca, seleziona un catalogo a seconda delle tue esigenze.
  3. Per la descrizione delle colonne del catalogo, fare riferimento alla tabella seguente.
  4. Per ulteriori informazioni su questo catalogo, fare clic su una scheda nel riquadro dei dettagli in basso.
Colonna Descrizione
Catalogo Macchine

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




    		Tipo di sessione supportato dalle macchine nel catalogo. I valori possibili includono:
  • Tipo di sistema operativo: sistema operativo multisessione (virtuale); Dati utente: ignora.
  • 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: ignora
  • Tipo di sistema operativo: sistema operativo a sessione singola (virtuale); dati utente: su disco locale
    		•
    Conteggio delle macchine Il numero di macchine nel catalogo e il metodo di provisioning. I possibili metodi di provisioning includono: servizi di creazione macchina (macchina MCS), manuale e servizi di provisioning Citrix.
    Conteggio assegnato Numero di macchine nel catalogo assegnate a un gruppo di consegna.
    Cartella 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) oppure - se il catalogo si trova al livello radice.
    Aggiornamento VDA Stato di aggiornamento VDA. I valori possibili includono: Non configurato, Pianificato, Disponibile e Aggiornato.
    Stato dell’immagine Lo stato di aggiornamento delle immagini del catalogo. Applicabile solo ai cataloghi di macchine non persistenti. I valori possibili includono: Completamente aggiornato, Parzialmente aggiornato, Aggiornamenti in sospeso, Preparazione

    Prima di iniziare:

    • Assicurarsi che l’host di virtualizzazione disponga di processori, memoria e storage sufficienti per ospitare le macchine aggiuntive.
    • Assicuratevi di avere un numero sufficiente di account computer Active Directory inutilizzati. Se si utilizzano account esistenti, il numero di macchine che è possibile aggiungere è limitato dal numero di account disponibili.
    • Se si utilizza Web Studio per creare account computer Active Directory per i computer aggiuntivi, è necessario disporre dell’autorizzazione di amministratore di dominio appropriata.

    Per aggiungere macchine a un catalogo:

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

    Le macchine vengono create come processo in background e, se vengono create numerose macchine, possono richiedere molto tempo. La creazione della macchina continua anche se si chiude Web Studio.

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

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

    Per eliminare macchine da un catalogo:

    1. Accedi a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro di sinistra.
    3. Seleziona un catalogo, quindi seleziona Visualizza macchine nella barra delle azioni.
    4. Seleziona una o più macchine, quindi seleziona Elimina nella barra delle azioni.

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

    1. Nella pagina Descrizione , modifica la descrizione del catalogo.
    2. Selezionare Cataloghi macchine nel riquadro di sinistra.
    3. Seleziona un catalogo, quindi seleziona Modifica catalogo macchina nella barra delle azioni.
    4. Nella pagina Ambiti , modifica gli ambiti.

    5. A seconda del tipo di catalogo, potresti visualizzare altre pagine.

      Per i cataloghi creati utilizzando un’immagine di Azure Resource Manager, sono visibili le pagine seguenti. Tieni presente che le modifiche apportate verranno applicate solo alle macchine che aggiungerai al catalogo in un secondo momento. Le macchine esistenti rimangono invariate.

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

        Nota:

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

      • On the Machine Profile page, choose whether to use or change a machine profile.

      • (Visible only when the catalog is configured with a dedicated group host) On the Dedicated host group page, choose whether to change a host group.

      • On the Storage and License Types page, choose whether to change the storage type, license type, and Azure Computer Gallery settings (available only when Place prepared image in Azure Gallery is in use).

      Nota:

      Se la nuova impostazione selezionata non supporta le dimensioni correnti della macchina, viene visualizzata una finestra di dialogo di avviso che informa che la modifica dell’impostazione comporta il ripristino delle impostazioni relative alle dimensioni della macchina. Se scegli di continuare, accanto al menu Macchine virtuali apparirà un punto rosso che ti chiederà di selezionare una nuova dimensione della macchina.

      • On the License Type page, choose whether to change the Windows license or Linux license setting.

      Per i cataloghi di Accesso PC remoto sono visibili le seguenti pagine:

      • On the Power Management page, change the power management settings and select a power management connection.
      • Nella pagina Unità organizzative , aggiungi o rimuovi le OU di Active Directory.
    6. Fai clic su Applica per applicare le modifiche apportate e fai clic su Salva per uscire.
    1. Accedi a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro di sinistra.
    3. Seleziona un catalogo, quindi seleziona Rinomina catalogo macchina nella barra delle azioni.
    4. Inserisci il nuovo nome.

    Spostare un catalogo in una zona diversa

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

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

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

    Prima di eliminare un catalogo, assicurati che:

    • Tutti gli utenti vengono disconnessi e non è possibile eseguire sessioni disconnesse.
    • La modalità di manutenzione è attivata per tutte le macchine nel catalogo, in modo che non sia possibile effettuare nuove connessioni.
    • Tutte le macchine presenti nel catalogo sono spente.
    • Il catalogo non è associato ad alcun gruppo di consegna. In altre parole, il gruppo di consegna non contiene macchine dal catalogo.

    Per eliminare un catalogo:

    1. Accedi a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro di sinistra.
    3. Seleziona un catalogo, quindi seleziona Elimina catalogo macchina nella barra delle azioni.
    4. Indica se le macchine nel catalogo vengono eliminate. Se si sceglie di eliminare le macchine, indicare se gli account computer Active Directory per tali macchine vengono mantenuti, disabilitati o eliminati.

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

    • Liberare gli account macchina inutilizzati rimuovendo gli account computer Active Directory dai cataloghi dei sistemi operativi a sessione singola e multisessione. Tali account potranno poi essere utilizzati per altre macchine.
    • Aggiungere account in modo che, quando si aggiungono più macchine al catalogo, gli account dei computer siano già attivi. Non utilizzare una barra (/) nel nome di una OU.

    Per gestire gli account di Active Directory:

    1. Accedi a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro di sinistra.
    3. Seleziona un catalogo, quindi seleziona Gestisci account AD nella barra delle azioni.

    4. Scegli se aggiungere o eliminare account computer. Se aggiungi account, specifica cosa fare con le password degli account: reimpostarli tutti o immettere una password valida per tutti gli account.

      È possibile reimpostare le password se non si conoscono le password dell’account corrente; per eseguire una reimpostazione della password è necessario disporre dell’autorizzazione. Quando si immette una password, la password viene modificata negli account durante l’importazione. Quando elimini un account, scegli se mantenerlo, disabilitarlo o eliminarlo in Active Directory.

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

    Si consiglia di salvare copie o snapshot delle immagini master prima di aggiornare le macchine nel catalogo. Il database conserva una registrazione storica delle immagini master utilizzate con ciascun catalogo macchina. Ripristinare o ripristinare le macchine in un catalogo in modo che utilizzino la versione precedente dell’immagine master. Esegui questa attività se gli utenti riscontrano problemi con gli aggiornamenti distribuiti sui loro desktop. Ciò riduce al minimo i tempi di inattività dell’utente. Non eliminare, spostare o rinominare le immagini master. Non è possibile ripristinare un catalogo per utilizzarli.

    Dopo l’aggiornamento, la macchina si riavvia automaticamente.

    Aggiorna o crea un’immagine master

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

    1. Sull’hypervisor, esegui uno snapshot della VM corrente e assegnagli un nome significativo. Se necessario, questo snapshot può essere utilizzato per ripristinare (rollback) le macchine nel catalogo.
    2. Se necessario, accendere l’immagine master ed effettuare l’accesso.
    3. Installare gli aggiornamenti o apportare le modifiche necessarie all’immagine master.
    4. Spegnere la macchina virtuale.
    5. Scattare uno snapshot della VM. Assegnargli un nome significativo che venga riconosciuto quando il catalogo viene aggiornato in Web Studio. Sebbene Web Studio possa creare uno snapshot, Citrix consiglia di crearlo tramite la console di gestione dell’hypervisor. Quindi seleziona lo snapshot in Web Studio. Questo processo consente di fornire un nome e una descrizione significativi anziché un nome generato automaticamente. Per le immagini master GPU, è possibile modificare l’immagine master solo tramite la console XenServer.

    Cambia l’immagine principale

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

    1. Accedi a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro di sinistra.
    3. Seleziona un catalogo, quindi seleziona Cambia immagine master nella barra delle azioni.
    4. Nella pagina Immagine , seleziona l’host e l’immagine che vuoi distribuire. > Suggerimento: > > Per un catalogo creato da MCS, è possibile annotare l’immagine aggiungendo una nota. 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, seleziona il catalogo, clicca su Proprietà modello nel riquadro in basso, quindi clicca su Visualizza cronologia note.
    5. Nella pagina Strategia di distribuzione , scegli quando le macchine nel catalogo macchine verranno aggiornate con la nuova immagine master: al successivo arresto o immediatamente. > Nota: > > La pagina Strategia di distribuzione non è disponibile per le VM persistenti perché il rollout è applicabile solo alle VM non persistenti.
    6. Verificare le informazioni nella pagina Riepilogo e quindi fare clic su Fine. Ogni macchina si riavvia automaticamente dopo l’aggiornamento.

    Per monitorare l’avanzamento dell’aggiornamento, individuare il catalogo in Cataloghi macchine per visualizzare la barra di avanzamento in linea e il grafico di avanzamento passo dopo passo.

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

    Strategia di lancio:

    L’aggiornamento delle immagini al successivo arresto avrà effetto immediato su tutte le macchine non in uso, ovvero quelle che non dispongono di una sessione utente attiva. Un sistema in uso riceve l’aggiornamento al termine della sessione attiva corrente. Considera quanto segue:

    • Non sarà possibile avviare nuove sessioni finché l’aggiornamento non sarà completato sui computer interessati.
    • Per le macchine con sistema operativo a sessione singola, l’aggiornamento avviene immediatamente quando non sono in uso o quando gli utenti non hanno effettuato l’accesso.
    • Per un sistema operativo multisessione con macchine secondarie, i riavvii non avvengono automaticamente. Per applicare l’immagine master aggiornata, riavviare i computer tramite Studio, PowerShell o Workspace. Il riavvio dalle macchine o dall’hypervisor non applica l’aggiornamento.

    Mancia:

    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.

    Ripristina l’immagine master

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

    1. Accedi a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro di sinistra.
    3. Selezionare il catalogo, quindi selezionare Ripristina immagine master nella barra delle azioni.
    4. Specificare quando applicare l’immagine master precedente alle macchine, come descritto nella sezione precedente per l’operazione di rollout.

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

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

    Cambia il livello funzionale o annulla la modifica

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

    Prima di modificare il livello funzionale di un catalogo macchine:

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

    Per modificare il livello funzionale di un catalogo:

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

    Una volta completata la modifica del catalogo, è possibile ripristinare le versioni VDA precedenti delle macchine selezionando il catalogo e quindi selezionando Annulla modifica del livello funzionale nella barra delle azioni.

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

    • Non è possibile modificare le impostazioni associate al sistema operativo e alla gestione della macchina . Il catalogo clonato eredita tali impostazioni dall’originale.
    • La clonazione di un catalogo può richiedere del tempo. Se necessario, seleziona Nascondi avanzamento per eseguire la clonazione in background.
    • Il catalogo clonato eredita il nome dell’originale e ha il suffisso Copia. Puoi cambiare il nome. Vedere Rinominare un catalogo.
    • Una volta completata la clonazione, assicurarsi di assegnare il catalogo clonato a un gruppo di distribuzione.
    1. Accedi a Web Studio, quindi seleziona Cataloghi macchine nel riquadro a sinistra.
    2. Seleziona un catalogo, quindi seleziona Clona nella barra delle azioni.
    3. Nella finestra Clona catalogo macchine selezionato , visualizza le impostazioni per il catalogo clonato e configura le impostazioni come applicabile. Selezionare Avanti per procedere alla pagina successiva.
    4. Nella pagina Riepilogo , visualizza un riepilogo delle impostazioni e seleziona Fine per avviare la clonazione.
    5. Se necessario, seleziona Nascondi avanzamento per eseguire la clonazione in background.

    Organizzare i cataloghi utilizzando le cartelle

    È possibile creare cartelle per organizzare i cataloghi e facilitarne l’accesso. Ad esempio, è possibile organizzare i cataloghi in base al tipo di immagine o alla struttura organizzativa.

    Prima di iniziare, pianifica come organizzare i tuoi cataloghi. Considera quanto segue:

    • È possibile nidificare cartelle fino a cinque livelli di profondità (esclusa la cartella radice predefinita).
    • Una cartella catalogo può contenere cataloghi e sottocartelle.
    • Tutti i nodi in Web Studio (ad esempio i nodi Cataloghi macchine e i nodi Applicazioni ) condividono un albero di cartelle nel backend. Per evitare conflitti di nomi con altri nodi durante la ridenominazione o lo spostamento di cartelle, si consiglia di assegnare nomi diversi alle cartelle di primo livello in nodi diversi.

    Per creare una cartella catalogo, segui questi passaggi:

    1. Selezionare Cataloghi macchine nel riquadro di sinistra.
    2. Nella gerarchia delle cartelle, seleziona una cartella e poi seleziona Crea cartella nella barra Azione .
    3. Inserisci un nome per la nuova cartella, quindi fai clic su Fatto.

    Mancia:

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

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

    1. Selezionare Cataloghi macchine nel riquadro di sinistra.
    2. Visualizza i cataloghi per cartella. Puoi anche 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 macchina.
    4. Seleziona la cartella in cui vuoi spostare il catalogo, quindi fai clic su Fatto.

    Mancia:

    È 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 i passaggi seguenti:

    1. Selezionare Cataloghi macchine nel riquadro di sinistra.

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

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

    Utilizzare PowerShell

    Questa sezione descrive in dettaglio come gestire i cataloghi utilizzando PowerShell:

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

    Utilizzando i comandi di PowerShell è possibile:

    • Ottieni un elenco di errori o avvisi
    • Cambia lo stato di avviso da Nuovo a Riconosciuto
    • Elimina gli errori o gli avvisi

    Per eseguire i comandi di PowerShell:

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

    Per ottenere un elenco di errori e avvisi:

    Esegui 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 Filtro : Ottiene errori o avvisi tramite filtro personalizzato

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

    Eseguire il comando Confirm-ProvOperationEvent .

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

    Per eliminare gli errori o gli avvisi:

    Eseguire il comando Remove-ProvOperationEvent .

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

    Per ulteriori informazioni, vedere Citrix PowerShell SDK.

    Aggiungere descrizioni a un’immagine

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

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

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

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

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

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

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

    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 passo dopo passo.

    Non è possibile effettuare il rollback in determinati scenari, tra cui quelli riportati di seguito. (L’opzione Ripristina immagine master non è visibile).

    • Non hai l’autorizzazione per effettuare 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 apportate dall’utente alle macchine nel catalogo non vengono mantenute.
    • Le macchine presenti nel catalogo sono in funzione.

    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 macchine creato da MCS. Attualmente questa funzionalità è applicabile ad AWS, Azure, XenServer, Google Cloud. Ambienti di virtualizzazione SCVMM e VMware.

    Per eseguire correttamente il comando PowerShell, assicurarsi che:

    • Le VM di destinazione si trovano in un catalogo MCS persistente.
    • Il catalogo delle macchine MCS funziona correttamente.
    • Ciò implica che lo schema di provisioning e l’host esistono e che lo schema di provisioning contiene voci corrette.
    • L’hypervisor non è in modalità di manutenzione.
    • Le VM di destinazione sono spente e in modalità di manutenzione.

    Per reimpostare il disco del sistema operativo, procedere come segue:

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

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

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

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

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

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

      • Specificare una singola VM per nome:

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

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

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

    4. Viene visualizzata una richiesta di conferma in cui sono elencate le VM da reimpostare, insieme a un messaggio di avviso che indica che si tratta di un’operazione non recuperabile. Se non si fornisce una risposta e si preme Invio, non verrà eseguita alcuna ulteriore azione.

      Nota:

      Non togliere le VM dalla modalità di manutenzione né accenderle prima del completamento del processo di ripristino.

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

      È anche possibile ignorare la richiesta di conferma utilizzando uno dei seguenti metodi:

      • Fornire il parametro -Force :

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

      • Fornire il parametro -Conferma:$false :

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

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

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

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

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

    Nota:

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

    Per modificare le impostazioni di rete per uno schema di provisioning esistente, procedere come segue:

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

    3. Assegna una variabile alla nuova impostazione di rete. Per esempio:

        $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
<!--NeedCopy-->
    4. Esegui Set-ProvScheme -ProvisioningSchemeName "nome" -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 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 macchine utilizzando i comandi di PowerShell. Puoi:

    • Visualizza l’elenco delle versioni di un catalogo di macchine
    • Utilizzare qualsiasi versione precedente per aggiornare il catalogo delle macchine
    • Elimina manualmente una versione se non è utilizzata da una VM di quel catalogo macchine
    • Modifica il numero massimo di versioni da conservare nel catalogo della macchina (il valore predefinito è 99)

    Una versione include le seguenti informazioni di un catalogo macchine:

    • Conteggio VMCpu
    • Memoria VMM
    • Proprietà personalizzate
    • ServizioOfferta
    • Profilo della macchina
    • Mappatura della rete
    • Gruppo di sicurezza

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

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

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

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

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

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

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

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

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

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

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

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

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

    Se il numero di versioni raggiunge il numero massimo di versioni, non sarà possibile creare una nuova versione se una qualsiasi delle VM nel catalogo delle macchine utilizza versioni precedenti. In tal caso, procedere in uno dei seguenti modi:

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

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

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

    Nota:

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

    Per fare questo:

    1. Creare un catalogo 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 macchine. Per esempio:

      • Nel caso di Azure:

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

      • Nel caso di AWS:

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

    Riparare le informazioni di identità degli account di computer attivi

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

    Nota:

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

    Condizioni

    Per reimpostare correttamente il disco di identità, assicurarsi di quanto segue:

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

    Reimposta disco identità

    Per reimpostare il disco di identità:

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

    3. Reimposta le informazioni di identità.

      • Per reimpostare solo la password della macchina e le chiavi di attendibilità, 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: Nome dell’account di identità che deve essere riparato.
        • PrivilegedUserName: account utente che dispone dell’autorizzazione di scrittura sul provider di identità (AD o AzureAD).
        • PrivilegedUserPassword: Password per PrivilegedUserName.
        • Obiettivo: Obiettivo dell’azione di riparazione. Può essere IdentityInfo per riparare la password/chiave di attendibilità dell’account e UserCertificate per riparare gli attributi del certificato utente delle identità delle macchine unite ad AzureAD ibrido.

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

           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 saltare la richiesta di conferma utilizzando il parametro -Force . Per esempio:

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

    Modificare la configurazione della cache su un catalogo di macchine esistente

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

    • WriteBackCacheMemorySize
    • WriteBackCacheDiskSize

    Questa funzionalità è attualmente applicabile a:

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

    Requisiti

    I requisiti per modificare la configurazione della cache sono:

    • Aggiornare all’ultima versione di VDA (2308 o successiva).

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

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

    Cambia la configurazione della cache

    Eseguire il comando Set-ProvScheme. Per 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 macchina.
    • Queste modifiche riguardano solo le nuove VM aggiunte al catalogo dopo che la modifica è stata apportata. Le VM esistenti non sono interessate da queste modifiche.

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

    Specificare il percorso del programma di installazione VDA tramite cmdlet di PowerShell, riducendo così lo sforzo necessario per specificare regole di rete per consentire a ogni VDA di andare a recuperare il nuovo programma di installazione VDA dalla CDN di Citrix Managed Azure.

    Cmdlet di PowerShell

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

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

    Prerequisiti

    • VUS Agent Installer fornito con VDA 2311
    • VDA Upgrade Agent alla versione 7.40.0.35 o successiva (utilizzando il programma di installazione VDA versione 2311 o successiva)
    • Virtual Apps and Desktops Remote PowerShell SDK versione 7.40 o successiva (rilasciata il 10 gennaio 2024 o successiva)

    Come impostare le autorizzazioni di condivisione file

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

    • Autorizzazione di condivisione file unita al dominio

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

      Il permesso con privilegi minimi può essere impostato concedendo l’accesso Lettura ai computer del dominio.

      1. Seleziona le persone sulla tua rete con cui desideri condividere il file.
      2. Fare clic su Impostazioni di condivisione avanzate e attivare Condivisione file e stampanti.

    • Autorizzazione di condivisione file non associata al dominio

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

      1. Seleziona una cartella condivisa.
      2. Disattivare la protezione tramite password.
        1. Vai alla cartella Proprietà.
        2. Seleziona Centro connessioni di rete e condivisione.
        3. Disattiva Condivisione protetta da password.
      3. Fare clic su Condivisione avanzata per concedere un’autorizzazione di condivisione.
        1. Seleziona Permessi.
        2. Concedi un permesso di condivisione Lettura a ACCESSO ANONIMO.
      4. Selezionare la scheda Sicurezza ** per concedere i permessi alla cartella
        1. Fare clic su Modifica per aggiungere autorizzazioni alla cartella condivisa
        2. Seleziona la cartella condivisa a cui concedere i permessi di accesso ACCESSO ANONIMO.
      5. Fare clic su Avanzate per attivare Condivisione file e stampanti.
      6. Aggiungere il nome della cartella condivisa a Criterio di sicurezza dell’accesso alla rete.

      Nota:

      Riavvia il computer affinché la modifica abbia effetto immediato.

    Aggiornamenti VDA da una condivisione file locale

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

      Nota:

      Con il servizio di aggiornamento virtuale puoi scegliere tra il percorso Current Release o il percorso LTSR.

      Ad esempio: Se il catalogo della macchina è impostato sulla versione corrente, ovvero 2311, e la versione VDA è 2305, è necessario aggiornare la versione VDA alla versione 2311.

      1. Vai alla pagina Download sul nostro sito web.
      2. Selezionare Citrix Virtual Apps and Desktops come prodotto.
      3. Seleziona Citrix Virtual Apps and Desktops 7 2311, tutte le edizioni.
      4. Selezionare il programma di installazione VDA dai componenti presenti nell’ISO del prodotto ma anche confezionati separatamente espandibili.

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

      • Scarica il programma di installazione VDA multi-sessione del sistema operativo ** se il tipo di catalogo è **multi-sessione
      • Scarica il programma di installazione VDA del sistema operativo a sessione singola ** se il tipo di catalogo è **sessione singola
      • Scarica il programma di installazione VDA dei servizi core del sistema operativo a sessione singola ** se il tipo di catalogo è **Accesso PC remoto

    Nota:

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

    Risoluzione dei problemi

    Dove andare dopo

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

    Gestire i cataloghi delle macchine
    January 24, 2025
    Grazie al contributo di: 
    C
    January 24, 2025
    Grazie al contributo di: 
    C

    In questo articolo

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