

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Amministra le impostazioni dell'applicazione VHDs per i tuoi utenti
<a name="administer-app-settings-vhds"></a>

Consulta i seguenti argomenti per scoprire come amministrare i file dei dischi rigidi virtuali (VHD) per le impostazioni delle applicazioni degli utenti delle applicazioni. WorkSpaces 

**Topics**
+ [Archiviazione con bucket Amazon S3](app-persistence-s3-buckets.md)
+ [Ripristinare le impostazioni dell'applicazione di un utente](app-persistence-s3-reset.md)
+ [Abilitare la funzione controllo delle versioni di oggetti Amazon S3 e ripristino delle impostazioni dell'applicazione dell'utente](app-persistence-enable-versions-revert-settings.md)
+ [Aumentare le dimensioni del VHD delle impostazioni dell'applicazione.](app-persistence-increase-VHD-size.md)

# Archiviazione con bucket Amazon S3
<a name="app-persistence-s3-buckets"></a>

Quando abiliti la persistenza delle impostazioni delle applicazioni, le personalizzazioni delle applicazioni degli utenti e le impostazioni di Windows vengono salvate automaticamente in un file del disco rigido virtuale (VHD) archiviato in un bucket Amazon S3 creato nel tuo account. AWS Per ogni AWS regione, WorkSpaces Applications crea un bucket nel tuo account che è unico per il tuo account e per la regione. Tutte le impostazioni dell'applicazione configurate dagli utenti sono memorizzate nel bucket per quella regione.

Non è necessario eseguire alcuna attività di configurazione per gestire questi bucket S3; sono completamente gestiti dal WorkSpaces servizio Applicazioni. [Il file VHD archiviato in ogni bucket viene crittografato in transito utilizzando gli endpoint SSL di Amazon S3 e a riposo tramite Managed.AWS CMKs](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk) I bucket vengono denominati in un formato specifico come segue:

```
appstream-app-settings-region-code-account-id-without-hyphens-random-identifier
```

***region-code***  
Questo è il codice AWS regionale in cui viene creato lo stack con la persistenza delle impostazioni dell'applicazione.

***account-id-without-hyphens***  
L'ID del tuo AWS account. L'identificatore casuale garantisce non vi è alcun conflitto con altri bucket in quella regione. La prima parte del nome del bucket, `appstream-app-settings`, resta uguale in tutti gli account o le regioni.

Ad esempio, se abiliti la persistenza delle impostazioni delle applicazioni per gli stack nella regione Stati Uniti occidentali (Oregon) (us-west-2) sul numero di account 123456789012, WorkSpaces Applications crea un bucket Amazon S3 all'interno del tuo account in quella regione con il nome mostrato. Solo un amministratore con autorizzazioni sufficienti può eliminare il bucket.

```
appstream-app-settings-us-west-2-1234567890123-abcdefg
```

La disabilitazione della persistenza delle impostazioni dell'applicazione non elimina le informazioni archiviate nel bucket S3. VHDs Per eliminare definitivamente le impostazioni VHDs, tu o un altro amministratore con autorizzazioni adeguate dovete farlo utilizzando la console o l'API di Amazon S3. WorkSpaces Applications aggiunge una policy sui bucket che impedisce l'eliminazione accidentale del bucket. Per ulteriori informazioni, consulta la sezione relativa a *policy IAM e bucket S3 per la persistenza delle impostazioni dell'applicazione* in [Identity and Access Management per WorkSpaces applicazioni Amazon](controlling-access.md).

Quando la persistenza delle impostazioni dell'applicazione è abilitata, viene creata una cartella univoca per ciascun gruppo di impostazioni per archiviare il VHD delle impostazioni. La gerarchia di una cartella nel bucket S3 dipende da come l'utente avvia una sessione di streaming, come descritto nella sezione seguente.

Il percorso per la cartella in cui le impostazioni VHD vengono memorizzate nel bucket S3 nel tuo account utilizza la seguente struttura:

```
bucket-name/Windows/prefix/settings-group/access-mode/user-id-SHA-256-hash
```

***bucket-name***  
Il nome del bucket S3 in cui sono archiviate le impostazioni delle applicazioni degli utenti. Il formato del nome è descritto precedentemente in questa sezione.

***prefix***  
Il prefisso specifico della versione di Windows. Ad esempio, v4 per Windows Server 2012 R2.

***settings-group***  
Il valore delle impostazioni di gruppo. Tale valore viene applicato a uno o più stack che condividono le stesse impostazioni delle applicazioni.

***access-mode***  
Il metodo di identità dell'utente: `custom` per l'API o la CLI WorkSpaces delle applicazioni, `federated` per SAML e `userpool` per gli utenti del pool di utenti.

***user-id-SHA-256-hash***  
Il nome di cartella specifico dell'utente. Questo nome viene creato utilizzando una stringa esadecimale hash SHA-256 minuscola generata dall'ID utente.

La seguente struttura di cartelle di esempio si applica a una sessione di streaming a cui si accede tramite l'API o la CLI con un ID utente`testuser@mydomain.com`, un Account AWS ID di e il gruppo di `123456789012` impostazioni `test-stack` nella regione Stati Uniti occidentali (Oregon) (us-west-2):

```
appstream-app-settings-us-west-2-1234567890123-abcdefg/Windows/v4/test-stack/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13
```

Puoi identificare la cartella per un utente generando il valore hash SHA-256 in lettere minuscole dell'ID utente utilizzando i siti Web o librerie di codifica open source disponibili online.

# Ripristinare le impostazioni dell'applicazione di un utente
<a name="app-persistence-s3-reset"></a>

Per ripristinare le impostazioni dell'applicazione di un utente, devi trovare ed eliminare il file VHD e i metadati associati dal bucket S3 del tuo account. AWS Assicurarsi di non eseguire questa operazione durante una sessione di streaming attiva di un utente. Dopo aver eliminato il file VHD e il file di metadati dell'utente, la volta successiva che l'utente avvia una sessione da un'istanza di streaming con la persistenza delle impostazioni dell'applicazione abilitata, WorkSpaces Applications crea un nuovo VHD delle impostazioni per quell'utente.

**Per ripristinare le impostazioni dell'applicazione di un utente**

1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nell'elenco **Bucket name (Nome bucket)**, scegliere bucket S3 che contiene il VHD delle impostazioni dell'applicazione da ripristinare.

1. Individuare la cartella che contiene il VHD. Per ulteriori informazioni su come esplorare la struttura della cartella del bucket S3, consulta la sezione relativa allo *storage del bucket Amazon S3* di cui si è già parlato in precedenza in questo argomento.

1. Nell'elenco **Name (Nome)**, selezionare la casella di controllo accanto a VHD e REG, scegliere **More (Altro)**, quindi **Delete (Elimina)**.

1. Nella finestra di dialogo **Delete objects (Elimina oggetti)**, verificare che VHD e REG siano elencati, quindi scegliere **Delete (Elimina)**. 

La volta successiva in cui l'utente esegue lo streaming da un parco istanze in cui la persistenza delle impostazioni dell'applicazione è abilitata con il gruppo di impostazioni applicabili sarà creato un nuovo VHD delle impostazioni dell'applicazione. Questo VHD viene salvato nel bucket S3 alla fine della sessione.

# Abilitare la funzione controllo delle versioni di oggetti Amazon S3 e ripristino delle impostazioni dell'applicazione dell'utente
<a name="app-persistence-enable-versions-revert-settings"></a>

Puoi utilizzare la funzione controllo delle versioni di oggetti Amazon S3 e le policy del ciclo di vita per gestire le impostazioni dell'applicazione degli utenti quando gli utenti le modificano. Con la funzione controllo delle versioni degli oggetti Amazon S3, puoi conservare, recuperare e ripristinare qualsiasi versione del VHD delle impostazioni. Ciò consente il recupero sia in seguito a operazioni involontarie dell'utente, sia in seguito a guasti dell'applicazione. Quando è abilitata la funzione controllo delle versioni, dopo ogni sessione di streaming, una nuova versione del VHD delle impostazioni dell'applicazione viene sincronizzata su Amazon S3. La nuova versione non sovrascrive la versione precedente, così se si verifica un problema con le impostazioni degli utenti, è possibile ripristinare una versione precedente del VHD.

**Nota**  
Ogni versione del VHD delle impostazioni dell'applicazione viene salvata su Amazon S3 come un oggetto separato e ne viene addebitato il costo di conseguenza.

La funzione delle versioni multiple degli oggetti non è abilitata per impostazione predefinita sul bucket S3, pertanto è necessario attivarla. 

**Per abilitare la funzione Versioni multiple di oggetti per il VHD delle impostazioni delle applicazioni**

1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nell'elenco **Bucket name (Nome bucket)**, scegliere il bucket S3 che contiene il VHD delle impostazioni dell'applicazione su cui abilitare le versioni multiple degli oggetti.

1. Scegli **Properties (Proprietà)**.

1. Selezionare **Versioning (Versioni multiple)**, **Enable versioning (Abilita versioni multiple)**, quindi selezionare **Save (Salva)**.

Per far scadere le versioni precedenti delle impostazioni dell'applicazione VHDs, puoi utilizzare le policy del ciclo di vita di Amazon S3. Per informazioni, consulta [Come creare una policy del ciclo di vita per un bucket S3](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-lifecycle.html) nella *Guida per l'utente Amazon Simple Storage Service*.

**Per ripristinare un VHD delle impostazioni dell'applicazione di un utente**

È possibile ripristinare una versione precedente di un VHD delle impostazioni dell'applicazione di un utente eliminando versioni più recenti del VHD dal bucket S3 applicabile. Non eseguire questa operazione quando l'utente ha una sessione di streaming attiva.

1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nell'elenco **Bucket name (Nome bucket)**, scegliere il bucket S3 che contiene il VHD delle impostazioni dell'applicazione dell'utente da ripristinare.

1. Individuare e selezionare la cartella che contiene il VHD. Per informazioni su come esplorare la struttura della cartella del bucket S3, consulta l'argomento *storage del bucket Amazon S3* già trattato in precedenza in questo documento.

   Quando si seleziona la cartella, vendono visualizzati il VHD delle impostazioni e il file di metadati associato.

1. Per visualizzare un elenco di versioni di file di metadati e VHD, scegliere **Show (Mostra)**.

1. Individuare la versione del VHD da ripristinare.

1. Nell'elenco **Name (Nome)**, selezionare le caselle di spunta accanto alle versioni più recenti dei file VHD e dei file di metadati associati, selezionare **More (Altro)**, quindi **Delete (Elimina)**.

1. Verificare che il VHD delle impostazioni dell'applicazione che si desidera ripristinare e i file di metadati associati siano le versioni più recenti di questi file. 

La volta successiva in cui l'utente esegue lo streaming da un parco istanze in cui la persistenza delle impostazioni dell'applicazione è abilitata con il gruppo di impostazioni applicabili viene visualizzata la versione ripristinata delle impostazioni dell'utente.

# Aumentare le dimensioni del VHD delle impostazioni dell'applicazione.
<a name="app-persistence-increase-VHD-size"></a>

La dimensione massima predefinita del VHD è di 1 GB per le flotte Elastic e di 5 GB per le flotte Always-On e On-Demand. Se un utente richiede ulteriore spazio per le impostazioni delle applicazioni, è possibile scaricare il VHD delle impostazioni delle applicazioni applicabili su un computer Windows per espanderlo. Quindi, sostituire l'attuale VHD nel bucket S3 con uno di dimensioni maggiori. Non eseguire questa operazione quando l'utente ha una sessione di streaming attiva. 

**Nota**  
Per ridurre le dimensioni fisiche del disco rigido virtuale (VHD), svuota il cestino prima di terminare una sessione. Ciò riduce anche i tempi di caricamento e download e migliora l'esperienza utente complessiva.

**Per aumentare le dimensioni del VHD delle impostazioni dell'applicazione**
**Nota**  
Il VHD completo deve essere scaricato prima che un utente possa eseguire lo streaming delle applicazioni. Aumentando le dimensioni del VHD delle impostazioni di un'applicazione può aumentare il tempo necessario per gli utenti per iniziare le sessioni di streaming dell'applicazione.

1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nell'elenco **Bucket name (Nome bucket)**, scegliere il nome del bucket S3 contenente il VHD delle impostazioni dell'applicazione da espandere.

1. Individuare e selezionare la cartella che contiene il VHD. Per informazioni su come esplorare la struttura della cartella del bucket S3, consulta l'argomento *storage del bucket Amazon S3* già trattato in precedenza in questo documento.

   Quando si seleziona la cartella, vendono visualizzati il VHD delle impostazioni e il file di metadati associato.

1. Scaricare il file Profile.vhdx in una directory sul computer Windows. Non chiudere il browser al termine del download, perché sarà possibile utilizzare nuovamente il browser in un secondo momento per caricare il VHD espanso.

1. Per utilizzare Diskpart per aumentare le dimensioni del disco rigido virtuale a 7 GB, apri il prompt dei comandi come amministratore e digita i seguenti comandi.

   `diskpart`

   `select vdisk file="C:\path\to\application\settings\profile.vhdx"`

   `expand vdisk maximum=7000`

1. Quindi, digitare i seguenti comandi Diskpart per trovare e collegare il VHD e visualizzare l'elenco dei volumi:

   `select vdisk file="C:\path\to\application\settings\profile.vhdx"`

   `attach vdisk`

   `list volume`

   Nell'output, annota il numero del volume con l'etichetta "». AppStreamUsers Nella fase successiva, si seleziona questo volume in modo che possa essere ingrandito.

1. Digita il seguente comando:

   `select volume ###`

   dove \$1 \$1 \$1 è il numero nell'output del volume dell'elenco.

1. Digita il seguente comando:

   `extend`

1. Digitare i seguenti comandi per confermare che le dimensioni della partizione sul VHD sono aumentate come previsto (2 GB in questo esempio):

   `diskpart`

   `select vdisk file="C:\path\to\application\settings\profile.vhdx"`

   `list volume`

1. Digitare il comando seguente per scollegare il file VHD in modo che possa essere caricato:

   `detach vdisk`

1. Torna al browser con la console Amazon S3, scegli **Carica**, **Aggiungi file**, quindi seleziona il VHD ampliato. 

1. Scegli **Carica**.

Una volta caricato il VHD, la volta successiva in cui l'utente esegue lo streaming da un parco istanze in cui la persistenza delle impostazioni dell'applicazione è abilitata con il gruppo di impostazioni applicabili sarà disponibile il VHD delle impostazioni dell'applicazione di dimensioni maggiori.