

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 immagini delle tue WorkSpaces applicazioni Amazon
<a name="administer-images"></a>

Le immagini disponibili sono elencate nel **registro delle immagini** nella console WorkSpaces Applicazioni e classificate in base alla visibilità come segue: 
+ **Pubbliche**: immagini di base di proprietà e rese disponibili da AWS. Le immagini di base includono il sistema operativo Windows più recente e il software dell'agente WorkSpaces Applicazioni. È possibile utilizzare queste immagini di base per creare nuove immagini che includano le proprie applicazioni. Per informazioni sulle immagini di base rilasciate da AWS, vedere[WorkSpaces Note sulla versione di Applications Base Image e Managed Image Update](base-image-version-history.md). 
+ **Private**: immagini che crei e possiedi e che non hai condiviso con altri AWS account. 
+ **Condivise con altri**: immagini che crei e possiedi e che hai condiviso con uno o più AWS account nella stessa AWS regione. Quando condividi un'immagine con un altro AWS account, puoi specificare se l'immagine può essere utilizzata per un generatore di immagini (per creare una nuova immagine), per una flotta o entrambi.
+ **Condivise con me**: immagini create e di proprietà di un altro AWS account nella stessa AWS regione e condivise con il tuo AWS account. A seconda delle autorizzazioni che il proprietario ha fornito al momento della condivisione dell'immagine con l'account, è possibile usare questa immagine per l'Image Builder, per i parchi istanze o per entrambi.

**Topics**
+ [Eliminare un'immagine privata nelle WorkSpaces applicazioni Amazon](delete-private-image.md)
+ [Copia un'immagine di tua proprietà in un'altra AWS regione in Amazon WorkSpaces Applications](copy-image-different-region.md)
+ [Condividi un'immagine di tua proprietà con un altro AWS account in Amazon WorkSpaces Applications](share-image-with-another-account.md)
+ [Smetti di condividere un'immagine di tua proprietà nelle WorkSpaces applicazioni Amazon](stop-sharing-image-with-all-accounts.md)
+ [Mantieni l'immagine WorkSpaces delle tue applicazioni Amazon Up-to-Date](keep-image-updated.md)
+ [Software Windows Update e antivirus nelle WorkSpaces applicazioni Amazon](windows-update-antivirus-software.md)
+ [Crea in modo programmatico una nuova immagine nelle applicazioni Amazon WorkSpaces](create-image-programmatically.md)
+ [Gestisci le applicazioni incluse nella licenza sulla tua immagine in Amazon WorkSpaces Applications](license-included-applications.md)
+ [Importa immagine](import-image.md)
+ [Esporta immagine](export-image.md)

# Eliminare un'immagine privata nelle WorkSpaces applicazioni Amazon
<a name="delete-private-image"></a>

È possibile eliminare le immagini private quando non sono più necessarie. Non puoi eliminare un'immagine utilizzata dalle flotte o condivisa con altri AWS account. Per eliminare un'immagine utilizzata da parchi istanze o condivisa, è necessario prima eliminare l'immagine da qualsiasi parco istanze e rimuovere tutte le autorizzazioni di condivisione dell'immagine. Dopo aver eliminato un'immagine, non è possibile ripristinarla.

**Per eliminare un'immagine privata**

1. Apri la console WorkSpaces Applicazioni in [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)

1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**.

1. Nell'elenco di immagini, selezionare l'immagine privata da eliminare.

1. Seleziona **Operazioni**, **Elimina**, quindi di nuovo **Elimina**.

   L'immagine viene rimossa dal registro immagini ed eliminata.

# Copia un'immagine di tua proprietà in un'altra AWS regione in Amazon WorkSpaces Applications
<a name="copy-image-different-region"></a>

**Importante**  
Per le regioni AWS di Asia Pacifico (Malesia), Europa (Milano), Europa (Spagna) e Israele (Tel Aviv): la copia di immagini tra regioni è supportata solo per le immagini con versioni dell'agente WorkSpaces Applications rilasciate il 2 on/after ottobre 2025 o per le immagini che utilizzano aggiornamenti gestiti rilasciati il 5 settembre 2025. on/after Le versioni precedenti non sono idonee per la copia tra regioni. Aggiorna le immagini per soddisfare questi requisiti minimi di versione e abilitare la funzionalità di copia tra aree geografiche.

Puoi copiare le immagini di tua proprietà in un'altra AWS regione. L'utilizzo della stessa immagine in diverse AWS regioni può contribuire a semplificare le distribuzioni globali delle applicazioni su WorkSpaces Applicazioni. Distribuendo le applicazioni nelle AWS regioni geograficamente più vicine agli utenti, puoi contribuire a fornire agli utenti un'esperienza più reattiva.

**Per copiare un'immagine di tua proprietà in un'altra regione AWS**

1. Apri la console WorkSpaces delle applicazioni in [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)

1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**.

1. Nell'elenco delle immagini, selezionate l'immagine che desiderate copiare in un'altra regione. AWS 

1. Selezionare **Actions (Operazioni)**, **Copy (Copia)**. 

1. Nella finestra di dialogo **Copia immagine**, in **Regione di destinazione**, selezionate la AWS regione in cui desiderate copiare l'immagine.

1. Digitare un nome univoco e, facoltativamente, una descrizione per l'immagine in **Destination region (Regione di destinazione)**. 

1. Scegliere **Copy Image (Copia immagine)**.

# Condividi un'immagine di tua proprietà con un altro AWS account in Amazon WorkSpaces Applications
<a name="share-image-with-another-account"></a>

WorkSpaces Le immagini delle applicazioni sono una risorsa regionale, quindi puoi condividere un'immagine di tua proprietà con altri AWS account all'interno della stessa AWS regione. Questa operazione può essere utile in diversi scenari. Ad esempio, se separi le risorse di sviluppo e di produzione utilizzando AWS account diversi, puoi creare un'immagine utilizzando il tuo account di sviluppo. Quindi è possibile condividere l'immagine con il tuo account di produzione. Se la tua organizzazione è un fornitore di software indipendenti (ISV), è possibile condividere immagini ottimizzate con i tuoi clienti. Le immagini ottimizzate che hanno le applicazioni necessarie già installate e configurate consentono ai tuoi clienti di iniziare a utilizzare le applicazioni in modo rapido, in modo che non necessitino di installare e configurare le applicazioni stesse.

Quando condividi un'immagine con un altro AWS account, specifichi se l'account di destinazione può utilizzare l'immagine in una flotta o creare nuove immagini creando un generatore di immagini. Tu continui a essere in possesso di immagini che condividono. In questo modo, è possibile aggiungere, modificare o rimuovere le autorizzazioni necessarie per le tue immagini condivise.

Se condividi un'immagine con un account e concedi autorizzazioni al parco istanze dell'account, l'immagine condivisa può essere utilizzata per creare o aggiornare i parchi istanze nell'account. Se si rimuovono queste autorizzazioni in un secondo momento, l'account non è più in grado di utilizzare l'immagine. Per i parchi istanze nell'account che utilizza l'immagine condivisa, la capacità desiderata è impostata su 0, che impedisce la creazione delle nuove istanze del parco. Le sessioni esistenti continuano fino al termine della sessione di streaming. Per le nuove istanze del parco istanze da creare, il parco istanze nell'account deve essere aggiornato con un'immagine valida.

Se condividi un'immagine con un account e concedi autorizzazioni all'Image Builder dell'account, l'immagine condivisa può essere utilizzata per creare gli Image Builder e le immagini in quell'account. Se si rimuovono queste autorizzazioni in un secondo momento, l'Image Builder e le immagini create dalla tua immagine non sono interessati. 

**Importante**  
Dopo aver condiviso un'immagine con un account, non è possibile controllare gli Image Builder o le immagini nell'account create dalla tua immagine. Per questo motivo, concedere le autorizzazioni dell'Image Builder a un account solo se si desidera abilitare l'account per effettuare una copia della tua immagine e mantenere l'accesso alla copia dopo l'interruzione della condivisione dell'immagine.

**Per condividere un'immagine di tua proprietà con un altro account AWS**

1. Apri la console WorkSpaces delle applicazioni in [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)

1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**.

1. Nell'elenco di immagini, selezionare l'immagine privata da condividere.

1. Selezionare **Actions (Operazioni)**, **Share (Condividi)**.

1. Nella finestra di dialogo **Share image (Condividi immagine)**, selezionare **Add account (Aggiungi account)**.

1. Digita l'ID AWS account a 12 cifre dell'account con cui desideri condividere l'immagine, quindi seleziona se l'account può eseguire una o entrambe le seguenti operazioni:
   + Utilizzare l'immagine per avviare un Image Builder, se si desidera creare una nuova immagine.
   + Utilizzare l'immagine con un parco istanze.

   Per rimuovere un account dall'elenco di account con cui è condivisa l'immagine, nella riga dell'account che si desidera rimuovere, scegliere l'icona X a destra dell'opzione **Use for fleet (Utilizza per il parco istanze)**.

1. Per condividere l'immagine con più AWS account, ripeti il passaggio 6 per ogni account con cui desideri condividere l'immagine. 

1. Scegliere **Share Image (Condividi immagine)**.

**Per aggiungere o aggiornare le autorizzazioni per la condivisione di immagini per un'immagine di tua proprietà**

1. Apri la console WorkSpaces Applicazioni in [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)

1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**.

1. Nell'elenco di immagini, selezionare l'immagine di cui si desidera modificare le autorizzazioni.

1. Sotto l'elenco di immagini, scegliere la scheda **Autorizzazioni** per l'immagine selezionata, quindi scegliere **Edit (Modifica)**.

1. Nella finestra di dialogo **Modifica autorizzazioni per l'immagine**, selezionate o deselezionate una o entrambe le seguenti opzioni di condivisione delle immagini in base alle esigenze per uno o più account. AWS Se si cancellano entrambe le opzioni per un account, l'immagine non è più condivisa con tale account. 
   + Utilizzare l'immagine per avviare un Image Builder, se si desidera creare una nuova immagine.
   + Utilizzare l'immagine con un parco istanze.

   Per rimuovere un account dall'elenco di account con cui è condivisa l'immagine, nella riga dell'account che si desidera rimuovere, scegliere l'icona X a destra dell'opzione **Use for fleet (Utilizza per il parco istanze)**.

1. Per modificare le autorizzazioni di condivisione delle immagini per più AWS account, ripeti il passaggio 5 per ogni account per cui desideri aggiornare le autorizzazioni. 

1. Scegliere **Update image sharing permissions (Aggiorna autorizzazioni per la condivisione di immagini)**.

# Smetti di condividere un'immagine di tua proprietà nelle WorkSpaces applicazioni Amazon
<a name="stop-sharing-image-with-all-accounts"></a>

Segui questi passaggi per interrompere la condivisione di un'immagine di tua proprietà con qualsiasi altro AWS account.

**Per interrompere la condivisione di un'immagine di tua proprietà con qualsiasi altro AWS account**

1. Apri la console WorkSpaces delle applicazioni in [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)

1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**.

1. Nell'elenco di immagini, selezionare l'immagine di cui si desidera modificare le autorizzazioni.

1. Sotto l'elenco di immagini, scegliere la scheda **Autorizzazioni** per l'immagine selezionata, quindi scegliere **Edit (Modifica)**.

1. Nella finestra di dialogo **Modifica le autorizzazioni dell'immagine**, nella riga relativa a tutti gli AWS account con cui è condivisa l'immagine, scegli l'icona X a destra dell'opzione **Usa** per la flotta.

1. Scegliere **Update image sharing permissions (Aggiorna autorizzazioni per la condivisione di immagini)**.

# Mantieni l'immagine WorkSpaces delle tue applicazioni Amazon Up-to-Date
<a name="keep-image-updated"></a>

Puoi conservare l'immagine WorkSpaces delle tue applicazioni up-to-date effettuando una delle seguenti operazioni:
+ [Aggiornare un'immagine utilizzando Managed WorkSpaces Applications Image Updates](keep-image-updated-managed-image-updates.md)— Questo metodo di aggiornamento fornisce gli aggiornamenti più recenti del sistema operativo e dei driver e il software dell'agente WorkSpaces Applications più recente.
+ [WorkSpaces Aggiornate il software Applications Agent utilizzando le versioni di Managed WorkSpaces Applications Agent](keep-image-updated-manage-image-versions.md)— Questo metodo di aggiornamento fornisce il software dell'agente WorkSpaces Applications più recente.

# Aggiornare un'immagine utilizzando Managed WorkSpaces Applications Image Updates
<a name="keep-image-updated-managed-image-updates"></a>

WorkSpaces Applications offre un modo automatizzato per aggiornare l'immagine con gli ultimi aggiornamenti del sistema operativo, gli aggiornamenti delle applicazioni inclusi nella licenza, gli aggiornamenti dei driver e il software dell'agente WorkSpaces delle applicazioni. Con gli aggiornamenti gestiti WorkSpaces delle immagini delle applicazioni, è possibile selezionare l'immagine che si desidera aggiornare. WorkSpaces Applications crea un generatore di immagini nello stesso AWS account e nella stessa regione per installare gli aggiornamenti e creare la nuova immagine. Dopo aver creato la nuova immagine, puoi testarla su una flotta di preproduzione prima di aggiornare le flotte di produzione o condividere l'immagine con altri account. AWS 

**Nota**  
Managed WorkSpaces Applications Image Updates è disponibile per i sistemi operativi Microsoft Windows Server, Red Hat Enterprise Linux e Rocky Linux.

**Nota**  
Dopo aver creato la nuova immagine, sei responsabile del mantenimento degli aggiornamenti per il sistema operativo. A tale scopo, puoi continuare a utilizzare gli aggiornamenti WorkSpaces delle immagini gestiti delle Applicazioni.  
Sei responsabile della manutenzione degli aggiornamenti per il driver Amazon EC2 Windows Paravirtual (PV), il driver ENA e il driver. AWS NVMe Per ulteriori informazioni su come aggiornare i driver, consulta [Gestire i driver di dispositivo](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-device-drivers.html) per l'istanza EC2.  
Sei inoltre responsabile della gestione delle applicazioni e delle relative dipendenze. Per aggiungere altre applicazioni, aggiornare quelle esistenti o modificare le impostazioni dell'immagine, devi avviare lo sviluppatore di immagini utilizzato per creare l'immagine ed eseguire una nuova connessione allo stesso. Se hai eliminato quell'Image Builder, avviane uno nuovo basato sulla tua immagine. Apportare quindi le modifiche e creare una nuova immagine.

## Prerequisiti
<a name="keep-image-updated-managed-image-updates-prerequisites"></a>

Di seguito sono riportati i prerequisiti e le considerazioni per l'utilizzo degli aggiornamenti gestiti delle immagini.
+ Assicurati che le quote del tuo account WorkSpaces Applications (chiamate anche limiti) siano sufficienti a supportare la creazione di un nuovo generatore di immagini e di una nuova immagine. Per richiedere un aumento della quota, puoi utilizzare la console Service Quotas all'indirizzo. [https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/) Per informazioni sulle quote predefinite WorkSpaces delle applicazioni, vedere. [Amazon WorkSpaces Applications Service Quotas](limits.md) 
+ Devi essere il proprietario dell'immagine aggiornata. Non puoi aggiornare un'immagine condivisa con te.
+ Quando WorkSpaces Applications crea un generatore di immagini per installare gli aggiornamenti più recenti del sistema operativo, gli aggiornamenti dei driver e il software dell'agente WorkSpaces Applications e crea la nuova immagine, ti viene addebitato il costo dell'istanza di image builder durante l'aggiornamento.
+ Le immagini supportate devono essere create a partire da un'immagine di base rilasciata a partire dal 24-07-2017T00:00:00 Z.
+ L'inglese e il giapponese sono lingue di visualizzazione supportate. Per ulteriori informazioni, consulta [Specificare una lingua di visualizzazione predefinita](configure-default-display-language.md).
+ Utilizza l'ultima versione dell'agente SSM. Per informazioni sulla versione, consulta [WorkSpaces Note sulla versione di Applications Base Image e Managed Image Update](base-image-version-history.md). Per ulteriori informazioni, consulta [Installazione manuale dell'agente SSM su istanze EC2 per Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html). 

## Come aggiornare un'immagine utilizzando Managed WorkSpaces Applications Image Updates
<a name="keep-image-updated-managed-image-updates-how-to-update-image"></a>

Per aggiornare un'immagine WorkSpaces delle applicazioni con le patch, gli aggiornamenti dei driver e il software dell'agente WorkSpaces Applications più recenti, effettuate le seguenti operazioni.

1. Apri la console WorkSpaces delle applicazioni in [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)

1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**. 

1. Nell'elenco di immagini, scegli l'immagine da aggiornare. Verifica che lo stato dell'immagine sia **Disponibile**.

1. Scegli **Operazioni**, **Aggiorna**.

1. Nella finestra di dialogo **Crea immagine** procedi nel seguente modo:
   + Per Nome **nuova immagine, inserisci un nome** di immagine univoco all'interno dell' AWS account e della regione. Il nome dell'immagine non può iniziare con «Amazon»AWS,» o "»AppStream. 
   + Per **Nome di visualizzazione nuova immagine**, puoi facoltativamente inserire un nome da visualizzare per l'immagine.
   + Per **Descrizione nuova immagine**, puoi immettere facoltativamente una descrizione dell'immagine.
   + Per **Tag**, puoi scegliere **Aggiungi tag** e immettere la chiave e il valore per il tag. Ripetere questa fase per aggiungere altri tag. Per ulteriori informazioni, consulta [Etichettatura delle risorse WorkSpaces delle applicazioni Amazon](tagging-basic.md).

1. Scegli **Crea immagine**.

   Se l'immagine attuale è già aggiornata, viene visualizzato un messaggio di notifica.

1. Nel riquadro di navigazione, scegli **Immagini**, quindi **Image Builder**. 

1. Nell'elenco degli Image Builder, verifica che sia visualizzato un nuovo Image Builder nello stato **Aggiornamento in corso**. Il nome dell'Image Builder include un suffisso casuale di 10 cifre.

   L'Image Builder è la dimensione più piccola nella famiglia di istanze scelta per la nuova immagine nella fase 5. Non è specificata alcuna sottorete perché l'Image Builder non è collegato al cloud privato virtuale (VPC).

1. Scegli **Registro immagini** e verifica che la nuova immagine compaia nell'elenco.

   Durante la creazione dell'immagine, lo stato dell'immagine nel registro immagini della console viene visualizzato come **In fase di creazione**.

1. Dopo aver creato l'immagine, WorkSpaces Applications esegue un processo di qualificazione per verificare che l'immagine funzioni come previsto. 

   Durante questa fase, l'Image Builder, utilizzato anche per questo processo, viene visualizzato nell'elenco **Image Builder** con lo stato**Qualifica in sospeso**. 

1. Una volta completato correttamente il processo di qualificazione, viene visualizzato un messaggio di **Operazione riuscita** nella parte superiore della console e lo stato dell'immagine nel registro immagini appare come **Disponibile**.

   Inoltre, il generatore di immagini creato da WorkSpaces Applications viene eliminato automaticamente.
**Nota**  
A seconda del volume degli aggiornamenti del sistema operativo, il completamento dell'aggiornamento dell'immagine potrebbe richiedere diverse ore. Se un problema impedisce l'aggiornamento dell'immagine, accanto al nome dell'immagine viene visualizzata un'icona rossa con un punto esclamativo e lo stato dell'immagine nel registro immagini viene visualizzato come **Non riuscito**. In tal caso, seleziona l'immagine, scegli la scheda **Notifiche** ed esamina le eventuali notifiche di errore. Per ulteriori informazioni, consulta le informazioni contenute nella sezione [Servizio interno di immagini](troubleshooting-notification-codes.md#troubleshooting-notification-codes-image) della documentazione per la risoluzione dei problemi dei codici di notifica.  
Se il processo di qualificazione non ha esito positivo, il generatore di immagini creato WorkSpaces dalle Applicazioni viene comunque eliminato automaticamente.

1. Dopo che WorkSpaces Applications ha creato la nuova immagine, testala su una flotta di pre-produzione. Dopo aver verificato il corretto funzionamento delle applicazioni, aggiorna i parchi istanze di produzione con la nuova immagine.

# WorkSpaces Aggiornate il software Applications Agent utilizzando le versioni di Managed WorkSpaces Applications Agent
<a name="keep-image-updated-manage-image-versions"></a>

WorkSpaces Applications offre un modo automatizzato per aggiornare il generatore di immagini con il software WorkSpaces Applications Agent più recente. In questo modo puoi creare una nuova immagine ogni volta che una nuova versione dell'agente viene rilasciata. Puoi quindi testare l'immagine prima di aggiornare i tuoi parchi istanze di produzione. Per ulteriori informazioni su come gestire il software dell'agente WorkSpaces Applications, vedere. [Gestione WorkSpaces delle versioni di Applications Agent](base-images-agent.md) 

**Nota**  
Devi installare e mantenere gli aggiornamenti per il sistema operativo Windows, le applicazioni e le loro dipendenze.

Per mantenere l'immagine WorkSpaces delle applicazioni aggiornata con gli ultimi aggiornamenti del sistema operativo Windows, effettuate una delle seguenti operazioni:
+ Installa le tue applicazioni sull'immagine di base più recente ogni volta che viene rilasciata una nuova immagine.
+ Installa gli aggiornamenti per il sistema operativo Windows, le applicazioni e le loro dipendenze su uno sviluppatore di immagini esistente.
+ Installa gli aggiornamenti per il sistema operativo Windows, le applicazioni e le loro dipendenze su un nuovo sviluppatore di immagini da una immagine esistente.

Dopo aver creato una nuova immagine con il sistema operativo Windows più recente, le applicazioni e le relative dipendenze e il software dell'agente WorkSpaces Applicazioni, testate l'immagine su un parco di sviluppo. Dopo aver verificato il corretto funzionamento delle applicazioni, aggiorna i parchi istanze di produzione con la nuova immagine.

# Software Windows Update e antivirus nelle WorkSpaces applicazioni Amazon
<a name="windows-update-antivirus-software"></a>

WorkSpaces Le istanze di streaming delle applicazioni non sono persistenti. Al termine di una sessione di streaming utente, WorkSpaces Applications chiude l'istanza utilizzata dalla sessione e, a seconda delle politiche di scalabilità, effettua il provisioning di una nuova istanza per sostituirla nel parco istanze. Tutte le istanze del parco istanze vengono assegnate dalla stessa immagine. Poiché le immagini non possono essere modificate una volta create, tutte le istanze del parco istanze utilizzate nelle sessioni di streaming degli utenti dispongono solo degli aggiornamenti Windows e dell'applicazione installati sull'immagine sottostante al momento della creazione dell'immagine. Inoltre, poiché un'istanza del parco istanze utilizzata per una sessione di streaming termina al termine della sessione, qualsiasi aggiornamento apportato a Windows o alle applicazioni sull'istanza durante la sessione di streaming non persisterà nelle sessioni future dello stesso utente o di altri utenti.

**Nota**  
Se hai abilitato la persistenza delle impostazioni dell'applicazione per lo stack, WorkSpaces Applications mantiene le modifiche alla configurazione di Windows e delle applicazioni apportate da un utente alle sessioni future per lo stesso utente se tali modifiche alla configurazione sono archiviate nel profilo Windows dell'utente. Tuttavia, la funzionalità di persistenza delle impostazioni dell'applicazione mantiene solo le impostazioni di configurazione di Windows e dell'applicazione. Non mantiene gli aggiornamenti software a Windows o applicazioni sull'istanza di streaming.

Per questi motivi, WorkSpaces Applications adotta il seguente approccio a Windows Update e al software antivirus sulle WorkSpaces istanze delle applicazioni.

## Windows Update
<a name="windows-update-antivirus-software-wu"></a>

Windows Update non è abilitato per impostazione predefinita nelle immagini di base WorkSpaces delle applicazioni. Se abiliti Windows Update in uno sviluppatore di immagini e quindi provi a creare un'immagine, Image Assistant mostra un avviso e disabilita Windows Update durante il processo di creazione dell'immagine. Per assicurarti che il parco istanze disponga degli aggiornamenti di Windows più recenti installati, ti consigliamo di installare gli aggiornamenti di Windows sull'Image Builder, creare una nuova immagine e aggiornare regolarmente il parco istanze con la nuova immagine.

## Software antivirus
<a name="windows-update-antivirus-software-av"></a>

Se scegli di installare il software antivirus sull'immagine, ti consigliamo di non abilitare gli aggiornamenti automatici per il software antivirus. In caso contrario, il software antivirus potrebbe tentare di aggiornarsi con i file di definizione più recenti o altri aggiornamenti durante le sessioni utente. Questo può influire sulle prestazioni. Inoltre, gli aggiornamenti apportati al software antivirus non persisteranno oltre la sessione utente corrente. Per assicurarti che il parco istanze disponga sempre degli aggiornamenti antivirus più recenti, ti consigliamo di eseguire una delle seguenti operazioni:
+ Aggiornare lo sviluppatore di immagini e creare regolarmente una nuova immagine (ad esempio, utilizzando le [operazioni dell'interfaccia a riga di comando Image Assistant](https://docs.aws.amazon.com/appstream2/latest/developerguide/programmatically-create-image.html)).
+ Utilizzate un'applicazione antivirus che deleghi la scansione o altre operazioni a un server always-up-to-date esterno.

**Nota**  
Anche se non abiliti gli aggiornamenti automatici per il tuo software antivirus, il software antivirus potrebbe eseguire scansioni del disco rigido o altre operazioni che potrebbero influire sulle prestazioni del parco istanze durante le sessioni utente.

Nelle immagini di base WorkSpaces delle applicazioni Windows Server 2025/2022/2019/2016 pubblicate a partire dal 10 settembre 2019, Windows Defender non è abilitato per impostazione predefinita. Nelle immagini di base WorkSpaces delle applicazioni Windows Server 2016 e Windows Server 2019 pubblicate il 24 giugno 2019, Windows Defender è abilitato per impostazione predefinita.

**Per attivare manualmente Windows Defender**

Se Windows Defender non è abilitato nell'immagine di base, è possibile attivarlo manualmente. Per fare ciò, completare questa procedura:

1. Apri la console WorkSpaces delle applicazioni in [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)

1. Nel riquadro di navigazione a sinistra, scegliere **Images (Immagini)**, **Image Builder**. 

1. Scegliere l'Image Builder su cui attivare Windows Defender, verificare che sia nello stato **Running (In esecuzione)** e scegliere **Connect (Connetti)**. 

1. Accedi con l'account **Amministratore** locale o con un account di dominio che abbia le autorizzazioni di amministratore locale.

1. Aprire l'editor del Registro di sistema.

1. Accedere alla seguente posizione nel registro: **HKLM\$1 SOFTWARE\$1 Policies\$1 Microsoft\$1 Windows Defender\$1**. DisableAntiSpyware 

1. Per modificare questa chiave del registro di sistema, fare doppio clic su di essa o fare clic con il pulsante destro del mouse sulla chiave del registro di sistema e scegliere **Modify (Modifica)**.

1. Nella finestra di dialogo **Edit DWORD (32-bit) Value (Modifica valore DWORD (32 bit))** in **Value data (Dati valore)**, modificare **1** in **0**.

1. Scegli **OK**.

1. Chiudere l'editor del registro di sistema.

1. Aprire lo snap-in **Servizi** di Microsoft Management Console (MMC) (`services.msc`).

1. Nell'elenco dei servizi, effettuate una delle seguenti operazioni.

   Se utilizzi Microsoft Windows Server 2022/2025, esegui una delle seguenti operazioni:
   + Fai clic con il pulsante destro del mouse **su Microsoft Defender Antivirus Service** e scegli **Avvia**.
   + **Fate doppio clic su **Microsoft Defender Antivirus Service**, scegliete **Start** nella finestra di dialogo delle proprietà, quindi scegliete OK.**

   Se utilizzi Microsoft Windows Server 2019 o 2016, esegui una delle seguenti operazioni:
   + Fare clic con il pulsante destro del mouse su **Windows Defender Antivirus Service**, e scegliere **Start (Avvia)**.
   + Fare doppio clic su **Windows Defender Antivirus Service**, scegliere **Start (Avvia)** nella finestra di dialogo delle proprietà e quindi scegliere **OK**.

1. Chiudere lo snap-in **Services (Servizi)**.

# Crea in modo programmatico una nuova immagine nelle applicazioni Amazon WorkSpaces
<a name="create-image-programmatically"></a>

È possibile creare immagini WorkSpaces delle applicazioni a livello di codice collegandosi a un generatore di immagini e utilizzando le operazioni dell'interfaccia a riga di comando (CLI) di Image Assistant. Per ulteriori informazioni, consulta [Crea l'immagine WorkSpaces delle tue applicazioni Amazon in modo programmatico utilizzando le operazioni CLI di Image Assistant](programmatically-create-image.md). 

# Gestisci le applicazioni incluse nella licenza sulla tua immagine in Amazon WorkSpaces Applications
<a name="license-included-applications"></a>

È possibile eseguire lo streaming delle seguenti applicazioni con licenza Microsoft inclusa utilizzando WorkSpaces Applicazioni. È possibile installare queste applicazioni sulla propria immagine Windows, utilizzare questa immagine personalizzata per creare una serie di applicazioni e quindi eseguire lo streaming di tali applicazioni. Tutte le seguenti applicazioni sono disponibili in architettura a 32 e 64 bit:
+ Microsoft Office LTSC Professional Plus 2021/2024
+ Microsoft Visio LTSC Professional 2021/2024
+ Microsoft Project Professional 2021/2024
+ Norma LTSC di Microsoft Office 2021/2024
+ Norma LTSC di Microsoft Visio 2021/2024
+ Microsoft Project Standard 2021/2024
**Importante**  
Microsoft Office, Visio e Project devono seguire le stesse versioni. Ad esempio, non puoi combinare le applicazioni 2021 con le applicazioni 2024.
Microsoft Office, Visio e Project devono seguire la stessa architettura. Ad esempio, non è possibile combinare applicazioni a 32 bit con applicazioni a 64 bit.
Le Standard/Professional versions are supported on Microsoft Windows Server 2019/2022/2025. Microsoft Office, Visio, and Project 2024 Standard/Professional versioni di Microsoft Office, Visio e Project 2021 sono supportate su Microsoft Windows Server 2022 e 2025.
Per abilitare questa funzionalità, è necessario utilizzare un WorkSpaces Applications Image Builder che utilizza un agente WorkSpaces Applications rilasciato il o dopo il 2 ottobre 2025. Per ulteriori informazioni, consulta [Gestione WorkSpaces delle versioni di Applications Agent](base-images-agent.md). In alternativa, l'immagine deve utilizzare gli aggiornamenti gestiti WorkSpaces delle immagini delle applicazioni rilasciati a partire dal 3 ottobre 2025. Per ulteriori informazioni, consulta [Mantieni l'immagine WorkSpaces delle tue applicazioni Amazon Up-to-Date](keep-image-updated.md).
Il protocollo TCP in uscita sulla porta 1688 deve essere aperto sull'interfaccia di rete di gestione di tutte le istanze di streaming. 
Tutti gli utenti che effettuano lo streaming tramite una flotta basata su un'immagine con una o più app con licenza prevedono una fatturazione mensile per queste app, indipendentemente dall'utilizzo. La funzionalità di autorizzazione all'applicazione non limita l'accesso a utenti specifici.
Le applicazioni con licenza inclusa in Image Builder non vengono attivate perché installate per scopi amministrativi. L'attivazione avviene quando gli utenti eseguono lo streaming tramite un'istanza del parco istanze.

**Topics**
+ [Visualizza l'elenco delle applicazioni con licenza inclusa installate sull'immagine](view-list-image.md)
+ [Visualizza l'elenco delle applicazioni con licenza inclusa nel tuo generatore di immagini](view-list-apps.md)
+ [Installa o disinstalla le applicazioni con licenza inclusa](install-uninstall-apps.md)
+ [Abilita gli aggiornamenti per le applicazioni con licenza inclusa su image builder](updates-image-builder.md)
+ [Abilita gli aggiornamenti per le applicazioni incluse nella licenza su image builder con Powershell](enable-updates-managed-powershell.md)
+ [Abilita gli aggiornamenti per le applicazioni con licenza inclusa su image builder con Managed Image Update](enable-updates-managed.md)

# Visualizza l'elenco delle applicazioni con licenza inclusa installate sull'immagine
<a name="view-list-image"></a>

**Visualizza l'elenco delle applicazioni con licenza inclusa installate sull'immagine**

Per visualizzare l'elenco delle applicazioni con licenza inclusa installate sull'immagine, procedi nel seguente modo.

1. Apri la console WorkSpaces delle applicazioni in [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)

1. Scegli **Immagini** nel riquadro di navigazione a sinistra e nella scheda **Image** Registry.

1. Seleziona un'immagine e scegli **Visualizza dettagli**.

1. Consulta l'elenco di tutte le applicazioni installate nella sezione **Applicazioni incluse nella licenza**.

# Visualizza l'elenco delle applicazioni con licenza inclusa nel tuo generatore di immagini
<a name="view-list-apps"></a>

**Visualizza l'elenco delle applicazioni con licenza inclusa nel tuo generatore di immagini**

Per visualizzare l'elenco delle applicazioni con licenza inclusa nel tuo generatore di immagini, segui questi passaggi.

1. Apri la console WorkSpaces delle applicazioni in [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)

1. Scegli **Immagini** nel riquadro di navigazione a sinistra e nella scheda **Image** builder.

1. Seleziona un generatore di immagini e scegli **Visualizza** dettagli.

1. Consulta l'elenco delle applicazioni e i relativi stati nella sezione Applicazioni **incluse nella licenza.**

# Installa o disinstalla le applicazioni con licenza inclusa
<a name="install-uninstall-apps"></a>

**Installa o disinstalla le applicazioni incluse nella licenza**

Per installare o disinstallare una o più applicazioni con licenza inclusa nell'immagine, procedi nel seguente modo.

1. Completa una delle seguenti opzioni:
   + Avvia un generatore di immagini e configura le applicazioni con licenza inclusa. Per ulteriori informazioni, consulta [Avvio di uno sviluppatore di immagini per installare e configurare applicazioni per lo streaming](tutorial-image-builder-create.md).
   + Gestisci le applicazioni con licenza inclusa nel tuo generatore di immagini. Per ulteriori informazioni, consulta [Diritti sulle applicazioni basati su attributi che utilizzano un gestore dell'identità digitale SAML 2.0 di terze parti](application-entitlements-saml.md).

1. Se hai creato un'immagine con una o più applicazioni con licenza inclusa, puoi usare questa immagine per creare flotte. Gli utenti che si connettono a questa flotta possono accedere a queste applicazioni. 
**Importante**  
Tutti gli utenti che effettuano lo streaming tramite una flotta basata su un'immagine con una o più app con licenza saranno soggetti alla fatturazione mensile per queste app, indipendentemente dall'utilizzo. La funzionalità di autorizzazione all'applicazione non limita l'accesso a utenti specifici. 

Se si verificano errori durante l'installazione o la disinstallazione dell'app inclusa nella licenza, verrà visualizzato uno stato di errore nella pagina dei dettagli di Image Builder. Per risolvere questi problemi, consigliamo di collegarsi a Image Builder e abilitare la registrazione dettagliata. Per ulteriori informazioni, vedi [Come abilitare le app Microsoft 365 per la registrazione aziendale](https://learn.microsoft.com/en-us/troubleshoot/microsoft-365-apps/diagnostic-logs/how-to-enable-office-365-proplus-uls-logging). Se il problema persiste dopo aver esaminato i registri e risolto il problema, contatta Supporto AWS per ricevere assistenza.

# Abilita gli aggiornamenti per le applicazioni con licenza inclusa su image builder
<a name="updates-image-builder"></a>

**Abilita gli aggiornamenti per le applicazioni con licenza inclusa su image builder**

Gli aggiornamenti per tutte le applicazioni con licenza inclusa sono disabilitati per impostazione predefinita. È possibile abilitare gli aggiornamenti per queste applicazioni nel generatore di immagini con un'immagine che include una o più di queste applicazioni. Gli aggiornamenti sulle istanze del parco istanze rimangono disabilitati per impedire l'installazione durante la configurazione della sessione.

Esistono tre opzioni per abilitare gli aggiornamenti per le applicazioni con licenza inclusa in Image Builder.

Per abilitare gli aggiornamenti per le applicazioni con licenza inclusa su image builder con il menu dell'applicazione, segui questi passaggi.

1. Apri qualsiasi applicazione con licenza inclusa.

1. Scegli **File**, **Account**, **Opzioni di aggiornamento** e **Abilita aggiornamenti**.

# Abilita gli aggiornamenti per le applicazioni incluse nella licenza su image builder con Powershell
<a name="enable-updates-managed-powershell"></a>

Per abilitare gli aggiornamenti per le applicazioni con licenza inclusa su image builder con Powershell, segui questi passaggi.
+ Esegui il comando seguente con PowerShell come amministratore: 

  `Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration" -Name UpdatesEnabled -Value True `

# Abilita gli aggiornamenti per le applicazioni con licenza inclusa su image builder con Managed Image Update
<a name="enable-updates-managed"></a>

Per abilitare gli aggiornamenti per le applicazioni con licenza inclusa su image builder con Managed Image Update, segui questi passaggi.
+  Usa Managed Image Update per ricevere aggiornamenti sulle applicazioni con licenza Microsoft inclusa. Per ulteriori informazioni, consultare la pagina 

  [Aggiornare un'immagine utilizzando Managed WorkSpaces Applications Image Updates](keep-image-updated-managed-image-updates.md).

# Importa immagine
<a name="import-image"></a>

Puoi creare immagini WorkSpaces delle Applicazioni importando le tue immagini personalizzate EC2 AMIs. Come funziona:

1. Personalizza la tua EC2 AMI utilizzando qualsiasi metodo preferito, incluso [EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/).

1. Importa la tua AMI personalizzata in WorkSpaces Applications per creare un'immagine WorkSpaces Applications

1. Facoltativamente, utilizzare Image Builder per personalizzare ulteriormente le immagini

Le immagini create tramite l'importazione AMI sono di`type = "custom"`, mentre WorkSpaces le immagini fornite dalle Applicazioni sono di`type = "native"`.

È possibile utilizzare i tipi di istanza stream.\$1 per immagini con. `type = "native"` Per utilizzare uno dei seguenti tipi di istanza, devi importare l'AMI e creare un'immagine con`type = "custom"`.
+ GeneralPurpose.\$1
+ MemoryOptimized.\$1
+ ComputeOptimized.\$1
+ Accelerato. \$1

## Prerequisiti per l'importazione di immagini
<a name="import-image-prerequisites"></a>

Tutti questi prerequisiti sono importanti per una corretta esecuzione del flusso di lavoro. Le configurazioni AMI supportate e altri requisiti obbligatori sono elencati di seguito.

### Proprietà AMI obbligatorie
<a name="required-ami-properties"></a>

EBS  
+ Dimensioni inferiori o uguali a 500 GB
  + Puoi importare un'AMI con < 200 GB, tuttavia l'immagine importata utilizzerà almeno 200 GB.
+ GP2
  + Puoi importare un AMI con il tipo di volume gp2 o gp3 EBS, tuttavia l'immagine importata utilizzerà gp2.
+ Un volume per immagine
+ `/dev/sda1`Nome del dispositivo root
+ Tipo di immagine: macchina
+ Architettura: x86\$164
+ Tipo di virtualizzazione: HVM
+ Modalità di avvio: UEFI
+ Supporto TPM: v2.0. Questo è obbligatorio, fare riferimento a [https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html\$1 per trovare un'AMI abilitata per ami-windows-tpm-find TPM](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find).
+ ENA Support: vero
+ Piattaforma: Windows
+ Dettagli della piattaforma: Windows

### Proprietà del sistema operativo
<a name="operating-system-properties"></a>

**Base completa di Windows Server 2022/2025**  
+ **Windows Server Core non è supportato**
+ Windows con SQL Server non è supportato

Agents (Agenti)  
+ EC2 Avvia la versione V2 >= 2.1.1
+ Agente SSM richiesto

Driver  
+ EC2 Versione del driver ENA >= 2.9.0
+ EC2 NVMe Versione del driver >= 1.6.0

Supporto per biblioteche  
+ .NET Framework 4.8 o versione successiva
  + Installato per impostazione predefinita in Windows Server 2022/2025
+ PowerShell 5.1 o versione successiva
  + Installato per impostazione predefinita in Windows Server 2022/2025
+ Funzionalità di Windows: Remote Desktop Services Licensing e Remote Desktop Services Session Host non devono essere installati
+ Porte: le porte 8000, 8300 e 8443 devono essere sbloccate e non occupate
+ Modalità di avvio: UEFI

Se desideri utilizzare l'immagine con istanze grafiche come Accelerated.G4DN, Accelerated.G5, Accelerated.G6 o Accelerated.G6E, devi installare il driver GRID appropriato sull'AMI. [Per maggiori dettagli, consulta -GRID-driver.html. https://docs.aws.amazon.com/AWSEC2/ latest/UserGuide/nvidia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html) Se i driver non sono configurati correttamente, lo streaming funzionerà, tuttavia la scheda grafica potrebbe non essere disponibile.

**Importante**  
«Owner Account Id» dell'AMI deve essere l'ID AWS del tuo account. Non è possibile importare un' EC2 AMI pubblica.  
Eseguite tutti gli aggiornamenti di Windows e disattivate gli aggiornamenti automatici di Windows prima di importare l'immagine.  
L'importazione di immagini crittografate non EC2 AMIs è attualmente supportata

### Requisiti del ruolo IAM
<a name="iam-role-requirements"></a>

**Importante**  
«Crea un ruolo IAM con le seguenti autorizzazioni da utilizzare per l'importazione di immagini:

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Sid": "AllowModifyImageAttributeWithTagCondition",  
            "Effect": "Allow",  
            "Action": "ec2:ModifyImageAttribute",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        }  
    ]  
}
```

Aggiungi la seguente relazione di fiducia per questo ruolo IAM

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Effect": "Allow",  
            "Principal": {  
                "Service": "appstream.amazonaws.com"  
            },  
            "Action": "sts:AssumeRole"  
        }  
    ]  
}
```

## Per importare un'immagine
<a name="import-image-procedure"></a>

1. Apri la console WorkSpaces Applicazioni in [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)

1. **Nel riquadro di navigazione a sinistra, scegli **Immagini**, quindi scegli Registro immagini.**

1. Scegli **Importa immagine**.

1. **ID AMI**: inserisci un ID AMI per l'AMI che desideri importare WorkSpaces nelle applicazioni. Puoi anche cercare il tuo AMI utilizzando questo campo.

1. **Nome immagine**: inserisci un nome univoco per l'immagine che verrà creata a seguito dell'operazione di importazione.

1. **Nome visualizzato** *(opzionale)*: immettere un nome da visualizzare per l'immagine.

1. **Descrizione** *(opzionale)*: immettere una descrizione per l'immagine.

1. **Ruolo IAM**: seleziona il ruolo IAM che hai creato per l'importazione di immagini. Per maggiori dettagli, consulta[Requisiti del ruolo IAM](#iam-role-requirements).

1. **Gestisci l'agente WorkSpaces delle applicazioni**: seleziona questa opzione se desideri utilizzare sempre la versione più recente dell'agente WorkSpaces Applications, le istanze di streaming vengono aggiornate automaticamente con le funzionalità più recenti, i miglioramenti delle prestazioni e gli aggiornamenti di sicurezza disponibili a partire dal AWS rilascio di una nuova versione dell'agente.

1. **Convalida del runtime** *(opzionale)*: selezionate questa opzione e il servizio fornirà un'istanza con l'immagine da importare ed eseguirà test di streaming.
   + 
**Nota**  
Questi test di streaming verranno eseguiti in background, non è possibile connettersi a questa istanza tramite il client WorkSpaces Applications.
   + Ti consigliamo di utilizzare questa opzione per avere maggiore certezza che l'immagine sia adatta WorkSpaces alle applicazioni.
   + Ti verrà addebitato il prezzo orario di quell'istanza.
   + Puoi evitare di eseguire la convalida del runtime se stai reimportando l'AMI dopo aver apportato modifiche minori che potrebbero non influire sul test di streaming e se la convalida del runtime è stata superata l'ultima volta, hai importato questa AMI.
   + **Scegli il tipo di istanza** *(facoltativo)*: seleziona la famiglia, il tipo e la dimensione dell'istanza corretti per eseguire il test di streaming. Si consiglia di utilizzare la stessa istanza che si prevede di utilizzare per la creazione del parco veicoli.

1. **Catalogo delle applicazioni e manifesto delle prestazioni di avvio** *(opzionale)*: fornisci i dettagli per creare un catalogo di applicazioni per gli utenti finali e migliorare le prestazioni di avvio delle applicazioni.
   + **Catalogo delle applicazioni**: per creare un catalogo di applicazioni, specificate i dettagli sulle applicazioni installate (immagine). Per ogni applicazione per cui si prevede di effettuare lo streaming, è possibile specificare il nome, il nome visualizzato, il file eseguibile da avviare e l'icona da visualizzare.
   + **Prestazioni di avvio**: l'aggiunta di file al manifesto di ottimizzazione dell'applicazione riduce il tempo necessario al primo avvio dell'applicazione su una nuova istanza del parco istanze. Il manifest di ottimizzazione è un file di testo delimitato da tabulazioni per applicazione.

   Per ulteriori informazioni, fare riferimento a[Dettagli delle applicazioni](applications-details.md).

1. **Tag** *(facoltativo)*: scegli **Aggiungi tag** e digita la chiave e il valore per il tag. Ripetere questa fase per aggiungere altri tag. Per ulteriori informazioni, consulta [Etichettatura delle risorse WorkSpaces delle applicazioni Amazon](tagging-basic.md).

1. **Importa immagine**: rivedi tutte le informazioni che hai inserito e scegli **Importa immagine**. Il servizio eseguirà controlli di compatibilità per assicurarsi che l'AMI sia compatibile con WorkSpaces le applicazioni.
   + Se i controlli statici falliscono, riceverai immediatamente un errore.
   + Se i controlli statici vengono superati, la richiesta di importazione verrà inviata e, a seconda delle opzioni selezionate, potrebbero essere necessari 30-60 minuti per creare una nuova immagine WorkSpaces delle applicazioni con `type = "custom"`

# Dettagli delle applicazioni
<a name="applications-details"></a>

I dettagli delle applicazioni contengono informazioni sui manifesti preriscaldati e sulle configurazioni del catalogo delle app.

## Manifesti delle applicazioni PreWarm
<a name="application-prewarm-manifests"></a>

Durante la creazione WorkSpaces delle immagini delle Applicazioni, è possibile specificare le applicazioni da rendere disponibili agli utenti. Per velocizzare il tempo di avvio dell'applicazione puoi preparare un PreWarm manifesto. Si tratta essenzialmente di un catalogo dei file che l'applicazione deve avviare quando gli utenti avviano l'applicazione. Durante il provisioning delle istanze, questi file verranno preparati prima delle connessioni alla sessione per velocizzare i tempi di avvio delle applicazioni nelle sessioni utente.

I manifesti Prewarm devono essere pre-creati sull'AMI prima di essere importati nell' WorkSpaces ambiente Applicazioni. È possibile scegliere di creare un file manifest Prewarm comune o uno per ogni applicazione. Questo cambia il modo in cui importerai l'AMI in un secondo momento.

### Manifesto preriscaldato comune
<a name="common-prewarm-manifest"></a>

Per ogni applicazione che desideri preriscaldare, avvia l'applicazione ed esegui tutte le interazioni iniziali che gli utenti potrebbero eseguire. Quindi, utilizzate il seguente comando per indirizzare la directory in cui sono archiviati i dati delle applicazioni.

```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```

Questo aggiungerà i file da ottimizzare per ogni applicazione nel file comune`C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt`. Non è necessaria alcuna azione aggiuntiva per eseguire il preriscaldamento dell'applicazione. WorkSpaces Le applicazioni cercheranno il file di preriscaldamento nella posizione sopra indicata e lo utilizzeranno se presente.

Questo processo è facoltativo e, all'aumentare delle dimensioni del manifesto di preriscaldamento, aumenterà anche il tempo di approvvigionamento della flotta. Fate quindi attenzione a bilanciare l'ottimizzazione con l'approvvigionamento della flotta.

### Manifesti specifici dell'applicazione
<a name="application-specific-manifests"></a>

Durante l'importazione delle immagini, potreste voler specificare file manifesto dell'applicazione separati per applicazione per facilitare il tracciamento delle risorse preriscaldate per applicazione. A tale scopo, esegui gli stessi passaggi descritti sopra, ma invece di creare un `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` file comune, crea un file per applicazione sull'AMI.

Per ogni applicazione che desideri preriscaldare, avvia l'applicazione ed esegui tutte le interazioni iniziali che gli utenti potrebbero eseguire. Quindi, utilizzate il seguente comando per indirizzare la directory in cui sono archiviati i dati delle applicazioni.

```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\Path\To\My\<ApplicationName>PreWarm.txt" -encoding UTF8 -append
```

Utilizzeremo questi file di preriscaldamento dell'applicazione durante il processo di importazione delle immagini. Ancora una volta questo è completamente facoltativo. È possibile scegliere di utilizzare questo metodo, il metodo Common Prewarm Manifest o nessun manifesto Prewarm.

## Configurazioni del catalogo delle applicazioni
<a name="application-catalog-configs"></a>

`AppCatalogConfig`che consente di specificare le applicazioni che si desidera registrare nell'immagine WorkSpaces delle applicazioni durante l'importazione dell'AMI. `AppCatalogConfig`Si tratta di un elenco JSON di oggetti di configurazione dell'applicazione con la seguente struttura.

```
[  
    {  
        "Name": "Rufus", //Required and must be unique among the list of applications  
        "DisplayName": "Rufus",  
        "AbsoluteAppPath": "Rufus", //Required  
        "AbsoluteIconPath": "Rufus",  
        "AbsoluteManifestPath": "Rufus",  
        "WorkingDirectory": "Rufus",  
        "LaunchParameters": "Rufus"  
    }  

    ...  

    // Up to 50 applications total  
 ]
```

Gli unici campi obbligatori per applicazione sono i `Name` `AbsoluteAppPath` e. I dettagli di ogni campo sono i seguenti:

Nome [**Obbligatorio**]  
+ Un nome specifico per l'applicazione per identificarla
+ Tra 1 e 100 caratteri
+ Caratteri consentiti regex `^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,99}$`
+ Deve essere unico in un dato AppCatalogConfig

DisplayName  
+ Il nome visualizzato per una determinata applicazione da mostrare agli utenti
+ Tra 0 e 100 caratteri
+ Caratteri consentiti regex `^[a-zA-Z0-9][a-zA-Z0-9_. -]{0,99}$`

AbsoluteAppPath [**Obbligatorio**]  
+ Il percorso dell'eseguibile per avviare l'applicazione
  + Questo è l'eseguibile che verrà avviato quando gli utenti selezioneranno l'applicazione
+ Tra 1 e 32767 caratteri
  + Questo limite massimo di lunghezza di caratteri serve a supportare percorsi di file estesi in Windows. Assicurati che l'AMI e l'applicazione siano configurate correttamente per supportare i percorsi di file estesi di Windows se utilizzi percorsi di file più grandi di 260 caratteri.
+ Utilizza stringhe di percorsi di file con escape, ad esempio
  + `"C:\\Windows\\System32\\notepad.exe"`

AbsoluteManifestPath  
+ Applicabile solo se si utilizza [Manifesti specifici dell'applicazione](#application-specific-manifests)
+ Percorso del preriscaldamento del file manifest per questa applicazione
+ Tra 0 e 32767 caratteri
  + Questo limite massimo di lunghezza di caratteri serve a supportare percorsi di file estesi in Windows. Assicurati che l'AMI e l'applicazione siano configurate correttamente per supportare i percorsi di file estesi di Windows se utilizzi percorsi di file più grandi di 260 caratteri.
+ Utilizza stringhe di percorsi di file con escape, ad esempio
  + `"C:\\Path\\To\\PrewarmManifest.txt"`

AbsoluteIconPath  
+ Percorso del file icona sull'AMI da utilizzare per l'applicazione.
  + Questa icona verrà mostrata agli utenti durante lo streaming su questa immagine.
  + Se non ne viene fornita alcuna, l'icona verrà derivata dall'eseguibile stesso.
  + Fai attenzione a selezionare file di icone con una trasparenza dello sfondo gestita in modo appropriato per una buona esperienza cliente per i tuoi utenti
    + Usa immagini PNG
+ Tra 1 e 32767 caratteri
  + Questo limite massimo di lunghezza di caratteri serve a supportare percorsi di file estesi in Windows. Assicurati che l'AMI e l'applicazione siano configurate correttamente per supportare i percorsi di file estesi di Windows se utilizzi percorsi di file più grandi di 260 caratteri.
+ Utilizza stringhe di percorsi di file con escape, ad esempio
  + `"C:\\Path\\To\\ApplicationIcon.png"`

WorkingDirectory  
+ La directory di lavoro in cui avviare l'applicazione
+ Tra 0 e 32767 caratteri
  + Questo limite massimo di lunghezza di caratteri serve a supportare percorsi di file estesi in Windows. Assicurati che l'AMI e l'applicazione siano configurate correttamente per supportare i percorsi di file estesi di Windows se utilizzi percorsi di file più grandi di 260 caratteri.
+ Utilizza stringhe di percorsi di file con escape, ad esempio
  + `"C:\\Path\\To\\Working\\Directory"`

LaunchParameters  
+ Una stringa da utilizzare come parametro di avvio per l'eseguibile specificato in `AbsoluteAppPath`
+ Tra 0 e 1024 caratteri
+ Utilizzate le stringhe escape con l'elenco completo dei parametri di avvio richiesti, come nell'esempio seguente che mostra come utilizzare PowerShell gli script come applicazioni utilizzando l' PowerShell eseguibile come app con uno script fornito nei parametri di avvio
  + AbsoluteAppPath
    + `"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"`
  + LaunchParameters
    + `"-File \"C:\\Path\\To\\App\\Script.ps1\""`

### Esempio AppCatalogConfig
<a name="sample-appcatalogconfig"></a>

Questo è un semplice esempio di Notepad, Google Chrome e Mozilla Firefox AppCatalogConfig 

```
[  
    {  
        "Name": "Notepad",  
        "DisplayName": "Notepad",  
        "AbsoluteAppPath": "C:\\Windows\\System32\\notepad.exe"
    },  
    {  
        "Name": "Chrome",  
        "DisplayName": "Chrome",  
        "AbsoluteAppPath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
        "LaunchParameters": "https://www.amazon.com/"  
    },  
    {  
        "Name": "Firefox",  
        "DisplayName": "Firefox",  
        "AbsoluteAppPath": "C:\\Program Files\\Mozilla Firefox\\firefox.exe",
        "LaunchParameters": "https://aws.amazon.com/"  
    }  
 ]
```

# Esporta immagine
<a name="export-image"></a>

Puoi esportare le tue immagini per crearle EC2 AMIs. Successivamente puoi [Importa immagine](import-image.md) AMIs tornare indietro per creare WorkSpaces le immagini delle Applicazioni. Questo ti aiuta a utilizzare i tuoi strumenti di personalizzazione AMI per personalizzare le tue immagini.

**Nota**  
Durante l'esportazione, i seguenti componenti verranno rimossi dalle immagini  
WorkSpaces Agente delle applicazioni
La licenza Microsoft includeva applicazioni, che venivano aggiunte utilizzando Image Builder
È possibile esportare solo immagini di Microsoft Windows Server 2022 e 2025.

## Requisiti del ruolo IAM
<a name="export-image-iam-requirements"></a>

**Importante**  
Crea un ruolo IAM con le seguenti autorizzazioni da utilizzare per l'importazione da esportare:

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Sid": "AllowCopyImage",  
            "Effect": "Allow",  
            "Action": "ec2:CopyImage",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowCreateTags",  
            "Effect": "Allow",  
            "Action": "ec2:CreateTags",  
            "Resource": "*"  
        }  
    ]  
}
```

Aggiungi la seguente relazione di fiducia per questo ruolo IAM

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Effect": "Allow",  
            "Principal": {  
                "Service": "appstream.amazonaws.com"  
            },  
            "Action": "sts:AssumeRole"  
        }  
    ]  
}
```

## Per esportare un'immagine
<a name="export-image-procedure"></a>

1. Apri la console WorkSpaces Applicazioni in [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)

1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**.

1. Nell'elenco delle immagini, seleziona l'immagine privata che desideri esportare.

1. Scegli **Azioni**, **Esporta**.

1. Nella finestra di dialogo **Esporta immagine**, digitate un **nome AMI** univoco e, facoltativamente, una **descrizione AMI** per l'AMI.

1. **Ruolo IAM**: seleziona il ruolo IAM che hai creato per l'esportazione delle immagini.

1. Facoltativamente, puoi copiare i tag dall'immagine all'AMI selezionando la casella di controllo **Copia i tag nell'esportazione**.

1. Scegli **Esporta immagine**.