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à.
# Immagini
Puoi creare immagini di Amazon WorkSpaces Applications che contengono applicazioni da trasmettere in streaming ai tuoi utenti e impostazioni predefinite di sistema e applicazioni per consentire agli utenti di iniziare rapidamente a utilizzare tali applicazioni. Tuttavia, dopo aver creato un'immagine, non puoi modificarla. 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 quel sviluppatore di immagini, avviane uno nuovo basato sulla tua immagine. Apporta quindi le modifiche e crea una nuova immagine. Per ulteriori informazioni, consultare [Avvio di uno sviluppatore di immagini per installare e configurare applicazioni per lo streaming](tutorial-image-builder-create.md) e [Tutorial: creazione di un'immagine personalizzata WorkSpaces delle applicazioni utilizzando la console WorkSpaces delle applicazioni](tutorial-image-builder.md).
Le immagini a tua disposizione sono elencate nel **registro delle immagini** nella console WorkSpaces Applicazioni. Sono classificate come pubbliche, private o condivise. È possibile utilizzare uno qualsiasi di questi tipi di immagini per avviare un generatore di immagini e configurare un parco di WorkSpaces applicazioni. Le immagini condivise sono di proprietà di altri account Amazon Web Services e sono condivise con te. Le autorizzazioni impostate per le immagini condivise possono limitare le operazioni che puoi eseguire con tali immagini. Per ulteriori informazioni, consulta [Amministra le immagini delle tue WorkSpaces applicazioni Amazon](administer-images.md).
**Topics**
+ [Impostazioni predefinite delle applicazioni e di Windows e prestazioni di avvio delle applicazioni nelle WorkSpaces applicazioni Amazon](customizing-appstream-images.md)
+ [Gestione WorkSpaces delle versioni di Applications Agent](base-images-agent.md)
+ [WorkSpaces Note sulla versione di Applications Agent](agent-software-versions.md)
+ [Tutorial: creazione di un'immagine personalizzata WorkSpaces delle applicazioni utilizzando la console WorkSpaces delle applicazioni](tutorial-image-builder.md)
+ [Amministra le immagini delle tue WorkSpaces applicazioni Amazon](administer-images.md)
+ [Crea l'immagine WorkSpaces delle tue applicazioni Amazon in modo programmatico utilizzando le operazioni CLI di Image Assistant](programmatically-create-image.md)
+ [Creazione delle immagini basate su Linux](create-linux-based-images.md)
+ [Usa gli script di sessione per gestire l'esperienza di streaming degli utenti di Amazon WorkSpaces Applications](use-session-scripts.md)
# Impostazioni predefinite delle applicazioni e di Windows e prestazioni di avvio delle applicazioni nelle WorkSpaces applicazioni Amazon
Puoi creare impostazioni di applicazioni e Windows predefinite per consentire agli utenti di utilizzare rapidamente le applicazioni senza la necessità di creare o configurare personalmente le impostazioni.
WorkSpaces Applications ottimizza le prestazioni di avvio delle applicazioni per le sessioni di streaming degli utenti. Per avere la certezza che tutti i file necessari siano inclusi in questo processo, è possibile che tu debba aggiungere manualmente alcuni file e cartelle al manifest di ottimizzazione.
**Topics**
+ [Creazione delle impostazioni predefinite delle applicazioni e di Windows per gli utenti delle applicazioni WorkSpaces](creating-default-app-Windows-settings.md)
+ [Ottimizzazione delle prestazioni di avvio delle applicazioni in Amazon WorkSpaces Applications](optimizing-app-launch-performance.md)
# Creazione delle impostazioni predefinite delle applicazioni e di Windows per gli utenti delle applicazioni WorkSpaces
Le personalizzazioni delle applicazioni e le impostazioni di Windows salvate nella cartella del profilo utente Windows o nell'hive del Registro di sistema possono essere definite come valori predefiniti. Quando salvate le impostazioni predefinite utilizzando il **Template User** in Image Assistant, WorkSpaces Applications sostituisce il profilo utente predefinito di Windows con il profilo configurato dall'utente. Il profilo utente Windows predefinito viene quindi utilizzato per creare le impostazioni iniziali per gli utenti nel parco istanze. Se le impostazioni di applicazioni o Windows che configuri non funzionano nel parco istanze, assicurati che siano salvate nel profilo utente Windows. Per ulteriori informazioni, consulta Fase 3: creazione di impostazioni di applicazioni e Windows predefinite in [Tutorial: creazione di un'immagine personalizzata WorkSpaces delle applicazioni utilizzando la console WorkSpaces delle applicazioni](tutorial-image-builder.md).
Le impostazioni predefinite che puoi creare e configurare includono:
+ Preferenze delle applicazioni, tra cui l'home page del browser, personalizzazioni della barra degli strumenti e impostazioni di sicurezza.
+ Impostazioni per i dati delle applicazioni, tra cui segnalibri del browser e profili di connessione.
+ Impostazioni dell'esperienza Windows, tra cui visualizzazione di estensioni di nomi file e cartelle nascoste.
Puoi inoltre modificare o disabilitare le impostazioni di sicurezza di Internet Explorer, come Sicurezza avanzata. Per ulteriori informazioni, consulta [Disattiva la configurazione di sicurezza avanzata di Internet Explorer nelle WorkSpaces applicazioni Amazon](customize-fleets-disable-ie-esc.md).
# Ottimizzazione delle prestazioni di avvio delle applicazioni in Amazon WorkSpaces Applications
Quando crei un'immagine, WorkSpaces Applications richiede di ottimizzare le prestazioni di avvio delle applicazioni per le sessioni di streaming degli utenti. Quando le applicazioni sono aperte durante tale processo, accertati che utilizzino i componenti iniziali richiesti dagli utenti. In questo modo, i componenti vengono acquisiti dal processo di ottimizzazione. In alcuni casi, non tutti i file necessari per le ottimizzazioni sono rilevati. Esempi di tali file sono plug-in o componenti che non sono aperti nello sviluppatore di immagini. Per essere certo che tutti i file necessari per l'applicazione vengano acquisiti, puoi includerli nel manifest di ottimizzazione. L'aggiunta di file al manifst di ottimizzazione può aumentare il tempo necessario per la creazione del parco istanze e per la messa a disposizione delle stesse agli utenti. Tuttavia, in questo modo, si riduce il tempo necessario per l'avvio dell’applicazione la prima volta nel parco istanze.
Per ottimizzare tutti i file in una cartella, apri PowerShell e usa il seguente PowerShell comando:
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```
Per impostazione predefinita, Image Assistant sostituisce il manifesto di ottimizzazione dell'applicazione ogni volta che viene eseguita la fase **Ottimizza** di Image Assistant. È necessario eseguire il PowerShell comando per ottimizzare tutti i file in una cartella:
+ Ogni volta dopo l'esecuzione della fase **Ottimizza**.
+ Prima di scegliere **Disconnetti e crea immagine** nella pagina **Rivedi** di Image Assistant.
In alternativa, è possibile specificare il manifest di ottimizzazione in base all'applicazione utilizzando le operazioni dell'interfaccia a riga di comando (CLI) di Image Assistant. **Quando si specifica il manifesto di ottimizzazione utilizzando le operazioni CLI di Image Assistant, WorkSpaces Applications unisce il manifesto di ottimizzazione dell'applicazione specificato con i file identificati dal passaggio Image Assistant Optimize.** 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).
# Gestione WorkSpaces delle versioni di Applications Agent
L'agente WorkSpaces Applications è un software che viene eseguito sulle istanze di streaming e consente agli utenti di eseguire lo streaming delle applicazioni. Quando crei una nuova immagine, l'opzione **Always use latest agent version (Usa sempre l'ultima versione dell'agente)** è selezionata per impostazione predefinita. Quando questa opzione è selezionata, i nuovi generatori di immagini o le nuove istanze del parco istanze avviate dall'immagine utilizzano sempre la versione più recente dell'agente WorkSpaces Applications. Potresti voler controllare gli aggiornamenti degli agenti per garantire la compatibilità con il software o qualificare l'ambiente aggiornato prima di distribuirlo agli utenti finali.
Le seguenti procedure descrivono come gestire le versioni dell'agente WorkSpaces Applications.
**Topics**
+ [Crea un'immagine che utilizzi sempre la versione più recente di WorkSpaces Applications Agent](create-image-that-always-uses-latest-agent.md)
+ [Create un'immagine che utilizzi una versione specifica dell'agente WorkSpaces Applications](create-image-that-uses-specific-agent.md)
+ [Create un'immagine che utilizzi una versione più recente dell' WorkSpaces Applications Agent](create-image-that-uses-newer-agent.md)
# Crea un'immagine che utilizzi sempre la versione più recente di WorkSpaces Applications Agent
Quando le immagini sono configurate per utilizzare sempre la versione più recente dell'agente WorkSpaces Applications, le istanze di streaming vengono aggiornate automaticamente con le funzionalità, i miglioramenti delle prestazioni e gli aggiornamenti di sicurezza più recenti disponibili a partire dal AWS rilascio di una nuova versione dell'agente.
**Nota**
In alcuni casi, una nuova versione dell'agente WorkSpaces Applications potrebbe essere in conflitto con il software in uso. Ti consigliamo di qualificare la nuova versione dell'agente WorkSpaces Applications prima di distribuirla nelle tue flotte di produzione.
**Per creare un'immagine che utilizzi sempre la versione più recente dell'agente Applications WorkSpaces**
1. Apri la console WorkSpaces Applicazioni a [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. Esegui una delle operazioni seguenti:
+ Se si dispone di un Image Builder che si desidera utilizzare per creare l'immagine, avviare l'Image Builder, quindi collegarsi a esso. Se il generatore di immagini non esegue la versione più recente dell'agente WorkSpaces Applications, viene richiesto di scegliere se avviare il generatore di immagini con l'agente più recente. Assicurati che questa opzione sia selezionata, scegli **Start**, quindi connetti l'Image Builder.
+ Se non disponi di un Image Builder da utilizzare per creare l'immagine, avvia un nuovo Image Builder. Nel **passaggio 1: scegli Immagine, scegli** un'immagine di AWS base o un'immagine personalizzata. Nel **passaggio 2: Configurare Image Builder**, se l'immagine scelta non esegue la versione più recente dell'agente WorkSpaces Applicazioni, viene visualizzata la sezione **WorkSpaces Applicazioni**. Nell'elenco **Agent version (Versione agente)**, selezionare la versione dell'agente più recente. Completa i passaggi rimanenti per creare l'Image Builder e collegarti a esso. Per ulteriori informazioni, consulta [Avvio di uno sviluppatore di immagini per installare e configurare applicazioni per lo streaming](tutorial-image-builder-create.md).
1. Sul desktop dell'Image Builder, aprire Image Assistant e seguire la procedura per creare la nuova immagine. Per la fase **Configure Image (Configura immagine)**, verificare che l'opzione **Always use the latest agent version (Utilizza sempre l'ultima versione agente)** sia selezionata. Per ulteriori informazioni, consulta [Tutorial: creazione di un'immagine personalizzata WorkSpaces delle applicazioni utilizzando la console WorkSpaces delle applicazioni](tutorial-image-builder.md).
Se in seguito decidete di non utilizzare sempre la versione più recente dell'agente WorkSpaces Applications, dovete creare una nuova immagine e deselezionare tale opzione.
1. Creare un nuovo parco istanze oppure modificarne uno esistente. Quando configuri il parco istanze, seleziona la nuova immagine personalizzata che hai creato. Per ulteriori informazioni, consulta [Crea una flotta e uno stack di WorkSpaces applicazioni Amazon](set-up-stacks-fleets.md).
1. Creare un nuovo stack o modificarne uno esistente e associarlo al proprio parco istanze.
# Create un'immagine che utilizzi una versione specifica dell'agente WorkSpaces Applications
Potresti voler controllare gli aggiornamenti dell'agente WorkSpaces Applications anziché utilizzare sempre la versione più recente in modo da poter prima verificare la compatibilità. Per assicurarti che la versione dell'agente WorkSpaces Applications che utilizzi sia compatibile con le tue applicazioni di streaming, puoi creare un'immagine che utilizzi una versione specifica del software dell'agente. Quindi, eseguire i test di qualifica in un parco istanze separato prima della distribuzione al parco istanze di produzione.
Quando crei l'immagine, l'opzione **Always use latest agent version (Usa sempre l'ultima versione dell'agente)** non è selezionata. In questo modo l'immagine viene aggiunta alla versione dell'agente WorkSpaces Applications selezionata all'avvio del generatore di immagini, anziché utilizzare sempre la versione più recente. Una volta completati i test di qualifica, è possibile aggiornare il parco istanze di produzione con l'immagine.
**Per creare un'immagine che utilizzi una versione specifica dell'agente Applications WorkSpaces**
1. Apri la console WorkSpaces Applicazioni a [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. Esegui una delle operazioni seguenti:
+ Se si dispone di un Image Builder che si desidera utilizzare per creare l'immagine, avviare l'Image Builder, quindi collegarsi a esso.
+ Se non disponi di un Image Builder da utilizzare per creare l'immagine, avvia un nuovo Image Builder. Nel **passaggio 1: scegli Immagine**, scegli un'immagine di AWS base o un'immagine personalizzata. Nel **passaggio 2: Configurare Image Builder**, se l'immagine scelta non esegue la versione più recente dell'agente WorkSpaces Applicazioni, viene visualizzata la sezione **WorkSpaces Applicazioni**. Nell'elenco **Agent version (Versione agente)**, non selezionare la versione dell'agente più recente. Completa i passaggi rimanenti per creare l'Image Builder e collegarti a esso. Per ulteriori informazioni, consulta [Avvio di uno sviluppatore di immagini per installare e configurare applicazioni per lo streaming](tutorial-image-builder-create.md).
1. Sul desktop dell'Image Builder, aprire Image Assistant e seguire la procedura per creare la nuova immagine. Per la fase **Configure Image (Configura immagine)** in Image Assistant, verificare che l'opzione **Always use the latest agent version (Utilizza sempre l'ultima versione agente)** non sia selezionata. Per ulteriori informazioni, consulta [Tutorial: creazione di un'immagine personalizzata WorkSpaces delle applicazioni utilizzando la console WorkSpaces delle applicazioni](tutorial-image-builder.md).
Se in seguito decidete di utilizzare sempre la versione più recente dell'agente WorkSpaces Applications, dovete creare una nuova immagine e selezionare tale opzione.
1. Creare un nuovo parco istanze oppure modificarne uno esistente. Quando configuri il parco istanze, seleziona la nuova immagine personalizzata che hai creato. Per ulteriori informazioni, consulta [Crea una flotta e uno stack di WorkSpaces applicazioni Amazon](set-up-stacks-fleets.md).
1. Creare un nuovo stack o modificarne uno esistente e associarlo al proprio parco istanze.
1. Effettuare la connessione al parco istanze e testare le applicazioni per la compatibilità.
# Create un'immagine che utilizzi una versione più recente dell' WorkSpaces Applications Agent
Se aggiungi l'immagine a una versione specifica dell'agente WorkSpaces Applications, devi aggiornarla a una versione più recente creando una nuova immagine. Questo approccio consente di testare innanzitutto la compatibilità di ogni aggiornamento dell'agente, quindi di aggiornare il parco istanze in modo incrementale.
Quando crei l'immagine, l'opzione **Always use latest agent version (Usa sempre l'ultima versione dell'agente)** non è selezionata. Dopo aver creato l'immagine, eseguire i test di qualifica in un parco istanze separato prima della distribuzione al parco istanze di produzione. Una volta completati i test di qualifica, è possibile aggiornare il parco istanze di produzione con l'immagine.
**Per creare un'immagine che utilizzi una versione più recente dell'agente Applications WorkSpaces**
1. Apri la console WorkSpaces Applicazioni a [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. Esegui una delle operazioni seguenti:
+ Se si dispone di un Image Builder che si desidera utilizzare per creare l'immagine, avviare l'Image Builder, quindi collegarsi a esso. Se il generatore di immagini non esegue la versione più recente dell'agente WorkSpaces Applications, viene richiesto di scegliere se avviare il generatore di immagini con l'agente più recente. Assicurati che questa opzione sia selezionata, scegli **Start**, quindi connetti l'Image Builder.
+ Se non disponi di un Image Builder da utilizzare per creare l'immagine, avvia un nuovo Image Builder. Nel **passaggio 1: scegli Immagine, scegli** un'immagine di AWS base o un'immagine personalizzata. Nel **passaggio 2: Configurare Image Builder**, se l'immagine scelta non esegue la versione più recente dell'agente WorkSpaces Applicazioni, viene visualizzata la sezione **WorkSpaces Applicazioni**. Nell'elenco **Agent version (Versione agente)**, selezionare la versione dell'agente più recente. Completa i passaggi rimanenti per creare l'Image Builder e collegarti a esso. Per ulteriori informazioni, consulta [Avvio di uno sviluppatore di immagini per installare e configurare applicazioni per lo streaming](tutorial-image-builder-create.md).
1. Sul desktop dell'Image Builder, aprire Image Assistant e seguire la procedura per creare la nuova immagine. Per la fase **Configure Image (Configura immagine)** in Image Assistant, verificare che l'opzione **Always use the latest agent version (Utilizza sempre l'ultima versione agente)** non sia selezionata. Per ulteriori informazioni, consulta [Tutorial: creazione di un'immagine personalizzata WorkSpaces delle applicazioni utilizzando la console WorkSpaces delle applicazioni](tutorial-image-builder.md).
Se in seguito decidete di utilizzare sempre la versione più recente dell'agente WorkSpaces Applications, dovete creare una nuova immagine e selezionare tale opzione.
1. Creare un nuovo parco istanze oppure modificarne uno esistente. Quando configuri il parco istanze, seleziona la nuova immagine personalizzata che hai creato. Per ulteriori informazioni, consulta [Crea una flotta e uno stack di WorkSpaces applicazioni Amazon](set-up-stacks-fleets.md).
1. Creare un nuovo stack o modificarne uno esistente e associarlo al proprio parco istanze.
1. Effettuare la connessione al parco istanze e testare le applicazioni per la compatibilità.
# WorkSpaces Note sulla versione di Applications Agent
Il software agente Amazon WorkSpaces Applications viene eseguito sulle tue istanze di streaming, consentendo agli utenti finali di connettersi e avviare le proprie applicazioni di streaming. A partire dal 7 dicembre 2017, le istanze di streaming possono essere aggiornate automaticamente con le funzionalità, i miglioramenti delle prestazioni e gli aggiornamenti di sicurezza più recenti disponibili presso. AWS Prima della suddetta data, gli aggiornamenti dell'agente erano inclusi nei rilasci delle nuove immagini di riferimento.
Per utilizzare il software dell'agente WorkSpaces Applications più recente, è necessario ricostruire le immagini utilizzando nuove immagini di base pubblicate a partire dal AWS 7 dicembre 2017. In questo caso, la possibilità di abilitare gli aggiornamenti automatici dell'agente è selezionata per impostazione predefinita nell'Image Assistant. Consigliamo di tenere selezionata questa opzione, in modo che qualsiasi nuovo Image Builder o parco istanze avviato dalla tua immagine utilizzi sempre l'ultima versione dell'agente. Per ulteriori informazioni, consulta [Tutorial: creazione di un'immagine personalizzata WorkSpaces delle applicazioni utilizzando la console WorkSpaces delle applicazioni](tutorial-image-builder.md).
La tabella seguente descrive gli aggiornamenti più recenti disponibili nelle versioni rilasciate dell'agente WorkSpaces Applications per le istanze di Windows.
| Versione agente Amazon WorkSpaces Applications | Modifiche |
| --- | --- |
| 02-09-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-04-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-06-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-02-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 30-09-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 15/07/2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 29-05-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-05-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-07-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-31-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-10-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 18/09-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-05-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 15/04/2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 17/01/2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-07-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-06-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 30-05-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-08-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 04-13-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-03-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-13-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 06-20-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-14-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-02-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 20-12-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 19-10-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-02-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-01-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 06-25-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 17-05-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-04-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 17/12/2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-04-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 17/12/2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-08-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-01-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 30-07/2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 27-05-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 04-20-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-19-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 13-01-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 13-11-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-10-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 23-09-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-09-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-08-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-26-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 19-06-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-05-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-04-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-03-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 22-01-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-01-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 19-12-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 17-12-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 04-12-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 14-11-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 30-10-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 24-10-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-10-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 29-08-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 26-07-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 19-06-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 06-06-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 31-05-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-05-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 19-03-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 24-01-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-12-2017 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/agent-software-versions.html) |
# Tutorial: creazione di un'immagine personalizzata WorkSpaces delle applicazioni utilizzando la console WorkSpaces delle applicazioni
Questo tutorial descrive come creare immagini di WorkSpaces applicazioni basate sui sistemi operativi Microsoft Windows Server. Se desideri creare immagini personalizzate basate sui sistemi operativi Amazon Linux 2, Rocky Linux o Red Hat Enterprise Linux, consulta[Tutorial: creazione di un'immagine personalizzata di applicazioni basate su Linux WorkSpaces](tutorial-create-linux-image.md).
In questo tutorial, imparerai come creare un'immagine Amazon WorkSpaces Applications personalizzata che contenga le applicazioni che puoi trasmettere in streaming ai tuoi utenti e le impostazioni predefinite delle applicazioni e di Windows per consentire agli utenti di iniziare rapidamente a utilizzare le loro applicazioni. Per completare questo tutorial, è necessario già disporre di un Image Builder. Se non disponi di un Image Builder, consulta [Avvio di uno sviluppatore di immagini per installare e configurare applicazioni per lo streaming](tutorial-image-builder-create.md).
**Importante**
Questo tutorial include informazioni valide per l'ultima versione dell'immagine di base. Per ulteriori informazioni, consulta [WorkSpaces Note sulla versione di Applications Base Image e Managed Image Update](base-image-version-history.md).
**Topics**
+ [Fase 1: installare le applicazioni sull'Image Builder](#tutorial-image-builder-install)
+ [Fase 2: Creare un catalogo di WorkSpaces applicazioni](#tutorial-image-builder-add)
+ [Fase 3: creazione di impostazioni di applicazioni e Windows predefinite](#tutorial-image-builder-create-default-app-settings)
+ [Fase 4: testare le applicazioni](#tutorial-image-builder-test-applications)
+ [Fase 5: ottimizzare le applicazioni](#tutorial-image-builder-optimize)
+ [Fase 6: terminare la creazione dell'immagine](#tutorial-image-builder-finish-create-image)
+ [Fase 7 (facoltativa): applicare tag e copiare un'immagine](#tutorial-image-builder-tag-copy)
+ [Fase 8: elimina](#tutorial-image-builder-finish)
## Fase 1: installare le applicazioni sull'Image Builder
In questo passaggio, viene connesso un Image Builder e vengono installate le applicazioni sull'Image Builder.
**Importante**
Per completare questa operazione, devi accedere all'Image Builder con l'account **Amministratore** locale o un account di dominio che abbia le autorizzazioni di amministratore locale. Non rinominare o eliminare l'account **Amministratore** predefinito locale. Se rinomini o elimini questo account, l'Image Buider restituirà un errore.
**Installare le applicazioni sull'Image Builder**
1. Connetti l'Image Builder in uno dei seguenti modi:
+ [Usa la console WorkSpaces Applicazioni](managing-image-builders-connect-console.md) (solo per connessioni Web)
+ [Crea un URL di streaming](managing-image-builders-connect-streaming-URL.md) (per connessioni client Web o WorkSpaces Applicazioni)
**Nota**
Se il generatore di immagini a cui desideri connetterti fa parte di un dominio Active Directory e l'organizzazione richiede l'accesso tramite smart card, devi creare un URL di streaming e utilizzare il client WorkSpaces Applications per la connessione. Per informazioni sull'accesso con smart card, consulta [Smart card](feature-support-USB-devices-qualified.md#feature-support-USB-devices-qualified-smart-cards).
1. Installare le applicazioni da un sito Web dell'applicazione o da altre origini di download. Installare le applicazioni desiderate prima di procedere con il passaggio successivo.
**Nota**
Scaricare e installare le applicazioni solo dai siti fidati.
Consentire il riavvio del sistema operativo Windows, qualora un'applicazione lo richiedesse. Prima del riavvio del sistema operativo, si è disconnessi dall'Image Builder. Una volta completato il riavvio, connettersi nuovamente all'Image Builder, quindi terminare l'installazione dell'applicazione.
## Fase 2: Creare un catalogo di WorkSpaces applicazioni
In questo passaggio, create un catalogo di WorkSpaces applicazioni specificando le applicazioni (*.exe), gli script batch (.bat**) e le scorciatoie delle applicazioni (.lnk*) per l'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. Se si sceglie un tasto rapido dell'applicazione, questi valori vengono precompilati.
**Importante**
Per completare questa operazione, è necessario aver eseguito l'accesso all'Image Builder con l'account **Amministratore** locale o un account di dominio che abbia le autorizzazioni di amministratore locale.
**Per creare un catalogo di applicazioni per le applicazioni WorkSpaces**
1. Dal desktop dell'Image Builder, aprire Image Assistant. Image Assistant guida l'utente attraverso il processo di creazione dell'immagine.
![\[Row of icons representing different functions in Image Assistant interface.\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/images/Image-Builder-Desktop-Image-Assistant.png)
1. In **1. Aggiungi app**, scegli **\$1Aggiungi app** e individua la posizione dell'applicazione, dello script o del tasto di scelta rapida da aggiungere. Seleziona **Apri**.
1. Nella finestra di dialogo **App Launch Settings (Impostazioni di avvio app)**, mantenere o modificare le impostazioni predefinite per **Name (Nome)**, **Display Name (Nome visualizzazione)** e **Icon Path (Percorso dell'icona)**. Eventualmente, è possibile specificare i parametri di avvio (ulteriori argomenti passati all'applicazione quando viene avviata) e una directory di lavoro per l'applicazione. Una volta terminato, scegli **Salva**.
Le impostazioni **Display Name (Nome visualizzazione)** e **Icon Path (Percorso dell'applicazione)** determinano le modalità di visualizzazione del nome e dell'icona dell'applicazione nel catalogo dell'applicazione. Il catalogo viene visualizzato agli utenti quando accedono a una sessione di streaming WorkSpaces delle Applicazioni.
1. Ripetere i passaggi 2 e 3 per ogni applicazione in Image Assistant e confermare che le applicazioni vengono visualizzate nella scheda **Add Apps (Aggiungi app)**. Al termine, scegliere **Next (Successivo)** per continuare a utilizzare Image Assistant per creare l'immagine.
## Fase 3: creazione di impostazioni di applicazioni e Windows predefinite
In questo passaggio, crei le impostazioni predefinite dell'applicazione e di Windows per gli utenti WorkSpaces delle Applicazioni. In questo modo gli utenti possono iniziare rapidamente a usare le applicazioni durante le sessioni di streaming WorkSpaces delle Applicazioni, senza la necessità di creare o configurare queste impostazioni da soli.
**Importante**
Per completare questa operazione, è necessario aver eseguito l'accesso all'Image Builder con l'account **Template User (Utente modello)** locale o un account utente di dominio che non abbia le autorizzazioni di amministratore locale.
**Creare impostazioni di applicazioni e Windows predefinite per gli utenti**
1. In Image Assistant, in **2. Configura app**, scegli **Cambia utente**. La sessione corrente viene disconnessa e viene visualizzato il menu di accesso.
1. Esegui una delle operazioni seguenti:
+ Se lo sviluppatore di immagini non è aggiunto a un dominio Active Directory, nella scheda **Local User (Utente locale)** scegli **Template User (Utente modello)**. Questo account consente la creazione di impostazioni di applicazioni e Windows predefinite per gli utenti.
+ Se l'Image Builder è aggiunto a un dominio Active Directory, scegliere **Directory User (Utente directory)** e accedere come utente di dominio senza autorizzazioni di amministratore locale.
1. Dal desktop dell'Image Builder, aprire Image Assistant, dove vengono visualizzate le applicazioni aggiunte al momento della creazione del catalogo di immagini.
1. Scegliere l'applicazione per cui creare le impostazioni predefinite delle applicazioni.
1. Dopo l'apertura dell'applicazione, creare queste impostazioni in base alle esigenze.
1. Al termine, chiudere l'applicazione e tornare a Image Assistant.
1. Se è stata specificata più di un'applicazione in Image Assistant, ripetere le fasi da 4 a 6 per ogni applicazione in base alle esigenze.
1. Se si desiderano impostazioni predefinite di Windows, crearle ora. Al termine, tornare a Image Assistant.
1. Scegliere **Switch user (Cambia utente)** e accedere con lo stesso account utilizzato per creare il catalogo dell'applicazione (un account che dispone di autorizzazioni di amministratore locale).
1. In Image Assistant, in **2. Configura app**, effettua una delle seguenti operazioni:
+ Se l'Image Builder non è aggiunto a un dominio Active Directory, scegliere **Save settings (Salva impostazioni)**.
+ Se l'Image Builder viene aggiunto a un dominio Active Directory, nell'elenco **Choose which user settings to copy (Scegli quale impostazione utente copiare) **scegliere lo stesso account utilizzato per accedere all'Image Builder al momento della creazione delle impostazioni di applicazioni e Windows predefinite, quindi scegliere **Save settings (Salva impostazioni)**.
L'elenco **Scegli quali impostazioni copiare** mostra qualsiasi account utente che attualmente dispone di impostazioni salvate nell'Image Builder.
1. Al termine, scegliere **Next (Successivo)** per continuare la creazione dell'immagine.
## Fase 4: testare le applicazioni
In questo passaggio, verificare che le applicazioni aggiunte si aprano correttamente e funzionino come previsto. A questo scopo, avviare una nuova sessione di Windows come utente che dispone delle stesse autorizzazioni degli utenti.
**Importante**
Per completare questa operazione, devi accedere all'Image Builder con l'account **Utente di test** o un account utente di dominio che non abbia le autorizzazioni di amministratore locale.
**Testare le applicazioni**
1. In Image Assistant, in **3. Test**, esegui una delle operazioni seguenti:
+ Se l'Image Builder non è aggiunto a un dominio Active Directory, scegliere **Switch user (Cambia utente)**.
+ Se l'Image Builder è aggiunto a un dominio Active Directory, è necessario un account di dominio per testare le applicazioni e l'utente dispone già di impostazioni nell'Image Builder, è necessario ripristinare le impostazioni dell'applicazione per l'utente. A questo scopo, selezionare l'utente dall'elenco **User to reset (Utente da ripristinare)** e scegliere **Reset (Ripristina)**. Al termine, selezionare **Switch user (Cambia utente)**.
**Nota**
Se l'Image Builder è nuova e nessun utente dispone di impostazioni nell'Image Builder, l'elenco non visualizza alcun utente.
1. Scegliere l'utente da utilizzare per i test in uno dei seguenti modi:
+ Se l'Image Builder non è aggiunto a un dominio Active Directory, scegliere **Test user (Utente di test)**. Questo account consente di testare le applicazioni utilizzando le stesse policy e le autorizzazioni degli utenti.
+ Se l'Image Builder è aggiunto a un dominio Active Directory, scegliere la scheda **Directory User (Utente directory)**, specificare le credenziali per un account di dominio senza le autorizzazioni di amministratore locale, quindi scegliere **Log in (Accedi)**.
1. Dal desktop dell'Image Builder, aprire Image Assistant, dove vengono visualizzate le applicazioni specificate al momento della creazione del catalogo di immagini.
1. Scegliere l'applicazione che si desidera testare, per confermare che si apra correttamente e che vengano applicate tutte le impostazioni predefinite delle applicazioni create.
1. Dopo l'apertura, testare l'applicazione in base alle esigenze. Al termine, chiudere l'applicazione e tornare a Image Assistant.
1. Se è stata specificata più di un'applicazione in Image Assistant, ripetere le fasi da 4 a 5 per testare ciascuna applicazione in base alle esigenze.
1. Al termine, scegliere **Switch user (Cambia utente)**, quindi procedere con una delle opzioni seguenti:
+ Se l'Image Builder non è aggiunto a un dominio Active Directory, nella scheda **Local User (Utente locale)** scegli **Administrator (Amministratore)**.
+ Se l'Image Builder è aggiunto a un dominio Active Directory e si ha effettuato l'accesso come utente di dominio con autorizzazioni di amministratore locale per specificare le applicazioni in Image Assistant, accedere come utente.
1. Scegliere **Next (Successivo)** per continuare la creazione dell'immagine.
## Fase 5: ottimizzare le applicazioni
In questa fase, Image Assistant apre le applicazioni una dopo l'altra, ne identifica le dipendenze di avvio ed esegue ottimizzazioni per garantire che le applicazioni vengano avviate in modo rapido. Queste sono fasi necessarie che vengono eseguite su tutte le applicazioni nell'elenco.
**Ottimizzare le applicazioni**
1. In Image Assistant, in **4. Ottimizza**, scegli **Avvia**.
1. WorkSpaces Applications avvia automaticamente la prima applicazione dell'elenco. Quando l'applicazione viene avviata completamente, fornire l'input richiesto per eseguire la prima esecuzione per l'applicazione. Ad esempio, un browser Web potrebbe richiedere di importare le impostazioni prima di essere completamente operativo.
1. Una volta completata la prima esecuzione e verificato che l'applicazione venga eseguita correttamente, scegliere **Continue (Continua)**. Se è stata aggiunta più di un'applicazione all'immagine, ogni applicazione si apre automaticamente. Ripetere questo passaggio per ogni applicazione in base alle esigenze, lasciando tutte le applicazioni in esecuzione.
1. Al termine, la scheda successiva in Image Assistant, **5. Viene mostrato automaticamente Configura immagine**.
## Fase 6: terminare la creazione dell'immagine
In questa fase, scegliere un nome dell'immagine e terminare la creazione dell'immagine.
**Creare l'immagine**
1. Digitare un nome univoco dell'immagine e, opzionalmente, un nome di visualizzazione dell'immagine e una descrizione. Il nome dell'immagine non può iniziare con «Amazon»AWS, "o"»AppStream.
È anche possibile aggiungere uno o più tag per l'immagine. Per fare ciò, selezionare **Add Tag (Aggiungi nuovo tag)** e digitare 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). Al termine, selezionare **Next (Successivo)**.
**Nota**
Se scegli un'immagine di base pubblicata AWS il o dopo il 7 dicembre 2017, viene visualizzata l'opzione **Usa sempre l'ultima versione dell'agente**, selezionata per impostazione predefinita. È consigliabile lasciare questa opzione selezionata, in modo che le istanze di streaming che vengono avviate dall'immagine utilizzano sempre la versione più recente dell'agente. Se disabiliti questa opzione, non è puoi abilitarla dopo aver terminato la creazione dell'immagine. Per informazioni sull'ultima versione dell'agente WorkSpaces Applications, consulta[WorkSpaces Note sulla versione di Applications Agent](agent-software-versions.md).
1. In **6. Esamina**, verifica i dettagli dell'immagine. Per apportare modifiche, scegliere **Previous (Precedente)** per individuare la scheda Image Assistant appropriata, apportare le modifiche, quindi procedere attraverso la procedura indicata in Image Assistant in base alle esigenze.
1. Dopo aver esaminato i dettagli dell'immagine, scegliere **Disconnect and Create Image (Disconnetti e crea immagine)**.
1. La sessione remota si disconnette entro pochi istanti. Quando viene visualizzato il messaggio **Lost Connectivity (Connessione persa)**, chiudere la scheda del browser. Durante la creazione dell'immagine, lo stato dell'Image Builder viene visualizzato come **Snapshotting (Creazione di snapshot)**. Non è possibile connettersi all'Image Builder fino al termine del processo.
1. Tornare alla console e passare a **Images (Immagini)**, **Image Registry (Registro immagine)**. Verificare che la nuova immagine venga visualizzata nell'elenco.
Durante la creazione dell'immagine, lo stato dell'immagine nel registro immagine della console viene visualizzato come **Pending (In attesa)** e non è possibile connettervisi.
1. Scegliere l'icona **Refresh (Aggiorna)** periodicamente per aggiornare lo stato. Durante la creazione dell'immagine, lo stato dell'immagine viene modificata in **Available (Disponibile)** e l'Image Builder viene automaticamente arrestato.
Per continuare la creazione di immagini, avviare l'Image Builder e connettersi dalla console o creare un nuovo Image Builder.
**Nota**
Dopo aver creato l'immagine, sei responsabile della gestione degli aggiornamenti per il sistema operativo Windows. A tale scopo, puoi utilizzare gli aggiornamenti gestiti WorkSpaces delle immagini delle Applicazioni. Sei inoltre responsabile della gestione degli aggiornamenti per le applicazioni e le relative dipendenze. Per ulteriori informazioni, consulta [Mantieni l'immagine WorkSpaces delle tue applicazioni Amazon Up-to-Date](keep-image-updated.md).
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.
## Fase 7 (facoltativa): applicare tag e copiare un'immagine
È possibile aggiungere uno o più tag a un'immagine durante la creazione dell'immagine o dopo aver creato un'immagine. È anche possibile copiare l'immagine all'interno della stessa regione o in una nuova regione all'interno dello stesso account Amazon Web Services. La copia di un'immagine sorgente produce un'immagine di destinazione identica ma distinta. AWS tuttavia, non copia alcun tag definito dall'utente. Inoltre, è possibile copiare solo immagini personalizzate che sono state create, non le immagini di base fornite da AWS.
**Nota**
È possibile copiare fino a due immagini in una destinazione nello stesso momento. Se la destinazione in cui si desidera copiare un'immagine è al limite dell'immagine, viene restituito un errore. Per copiare l'immagine in questo caso, è necessario prima rimuovere le immagini dalla destinazione. Dopo che la destinazione è inferiore alla quota immagine (definita anche limite), avviare la copia dell'immagine dalla regione di origine. Per ulteriori informazioni, consulta [Amazon WorkSpaces Applications Service Quotas](limits.md).
**Per aggiungere tag a un'immagine esistente**
1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**.
1. Nell'elenco di immagini, selezionare l'immagine a cui si desidera aggiungere tag.
1. Scegliere **Tags (Tag)**, **Add/Edit Tags (Aggiungi/modifica tag)**, **Add Tag (Aggiungi tag)**, specificare la chiave e il valore per il tag e selezionare **Save (Salva)**.
Per ulteriori informazioni, consulta [Etichettatura delle risorse WorkSpaces delle applicazioni Amazon](tagging-basic.md).
**Copiare un'immagine**
La copia di un'immagine su più regioni geograficamente diverse consente di effettuare lo streaming di applicazioni da più regioni in base alla stessa immagine. Effettuando lo streaming delle applicazioni in prossimità degli utenti, è possibile migliorare l'esperienza degli utenti durante lo streaming delle applicazioni con WorkSpaces Applications.
1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**.
1. Nell'elenco di immagini, selezionare l'immagine da copiare.
1. Selezionare **Actions (Operazioni)**, **Copy (Copia)**.
1. Nella finestra di dialogo **Copy Image (Copia immagine)**, specificare le informazioni seguenti, quindi scegli **Copy Image (Copia immagine):**
+ Per **Destination Region (Regione di destinazione)** scegliere la regione in cui copiare la nuova immagine.
+ Per **Name (Nome)**, specificare un nome che avrà l'immagine quando verrà copiata nella destinazione.
+ Per **Description (Descrizione)** (facoltativo), specificare una descrizione che avrà l'immagine quando verrà copiata nella destinazione.
1. Per controllare il progresso dell'operazione di copia, tornare alla console e passare a **Images (Immagini)**, **Image Registry (Registro immagine)**. Utilizzare la barra di navigazione per passare alla regione di destinazione (se applicabile) e confermare che la nuova immagine viene visualizzata nell'elenco di immagini.
La nuova immagine viene visualizzata prima con stato **Copying (Copia)** nel registro immagine della console. Dopo che l'immagine è stata creata con successo, lo stato dell'immagine viene modificato in **Available (Disponibile)**, che significa che è possibile utilizzare l'immagine per avviare uno stack ed effettuare lo streaming delle applicazioni.
## Fase 8: elimina
Infine, arrestare gli Image Builder in esecuzione per liberare le risorse ed evitare addebiti inattesi all'account. Consigliamo di arrestare qualsiasi Image Builder inutilizzato in esecuzione. Per ulteriori informazioni, consulta i [prezzi WorkSpaces delle applicazioni](https://aws.amazon.com/appstream2/pricing/).
**Arrestare un Image Builder in esecuzione**
1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Builders (Image Builder)** e selezionare l'istanza dell'Image Builder in esecuzione.
1. Scegliere **Actions (Operazioni)**, **Stop (Arresta)**.
# Amministra le immagini delle tue WorkSpaces applicazioni Amazon
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
È 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
**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
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
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
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
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
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
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
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
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
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
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
È 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
È 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
**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
**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
**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
**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
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
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
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
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
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
**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
**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
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
I dettagli delle applicazioni contengono informazioni sui manifesti preriscaldati e sulle configurazioni del catalogo delle app.
## Manifesti delle applicazioni PreWarm
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
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
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\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
`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
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
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
**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
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**.
# Crea l'immagine WorkSpaces delle tue applicazioni Amazon in modo programmatico utilizzando le operazioni CLI di Image Assistant
Puoi creare immagini di Amazon WorkSpaces Applications collegandoti a un generatore di immagini e utilizzando le operazioni dell'interfaccia utente grafica (GUI) o dell'interfaccia a riga di comando (CLI) di Image Assistant. Le operazioni dell'interfaccia a riga di comando di Image Assistant offrono funzionalità simili all’l'interfaccia grafica utente di Image Assistant. Con queste operazioni, è possibile eseguire le operazioni seguenti in modo programmatico:
+ Gestire le applicazioni che sono inclusi in un'immagine.
+ Salvare, aggiornare e ripristinare le impostazioni dell'applicazione di default.
+ Abilita o disabilita il framework applicativo dinamico delle WorkSpaces applicazioni.
+ Specificare i tag.
+ Creare un'immagine.
È possibile utilizzare queste operazioni per integrare la creazione di immagini WorkSpaces delle applicazioni con il processo di sviluppo del software di integrazione o distribuzione continua.
Per lavorare con le operazioni dell'interfaccia a riga di comando di Image Assistant, utilizzare lo shell della riga di comando a scelta su un image builder. Ad esempio, è possibile utilizzare il prompt dei comandi di Windows o PowerShell.
**Nota**
Il generatore di immagini deve utilizzare una versione dell'agente WorkSpaces Applicazioni rilasciata a partire dal 26 luglio 2019. Se non si dispone di un image builder, è necessario crearne uno. Per ulteriori informazioni, consulta [Avvio di uno sviluppatore di immagini per installare e configurare applicazioni per lo streaming](tutorial-image-builder-create.md).
**Topics**
+ [Creazione di applicazioni di default e impostazioni di Windows con le operazioni dell'interfaccia a riga di comando di Image Assistant](create-default-app-windows-settings-image-assistant.md)
+ [Ottimizzazione delle performance di avvio delle applicazioni con le operazioni dell'interfaccia a riga di comando di Image Assistant](optimize-app-launch-performance-image-assistant-cli.md)
+ [Panoramica del processo per la creazione programmatica di un'immagine di Amazon Applications WorkSpaces](process-overview-creating-image-programmatically-image-assistant-cli.md)
+ [Operazioni CLI di Image Assistant per la creazione e la gestione dell'immagine delle applicazioni Amazon WorkSpaces](cli-operations-managing-creating-image-image-assistant.md)
# Creazione di applicazioni di default e impostazioni di Windows con le operazioni dell'interfaccia a riga di comando di Image Assistant
È possibile creare applicazioni di default e le impostazioni di Windows in modo che gli utenti possono iniziare a utilizzare le proprie applicazioni in modo rapido. Quando si creano queste impostazioni, WorkSpaces Applications sostituisce il profilo utente predefinito di Windows con il profilo configurato dall'utente. Il profilo utente Windows predefinito viene quindi utilizzato per creare le impostazioni iniziali per gli utenti nel parco istanze. Se si creano queste impostazioni utilizzando l'interfaccia a riga di comando di Image Assistant, le operazioni di installazione, o l'automazione, devono modificare il profilo utente predefinito direttamente.
Per sovrascrivere il profilo utente predefinito di Windows con quello di un altro utente Windows, puoi utilizzare anche l'operazione `update-default-profile` della CLI di Image Assistant.
Per ulteriori informazioni sulla configurazione delle impostazioni predefinite dell'applicazione e di Windows, vedere *Creazione di applicazioni predefinite e impostazioni Windows per gli utenti WorkSpaces delle applicazioni* in. [Impostazioni predefinite delle applicazioni e di Windows e prestazioni di avvio delle applicazioni nelle WorkSpaces applicazioni Amazon](customizing-appstream-images.md)
# Ottimizzazione delle performance di avvio delle applicazioni con le operazioni dell'interfaccia a riga di comando di Image Assistant
WorkSpaces Applications consente di ottimizzare le prestazioni di avvio delle applicazioni per le sessioni di streaming degli utenti. Quando si effettua questa operazione utilizzando l'interfaccia a riga di comando di Image Assistant, è possibile specificare i file per ottimizzare l'avvio dell’applicazione. Aggiungere i file al manifest di ottimizzazione dell'applicazione riduce il tempo necessario per l'avvio dell’applicazione per la prima volta su un nuovo parco istanze. Tuttavia, ciò aumenta anche il tempo necessario per consentire al parco istanze di essere disponibile agli utenti. Il manifest di ottimizzazione è un file di testo delimitato da tabulazioni per applicazione.
**Nota**
Se si esegue l’onboarding dei manifest di ottimizzazione dell'applicazione utilizzando sia le operazioni dell'interfaccia a riga di comando (CLI) sia la GUI di Image Assistant, allora i manifest si uniscono.
Di seguito è riportato un esempio di file manifesto di ottimizzazione dell'applicazione:
```
C:\Program Files (x86)\Notepad++\autoCompletion
C:\Program Files (x86)\Notepad++\localization
C:\Program Files (x86)\Notepad++\plugins
C:\Program Files (x86)\Notepad++\themes
C:\Program Files (x86)\Notepad++\updater
C:\Program Files (x86)\Notepad++\userDefineLangs
C:\Program Files (x86)\Notepad++\change.log
C:\Program Files (x86)\Notepad++\config.xml
C:\Program Files (x86)\Notepad++\contextMenu.xml
C:\Program Files (x86)\Notepad++\doLocalConf.xml
C:\Program Files (x86)\Notepad++\functionList.xml
C:\Program Files (x86)\Notepad++\langs.model.xml
C:\Program Files (x86)\Notepad++\license.txt
C:\Program Files (x86)\Notepad++\notepad++.exe
C:\Program Files (x86)\Notepad++\readme.txt
C:\Program Files (x86)\Notepad++\SciLexer.dll
C:\Program Files (x86)\Notepad++\shortcuts.xml
C:\Program Files (x86)\Notepad++\stylers.model.xml
```
Per ulteriori informazioni su come ottimizzare le prestazioni di avvio delle applicazioni, vedere *Ottimizzare le prestazioni di avvio delle applicazioni* in [Impostazioni predefinite delle applicazioni e di Windows e prestazioni di avvio delle applicazioni nelle WorkSpaces applicazioni Amazon](customizing-appstream-images.md).
# Panoramica del processo per la creazione programmatica di un'immagine di Amazon Applications WorkSpaces
È possibile utilizzare le operazioni CLI di Image Assistant con l'automazione dell'installazione delle applicazioni per creare un flusso di lavoro di creazione di immagini WorkSpaces delle applicazioni completamente programmatico. Quando l’automazione dell’installazione dell’applicazione è completa, ma prima che l'immagine venga creata, utilizzare le operazioni dell'interfaccia a riga di comando (CLI) di Image Assistant per specificare le operazioni seguenti:
+ Il file eseguibili che gli utenti possono avviare
+ I manifest di ottimizzazione per le applicazioni
+ Metadati delle immagini di altre WorkSpaces applicazioni
La seguente panoramica di alto livello descrive il processo di creazione programmatica di un'immagine delle applicazioni. WorkSpaces
1. Usa l’automazione di installazione dell’applicazione per installare le applicazioni necessarie per l’image builder. Questa installazione può includere le applicazioni che gli utenti lanceranno, eventuali dipendenze e le applicazioni in background.
1. Determinare i file e le cartelle da ottimizzare.
1. Se applicabile, utilizzate l'operazione `add-application` CLI di Image Assistant per specificare i metadati dell'applicazione e il manifesto di ottimizzazione per l' WorkSpaces immagine Applications.
1. Per specificare applicazioni aggiuntive per l'immagine WorkSpaces Applications, ripetete i passaggi da 1 a 3 per ciascuna applicazione, se necessario.
1. Se applicabile, utilizzare l'operazione dell’interfaccia a riga di comando `update-default-profile` di Image Assistant per sovrascrivere il profilo Windows predefinito e creare applicazioni e impostazioni Windows predefinite per gli utenti.
1. Utilizzare l’operazione `create-image` dell’interfaccia a riga di comando di Image Assistant per creare l'immagine.
# Operazioni CLI di Image Assistant per la creazione e la gestione dell'immagine delle applicazioni Amazon WorkSpaces
Questa sezione descrive le operazioni CLI di Image Assistant che è possibile utilizzare per creare e gestire l'immagine WorkSpaces delle applicazioni.
Nei generatori di immagini Windows, il file eseguibile che include l'interfaccia della riga di comando si trova in: C:\$1Program Files\$1 Amazon\$1 Photon\$1ConsoleImageBuilder\$1 Image-Assistant.exe. Per praticità, questo file eseguibile è incluso nella variabile PATH di Windows. Questo servizio consente di chiamare le operazioni dell'interfaccia a riga di comando di Image Assistant senza specificare il percorso assoluto al file eseguibile. Per chiamare queste operazioni, digitare il comando **image-assistant.exe**.
Nei generatori di immagini Linux, lo strumento di assistenza alle immagini si trova in/. usr/local/appstream/image-assistant/AppStreamImageAssistant, with a symbolic link at /bin/AppStreamImageAssistant
## Operazione `help`
Consente di recuperare un elenco di tutte le operazioni dell'interfaccia a riga di comando di Image Assistant. Per ogni operazione nell'elenco, vengono fornite una descrizione e una sintassi di utilizzo. Per visualizzare la Guida per un'operazione specifica, digitare il nome dell'operazione e specificare il parametro **-help**. Esempio:
```
add-application --help
```
**Riepilogo**
```
help
```
**Output**
Stampa in formato standard l'elenco di operazioni disponibili con una descrizione della loro funzione.
## Operazione `add-application`
Aggiunge l'applicazione all'elenco delle applicazioni per gli utenti delle WorkSpaces Applicazioni. Le applicazioni in questo elenco sono incluse nel catalogo delle applicazioni. Il catalogo delle applicazioni viene visualizzato agli utenti quando accedono a una sessione di streaming WorkSpaces delle applicazioni.
**Nota**
Se devi apportare modifiche alla configurazione di un'applicazione, rimuovi l'applicazione e aggiungi l'applicazione con le impostazioni aggiornate.
**Riepilogo**
```
add-application
--name
--absolute-app-path
[--display-name ]
[--absolute-icon-path ]
[--working-directory ]
[--launch-parameters <""-escaped value>]
[--absolute-manifest-path ]
```
**Opzioni**
**`--name` (Stringa)**
Un nome univoco per l'applicazione. La lunghezza massima è 256 caratteri. È possibile aggiungere fino a un massimo di 50 applicazioni. Non è possibile utilizzare caratteri di spazio.
**`--absolute-app-path` (Stringa)**
Il percorso assoluto al file eseguibile, un file batch o uno script per l'applicazione. Il percorso deve puntare a un file valido.
**`--display-name` (Stringa)**
Il nome da visualizzare per l'applicazione nel catalogo dell'applicazione. Se non si specifica un nome visualizzato, WorkSpaces Applications crea un nome derivato dal nome del file eseguibile. Il nome viene creato senza l'estensione del file e con il carattere di sottolineatura al posto degli spazi. La lunghezza massima è 256 caratteri.
**`--absolute-icon-path` (Stringa)**
Il percorso assoluto all'icona per l'applicazione. Il percorso deve puntare a un file icona valido con uno dei seguenti formati: .jpg, .png o bmp. Le dimensioni massime sono: 256 px x 256 px. Se non si specifica un percorso, viene utilizzata l'icona predefinita per il file eseguibile, se disponibile. Se non è disponibile un'icona predefinita per il file eseguibile, viene utilizzata un'icona predefinita dell'applicazione WorkSpaces Applications.
**`--working-directory` (Stringa)**
La directory di lavoro iniziale per l'applicazione quando l'applicazione viene avviata.
**`--absolute-manifest-path` (Stringa)**
Il percorso a un nuovo file di testo delimitato. Il file specifica i percorsi assoluti dei file per l’ottimizzazione prima che il parco istanze sia disponibile a un utente per lo streaming. Il percorso deve puntare a un file di testo valido.
**Output messaggio**
| Codice di uscita | Messaggio stampato per standard in uscita | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | L'applicazione è stata aggiunta correttamente. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Sono necessari i privilegi di amministratore per completare l'operazione. |
| 1 | \$1"status": 1, "message": "Unable to add more than 50 apps to the catalog."\$1 | Impossibile aggiungere l'applicazione perché il numero massimo di applicazioni che è possibile aggiungere al catalogo delle WorkSpaces applicazioni Applicazioni è 50. |
| 1 | \$1"status": 1, "messaggio": "Nome non è univoco"\$1 | Un'applicazione con quel nome esiste già nel catalogo delle WorkSpaces applicazioni Applicazioni. |
| 1 | \$1"status»: 1, «message»: «File non trovato (absolute-app-path)"\$1 | Il file che è stato specificato per absolute-app-path non è disponibile. |
| 1 | \$1"status": 1, "message": "Unsupported file extension"\$1 | Il parametro Absolute-app-path supporta solo i seguenti tipi di file: .exe e .bat. |
| 1 | \$1"status": 1, "message": "Directory not found (working-directory)" | La directory specificata per working-directory non è stata trovata. |
| 1 | \$1"status": 1, "message": "Optimization-manifest not found: "\$1 | Il file che è stato specificato per optimization-manifest non è disponibile. |
| 1 | \$1"status": 1, "message": "File not found: "\$1 | Un file che è stato specificato all'interno del manifest di ottimizzazione non è stato trovato. |
| 255 | \$1"status": 255, "message": \$1 | Si è verificato un errore imprevisto. Prova di nuovo la richiesta. Se l'errore persiste, contatta Supporto AWS per ricevere assistenza. Per ulteriori informazioni, consulta [Centro di Supporto AWS](https://console.aws.amazon.com/support/home#/). |
## Operazione `remove-application`
Rimuove un'applicazione dall'elenco delle applicazioni per l'immagine WorkSpaces Applicazioni. L'applicazione non viene disinstallata o modificata, ma gli utenti non saranno in grado di avviarla dal catalogo delle WorkSpaces applicazioni Applicazioni.
**Riepilogo**
```
remove-application
--name
```
**Opzioni**
**`--name` (Stringa)**
Identificatore univoco dell'applicazione da rimuovere.
**Output messaggio**
| Codice di uscita | Messaggio stampato per standard in uscita | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | L'applicazione è stata rimossa correttamente. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Sono necessari i privilegi di amministratore per completare l'operazione. |
| 1 | \$1"status": 1, "message": "App not found"\$1 | L'applicazione specificata non è stata trovata nel catalogo delle WorkSpaces applicazioni Applicazioni. |
| 255 | \$1"status": 255, "message": \$1 | Si è verificato un errore imprevisto. Prova di nuovo la richiesta. Se l'errore persiste, contatta Supporto AWS per ricevere assistenza. Per ulteriori informazioni, consulta [Centro di Supporto AWS](https://console.aws.amazon.com/support/home#/). |
## Operazione `list-applications`
Elenca tutte le applicazioni che sono specificate nel catalogo delle applicazioni.
**Riepilogo**
```
list-applications
```
**Output messaggio**
| Codice di uscita | Messaggio stampato per standard in uscita | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success", "applications": [ \$1..app1.. \$1, \$1 ..app2.. \$1]\$1 | Elenco delle applicazioni nel catalogo delle WorkSpaces applicazioni Applicazioni. |
| 255 | \$1"status": 255, "message": \$1 | Si è verificato un errore imprevisto. Prova di nuovo la richiesta. Se l'errore persiste, contatta Supporto AWS per ricevere assistenza. Per ulteriori informazioni, consulta [Centro di Supporto AWS](https://console.aws.amazon.com/support/home#/). |
## Operazione `update-default-profile`
Copia il profilo utente di Windows specificato sul profilo utente predefinito di Windows. I nuovi utenti che eseguono lo streaming ereditano le impostazioni memorizzate nel profilo specificato.
**Nota**
Questa operazione non è supportata dallo strumento CLI di Image Assistant di Linux.
**Riepilogo**
```
update-default-profile
[--profile ]
```
**Opzioni**
**`--profile` (Stringa)**
Il nome dell'utente del profilo di Windows sarà copiato nel profilo utente predefinito di Windows. Utilizza il seguente formato per il nome:
"\$1"
Se l'Image Builder non è stato aggiunto a un dominio Microsoft Active Directory, immettere un punto "." per il dominio. Se non si specifica un utente, viene utilizzato l'account WorkSpaces Applications Template User.
**Output messaggio**
| Codice di uscita | Messaggio stampato per standard in uscita | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | Le impostazioni utente sono state copiate correttamente nel profilo di default di Windows. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Sono necessari i privilegi di amministratore per completare l'operazione. |
| 1 | \$1"status": 1, "message": "Unable to copy file or folder: . "\$1 | Non è stato possibile copiare le impostazioni dell'utente perché un file o una cartella non erano disponibili. |
| 1 | \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1 | Un utente di dominio Microsoft Active Directory è stato specificato, ma l'Image Builder non viene aggiunto a un dominio Active Directory. |
| 255 | \$1"status": 255, "message": \$1 | Si è verificato un errore imprevisto. Prova di nuovo la richiesta. Se l'errore persiste, contatta Supporto AWS per ricevere assistenza. Per ulteriori informazioni, consulta [Centro di Supporto AWS](https://console.aws.amazon.com/support/home#/). |
## Operazione `reset-user-profile`
Elimina il profilo utente di Windows per l'utente specificato.
**Nota**
Questa operazione non è supportata dallo strumento CLI di Image Assistant di Linux.
**Riepilogo**
```
reset-user-profile
[--profile ]
```
**Opzioni**
**`--profile` (Stringa)**
Il nome dell'utente Windows il cui profilo di Windows verrà eliminato. Utilizza il seguente formato per il nome:
"\$1"
Se l'Image Builder non è stato aggiunto a un dominio Microsoft Active Directory, immettere un punto "." per il dominio.
**Output messaggio**
| Codice di uscita | Messaggio stampato per standard in uscita | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | Le impostazioni dell'utente specificato sono state eliminate correttamente. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Sono necessari i privilegi di amministratore per completare l'operazione. |
| 1 | \$1"status": 1, "message": "Unable to copy file or folder: . "\$1 | Le impostazioni dell'utente non possono essere reimpostate perché un file o una cartella non era disponibile. |
| 1 | \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1 | Un utente di dominio Microsoft Active Directory è stato specificato, ma l'Image Builder non viene aggiunto a un dominio Active Directory. |
| 255 | \$1"status": 255, "message": \$1 | Si è verificato un errore imprevisto. Prova di nuovo la richiesta. Se l'errore persiste, contatta Supporto AWS per ricevere assistenza. Per ulteriori informazioni, consulta [Centro di Supporto AWS](https://console.aws.amazon.com/support/home#/). |
## Operazione `create-image`
Avvia il flusso di lavoro per la creazione dell'immagine, generando un'immagine WorkSpaces delle applicazioni che può essere utilizzata per i parchi di WorkSpaces applicazioni.
**Riepilogo**
```
create-image
--name
[--description ]
[--display-name ]
[--enable-dynamic-app-catalog] | [--no-enable-dynamic-app-catalog]
[--use-latest-agent-version] | [--no-use-latest-agent-version]
[--tags ]
[--dry-run]
```
**Opzioni**
**`--name` (Stringa)**
Il nome dell'immagine delle WorkSpaces applicazioni. Il nome deve essere univoco all'interno dell'account e della AWS regione Amazon Web Services. La lunghezza massima è 100 caratteri. I caratteri consentiti sono:
a-z, A-Z, 0-9, caratteri di sottolineatura (\$1), trattini (-) e punti (.)
Il nome dell'immagine non può iniziare con uno dei seguenti prefissi: “aws”, “appstream” e “amazon”. Questi prefissi sono riservati per l'utilizzo di AWS .
**`--description` (Stringa)**
La descrizione da visualizzare per l'immagine. La lunghezza massima è 256 caratteri.
**`--display-name` (Stringa)**
Il nome da visualizzare per l'immagine. La lunghezza massima è 256 caratteri.
**`--enable-dynamic-app-catalog` \$1 `--no-enable-dynamic-app-catalog`**
Abilita o disabilita il supporto per il framework applicativo dinamico WorkSpaces delle applicazioni. Se non si specifica un parametro, il supporto per il framework di applicazioni dinamiche non è abilitato.
Il framework applicativo dinamico fornisce operazioni all'interno di un'istanza di streaming di WorkSpaces Applicazioni che è possibile utilizzare per creare un provider di app dinamico. I provider di app dinamiche possono utilizzare queste operazioni per modificare il catalogo delle applicazioni a cui gli utenti possono accedere in tempo reale. Per ulteriori informazioni, consulta [Utilizza l' WorkSpaces Applications Dynamic Application Framework per creare un provider di app dinamico](build-dynamic-app-provider.md).
**`--use-latest-agent-version` \$1 `--no-use-latest-agent-version`**
Speciifica se aggiungere l'immagine alla versione dell'agente WorkSpaces Applicazioni attualmente installata o utilizzare sempre la versione più recente dell'agente. Se non si specifica nessuno dei parametri, l'immagine viene aggiunta alla versione dell'agente WorkSpaces Applications attualmente installata. Per ulteriori informazioni, consulta [Gestione WorkSpaces delle versioni di Applications Agent](base-images-agent.md).
**`--tags` (Stringa)**
I tag da associare all'immagine. Un tag è una coppia chiave-valore. Utilizza il seguente formato:
--tags "mykey" "myval" "mykey2" "myval2"
Per ulteriori informazioni sui tag, consulta [Etichettatura delle risorse WorkSpaces delle applicazioni Amazon](tagging-basic.md).
**`--dry-run` (Stringa)**
Esegue la convalida senza creare l'immagine. Utilizzare questo comando per identificare se l'immagine dispone di eventuali problemi prima della creazione.
**Output messaggio**
| Codice di uscita | Messaggio stampato per standard in uscita | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | Il flusso di lavoro per creare l'immagine è stato avviato correttamente. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Sono necessari i privilegi di amministratore per completare l'operazione. |
| 1 | \$1"status": 1, "message": "An image with the given name already exists"\$1 | Un’immagine con il nome specificato esiste già nell'account di Amazon Web Services. |
| 1 | \$1"status": 1, "message": "Invalid value (tags)"\$1 | I tag specificati non sono validi. |
| 255 | \$1"status": 255, "message": \$1 | Si è verificato un errore imprevisto. Prova di nuovo la richiesta. Se l'errore persiste, contatta Supporto AWS per ricevere assistenza. Per ulteriori informazioni, consulta [Centro di Supporto AWS](https://console.aws.amazon.com/support/home#/). |
# Creazione delle immagini basate su Linux
Puoi creare immagini WorkSpaces Amazon Applications basate su Linux connettendoti a un generatore di immagini Linux, installando le applicazioni necessarie, creando impostazioni applicative e variabili di ambiente predefinite e utilizzando uno strumento di interfaccia a riga di comando (CLI) o uno strumento Image Assistant (GUI) per aggiungere queste applicazioni al catalogo delle applicazioni. Per aprire lo strumento GUI, cerca **Image Assistant** nell'elenco delle applicazioni.
**Topics**
+ [Creazione di impostazioni predefinite delle applicazioni per gli utenti](create-default-app-settings.md)
+ [Creazione di variabili di ambiente predefinite per gli utenti Linux](create-default-variables-linux.md)
+ [Ottimizzazione delle prestazioni di avvio delle applicazioni Linux](optimize-launch-performance.md)
+ [Creazione di script di sessione](create-session-scripts.md)
+ [Utilizzo dello strumento CLI di Image Assistant per Linux](image-assistant-cli.md)
+ [Abilitazione e disattivazione del supporto per webcam](webcam-support.md)
+ [Abilitazione e disabilitazione della modalità Heavy File Sync per le cartelle Home](heavy-file-sync.md)
+ [Tutorial: creazione di un'immagine personalizzata di applicazioni basate su Linux WorkSpaces](tutorial-create-linux-image.md)
+ [Tutorial: abilitare il supporto per la lingua giapponese per le immagini Linux](enable-japanese-support-linux.md)
# Creazione di impostazioni predefinite delle applicazioni per gli utenti
Segui questi passaggi per creare impostazioni predefinite delle applicazioni per i tuoi utenti.
**Topics**
+ [Fase 1: installazione delle applicazioni sull'Image Builder](#app-settings-image-install)
+ [Fase 2: Crea un account TemplateUser](#app-settings-template-user)
+ [Fase 3: creazione di impostazioni predefinite delle applicazioni](#app-settings-image-create-default-app-settings)
+ [Fase 4: salvataggio delle impostazioni predefinite delle applicazioni](#app-settings-image-save-default-app-settings)
+ [Fase 5: Verifica delle impostazioni predefinite dell'applicazione (facoltativo)](#app-settings-image-test-applications)
+ [Passaggio 6: Pulizia](#app-settings-image-finish)
## Fase 1: installazione delle applicazioni sull'Image Builder
In questa fase, connetti un Image Builder Linux e installi le applicazioni sull'Image Builder.
**Installare le applicazioni sull'Image Builder**
1. Connetti l'Image Builder in uno dei seguenti modi:
+ [Utilizza la console WorkSpaces Applicazioni](managing-image-builders-connect-console.md) (solo per connessioni Web)
+ [Crea un URL di streaming](managing-image-builders-connect-streaming-URL.md) (per connessioni client Web o WorkSpaces Applicazioni)
**Nota**
Accederai come ImageBuilderAdmin utente al desktop Amazon Linux GNOME e disporrai dei privilegi di amministratore root.
1. Installa le applicazioni necessarie. Ad esempio, per installare un browser Chromium da un repository yum pubblico, apri prima l'applicazione Terminale, quindi esegui il seguente comando:
**[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164**
## Fase 2: Crea un account TemplateUser
In questo passaggio, crei un TemplateUser account, che crea le impostazioni predefinite dell'applicazione per gli utenti di streaming.
**Per creare un TemplateUser account**
1. Crea un TemplateUser account senza permessi di root. Ad esempio, in una finestra del Terminale, esegui i seguenti comandi da creare TemplateUser sul generatore di immagini:
**[ImageBuilderAdmin]\$1 sudo useradd -m TemplateUser**
**[ImageBuilderAdmin]\$1 echo -e '<*password*>\$1n<*password*>\$1n' \$1 sudo passwd TemplateUser**
1. Passa all' TemplateUser account:
**[ImageBuilderAdmin]\$1 su - TemplateUser**
## Fase 3: creazione di impostazioni predefinite delle applicazioni
In questo passaggio, crei le impostazioni predefinite delle applicazioni per gli utenti WorkSpaces delle Applicazioni. In questo modo gli utenti possono iniziare rapidamente a usare le applicazioni durante le sessioni di streaming WorkSpaces delle Applicazioni, senza la necessità di creare o configurare queste impostazioni da soli.
**Per creare impostazioni di applicazioni e Windows predefinite per gli utenti**
1. Avvia l'applicazione per cui creare le impostazioni predefinite. Ad esempio, in una finestra del Terminale, esegui il seguente comando per avviare il browser Chromium:
**[TemplateUser]\$1 chromium-browser**
1. Configurazione delle impostazioni delle applicazioni. Ad esempio, imposta la home page del browser Chromium come. **https://aws.amazon.com**.
1. Chiudi le applicazioni.
1. Effettua la disconnessione:
**[TemplateUser]\$1 logout**
## Fase 4: salvataggio delle impostazioni predefinite delle applicazioni
In questa fase, copia le impostazioni predefinite dell'applicazione che hai aggiunto alla directory **/etc/skel/** e rendile disponibili agli utenti di streaming.
**Per salvare le impostazioni predefinite delle applicazioni**
+ Per copiare le impostazioni predefinite dell'applicazione per gli utenti di streaming, esegui il seguente comando in una finestra del Terminale:
**[ImageBuilderAdmin]\$1 sudo cp -r -f /home/TemplateUser/. /etc/skel**
## Fase 5: Verifica delle impostazioni predefinite dell'applicazione (facoltativo)
In questa fase, verifica che le applicazioni che hai aggiunto funzionino correttamente e che le impostazioni predefinite dell'applicazione funzionino come previsto.
**Test delle applicazioni e delle impostazioni predefinite su un Image Builder**
1. Crea un utente di test senza autorizzazioni root. Ad esempio, in una finestra di **Terminale**, esegui i seguenti comandi per creare **test-user** sull'Image Builder:
**[ImageBuilderAdmin]\$1 sudo useradd -m test-user**
**[ImageBuilderAdmin]\$1 echo -e '*password*>\$1n<*password*>\$1n' \$1 sudo passwd test-user**
1. Passa all'utente di test:
**[ImageBuilderAdmin]\$1 su - test-user**
1. Avvia l'applicazione (ad esempio, Chromium) come utente di test:
**[test-user]\$1 /usr/bin/chromium-browser**
1. Verifica che le impostazioni predefinite siano disponibili per l'utente di test (ad esempio, la home page di Chromium è https://aws.amazon.com/).
1. Effettua la disconnessione:
**[test-user]\$1 logout**
## Passaggio 6: Pulizia
Infine, l'ultima fase è quella della pulizia.
**Per eliminare**
1. Elimina: TemplateUser
**[ImageBuilderAdmin]\$1 sudo killall -u TemplateUser**
**[ImageBuilderAdmin]\$1 sudo userdel -r TemplateUser**
1. Elimina test-user (non richiesto se hai saltato il passaggio 5):
**[ImageBuilderAdmin]\$1 sudo killall -u test-user**
**ImageBuilderAdmin]\$1 sudo userdel -r test-user**
# Creazione di variabili di ambiente predefinite per gli utenti Linux
Puoi creare variabili di ambiente su un'istanza dell'Image Builder Linux. La creazione di variabili di ambiente le rende disponibili su istanze di streaming create da quell'immagine.
**Nota**
Nelle istanze Linux fleet, le variabili di ambiente impostate utilizzando lo strumento Image Assistant (GUI) e le variabili di ambiente di sistema predefinite vengono esportate tramite lo script/etc/profile.d/appstream\$1system\$1vars.sh script. To access these environment variables, you must explicitly source the /etc/profile.d/appstream\$1system\$1vars.sh nelle applicazioni.
**Per creare variabili di ambiente per gli utenti**
1. Se la cartella `/etc/profile` non esiste, per crearla esegui il comando seguente:
**[ImageBuilderAdmin]\$1 sudo mkdir -p /etc/profile.d**
1. Per creare un nuovo file di script di shell (ad esempio, my-environment.sh) in questa cartella, esegui il comando seguente:
**[ImageBuilderAdmin]\$1 vim my-environment.sh**
1. Nella prima riga del file di script, aggiungi i seguenti contenuti:
**\$1\$1/bin/sh **
1. Per ogni riga successiva, aggiungi un comando **export** per impostare le variabili di ambiente per l'immagine. Nell'esempio seguente viene aggiunto `$HOME/bin` alla variabile `PATH`:
**export PATH=”\$1HOME/bin:\$1PATH”**
1. Premi il tasto **Esc** per tornare alla modalità di comando in vim, quindi esegui il seguente comando per salvare lo script ed uscire da vim:
**:x**
1. Esegui il comando seguente per consentire l'esecuzione dello script come programma:
**[ImageBuilderAdmin]\$1 chmod \$1x my-environment.sh**
# Ottimizzazione delle prestazioni di avvio delle applicazioni Linux
Se utilizzi lo strumento GUI di Image Assistant, questo ottimizza automaticamente le prestazioni di avvio delle applicazioni.
Se utilizzi la CLI di Image Assistant, utilizza la procedura seguente per ottimizzare manualmente le prestazioni di avvio. Quando creano e si aggiungono file a un manifesto di ottimizzazione dell'applicazione, l'applicazione si avvia più velocemente quando viene avviata per la prima volta su una nuova istanza del parco istanze. Tuttavia, ciò aumenta anche il tempo necessario per consentire al parco istanze di essere disponibile agli utenti. Il manifesto di ottimizzazione è un file di testo delimitato da tabulazioni per ciascuna applicazione.
È possibile creare un file manifest (ad esempio < *your-app* >-manifest.txt) manualmente o seguendo i passaggi seguenti.
**Per creare un file manifest**
1. Assicurati che l'applicazione che stai cercando di ottimizzare sia avviata e in esecuzione.
1. Da un terminale dell'Image Builder di Linux, esegui il comando seguente:
**ps -ef \$1 grep <*application-process-name*>**
1. Cerca il numero PID più piccolo dall'output dell'ultima fase. Questo è il PID per il processo principale dell'applicazione.
1. Mantieni l'applicazione in esecuzione e assicurati di utilizzare i componenti iniziali richiesti dagli utenti. In questo modo, i componenti vengono acquisiti dal processo di ottimizzazione.
1. Crea un file script (ad esempio, `~/getfilestool.sh`) con i seguenti contenuti:
```
#!/bin/bash
## usage getfilestool.sh $pid
lsof -p $(pstree -p $1 | grep -o '([0-9]\+)' | grep -o '[0-9]\+' | tr '\012' ,)|grep REG | sed -n '1!p' | awk '{print $9}'|awk 'NF'
```
1. Assicurati che il file possa essere eseguito con il seguente comando:
**[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**
1. Esegui il comando seguente per acquisire tutti i file in esecuzione dal processo principale individuato nella fase 3 e salvali in un file manifesto temporaneo.
**[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh <*root-parent-pid*> > /tmp/-manifest.txt **
1. Verifica il contenuto del manifesto di ottimizzazione, che è un file di testo delimitato da righe per ogni applicazione.
In alternativa, puoi specificare il manifesto di ottimizzazione in base all'applicazione utilizzando le operazioni dell'interfaccia della linea di comando (CLI) di Image Assistant. Per ulteriori informazioni, consulta [Utilizzo dello strumento CLI di Image Assistant per Linux](image-assistant-cli.md).
# Creazione di script di sessione
WorkSpaces Applications fornisce script di sessione su istanze di streaming basate su Windows e Linux. Per ulteriori informazioni sugli script di sessione, consulta [Usa gli script di sessione per gestire l'esperienza di streaming degli utenti di Amazon WorkSpaces Applications](use-session-scripts.md).
Gli script di sessione sono specificati all'interno di un'immagine Applications. WorkSpaces Per individuare il file di configurazione degli script di sessione su un'istanza Linux, accedi a `/opt/appstream/SessionScripts/config.json`. Il codice seguente è un file `config.json` di esempio che specifica uno script di inizio sessione denominato "`test-session-start`" e uno script di fine sessione denominato "`test-session-stop`" insieme ai relativi parametri di runtime. Assicurati che gli script a cui si fa riferimento in `config.json` dispongano delle autorizzazioni di esecuzione e che sia definito un interprete dei comandi (ad esempio, \$1\$1/bin/bash).
```
{
"SessionStart": {
"Executables": [
{
"Context": "system",
"Filename": "/opt/appstream/SessionScripts/test-session-start",
"Arguments": "arg1",
"S3LogEnabled": true
}
],
"WaitingTime": 30
},
"SessionTermination": {
"Executables": [
{
"Context": "system",
"Filename": "/opt/appstream/SessionScripts/test-session-stop",
"Arguments": "arg2",
"S3LogEnabled": true
}
],
"WaitingTime": 30
}
}
```
# Utilizzo dello strumento CLI di Image Assistant per Linux
Su un generatore di immagini basato su Linux, è possibile utilizzare lo strumento CLI Image Assistant **AppStreamImageAssistant**per creare e gestire l'immagine delle applicazioni. WorkSpaces Lo strumento si trova all'indirizzo `/usr/local/appstream/image-assistant/AppStreamImageAssistant` con un collegamento simbolico all'indirizzo `/bin/AppStreamImageAssistant`. Questo strumento CLI per Linux supporta molte delle stesse operazioni dello strumento CLI di Image Assistant per Windows. Per ulteriori informazioni su queste operazioni, consulta [Operazioni CLI di Image Assistant per la creazione e la gestione dell'immagine delle applicazioni Amazon WorkSpaces](cli-operations-managing-creating-image-image-assistant.md).
# Abilitazione e disattivazione del supporto per webcam
WorkSpaces Le applicazioni supportano audio-video (AV) in tempo reale reindirizzando l'input video della webcam locale alle sessioni di streaming delle applicazioni. WorkSpaces Questa funzionalità consente agli utenti di utilizzare la webcam locale per conferenze video e audio all'interno di una sessione di streaming delle Applicazioni. WorkSpaces Grazie all'AV in tempo reale e al supporto per l'audio in tempo reale, gli utenti possono collaborare utilizzando applicazioni di videoconferenza e audio familiari senza dover abbandonare la sessione di streaming delle WorkSpaces Applicazioni.
Per utilizzare questa funzionalità, è necessario utilizzare un'immagine WorkSpaces delle applicazioni Linux che utilizzi un agente WorkSpaces delle applicazioni Linux rilasciato il o dopo il 21 settembre 2022.
**Nota**
L'AV in tempo reale non è supportato per le istanze stream.standard.small basate su Rocky Linux o Red Hat Enterprise Linux. Gli utenti non vedono le icone Fotocamera e Microfono sulla barra degli strumenti del client.
La funzionalità AV in tempo reale è abilitata per impostazione predefinita per le sessioni di streaming di Linux. Per configurare le autorizzazioni della webcam per glii utenti su un Image Builder Linux, crea `/etc/appstream/appstream.conf` e aggiungi i seguenti contenuti:
**Nota**
Specifica **1** per abilitare la webcam o **0** per disabilitarla.
```
[webcam]
permission = 1
```
# Abilitazione e disabilitazione della modalità Heavy File Sync per le cartelle Home
È possibile abilitare le opzioni Amazon Simple Storage Service Home Folders per l'organizzazione. Quando abiliti Amazon S3 Home Folders per uno stack WorkSpaces Applications, gli utenti dello stack possono accedere a una cartella di storage persistente durante le sessioni di streaming delle applicazioni. Gli utenti non devono eseguire ulteriori configurazioni per accedere alla home directory. I dati archiviati dagli utenti nella loro cartella home vengono automaticamente sottoposti a backup in un bucket Amazon S3 nel tuo Account AWS e sono resi disponibili a tali utenti nelle sessioni successive. Per ulteriori informazioni, consulta [Abilita e amministra le cartelle Home per gli utenti delle tue applicazioni WorkSpaces](home-folders.md).
Per garantire un'esperienza fluida e risolvere alcune limitazioni esistenti, in cui potrebbe verificarsi una sincronizzazione incoerente dei file quando gli utenti salvano file di testo di grandi dimensioni dalle loro istanze di streaming nelle loro cartelle Home, gli amministratori WorkSpaces delle applicazioni possono attivare l'opzione di configurazione **heavy\$1sync** se il caricamento di file di grandi dimensioni su Amazon S3 è uno scenario utente comune durante l'utilizzo delle Applicazioni. WorkSpaces L'attivazione di questa opzione significa che potrebbe aggiungere una certa latenza al processo di sincronizzazione dei file della cartella principale, ma la completezza di tutte le sincronizzazioni con Amazon S3 è garantita.
Questa funzionalità è disponibile su tutte le immagini Red Hat Enterprise Linux e sulle immagini WorkSpaces delle applicazioni Linux che utilizzano un agente Linux WorkSpaces Applications rilasciato il o dopo il 12 settembre 2024.
La funzionalità di heavy sync è disabilitata per impostazione predefinita per le sessioni di streaming di Red Hat Enterprise Linux e Amazon Linux. Per configurare le autorizzazioni di sincronizzazione avanzata per i tuoi utenti su un generatore di immagini Red Hat Enterprise Linux o Amazon Linux, crea `/etc/appstream/appstream.conf` e aggiungi i seguenti contenuti:
**Nota**
Specificate **1** di abilitare la sincronizzazione pesante o di **0** disabilitare la sincronizzazione pesante.
```
[storage]
heavy_sync = 1
```
# Tutorial: creazione di un'immagine personalizzata di applicazioni basate su Linux WorkSpaces
Questo tutorial descrive come creare un'immagine WorkSpaces Amazon Applications personalizzata basata su Linux che contenga applicazioni che puoi trasmettere in streaming ai tuoi utenti.
**Importante**
Non creare un utente chiamato «as2-streaming-user» nel tuo generatore di immagini. Questo è un nome utente riservato per Fleet. Se crei questo nome utente al di fuori del flusso di lavoro delle WorkSpaces Applicazioni, potresti riscontrare problemi di streaming in Fleets.
**Topics**
+ [Fase 1: installazione delle applicazioni sull'Image Builder](#tutorial-linux-image-install)
+ [Fase 2: Generazione del file manifesto per l'ottimizzazione delle applicazioni](#tutorial-linux-image-manifest)
+ [Fase 3: Creare un catalogo di applicazioni WorkSpaces](#tutorial-linux-image-catalog)
+ [Fase 4: Creazione delle impostazioni predefinite dell'applicazione e delle variabili di ambiente](#tutorial-linux-image-create-default-app-settings)
+ [Fase 5: Test delle applicazioni e delle impostazioni](#tutorial-linux-image-test-applications)
+ [Fase 6: terminare la creazione dell'immagine](#tutorial-linux-image-finish-create-image)
+ [Fase 7 (facoltativa): applicare tag e copiare un'immagine](#tutorial-linux-image-tag-copy)
+ [Fase 8: elimina](#tutorial-linux-image-finish)
## Fase 1: installazione delle applicazioni sull'Image Builder
In questa fase, connetti un Image Builder Linux e installi le applicazioni sull'Image Builder.
**Installare le applicazioni sull'Image Builder**
1. Connetti l'Image Builder in uno dei seguenti modi:
+ [Utilizza la console WorkSpaces Applicazioni](managing-image-builders-connect-console.md) (solo per le connessioni Web)
+ [Crea un URL di streaming](managing-image-builders-connect-streaming-URL.md) (per connessioni client Web o WorkSpaces Applicazioni)
**Nota**
Accederai come ImageBuilderAdmin utente al desktop Amazon Linux GNOME e disporrai dei privilegi di amministratore root.
1. Installa le applicazioni necessarie. Ad esempio, per installare un browser Chromium da un repository yum pubblico, apri prima l'applicazione Terminale, quindi esegui il seguente comando:
**[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164**
**Nota**
Scaricare e installare le applicazioni solo dai siti fidati.
## Fase 2: Generazione del file manifesto per l'ottimizzazione delle applicazioni
In questa fase, generati un file manifesto per ogni applicazione installata nella fase 1.
**Generazione di un file manifesto per ottimizzare le prestazioni di avvio di un'applicazione**
1. Assicurati che l'applicazione (ad esempio, Chromium) che stai cercando di ottimizzare sia avviata e in esecuzione.
1. In una finestra di Terminale, esegui il comando seguente per elencare i processi relativi all'applicazione:
**[ImageBuilderAdmin]\$1 ps -ef \$1 grep chromium **
1. Trova il PID principale dall'output del comando precedente. Di seguito è riportato un esempio di output e il PID principale è 16712:
**Example**
```
[ImageBuilderAdmin]$ ps -ef | grep chromium
ImageBu+ 16712 4128 0 Aug26 ? 00:00:44 /usr/lib64/chromium- browser/chromium-browser --enable-plugins --enable-extensions -- enable-user- scripts --enable-printing --enable-gpu-rasterization -- enable-sync --auto-ssl- client-auth
ImageBu+ 16726 16712 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium-browser --type=zygote --no-zygote-sandbox ImageBu+ 16727 16712 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium- browser --type=zygote
ImageBu+ 16731 16727 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium-browser --type=zygot
```
1. Mantieni l'applicazione in esecuzione e assicurati di utilizzare i componenti iniziali richiesti dagli utenti. In questo modo, i componenti vengono acquisiti dal processo di ottimizzazione.
1. Crea un file script (ad esempio, `~/getfilestool.sh`) con i seguenti contenuti:
```
#!/bin/bash
## usage getfilestool.sh $pid
lsof -p $(pstree -p $1 | grep -o '([0-9]\+)' | grep -o '[0-9]\+' | tr '\012' ,)|grep REG | sed -n '1!p' | awk '{print $9}'|awk 'NF'
```
1. Verifica che il file possa essere eseguito eseguendo il seguente comando:
**[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**
1. Esegui il comando seguente per acquisire tutti i file in esecuzione dal processo principale individuato nella fase 3 precedente e salvali in un file manifesto temporaneo:
**[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh 16712 > /tmp/chromium-manifest.txt **
1. Verifica il contenuto del manifesto di ottimizzazione, che è un file di testo delimitato da righe per ogni applicazione.
## Fase 3: Creare un catalogo di applicazioni WorkSpaces
In questo passaggio, si utilizza lo strumento CLI `AppStreamImageAssistant` sul generatore di immagini per creare un catalogo di WorkSpaces applicazioni delle applicazioni specificando le applicazioni per l'immagine. Per ogni applicazione per cui prevedi di effettuare lo streaming, puoi specificare il nome, il nome visualizzato, il file eseguibile da avviare e l'icona da visualizzare.
**Per creare un catalogo di applicazioni WorkSpaces Applicazioni**
1. Dal desktop dell'Image Builder, apri **Terminale** dal pannello laterale o aprendo la griglia dell'app.
1. Esegui **AppStreamImageAssistant --help** per visualizzare l'elenco dei comandi disponibili. Utilizzerai questi comandi per aggiungere applicazioni e creare un'immagine.
1. Esegui il comando seguente per aggiungere un'applicazione installata (ad esempio, Chromium) all'elenco delle WorkSpaces applicazioni per gli utenti delle Applicazioni:
```
AppStreamImageAssistant add-application \
--name Chromium \
--absolute-app-path /usr/lib64/chromium-browser/chromium-browser \
--display-name Chromium \
--absolute-icon-path /usr/share/icons/hicolor/256x256/apps/chromium-browser.png \
--absolute-manifest-path /tmp/chromium-manifest.txt
```
In alternativa, esegui il seguente comando:
```
AppStreamImageAssistant add-application \
--name="Chromium" \
--absolute-app-path="/usr/lib64/chromium-browser/chromium-browser" \
--display-name="Chromium" \
--absolute-icon-path="/usr/share/icons/hicolor/256x256/apps/chromium-browser.png" \
--absolute-manifest-path="/tmp/chromium-manifest.txt"
```
1. Per aggiungere altre applicazioni, ripeti la fase 3 per ogni applicazione aggiuntiva.
1. Per visualizzare l'elenco delle applicazioni che sono state aggiunte al catalogo, insieme ai metadati come i percorsi delle icone e i parametri di avvio, esegui il comando seguente:
**AppStreamImageAssistant list-applications**
1. Per rimuovere le applicazioni dal catalogo, esegui il comando seguente:
**AppStreamImageAssistant remove-application –-name *application\$1name***
## Fase 4: Creazione delle impostazioni predefinite dell'applicazione e delle variabili di ambiente
In questo passaggio, crei le impostazioni predefinite dell'applicazione e le variabili di ambiente per gli utenti delle WorkSpaces Applicazioni. In questo modo gli utenti possono iniziare rapidamente a usare le applicazioni durante le sessioni di streaming WorkSpaces delle Applicazioni, senza la necessità di creare o configurare queste impostazioni da soli.
**Per creare applicazioni predefinite e variabili di ambiente per gli utenti**
1. Avvia l'applicazione per cui creare le impostazioni predefinite. Ad esempio, in una finestra del Terminale, esegui il seguente comando per avviare il browser Chromium:
**[ImageBuilderAdmin]\$1 chromium-browser**
1. Configurazione delle impostazioni delle applicazioni. Ad esempio, imposta la home page del browser Chromium come. **https://aws.amazon.com**.
1. **Assicurati che l'applicazione Chromium sia chiusa, quindi esegui i seguenti comandi per copiare la configurazione di Chromium in /etc/skel:**
**[ImageBuilderAdmin]\$1 sudo mkdir /etc/skel/.config**
**[ImageBuilderAdmin]\$1 sudo cp -R \$1/.config/chromium /etc/skel/.config**
1. Imposta le variabili di ambiente e aggiungile al file di script. Ad esempio, esegui i comandi seguenti:
**[ImageBuilderAdmin]\$1 echo "export *FOO*=*BAR*" \$1 sudo tee -a /etc/profile.d/myenvvars.sh**
**[ImageBuilderAdmin]\$1 sudo chmod \$1x /etc/profile.d/myenvvars.sh**
## Fase 5: Test delle applicazioni e delle impostazioni
In questa fase, verifica che le applicazioni che hai aggiunto funzionino correttamente e che le impostazioni predefinite dell'applicazione e le variabili di ambiente funzionino come previsto.
**Per testare le applicazioni e le impostazioni predefinite su un Image Builder**
1. Crea un utente di test senza autorizzazioni root. Ad esempio, in una finestra di **Terminale**, esegui i seguenti comandi per creare **test-user** sull'Image Builder:
**[ImageBuilderAdmin]\$1 sudo useradd -m test-user**
**[ImageBuilderAdmin]\$1 echo -e 'Pa55w0rdas2\$1\$1\$1\$1nPa55w0rdas2\$1\$1\$1\$1n' \$1 sudo passwd test-user**
1. Passa all'utente di test:
**[ImageBuilderAdmin]\$1 su - test-user**
1. Avvia l'applicazione (ad esempio, Chromium) come utente di test:
**[test-user]\$1 /usr/bin/chromium-browser**
1. Verifica che le impostazioni predefinite siano disponibili per l'utente di test (ad esempio, la home page di Chromium è/). https://aws.amazon.com
1. Verifica che le variabili di ambiente siano disponibili per l'utente di test. Ad esempio, esegui il comando seguente:
**[test-user]\$1 echo \$1*FOO***
Questo comando dovrebbe visualizzare nel terminale l'output ***BAR***.
1. Esegui i seguenti comandi per eliminare l'utente di test prima di creare un'immagine da questo Image Builder:
**\$1 logout test user**
**[test-user]\$1 logout**
**\$1 kill test user's running processes**
**[ImageBuilderAdmin]\$1 sudo killall -u test-user**
**\$1 delete user**
**[ImageBuilderAdmin]\$1 sudo userdel -r test-user**
## Fase 6: terminare la creazione dell'immagine
In questa fase, scegliere un nome dell'immagine e terminare la creazione dell'immagine.
**Creare l'immagine**
1. In una finestra del **Terminale**, crea un'immagine dall'Image Builder eseguendo **AppStreamImageAssistant create-image**. Questa immagine contiene le applicazioni installate e registrate, oltre agli script di sessione e alle impostazioni predefinite delle applicazioni che hai configurato.
Esegui **AppStreamImageAssistant create-image --help** per visualizzare l'elenco delle opzioni disponibili. Per ulteriori informazioni, consulta l'operazione **create-image** in [Crea l'immagine WorkSpaces delle tue applicazioni Amazon in modo programmatico utilizzando le operazioni CLI di Image Assistant](programmatically-create-image.md).
1. La sessione remota si disconnette dopo pochi istanti. Quando viene visualizzato il messaggio **Lost Connectivity (Connessione persa)**, chiudere la scheda del browser. Durante la creazione dell'immagine, lo stato dell'Image Builder viene visualizzato come **Snapshotting (Creazione di snapshot)**. Non è possibile connettersi all'Image Builder fino al termine del processo.
1. Tornare alla console e passare a **Images (Immagini)**, **Image Registry (Registro immagine)**. Verificare che la nuova immagine venga visualizzata nell'elenco.
Durante la creazione dell'immagine, lo stato dell'immagine nel registro immagini della console viene visualizzato come **In sospeso**. Non puoi connetterti a immagini con stato **In sospeso**.
1. Scegli l'icona **Aggiorna** per aggiornare lo stato. Durante la creazione dell'immagine, lo stato dell'immagine viene modificata in **Available (Disponibile)** e l'Image Builder viene automaticamente arrestato.
Per continuare la creazione di immagini, avviare l'Image Builder e connettersi dalla console o creare un nuovo Image Builder.
## Fase 7 (facoltativa): applicare tag e copiare un'immagine
È possibile aggiungere uno o più tag a un'immagine durante la creazione dell'immagine o dopo aver creato un'immagine. È anche possibile copiare l'immagine all'interno della stessa regione o in una nuova regione all'interno dello stesso account Amazon Web Services. La copia di un'immagine sorgente produce un'immagine di destinazione identica ma distinta. AWS tuttavia, non copia alcun tag definito dall'utente. Inoltre, è possibile copiare solo immagini personalizzate che sono state create, non le immagini di base fornite da AWS.
**Nota**
È possibile copiare fino a due immagini in una destinazione nello stesso momento. Se la destinazione in cui si desidera copiare un'immagine è al limite dell'immagine, viene restituito un errore. Per copiare l'immagine in questo caso, è necessario prima rimuovere le immagini dalla destinazione. Dopo che la destinazione è inferiore alla quota immagine (definita anche limite), avviare la copia dell'immagine dalla regione di origine. Per ulteriori informazioni, consulta [Amazon WorkSpaces Applications Service Quotas](limits.md).
**Per aggiungere tag a un'immagine esistente**
1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**.
1. Nell'elenco di immagini, selezionare l'immagine a cui si desidera aggiungere tag.
1. Scegli **Tag**, **Aggiungi/Modifica tag**, quindi scegli **Aggiungi tag**. Specifica la chiave e il valore del tag, quindi scegli **Salva**.
Per ulteriori informazioni, consulta [Etichettatura delle risorse WorkSpaces delle applicazioni Amazon](tagging-basic.md).
**Copiare un'immagine**
La copia di un'immagine su più regioni geograficamente diverse consente di effettuare lo streaming di applicazioni da più regioni in base alla stessa immagine. Effettuando lo streaming delle applicazioni in prossimità degli utenti, è possibile migliorare l'esperienza degli utenti durante lo streaming delle applicazioni con WorkSpaces Applications.
1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Registry (Registro immagini)**.
1. Nell'elenco di immagini, selezionare l'immagine da copiare.
1. Selezionare **Actions (Operazioni)**, **Copy (Copia)**.
1. Nella finestra di dialogo **Copy Image (Copia immagine)**, specificare le informazioni seguenti, quindi scegli **Copy Image (Copia immagine):**
+ Per **Destination Region (Regione di destinazione)** scegliere la regione in cui copiare la nuova immagine.
+ Per **Name (Nome)**, specificare un nome che avrà l'immagine quando verrà copiata nella destinazione.
+ Per **Description (Descrizione)** (facoltativo), specificare una descrizione che avrà l'immagine quando verrà copiata nella destinazione.
1. Per controllare il progresso dell'operazione di copia, tornare alla console e passare a **Images (Immagini)**, **Image Registry (Registro immagine)**. Utilizzare la barra di navigazione per passare alla regione di destinazione (se applicabile) e confermare che la nuova immagine viene visualizzata nell'elenco di immagini.
La nuova immagine viene visualizzata prima con stato **Copying (Copia)** nel registro immagine della console. Dopo che l'immagine è stata creata con successo, lo stato dell'immagine viene modificato in **Available (Disponibile)**, che significa che è possibile utilizzare l'immagine per avviare uno stack ed effettuare lo streaming delle applicazioni.
## Fase 8: elimina
Infine, puoi arrestare gli Image Builder in esecuzione per liberare le risorse ed evitare addebiti indesiderati per l'account. Consigliamo di arrestare qualsiasi Image Builder inutilizzato in esecuzione. Per ulteriori informazioni, consulta i [prezzi WorkSpaces delle applicazioni](https://aws.amazon.com/appstream2/pricing/).
**Arrestare un Image Builder in esecuzione**
1. Nel riquadro di navigazione, scegliere **Images (Immagini)**, **Image Builders (Image Builder)** e selezionare l'istanza dell'Image Builder in esecuzione.
1. Scegliere **Actions (Operazioni)**, **Stop (Arresta)**.
# Tutorial: abilitare il supporto per la lingua giapponese per le immagini Linux
Questo tutorial descrive come abilitare il supporto in lingua giapponese per un'immagine Linux. Ciò consente alle applicazioni sull'immagine di visualizzare caratteri giapponesi e agli utenti di streaming di utilizzare il metodo di input giapponese nelle sessioni di streaming dall'immagine.
**Topics**
+ [Fase 1: installazione del font giapponese e del metodo di input](#tutorial-japanese-font)
+ [Fase 2: impostazione del fuso orario del sistema](#tutorial-japanese-zone)
+ [Fase 3: impostazione delle impostazioni locali del sistema e della lingua di visualizzazione](#tutorial-japanese-locale)
+ [Fase 4: configurazione dei metodi di input](#tutorial-japanese-input)
+ [Fase 5: impostazione del layout della tastiera](#tutorial-japense-keyboard)
+ [Fase 6: Verifica su Image Builder](#tutorial-japense-verify)
+ [Fase 7: Creazione dell'immagine](#tutorial-japanese-create)
## Fase 1: installazione del font giapponese e del metodo di input
In questa fase, colleghi un Image Builder Linux e installi i pacchetti di font e metodi di input di tua scelta.
**Installazione del font giapponese e del metodo di input**
1. Connetti l'Image Builder in uno dei seguenti modi:
+ [Usa la console WorkSpaces Applicazioni](managing-image-builders-connect-console.md) (solo per connessioni Web)
+ [Crea un URL di streaming](managing-image-builders-connect-streaming-URL.md) (per connessioni client Web o WorkSpaces Applicazioni)
**Nota**
Accederai come ImageBuilderAdmin utente al desktop Amazon Linux GNOME e disporrai dei privilegi di amministratore root.
1. Installa il font e il metodo di input necessari. Per fare ciò, apri l'applicazione Terminale, quindi esegui i seguenti comandi:
**sudo yum install vlgothic-p-fonts.noarch**
**sudo yum install ibus-kkc.x86\$164**
1. Oltre ai comandi precedenti, per Rocky Linux e Red Hat Enterprise Linux, esegui il seguente comando:
**sudo yum install glibc-langpack-ja**
## Fase 2: impostazione del fuso orario del sistema
Per impostare il fuso orario del sistema, esegui il seguente comando:
**sudo timedatectl set-timezone "Asia/Tokyo"**
## Fase 3: impostazione delle impostazioni locali del sistema e della lingua di visualizzazione
Per impostare le impostazioni locali del sistema e la lingua di visualizzazione, esegui i seguenti comandi.
**Per impostare le impostazioni locali del sistema e la lingua di visualizzazione**
1. Aggiorna il file `cloud-init config` eseguendo il comando **sudo vim /etc/cloud/cloud.cfg** e modifica **Impostazioni locali** in **Impostazioni locali: ja\$1JP.utf8**, quindi salva e chiudi il file.
1. Aggiorna le impostazioni di sistema eseguendo **sudo localectl set-locale LANG=ja\$1JP.utf8**.
1. Aggiorna le impostazioni della shell Gnome eseguendo **sudo gsettings set org.gnome.system.locale region "ja\$1JP.utf8"**.
## Fase 4: configurazione dei metodi di input
Configura i metodi di input per l'applicazione che desideri aggiungere all'immagine. Per ulteriori informazioni su come installare un'applicazione, generare un file manifesto e creare impostazioni predefinite, consulta [Tutorial: creazione di un'immagine personalizzata di applicazioni basate su Linux WorkSpaces](tutorial-create-linux-image.md). In questa fase, supponiamo che tu abbia già installato l'applicazione Firefox, che si trova in `/usr/local/firefox/firefox`.
**Per configurare i metodi di input**
1. Crea uno script eseguendo il comando **sudo vim /usr/local/bin/update-input-method.sh** e aggiungi il seguente contenuto allo script:
```
#!/bin/bash
function start_process()
{
command=$1
process_name=$2
process_count=$(pgrep $process_name -c)
echo "$(date) current $process_name count: $process_count"
while [ $process_count -lt 1 ]
do
echo "$(date) starting $process_name"
eval $command
sleep 1
process_count=$(pgrep $process_name -c)
done
echo "$(date) $process_name started"
}
start_process "ibus-daemon --xim &" "ibus-daemon"
start_process "/usr/libexec/ibus-engine-kkc --ibus &" "ibus-engine-kkc"
gsettings set org.gnome.desktop.input-sources sources "[('ibus','kkc'), ('xkb', 'us')]"
gsettings set org.gnome.desktop.wm.keybindings switch-input-source "['space']"
gsettings set org.gnome.desktop.wm.keybindings switch-input-source-backward "['space']"
echo "$(date) updated input source and switch shortcut"
```
Nello script precedente, la prima origine di input ('ibus', 'kkc') è il metodo di input predefinito. Puoi modificare il metodo di input predefinito modificando l'ordine delle origini di input. Inoltre, "Ctrl\$1Spazio" e "Maiusc\$1Ctrl\$1Spazio" sono specificati come combinazioni di tasti di scelta rapida per passare da un metodo di input all'altro. Puoi specificare combinazioni di tasti personalizzate che gli utenti possono utilizzare per cambiare metodo di input durante le sessioni di streaming.
1. Crea lo script per avviare l'applicazione (Firefox) da aggiungere all'immagine. A tale scopo, esegui il comando**sudo vim /usr/local/bin/firefox-jp.sh**, quindi aggiungi il seguente contenuto allo script:
```
#!/bin/bash
# Gather required environment variables from the GNOME shell session
while IFS= read -r -d $'\0' env_var; do
case "$env_var" in
DBUS_SESSION_BUS_ADDRESS=*|\
GTK_IM_MODULE=*|\
QT_IM_MODULE=*|\
XMODIFIERS=*|\
XAUTHORITY=*)
echo "$env_var"
export "$env_var"
;;
esac
done < "/proc/$(pgrep -u as2-streaming-user gnome-shell | head -n1)/environ"
/usr/local/bin/update-input-method.sh > /var/tmp/update-input-method.log 2>&1 &
/usr/local/firefox/firefox &
```
1. Aggiungi l'autorizzazione per l'esecuzione a entrambi gli script eseguendo i seguenti comandi:
**sudo chmod \$1x /usr/local/bin/update-input-method.sh**
**sudo chmod \$1x /usr/local/bin/firefox-jp.sh**
1. Se hai già creato il file manifesto di ottimizzazione per l'applicazione, esegui i seguenti comandi per aggiungere lo script di avvio dell'applicazione al catalogo delle applicazioni:
```
sudo AppStreamImageAssistant add-application \
--name firefox \
--absolute-app-path /usr/local/bin/firefox-jp.sh \
--display-name firefox \
--absolute-icon-path /usr/local/firefox/browser/chrome/icons/default/default128.png \
--absolute-manifest-path /tmp/firefox-manifest.txt
```
In alternativa, potete anche configurare i metodi di input aggiungendo lo script update-input-method .sh come applicazione separata al catalogo delle applicazioni per l'immagine. Durante le sessioni di streaming, gli utenti possono avviare questa applicazione per abilitare l'input in lingua giapponese e passare da un metodo di input all'altro con tasti di scelta rapida specificati all'interno della stessa sessione.
## Fase 5: impostazione del layout della tastiera
Imposta il layout della tastiera in modo che corrisponda alle tastiere che gli utenti useranno durante le sessioni di streaming. Puoi utilizzare il comando **localectl list-keymaps** per elencare tutte le mappe di tasti disponibili e, ad esempio, utilizzare il comando **sudo localectl set-keymap jp106** per impostare la mappa dei tasti sulla tastiera giapponese a 106 tasti.
## Fase 6: Verifica su Image Builder
Per eseguire la verifica su Image Builder, prima riavvialo eseguendo il comando **sudo shutdown -r now**. Dopo il riavvio, collegati nuovamente all'Image Builder e verifica che tutto, incluso il fuso orario, le impostazioni locali, la lingua e il metodo di input, funzioni come previsto.
## Fase 7: Creazione dell'immagine
Crea l'immagine nell'Image Builder. Per ulteriori informazioni, consulta [Tutorial: creazione di un'immagine personalizzata di applicazioni basate su Linux WorkSpaces](tutorial-create-linux-image.md). Assicurati di creare le impostazioni predefinite dell'applicazione, incluse le impostazioni regionali che hai appena configurato. Per ulteriori informazioni, consulta "Creazione di impostazioni predefinite delle applicazioni per gli utenti" in [Creazione delle immagini basate su Linux](create-linux-based-images.md).
Tutte le istanze del parco istanze Linux create da questa immagine avranno le stesse impostazioni predefinite di fuso orario, impostazioni locali, lingua e metodo di input configurate per l'immagine.
# Usa gli script di sessione per gestire l'esperienza di streaming degli utenti di Amazon WorkSpaces Applications
WorkSpaces Applications fornisce script di sessione su istanza. Puoi utilizzare questi script per eseguire script personalizzati quando si verificano determinati eventi in sessioni di streaming degli utenti. Ad esempio, è possibile utilizzare script personalizzati per preparare l'ambiente WorkSpaces delle applicazioni prima dell'inizio delle sessioni di streaming degli utenti. Puoi anche utilizzare script personalizzati per eliminare le istanze di streaming dopo che gli utenti hanno completato le proprie sessioni di streaming.
Gli script di sessione sono specificati all'interno di un'immagine delle applicazioni WorkSpaces . Questi script vengono sono eseguiti all'interno del contesto dell'utente o del contesto di sistema. Se la sessione usa gli script standard in uscita per scrivere informazioni, errori o messaggistica di debug, tali elementi possono essere facoltativamente salvati in un bucket Amazon S3 nell'account Amazon Web Services.
**Topics**
+ [Esecuzione degli script prima dell'inizio delle sessioni di streaming](run-scripts-before-streaming-sessions-begin.md)
+ [Esecuzione degli script dopo la fine delle sessioni di streaming.](run-scripts-after-streaming-sessions-end.md)
+ [Creazione e specificazione di script di sessione](create-specify-session-scripts.md)
+ [File di configurazione degli script di sessione](session-script-configuration-file.md)
+ [Utilizzo dei PowerShell file di Windows](using-powershell-files-with-session-scripts.md)
+ [Registrazione dell'output degli script di sessione](logging-session-output.md)
+ [Utilizzo dei connettori di storage con script di sessione](use-storage-connectors-with-session-scripts.md)
+ [Abilitazione dell'archiviazione nel bucket Amazon S3 per i log di script delle sessioni](enable-S3-bucket-storage-session-script-logs.md)
+ [Usa gli script di sessione su flotte multisessione](session-scripts-multi-session-fleets.md)
# Esecuzione degli script prima dell'inizio delle sessioni di streaming
Puoi configurare gli script per l'esecuzione per un massimo di 60 secondi prima di avviare le applicazioni degli utenti e prima che le sessioni di streaming abbiano inizio. In questo modo è possibile personalizzare l'ambiente WorkSpaces delle applicazioni prima che gli utenti inizino a trasmettere in streaming le proprie applicazioni. Quando gli script di sessione vengono eseguiti, viene mostrata un'icona di caricamento per i tuoi utenti. Quando gli script vengono completati con successo o quando trascorre l'intervallo di tempo massimo in attesa, inizierà la sessione di streaming dei tuoi utenti. Se gli non vengono completati correttamente, viene visualizzato un messaggio di errore per i tuoi utenti. Tuttavia, i tuoi utenti possono usare comunque le proprie sessioni di streaming.
Quando specifichi un nome di file su un'istanza Windows, devi utilizzare una doppia barra rovesciata. Esempio:
C:\$1\$1Scripts\$1\$1Myscript.bat
Se non si utilizza una doppia barra rovesciata, viene visualizzato un errore per notificare che il file.json non è formattato correttamente.
**Nota**
Quando gli script vengono completati correttamente, devono restituire un valore 0. Se gli script restituiscono un valore diverso da 0, WorkSpaces Applications visualizza il messaggio di errore all'utente.
Quando si eseguono gli script prima dell'inizio delle sessioni di streaming e il framework applicativo dinamico WorkSpaces delle applicazioni non è abilitato, si verifica il seguente processo:
![\[WorkSpaces Applications workflow diagram showing connection, application selection, and session launch steps.\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/images/session-scripts-without-DAF-non-domain-joined2.png)
1. I tuoi utenti si connettono a un'istanza del parco WorkSpaces applicazioni che non fa parte di un dominio. Si collegano utilizzando uno dei seguenti metodi di accesso:
+ WorkSpaces Pool di utenti delle applicazioni
+ SAML 2.0
+ WorkSpaces API delle applicazioni
1. Il catalogo delle applicazioni viene visualizzato nel portale WorkSpaces Applicazioni e gli utenti scelgono un'applicazione da avviare.
1. Si verifica uno degli eventi seguenti:
+ Se le impostazioni di persistenza delle applicazioni sono abilitate per i tuoi utenti, vengono scaricati e installati il file delle impostazioni delle applicazioni VHD (Virtual Hard Disk) che memorizza le tue impostazioni di personalizzazioni degli utenti e le impostazioni di Windows. In questo caso, è necessario l'accesso dell'utente a Windows.
Per ulteriori informazioni sulle impostazioni di persistenza delle applicazioni, consulta [Abilita la persistenza delle impostazioni delle applicazioni per gli utenti WorkSpaces delle applicazioni](app-settings-persistence.md).
+ Se le impostazioni di persistenza delle applicazioni non sono abilitate, l'utente Windows sarà già connesso.
1. Gli script di sessione sono avviati. Se lo storage persistente è abilitato per i tuoi utenti, viene inoltre avviata l'installazione del connettore di storage. Per informazioni sulle storage persistente, consulta [Abilita e amministra lo storage persistente per gli utenti WorkSpaces delle tue applicazioni](persistent-storage.md).
**Nota**
Affinché inizi la sessione di streaming non è necessario il completamento dell'installazione del connettore di storage. Se gli script di sessione vengono completati prima del completamento dell'installazione del connettore di storage, lo streaming di sessione ha inizio.
Per ulteriori informazioni sul monitoraggio dello stato di installazione dei connettori di storage, consulta [Utilizzo dei connettori di storage con script di sessione](use-storage-connectors-with-session-scripts.md).
1. I tuoi script di sessione vengono completati o scadono.
1. La sessione di streaming degli utenti ha inizio.
1. L'applicazione selezionata dai tuoi utenti viene avviata.
Per informazioni sul framework applicativo dinamico WorkSpaces delle applicazioni, vedere[Utilizza l' WorkSpaces Applications Dynamic Application Framework per creare un provider di app dinamico](build-dynamic-app-provider.md).
Quando si eseguono gli script prima dell'inizio delle sessioni di streaming e prima che il framework applicativo dinamico WorkSpaces delle applicazioni sia abilitato, si verifica il seguente processo:
![\[WorkSpaces Applications workflow from user login to application launch, including SAML authentication and session scripts.\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/images/session-scripts-with-DAF-domain-joined2.png)
1. I tuoi utenti visitano il portale applicativo SAML 2.0 per la tua organizzazione e scelgono lo stack WorkSpaces Applicazioni.
1. Si connettono a un'istanza della flotta di WorkSpaces applicazioni aggiunta a un dominio.
1. Se le impostazioni di persistenza delle applicazioni sono abilitata per i tuoi utenti, vengono scaricati e installati il file VHD (Virtual Hard Disk) che memorizza le tue impostazioni di personalizzazione degli utenti e le impostazioni di Windows.
1. Si verifica l'accesso dell'utente a Windows.
1. Il catalogo delle applicazioni viene visualizzato nel portale WorkSpaces Applicazioni e gli utenti scelgono un'applicazione da avviare.
1. Gli script di sessione sono avviati. Se lo storage persistente è abilitato per i tuoi utenti, viene inoltre avviata l'installazione del connettore di storage.
**Nota**
Affinché inizi la sessione di streaming non è necessario il completamento dell'installazione del connettore di storage. Se gli script di sessione vengono completati prima del completamento dell'installazione del connettore di storage, lo streaming di sessione ha inizio.
Per ulteriori informazioni sul monitoraggio dello stato di installazione dei connettori di storage, consulta [Utilizzo dei connettori di storage con script di sessione](use-storage-connectors-with-session-scripts.md).
1. I tuoi script di sessione vengono completati o scadono.
1. La sessione di streaming degli utenti ha inizio.
1. L'applicazione selezionata dai tuoi utenti viene avviata.
# Esecuzione degli script dopo la fine delle sessioni di streaming.
Puoi anche configurare gli script per l'esecuzione dopo la fine delle sessioni di streaming degli utenti. Ad esempio, è possibile eseguire uno script quando gli utenti selezionano **Termina sessione** dalla barra degli strumenti WorkSpaces delle Applicazioni o quando raggiungono la durata massima consentita per la sessione. È inoltre possibile utilizzare questi script di sessione per ripulire l'ambiente WorkSpaces delle applicazioni prima che un'istanza di streaming venga terminata. Ad esempio, puoi utilizzare gli script per rimuovere i blocchi dei file o caricare i file di log. Quando esegui gli script dopo la fine delle sessioni di streaming, si verifica il processo riportato di seguito.
![\[Flowchart showing WorkSpaces Applications session termination process with scripts and storage actions.\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/images/session-scripts-termination.png)
1. La sessione di streaming delle WorkSpaces Applicazioni degli utenti termina.
1. Gli script di fine sessione sono avviati.
1. I tuoi script di fine sessione vengono completati o scadono.
1. Si verifica l'uscita dell'utente da Windows.
1. Uno o entrambi i seguenti eventi si verificano in parallelo, ove applicabile:
+ Se per gli utenti sono abilitate le impostazioni di persistenza delle applicazioni, il file VHD che archivia le impostazioni di personalizzazione degli utenti e le impostazioni di Windows viene smontato e caricato in un bucket Amazon S3 nell'account.
+ Se lo storage persistente è abilitato per gli utenti, il connettore di storage completa una sincronizzazione finale e viene disinstallato.
1. L'istanza del parco istanze viene terminata.
# Creazione e specificazione di script di sessione
Puoi configurare e specificare script di sessione per parchi istanze sempre attivi, on demand ed elastici.
**Per configurare e specificare script di sessione per parchi istanze sempre attivi, on demand ed elastiche**
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, scegli **Image (Immagini)**, **Image Builder (Sviluppatore di immagini)**.
1. Seleziona uno sviluppatore di immagini che sia nello stato **Running (In esecuzione)** e scegli **Connect (Connessione)**.
1. Quando viene richiesto, scegliere **Administrator** (Amministratore).
1. Accedi a `C:\AppStream\SessionScripts` e apri il file di configurazione `config.json`.
Per ulteriori informazioni sui parametri degli script di sessione, vedi [File di configurazione degli script di sessione](session-script-configuration-file.md).
1. Al termine delle modifiche, salva e chiudi il file `config.json`.
1. Sul desktop dell'Image Builder, apri **Image Assistant**.
1. (Facoltativo) specifica altre applicazioni da includere nell'immagine.
1. Segui le fasi necessarie in Image Assistant per completare la creazione dell'immagine.
Se la configurazione di script di sessione non può essere convalidata (ad esempio, se il file .json non è formattato in modo corretto), riceverai una notifica quando scegli **Disconnect and create image (Disconnetti e crea immagine)**.
**Nota**
Per individuare il file di configurazione degli script di sessione per Image Builder basati su Linux, accedi a `/opt/appstream/SessionScripts/config.json`.
**Per configurare e specificare gli script di sessione per i parchi istanze elastici**
1. Crea un file zip che contenga gli script di sessione e il file config.json. I file degli script verranno copiati nelle seguenti posizioni. Devi utilizzare queste posizioni per config.json.
+ Per Windows utilizza `C:\AppStream\SessionScripts\SessionScript`.
+ Per Linux utilizza `/opt/appstream/SessionScripts/SessionScript`.
**Nota**
Per eseguire i file di script di sessione, assicurati che il file.zip contenga solo gli script di sessione e i file `config.json` e non la cartella che li contiene. Per ulteriori informazioni, consulta [File di configurazione degli script di sessione](session-script-configuration-file.md).
1. Carica il file zip in un bucket Amazon S3 nell'account.
**Nota**
Il VPC deve fornire l'accesso al bucket Amazon S3. Per ulteriori informazioni, consulta [Utilizzo degli endpoint VPC di Amazon S3 per le caratteristiche delle applicazioni WorkSpaces](managing-network-vpce-iam-policy.md).
È necessario che il bucket S3 e il parco WorkSpaces applicazioni si trovino nello stesso ambiente. Regione AWS
Per eseguire l'operazione `S3:GetObject` sull'oggetto script di sessione nel bucket Amazon S3, devi disporre delle autorizzazioni IAM. Per ulteriori informazioni sull'archiviazione degli script di sessione in un bucket Amazon S3, consulta [Archivia l'icona dell'applicazione, lo script di configurazione, lo script di sessione e il file VHD in un bucket S3](store-s3-bucket.md).
1. [Apri la console delle WorkSpaces applicazioni in /appstream2. https://console.aws.amazon.com](https://console.aws.amazon.com/appstream2)
1. Nel riquadro di navigazione, selezionare **Fleets (Parchi istanze)**.
1. Scegli un parco istanze elastico che desideri aggiornare, quindi scegli **Visualizza dettagli**.
1. Nella scheda **Impostazioni degli script di sessione**, scegli **Modifica**.
1. Per **Oggetto script di sessione in S3**, inserisci l'URI S3 che rappresenta l'oggetto script sessione oppure scegli **Sfoglia S3** per accedere ai bucket S3 e trovare l'oggetto script di sessione.
1. Una volta completate le modifiche, scegli **Salva modifiche**.
1. A questo punto, gli script di sessione sono disponibili per tutte le istanze del parco istanze avviate.
**Nota**
Puoi anche configurare gli script di sessione quando crei un nuovo parco istanze elastico.
# File di configurazione degli script di sessione
Per individuare il file di configurazione degli script di sessione in un'istanza di Windows, accedi a C:\$1\$1\$1 AppStream config.json. SessionScripts Su un'istanza Linux, vai a/.json. opt/appstream/SessionScripts/config La formattazione del file è la seguente.
**Nota**
Il file di configurazione è in formato .json. Verifica che qualsiasi testo digitato in questo file sia in formato .json valido.
```
{
"SessionStart": {
"executables": [
{
"context": "system",
"filename": "",
"arguments": "",
"s3LogEnabled": true
},
{
"context": "user",
"filename": "",
"arguments": "",
"s3LogEnabled": true
}
],
"waitingTime": 30
},
"SessionTermination": {
"executables": [
{
"context": "system",
"filename": "",
"arguments": "",
"s3LogEnabled": true
},
{
"context": "user",
"filename": "",
"arguments": "",
"s3LogEnabled": true
}
],
"waitingTime": 30
}
}
```
Puoi utilizzare i seguenti parametri nel file di configurazione degli script di sessione.
***SessionStart/SessionTermination ***
Gli script di sessione da eseguire nel pertinente evento della sessione in base al nome dell'oggetto.
▬**Tipo:** stringa
**Obbligatorio:** no
**Valori consentiti:** **SessionStart**, **SessionTermination**
***WaitingTime***
La durata massima degli script di sessione, in secondi.
**Tipo**: integer
**Obbligatorio:** no
**Limiti:** la durata massima è di 60 secondi. Se gli script di sessione non sono completati entro tale durata, vengono arrestati. Se per continuare l'esecuzione è necessario uno script, avviarlo come un processo separato.
***Executables***
I dettagli per gli script di sessione da eseguire.
▬**Tipo:** stringa
**Obbligatorio:** sì
**Limiti:** il numero massimo di script che può essere eseguito per ogni evento della sessione è 2 (uno per il contesto dell'utente, uno per il contesto di sistema).
***Context***
Il contesto in cui eseguire lo script di sessione.
▬**Tipo:** stringa
**Obbligatorio:** sì
**Valori consentiti:** **user**, **system**
***Filename***
Il percorso completo dello script di sessione da eseguire. Se il parametro non è specificato, lo script di sessione non viene eseguito.
▬**Tipo:** stringa
**Obbligatorio:** no
**Limiti:** la lunghezza massima per il nome del file e il percorso completo è pari a 1.000 caratteri.
**Valori consentiti:****.bat**,, **.exe** **.sh**
Puoi anche usare PowerShell file di Windows. Per ulteriori informazioni, consulta [Utilizzo dei PowerShell file di Windows](using-powershell-files-with-session-scripts.md).
***Arguments***
Gli argomenti per lo script di sessione o per il file eseguibile.
▬**Tipo:** stringa
**Obbligatorio:** no
**Limiti di lunghezza**: la lunghezza massima è pari a 1.000 caratteri.
***S3LogEnabled***
Quando il valore di questo parametro è impostato su **True**, viene creato un bucket S3 nell'account Amazon Web Services per archiviare i log creati dallo script di sessione. Per impostazione predefinita, questo valore è impostato su **True**. Per ulteriori informazioni, consulta la sezione *Registrazione dell'output degli script di sessione* riportata di seguito in questo argomento.
**Tipo**: Booleano
**Obbligatorio:** no
**Valori consentiti:** **True**, **False**
# Utilizzo dei PowerShell file di Windows
Per utilizzare PowerShell i file Windows, specifica il percorso completo del PowerShell file nel **filename** parametro:
```
"filename":
"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
```
Quindi specifica lo script di sessione nel parametro **arguments**:
```
"arguments": "-File \"C:\\path\\to\\session\\script.ps1\"",
```
Infine, verificate che la politica di PowerShell esecuzione consenta l'esecuzione PowerShell del file.
# Registrazione dell'output degli script di sessione
Quando questa opzione è abilitata nel file di configurazione, WorkSpaces Applications acquisisce automaticamente l'output dallo script di sessione che viene scritto nello standard out. Questo output viene caricato in un bucket Amazon S3 nell'account. Puoi esaminare i file di log per la risoluzione dei problemi o per finalità di debugging.
**Nota**
I file di log vengono caricati quando lo script di sessione restituisce un valore o quando il valore impostato in **WaitingTime** è scaduto.
# Utilizzo dei connettori di storage con script di sessione
Quando i connettori di archiviazione WorkSpaces delle applicazioni sono abilitati, iniziano il montaggio quando vengono eseguiti gli script di avvio della sessione. Se lo script si basa sul montaggio dei connettori di archiviazione, è possibile attendere che i connettori siano disponibili. WorkSpaces Applications mantiene lo stato di montaggio dei connettori di archiviazione nel registro di Windows sulle istanze Windows, con la seguente chiave:
HKEY\$1LOCAL\$1MACHINE\$1 SOFTWARE\$1 Amazon\$1\$1 Storage\$1\$1 AppStream
I valori della chiave di registro sono definiti come segue:
+ Nome utente fornito: l'ID utente fornito mediante la modalità di accesso. Le modalità di accesso e il valore per ciascuna modalità sono definiti come segue:
+ Pool di utenti: l'indirizzo e-mail dell'utente
+ URL di streaming: lo UserID
+ SAML: il NameID. Se il nome utente include una barra (ad esempio, il SAMAccount nome di un utente di dominio), la barra viene sostituita dal carattere «-».
+ Connettore di archiviazione: il connettore per l'opzione di archiviazione persistente abilitata per l'utente. I valori del connettore di storage sono indicati di seguito:
+ HomeFolder
+ GoogleDrive
+ OneDrive
Ogni chiave di registro del connettore di archiviazione contiene un valore **MountStatus**DWORD. La tabella seguente elenca i valori possibili per **MountStatus**.
**Nota**
Per visualizzare queste chiavi di registro, è necessario disporre di Microsoft.NET Framework versione 4.7.2 o successiva installato sull'immagine.
| Valore | Description |
| --- | --- |
| 0 | Connettore di storage non abilitato per questo utente |
| 1 | Installazione del connettore di storage in corso |
| 2 | Connettore di storage installato correttamente |
| 3 | Installazione del connettore di storage non riuscita |
| 4 | Il montaggio del connettore di storage è abilitato, ma non ancora montato |
Nelle istanze Linux, puoi controllare lo stato di montaggio della cartella home osservando il valore di appstream\$1home\$1folder\$1mount\$1status nel file \$1/. config/appstream-home-folder/appstreamhome-folder-mount-status-.
| Valore | Description |
| --- | --- |
| True | La home directory è stata montata correttamente |
| False | La home directory non è ancora montata |
# Abilitazione dell'archiviazione nel bucket Amazon S3 per i log di script delle sessioni
Quando abiliti la registrazione di Amazon S3 nella configurazione dello script di sessione, WorkSpaces Applications acquisisce l'output standard dallo script di sessione. L'output viene periodicamente caricato in un bucket S3 nell'account Amazon Web Services. Per ogni AWS regione, WorkSpaces Applications crea un bucket nel tuo account che è unico per il tuo account e per la regione.
Non devi eseguire alcuna attività di configurazione per gestire questi bucket S3. Sono completamente gestiti dal servizio WorkSpaces Applicazioni. I file di log che sono archiviati in ogni bucket sono crittografati tramite endpoint SSL di Amazon S3 quando in transito; vengono invece crittografati mediante chiavi di crittografia gestite da Amazon S3 se inattivi. I bucket vengono denominati in un formato specifico come segue:
```
appstream-logs-region-code-account-id-without-hyphens-random-identifier
```
***region-code***
Questo è il codice AWS regionale in cui viene creato lo stack con lo storage di bucket Amazon S3 abilitato per i log degli script di sessione.
***account-id-without-hyphens***
L'identificatore dell'account Amazon Web Services. L'ID casuale garantisce che non vi sia alcun conflitto con altri bucket in quella regione. La prima parte del nome del bucket, `appstream-logs`, resta uguale in tutti gli account o le regioni.
Ad esempio, se specifichi script di sessione in un'immagine nella regione Stati Uniti occidentali (Oregon) (us-west-2) con il 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-logs-us-west-2-1234567890123-abcdefg
```
La disabilitazione degli script di sessione non elimina nessun file di log memorizzato nel bucket S3. Per eliminare definitivamente i file di registro, 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 gli script di sessione sono abilitati, viene creata una cartella univoca per ogni sessione di streaming avviata.
Il percorso per la cartella in cui i file di log vengono memorizzati nel bucket S3 nel tuo account utilizza la seguente struttura:
```
bucket-name/stack-name/fleet-name/access-mode/user-id-SHA-256-hash/session-id/SessionScriptsLogs/session-event
```
***bucket-name***
Il nome del bucket S3 in cui sono archiviati gli script di sessione. Il formato del nome è descritto precedentemente in questa sezione.
***stack-name***
Il nome dello stack da cui proviene la sessione.
***fleet-name***
Il nome del parco istanze sul quale lo script di sessione è in esecuzione.
***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'identificatore utente.
***session-id***
L'identificatore di sessione della sessione di streaming dell'utente. Ogni sessione di streaming dell'utente genera un ID univoco.
***session-event***
L'evento che ha generato il log dello script di sessione. I valori dell'evento sono: `SessionStart` e `SessionTermination`.
L'esempio seguente di struttura della cartella si applica a una sessione di streaming avviata da test-stack e test-fleet. La sessione utilizza l'API dell'ID utente`testuser@mydomain.com`, da un Account AWS ID di `123456789012` e il gruppo di impostazioni `test-stack` nella regione Stati Uniti occidentali (Oregon) (us-west-2):
```
appstream-logs-us-west-2-1234567890123-abcdefg/test-stack/test-fleet/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/05yd1391-4805-3da6-f498-76f5x6746016/SessionScriptsLogs/SessionStart/
```
In questo esempio la struttura della cartella contiene un file di log per uno script di avvio sessione del contesto dell'utente e un file di log per uno script di avvio sessione del contesto di sistema, se applicabile.
# Usa gli script di sessione su flotte multisessione
Quando si utilizzano script di sessione su flotte multisessione, esistono requisiti e considerazioni aggiuntivi per garantire prestazioni e sicurezza ottimali.
## Requisiti
In una flotta a sessione singola, per un determinato esempio, è garantito che gli **SessionStart**e **SessionTermination**hook vengano eseguiti una sola volta. Questo perché esiste una mappatura 1:1 delle sessioni alle istanze. Quando si utilizzano flotte multisessione, esiste una mappatura N:M delle sessioni alle istanze, in cui ogni sessione viene eseguita autonomamente e si aggancia. **SessionStart**SessionTermination**** Ciò significa che gli **SessionStart**and **SessionTermination**hook possono essere eseguiti più volte su una determinata istanza e in molti ordini diversi. Per un'esperienza ottimale, per gli script di sessione utilizzati su flotte multisessione dovrebbe valere quanto segue:
+ Gli script sono idempotenti.
Quando un'azione è già stata eseguita, gli script devono gestire più di un'esecuzione sulla stessa istanza con una gestione corretta.
+ Gli script sono indipendenti.
Poiché gli script vengono eseguiti per sessione, se una sessione è in esecuzione **SessionTermination**mentre un'altra è in esecuzione **SessionStart**, non devono interferire tra loro o con l'esperienza di altre sessioni.
+ Gli script sono performanti.
Nelle istanze multisessione, è possibile effettuare il provisioning di più sessioni contemporaneamente. Ciò significa che possono esserci più esecuzioni simultanee degli script di sessione. Gli script devono essere efficienti, non consumare risorse eccessive e non influire sull'esperienza degli altri utenti sull'istanza o sulla stabilità delle sessioni.
Molti di questi requisiti possono essere soddisfatti mantenendo la logica degli script di sessione incentrata sulla sessione utente specifica per la quale lo script è in esecuzione.
## Considerazioni sulla sicurezza
WorkSpaces Le immagini delle applicazioni non devono essere configurate per consentire l'autorizzazione di scrittura ai file di script di sessione da parte di alcun utente. Ciò introduce un vettore di attacco fondamentale per gli utenti malintenzionati, che possono modificare i file di script. Questi file potrebbero quindi essere eseguiti come SYSTEM o come un altro utente, a seconda della configurazione.
**Importante**
È responsabilità dell'utente assicurarsi che le immagini WorkSpaces delle applicazioni siano configurate in modo sicuro. Ciò è particolarmente importante per le istanze multisessione, in cui più utenti utilizzano la stessa istanza. Se le immagini non sono configurate in modo sicuro, esiste un rischio di sicurezza per tutti gli utenti di quell'istanza.
Per le immagini e i file degli script di sessione dovrebbe valere quanto segue:
+ Gli utenti non sono autorizzati a modificare i file degli script di sessione.
+ Gli utenti non sono autorizzati a modificare lo script di sessione config.json. Il comportamento predefinito dell'immagine limita l'accesso agli amministratori.
Gli eseguibili degli script di sessione devono essere archiviati in un luogo sicuro, al riparo da modifiche in fase di esecuzione.
Se il servizio rileva che l'eseguibile di uno script di sessione è stato modificato, fallirà tutte le successive esecuzioni di quell'hook su quell'istanza, caricherà i file di registro su Amazon S3 (se la registrazione Amazon S3 è abilitata) e verrà visualizzato il seguente messaggio:
**Lo script di sessione non è stato eseguito perché l'eseguibile è stato modificato dopo il provisioning dell'istanza. L'esecuzione è stata ignorata per motivi di sicurezza.**
Se il caso d'uso richiede la modifica dell'eseguibile dello script di sessione in fase di esecuzione (ad esempio, se si punta a un file EXE modificato da un processo di aggiornamento automatico in fase di esecuzione), i controlli precedenti non supereranno. In questo caso, utilizzate uno script per reindirizzare l'esecuzione all'eseguibile modificato. Lasciate lo script invariato in fase di esecuzione quando il servizio esegue i controlli di sicurezza.
Se i file degli script di sessione sono eccessivamente grandi (più di 100 MB), ciò può causare ritardi nel provisioning dell'istanza e della sessione e i controlli di sicurezza richiederanno più tempo (a seconda del tipo di istanza e delle risorse disponibili). Se il tuo caso d'uso richiede script di sessione di grandi dimensioni, prendi in considerazione l'utilizzo di script più piccoli per reindirizzare l'esecuzione. Ciò migliorerà le esperienze di provisioning di istanze e sessioni.
Nota che il servizio controlla solo l'eseguibile definito negli script di sessione config.json e questo è solo un meccanismo di sforzo. fallback/best È responsabilità dell'utente garantire che tutti i percorsi di codice negli eseguibili degli script di sessione siano sicuri e non possano essere modificati dagli utenti finali.