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à.
# 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/"
}
]
```