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

November 8, 2024
Grazie al contributo di: 
C C

Nota:

È possibile gestire l’implementazione di Citrix Virtual Apps and Desktops utilizzando due console di gestione: Web Studio (basato sul Web) e Citrix Studio (basato 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 di macchine, rinominare, modificare la descrizione o gestire gli account computer Active Directory di un catalogo.

La manutenzione dei cataloghi può anche includere la verifica che ogni computer disponga degli ultimi aggiornamenti del sistema operativo. Questi comprendono aggiornamenti degli antivirus, aggiornamenti 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. 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, è possibile gestire gli aggiornamenti alle macchine degli utenti al di fuori di Web Studio. Eseguire questa attività singolarmente 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 permanenti o dedicate, tutte le nuove macchine create per il catalogo utilizzano l’immagine aggiornata. Le istanze preesistenti continuano a utilizzare l’istanza originale. Il processo di aggiornamento di un’immagine viene eseguito allo stesso modo per qualsiasi altro tipo di catalogo. Considerare quanto segue:

  • Nel caso dei cataloghi dei dischi persistenti, le macchine preesistenti non vengono aggiornate alla nuova immagine, ma tutte le nuove macchine aggiunte al catalogo utilizzano la nuova immagine.
  • Nel caso dei cataloghi di dischi non persistenti, l’immagine del computer viene aggiornata alla successiva reimpostazione del computer.
  • Nel caso dei cataloghi di macchine persistenti, l’aggiornamento dell’immagine aggiorna anche le istanze del catalogo che la utilizzano.
  • Nel caso dei cataloghi che non persistono, se si desidera utilizzare immagini diverse per macchine diverse, le immagini devono risiedere in cataloghi separati.

Gestire i cataloghi delle macchine

È possibile gestire un catalogo di macchine in due modi, come segue:

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 archiviazione sufficienti per ospitare i computer aggiuntivi.
    • Assicurarsi di disporre di un numero sufficiente di account computer Active Directory inutilizzati. Se si utilizzano account esistenti, il numero di computer 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. Accedere 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. Selezionare il numero di macchine virtuali da aggiungere.
    5. Se gli account Active Directory esistenti non sono sufficienti per il numero di macchine virtuali che si stanno aggiungendo, selezionare il dominio e il percorso in cui vengono creati gli account. Specificare uno schema di denominazione degli account, utilizzando i marcatori hash per indicare dove compaiono numeri o lettere sequenziali. Non utilizzare una barra (/) in un nome di unità organizzativa. Un nome non può iniziare con un numero. Ad esempio, uno schema di denominazione PC-Sales-## (con 0-9 selezionato) genera account computer denominati PC-Sales-01, PC-Sales-02, PC-Sales-03 e così via.
    6. Se si utilizzano account Active Directory esistenti, selezionare gli account oppure fare clic su Import e specificare un file CSV contenente i nomi di account. Assicurarsi che ci siano account sufficienti per tutte le macchine che si stanno aggiungendo. Web Studio gestisce questi account. Consentire a Web Studio di reimpostare le password per tutti gli account o specificare la password dell’account, che deve essere la stessa per tutti gli account.

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

    Dopo aver eliminato un computer da un catalogo di macchine, gli utenti non possono più accedervi, quindi prima di eliminare un computer, assicurarsi che si verifichino le seguenti condizioni:

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

    Per eliminare macchine da un catalogo:

    1. Accedere 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 che vengono rimosse. Se si sceglie di eliminare i computer, indicare se gli account di Active Directory per tali computer vengono mantenuti, disabilitati o eliminati.

    1. Nella pagina Description modificare 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. Tenere presente che le modifiche apportate si applicano solo alle macchine che verranno aggiunte 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.

      • Nella pagina Profilo macchina, scegli se utilizzare o modificare un profilo macchina.

      • (Visibile solo quando il catalogo è configurato con un gruppo host dedicato) Nella pagina Gruppo host dedicato, scegli se modificare un gruppo host.

      • Nella pagina Tipi di archiviazione e licenza, scegli se modificare le impostazioni relative al tipo di archiviazione, al tipo di licenza e alla Galleria computer di Azure (disponibile solo quando è in uso Inserisci immagine preparata nella Galleria di Azure).

      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.

      • Nella pagina Tipo di licenza, scegli se modificare l’impostazione della licenza Windows o Linux.

      Per i cataloghi Remote PC Access (Accesso remoto PC), sono visibili le seguenti pagine:

      • Nella pagina Gestione alimentazione, modifica le impostazioni di gestione alimentazione e seleziona una connessione di gestione alimentazione.
      • Nella pagina Organizational Units aggiungere o rimuovere le unità organizzative di Active Directory.
    6. Fai clic su Applica per applicare le modifiche apportate e fai clic su Salva per uscire.
    1. Accedere 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. Immettere il nuovo nome.

    Spostare un catalogo in una zona diversa

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

    Lo spostamento di un catalogo in una zona diversa, che non sia l’hypervisor contenente le macchine virtuali del catalogo, influisce sulle prestazioni.

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

    Prima di eliminare un catalogo, assicurarsi che si verifichino le seguenti condizioni:

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

    Per eliminare un catalogo:

    1. Accedere 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. Indicare se le macchine incluse nel catalogo vengono eliminate. Se si sceglie di eliminare i computer, indicare se gli account computer di Active Directory per tali macchine vengono mantenuti, disabilitati o eliminati.

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

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

    Per gestire gli account Active Directory:

    1. Accedere 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. 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 valida per tutti gli account.

      È possibile reimpostare le password se non si conoscono le password dell’account correnti; è necessario disporre dell’autorizzazione per eseguire la reimpostazione delle password. Quando si immette una password, la password viene modificata negli account man mano che vengono importati. Quando si elimina un account, scegliere se l’account in Active Directory viene mantenuto, disattivato o eliminato.

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

    Consigliamo di salvare copie o istantanee delle immagini master prima di aggiornare le macchine incluse nel catalogo. Il database conserva una cronologia delle immagini master utilizzate con ogni catalogo macchine. Eseguire il rollback o ripristinare le macchine di un catalogo per utilizzare la versione precedente dell’immagine master. Eseguire 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 utilizzarle.

    Dopo l’aggiornamento, il computer viene riavviato automaticamente.

    Aggiornare o creare un’immagine master

    Prima di aggiornare il catalogo delle macchine, aggiornare un’immagine master esistente o crearne una nell’hypervisor host.

    1. Nell’hypervisor, scattare un’istantanea della macchina virtuale corrente e assegnare all’istantanea un nome significativo. Questa istantanea può essere utilizzata per ripristinare (rollback) le macchine incluse nel catalogo, se necessario.
    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. Creare un’istantanea della macchina virtuale. Assegnare un nome significativo che venga riconosciuto quando il catalogo viene aggiornato in Web Studio. Sebbene Web Studio sia in grado di creare un’istantanea, Citrix consiglia di crearla utilizzando la console di gestione dell’hypervisor. Quindi selezionare l’istantanea 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.

    Cambiare l’immagine master

    Per preparare l’aggiornamento e implementarlo in tutte le macchine di un catalogo:

    1. Accedere 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, puoi annotarne 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 correlata alla nota se si aggiunge una nota. Se si aggiorna un catalogo senza aggiungere una nota, la voce viene visualizzata 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 Rollout Strategy (Strategia di rollout) scegliere quando le macchine nel catalogo macchine devono essere aggiornate con la nuova immagine master: al successivo spegnimento o immediatamente. > Nota: > > La pagina Strategia di rollout non è disponibile per le VM persistenti perché il rollout è applicabile solo alle VM non persistenti.
    6. Verificare le informazioni nella pagina Summary e quindi fare clic su Finish. 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). Usalo come alternativa a un’immagine o a un’istantanea di un’immagine.

    Strategia di rollout:

    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. Considerare quanto segue:

    • Le nuove sessioni non possono essere avviate fino al completamento dell’aggiornamento sui computer applicabili.
    • Le macchine con sistema operativo a sessione singola vengono immediatamente aggiornate quando la macchina non è in uso o quando gli utenti non hanno effettuato l’accesso.
    • In un sistema operativo multisessione, i riavvii non vengono eseguiti automaticamente. Le macchine devono essere spente e riavviate manualmente.

    Mancia:

    Limitare il numero di macchine da riavviare utilizzando le impostazioni avanzate per una connessione host. Utilizzare queste impostazioni per modificare le azioni eseguite in un determinato catalogo. Le impostazioni avanzate variano a seconda dell’hypervisor.

    Rollback dell’immagine master

    Dopo aver distribuito un’immagine master aggiornata o nuova, è possibile eseguire il rollback. Questo processo potrebbe essere necessario se si verificano problemi nei computer appena aggiornati. Quando si esegue il rollback, le macchine incluse nel catalogo vengono ripristinate all’ultima immagine funzionante. Tutte le nuove funzionalità che richiedono l’immagine più recente non sono più disponibili. Come per il rollout, il rollback di un computer include un riavvio.

    1. Accedere 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. I computer che non sono aggiornati con l’immagine master nuova o aggiornata non ricevono messaggi di notifica e non sono obbligati a scollegarsi.

    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.

    Cambiare il livello funzionale o annullare la modifica

    Modificare il livello funzionale del catalogo di macchine dopo l’aggiornamento dei VDA sui computer 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 di macchine:

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

    Per modificare il livello funzionale di un catalogo:

    1. Accedere a Web Studio.
    2. Selezionare Cataloghi macchine nel riquadro di sinistra.
    3. Selezionare il catalogo. La scheda Details nel riquadro inferiore visualizza le informazioni sulla versione.
    4. Seleziona Modifica livello funzionale. Se Web Studio rileva che il catalogo deve essere aggiornato, viene visualizzato un messaggio. Seguire le istruzioni. Se uno o più computer non possono essere aggiornati, viene visualizzato un messaggio che 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, tenere presente quanto segue:

    • Non è possibile modificare le impostazioni associate al sistema operativo e alla gestione della macchina . Il catalogo clonato eredita tali impostazioni dall’originale.
    • Il completamento della 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. È possibile modificare il nome. Vedere Rinominare un catalogo.
    • Al termine della clonazione, accertarsi di assegnare il catalogo clonato a un gruppo di consegna.
    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 Next (Avanti) per passare 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 per un facile accesso. Ad esempio, è possibile organizzare i cataloghi per tipo di immagine o per struttura organizzativa.

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

    • È possibile nidificare le cartelle fino a cinque livelli di profondità (esclusa la cartella principale predefinita).
    • Una cartella del 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 del catalogo, effettuare le seguenti operazioni:

    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 prevista, è 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. Visualizzare i cataloghi in base alla 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 tale cartella e le relative 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 visualizzare la cronologia degli errori e degli avvisi per comprendere i problemi del catalogo delle macchine MCS e risolverli.

    Utilizzando i comandi PowerShell, è possibile:

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

    Per eseguire i comandi PowerShell:

    1. Aprire una finestra di PowerShell.
    2. Eseguire il comando 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: si ricevono 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 correlate agli aggiornamenti delle immagini per i cataloghi delle 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 del 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 "Nota"
 <!--NeedCopy-->

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

       C:\PS>Pubblica-ProvMasterVMImage -ProvisioningSchemeName <name> -MasterImageVM XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\base.snapshot -MasterImageNote "Nota"
 <!--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 eseguire il rollback in alcuni scenari, inclusi i seguenti (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 VMware e SCVMM.

    Per eseguire correttamente il comando PowerShell, assicurarsi che sussistano le seguenti condizioni:

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

    Effettuare le seguenti operazioni per ripristinare il disco del sistema operativo:

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

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

      • Specificare l’elenco 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 . Questo metodo è meno efficiente perché ogni attività eseguirà gli stessi controlli ridondanti, quali 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 -Conferma:$false
 <!--NeedCopy-->

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

         PS C:\Windows\system32> $ConfirmPreference='Nessuno'
 PS C:\Windows\system32> $ConfirmPreference
 Nessuno
 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 le impostazioni di rete per uno schema di provisioning esistente

    È possibile modificare l’impostazione di rete per uno schema di provisioning esistente in modo che le nuove macchine virtuali vengano create nella 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 l’impostazione di rete per uno schema di provisioning esistente, procedere come segue:

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

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

      $NewNetworkMap = @{"0"= "XDHYP:\Unità di Hosting\Le Mie Reti\Nrete 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. È possibile effettuare le seguenti operazioni:

    • 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
    • ServiceOffering
    • MachineProfile
    • 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 -Versione 2
 <!--NeedCopy-->

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

      ``` (Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count

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

       Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Versione 2

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

       Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Versione 3

    • 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 -Nome "MaxProvSchemeVersions" -Valore 15

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

    Converti un catalogo macchine non basato su un profilo macchina in un catalogo macchine basato su un profilo macchina

    Puoi usare 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 non basato su un profilo 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 basato sul profilo macchina esistente non può essere modificato in un catalogo macchine non basato sul profilo macchina.

    Per fare questo:

    1. Creare un catalogo di macchine persistente o non persistente con macchine virtuali 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. Ad esempio:

      • Nel caso di Azure:

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

      • Nel caso di AWS:

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

    Ripara le informazioni di identità degli account computer attivi

    Puoi 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à o ripristinare tutta la configurazione del disco di identità. Questa implementazione è applicabile ai cataloghi di macchine di MCS sia persistenti che non persistenti.

    Nota:

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

    Condizioni

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

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

    Reimpostare il disco di 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. Reimpostare le informazioni sull’identità.

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

         Riparazione-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo

        La descrizione dei parametri utilizzati nel comando è la seguente:

        • IdentityAccountName: il nome dell’account di identità che deve essere riparato.
        • PrivilegedUserName: account utente che ha autorizzazione di scrittura sul provider di identità (AD o AzureAD).
        • PrivilegedUserPassword: Password per PrivilegedUserName.
        • Target: Destinazione dell’azione di riparazione. Può essere IdentityInfo per riparare la password dell’account e/o la chiave di fiducia e UserCertificate per riparare gli attributi del certificato utente delle identità delle macchine aggiunte ad AzureAD ibride.

      • Per ripristinare tutta la configurazione del disco di identità, eseguire i seguenti comandi nel seguente ordine:

         Riparazione-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo


         Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identità

      • Per ricreare completamente il disco di identità:

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

    4. Digitare y per confermare l’azione. È anche possibile saltare la richiesta di conferma utilizzando il parametro -Force. Per esempio:

      Ripristina-ProvVMDisk -ProvisioningSchemeName <name> -NomeVM <name> -Identità -Forza
    5. Eseguire Get-ProvVM -ProvisioningSchemeName <name -VMName <name> per verificare l’impostazione aggiornata del disco di identità. È necessario aggiornare gli attributi del disco di identità (ad esempio IdentityDiskId). StorageId e IdentityDiskIndex non devono cambiare.

    Modifica la configurazione della cache su un catalogo macchina esistente

    Dopo aver creato un catalogo non persistente con MCSIO abilitato, puoi usare 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:

    • Aggiornamento 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:

       Italiano: New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
 -IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot` -MasterImageVM $MasterImage `
 -ServiceOffering $ServiceOffering` -NetworkMap $NetworkMap `
 -SecurityGroup $SecurityGroup` -UsaWriteBackCache -WriteBackCacheDiskSize 8

    Modifica la configurazione della cache

    Esegui il comando Set-ProvScheme. Per esempio:

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

    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 la modifica. 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

    Passaggi successivi

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

    Gestire i cataloghi delle macchine
    November 8, 2024
    Grazie al contributo di: 
    C C
    November 8, 2024
    Grazie al contributo di: 
    C 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.