Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Bild importieren
Sie können WorkSpaces Anwendungs-Images erstellen, indem Sie Ihre benutzerdefinierten importieren EC2 AMIs. Funktionsweise:
1. Passen Sie Ihr EC2 AMI mit einer beliebigen Methode, einschließlich [EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/), an.
1. Importieren Sie Ihr benutzerdefiniertes AMI in WorkSpaces Applications, um ein WorkSpaces Anwendungs-Image zu erstellen
1. Verwenden Sie optional Image Builder für zusätzliche Image-Anpassungen
Bilder, die durch den AMI-Import erstellt wurden`type = "custom"`, sind von, während von WorkSpaces Anwendungen bereitgestellte Bilder von sind`type = "native"`.
Sie können Stream.\$1-Instance-Typen für Bilder mit verwenden. `type = "native"` Um einen der folgenden Instance-Typen zu verwenden, müssen Sie Ihr AMI importieren und ein Image mit erstellen`type = "custom"`.
+ GeneralPurpose.\$1
+ MemoryOptimized.\$1
+ ComputeOptimized.\$1
+ Beschleunigt. \$1
## Voraussetzungen für den Bildimport
All diese Voraussetzungen sind wichtig für eine erfolgreiche Workflow-Ausführung. Unterstützte AMI-Konfigurationen und andere verbindliche Anforderungen sind unten aufgeführt.
### Erforderliche AMI-Eigenschaften
EBS
+ Weniger oder gleich einer Größe von 500 GB
+ Sie können ein AMI mit < 200 GB importieren, das importierte Image benötigt jedoch mindestens 200 GB.
+ GP2
+ Sie können ein AMI mit dem EBS-Volumetyp gp2 oder gp3 importieren, das importierte Image verwendet jedoch gp2.
+ Ein Volume pro Bild
+ `/dev/sda1`Name des Root-Geräts
+ Bildtyp: Maschine
+ Architektur: x86\$164
+ Virtualisierungstyp: HVM
+ Startmodus: UEFI
+ TPM-Unterstützung: v2.0. Dies ist erforderlich. Unter [https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html\$1 finden Sie ein ami-windows-tpm-find TPM-fähiges](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find) AMI.
+ ENA-Unterstützung: wahr
+ Plattform: Windows
+ Plattformdetails: Windows
### Eigenschaften des Betriebssystems
**Windows Server 2022/2025 Vollständige Basis**
+ Windows Server **Core** wird nicht unterstützt
+ Windows mit SQL Server wird nicht unterstützt
Kundendienstmitarbeiters (Kundendienstmitarbeiter)
+ EC2 Starten Sie V2-Version >= 2.1.1
+ SSM-Agent erforderlich
Treiber
+ EC2 ENA-Treiberversion >= 2.9.0
+ EC2 NVMe Treiberversion >= 1.6.0
Bibliotheksunterstützung
+ .NET Framework 4.8 oder höher
+ Standardmäßig in Windows Server 2022/2025 installiert
+ PowerShell 5.1 oder höher
+ Standardmäßig in Windows Server 2022/2025 installiert
+ Windows-Funktionen: Die Lizenzierung von Remotedesktopdiensten und der Sitzungshost für Remotedesktopdienste dürfen nicht installiert sein
+ Anschlüsse: Die Ports 8000, 8300 und 8443 müssen entsperrt und nicht belegt sein
+ Startmodus: UEFI
Wenn Sie Image mit Grafikinstanzen wie Accelerated.G4DN, Accelerated.G5, Accelerated.G6 oder Accelerated.G6E verwenden möchten, müssen Sie den richtigen GRID-Treiber auf Ihrem AMI installieren. [Weitere Informationen finden Sie unter -GRID-driver.html. https://docs.aws.amazon.com/AWSEC2/ latest/UserGuide/nvidia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html) Wenn die Treiber nicht korrekt eingerichtet sind, funktioniert das Streaming, die Grafikkarte ist jedoch möglicherweise nicht verfügbar.
**Wichtig**
Die „Besitzerkonto-ID“ des AMI muss Ihre AWS Konto-ID sein. Sie können kein öffentliches EC2 AMI importieren.
Führen Sie alle Windows-Updates durch und deaktivieren Sie automatische Windows-Updates, bevor Sie das Image importieren.
Der Import von verschlüsselten EC2 AMIs Dateien wird derzeit nicht unterstützt
### Anforderungen an die IAM-Rolle
**Wichtig**
„Erstellen Sie eine IAM-Rolle mit den folgenden Berechtigungen, die Sie für den Bildimport verwenden können:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowModifyImageAttributeWithTagCondition",
"Effect": "Allow",
"Action": "ec2:ModifyImageAttribute",
"Resource": "*"
},
{
"Sid": "AllowDescribeImages",
"Effect": "Allow",
"Action": "ec2:DescribeImages",
"Resource": "*"
}
]
}
```
Fügen Sie die folgende Vertrauensbeziehung für diese IAM-Rolle hinzu
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "appstream.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## Um ein Bild zu importieren
1. Öffnen Sie die WorkSpaces Anwendungskonsole unter [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. **Wählen Sie im linken Navigationsbereich **Images** und dann Image Registry aus.**
1. Wählen Sie „**Bild importieren**“.
1. **AMI-ID** — Geben Sie eine AMI-ID für AMI ein, das Sie in WorkSpaces Anwendungen importieren möchten. In diesem Feld können Sie auch nach Ihrem AMI suchen.
1. **Imagename** — Geben Sie einen eindeutigen Namen für das Image ein, das aufgrund des Importvorgangs erstellt wird.
1. **Anzeigename** *(optional)* — Geben Sie einen Namen ein, der für das Bild angezeigt werden soll.
1. **Beschreibung** *(optional)* — Geben Sie eine Beschreibung für das Bild ein.
1. **IAM-Rolle** — Wählen Sie die IAM-Rolle aus, die Sie für den Image-Import erstellt haben. Weitere Einzelheiten finden Sie unter. [Anforderungen an die IAM-Rolle](#iam-role-requirements)
1. ** WorkSpaces Anwendungsagent verwalten** — Wählen Sie diese Option, wenn Sie immer die neueste Version des WorkSpaces Anwendungsagenten verwenden möchten. Ihre Streaming-Instances werden automatisch mit den neuesten Funktionen, Leistungsverbesserungen und Sicherheitsupdates aktualisiert, die ab AWS der Veröffentlichung einer neuen Agentenversion verfügbar sind.
1. **Laufzeitvalidierung** *(optional)*: Wählen Sie diese Option und der Service stellt eine Instanz mit dem importierten Image bereit und führt Streaming-Tests durch.
+
**Anmerkung**
Diese Streaming-Tests werden im Hintergrund ausgeführt. Sie können über den WorkSpaces Applications Client keine Verbindung zu dieser Instanz herstellen.
+ Wir empfehlen, diese Option zu verwenden, um die Sicherheit zu erhöhen, dass Ihr Bild für WorkSpaces Anwendungen geeignet ist.
+ Ihnen wird der Stundenpreis für diese Instanz in Rechnung gestellt.
+ Sie können die Ausführung der Laufzeitvalidierung vermeiden, wenn Sie Ihr AMI erneut importieren, nachdem Sie geringfügige Änderungen vorgenommen haben, die sich möglicherweise nicht auf den Streaming-Test auswirken, und wenn die Laufzeitvalidierung beim letzten Mal bestanden wurde, Sie dieses AMI importiert haben.
+ **Instance-Typ wählen** *(optional)*: Wählen Sie die richtige Instance-Familie, den richtigen Typ und die richtige Größe für die Ausführung des Streaming-Tests aus. Es wird empfohlen, dieselbe Instanz zu verwenden, die Sie für die Flottenerstellung verwenden möchten.
1. **Anwendungskatalog und Leistungsverzeichnis für den Start** *(optional)*: Geben Sie Einzelheiten an, um einen Anwendungskatalog für Ihre Endbenutzer zu erstellen und die Startleistung Ihrer Anwendungen zu verbessern.
+ **Anwendungskatalog**: Um einen Anwendungskatalog zu erstellen, geben Sie Details zu den Anwendungen an, auf denen Ihr Image installiert ist. Für jede Anwendung, die Sie streamen möchten, können Sie einen Namen, einen Anzeigenamen, eine ausführbare Datei zum Starten und ein Symbol zum Anzeigen festlegen.
+ **Leistung beim Starten**: Durch das Hinzufügen von Dateien zum Manifest für die Anwendungsoptimierung wird die Zeit reduziert, die benötigt wird, bis die Anwendung zum ersten Mal auf einer neuen Flotteninstanz gestartet wird. Das Optimierungsmanifest ist eine zeilengetrennte Textdatei, die für jede Anwendung erstellt wird.
Weitere Informationen finden Sie unter[Einzelheiten zu den Bewerbungen](applications-details.md).
1. **Tags** *(optional)* — Wählen Sie „**Tag hinzufügen**“ und geben Sie den Schlüssel und den Wert für das Tag ein. Wiederholen Sie diesen Schritt, um weitere Tags hinzuzufügen. Weitere Informationen finden Sie unter [Kennzeichnen Ihrer WorkSpaces Amazon-Anwendungsressourcen](tagging-basic.md).
1. **Bild importieren** — Überprüfen Sie alle von Ihnen eingegebenen Informationen und wählen Sie **Bild importieren**. Der Dienst führt Kompatibilitätsprüfungen durch, um sicherzustellen, dass AMI mit WorkSpaces Anwendungen kompatibel ist.
+ Wenn die statischen Prüfungen fehlschlagen, erhalten Sie sofort eine Fehlermeldung.
+ Wenn die statischen Prüfungen erfolgreich sind, wird Ihre Importanfrage übermittelt. Je nach den von Ihnen ausgewählten Optionen kann es 30-60 Minuten dauern, bis ein neues WorkSpaces Anwendungs-Image mit erstellt ist `type = "custom"`
# Einzelheiten zu den Bewerbungen
Die Anwendungsdetails enthalten Informationen zu Pre-Warm-Manifesten und App-Katalogkonfigurationen.
## Anwendungsmanifeste PreWarm
Bei der Erstellung von WorkSpaces Anwendungs-Images können Sie Anwendungen angeben, die Ihren Benutzern zur Verfügung gestellt werden sollen. Um den Start der Anwendung zu beschleunigen, können Sie ein PreWarm Manifest vorbereiten. Dies ist im Wesentlichen ein Katalog der Dateien, die Ihre Anwendung zum Starten benötigt, wenn Benutzer Ihre Anwendung starten. Während der Instanzbereitstellung werden diese Dateien im Vorfeld der Sitzungsverbindungen vorbereitet, um die Startzeiten von Anwendungen in Benutzersitzungen zu verkürzen.
Prewarm-Manifeste müssen auf Ihrem AMI vorab erstellt werden, bevor sie in die WorkSpaces Anwendungsumgebung importiert werden. Sie können wählen, ob Sie entweder eine gemeinsame Prewarm-Manifestdatei oder eine für jede Anwendung erstellen möchten. Dies ändert die Art und Weise, wie Sie Ihr AMI später importieren werden.
### Allgemeines Prewarm-Manifest
Starten Sie für jede Anwendung, die Sie vorwärmen möchten, die Anwendung und führen Sie alle ersten Interaktionen durch, die Ihre Benutzer möglicherweise durchführen. Verwenden Sie dann den folgenden Befehl, der auf das Verzeichnis abzielt, in dem Ihre Anwendungsdaten gespeichert sind.
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```
Dadurch werden die Dateien zur Optimierung für jede Anwendung an die gemeinsame `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` Datei angehängt. Für das Vorwärmen der Anwendung sind keine zusätzlichen Maßnahmen erforderlich. WorkSpaces Anwendungen suchen am oben genannten Speicherort nach der Prewarm-Datei und verwenden sie, falls sie vorhanden ist.
Dieser Vorgang ist optional und mit zunehmender Größe des Prewarm-Manifests nimmt auch die Zeit für die Bereitstellung der Flotte zu. Achten Sie also darauf, ein Gleichgewicht zwischen Optimierung und Flottenbereitstellung zu finden.
### Anwendungsspezifische Manifeste
Während des Imports von Bildern möchten Sie möglicherweise separate Anwendungsmanifestdateien pro Anwendung angeben, um die Prewarm-Assets pro Anwendung leichter nachverfolgen zu können. Führen Sie dazu dieselben Schritte wie oben aus, aber anstatt eine gemeinsame `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` Datei zu erstellen, erstellen Sie eine Datei pro Anwendung auf Ihrem AMI.
Starten Sie für jede Anwendung, die Sie vorwärmen möchten, die Anwendung und führen Sie alle ersten Interaktionen durch, die Ihre Benutzer möglicherweise durchführen. Verwenden Sie dann den folgenden Befehl, der auf das Verzeichnis abzielt, in dem Ihre Anwendungsdaten gespeichert sind.
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\Path\To\My\PreWarm.txt" -encoding UTF8 -append
```
Wir werden diese Vorwärmdateien für die Anwendung beim Import von Bildern verwenden. Auch dies ist völlig optional. Sie können wählen, ob Sie diese Methode, die Common Prewarm Manifest-Methode oder gar kein Prewarm-Manifest verwenden möchten.
## Konfigurationen des Anwendungskatalogs
`AppCatalogConfig`Dadurch können Sie die Anwendungen angeben, die Sie während des AMI-Imports in Ihrem WorkSpaces Anwendungs-Image registrieren möchten. Dies `AppCatalogConfig` ist eine JSON-Liste von Anwendungskonfigurationsobjekten mit der folgenden Struktur.
```
[
{
"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
]
```
Die einzigen erforderlichen Felder pro Anwendung sind die `Name` und die`AbsoluteAppPath`. Die Details der einzelnen Felder lauten wie folgt:
Name [**Erforderlich**]
+ Ein Vorname für Ihre Anwendung, um sie zu identifizieren
+ Zwischen 1 und 100 Zeichen
+ Zulässige Zeichen (Regex) `^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,99}$`
+ Muss in einem bestimmten Feld eindeutig sein AppCatalogConfig
DisplayName
+ Der Anzeigename für eine bestimmte Anwendung, der Benutzern angezeigt werden soll
+ Zwischen 0 und 100 Zeichen
+ Zulässige Zeichen (Regex) `^[a-zA-Z0-9][a-zA-Z0-9_. -]{0,99}$`
AbsoluteAppPath **[Erforderlich]**
+ Der Pfad zur ausführbaren Datei, um Ihre Anwendung zu starten
+ Dies ist die ausführbare Datei, die gestartet wird, wenn Benutzer Ihre Anwendung auswählen
+ Zwischen 1 und 32767 Zeichen
+ Diese Obergrenze für die Zeichenlänge dient der Unterstützung erweiterter Dateipfade in Windows. Stellen Sie sicher, dass Ihr AMI und Ihre Anwendung ordnungsgemäß konfiguriert sind, um erweiterte Windows-Dateipfade zu unterstützen, wenn Dateipfade mit mehr als 260 Zeichen verwendet werden.
+ Verwenden Sie Escape-Dateipfadzeichenfolgen wie
+ `"C:\\Windows\\System32\\notepad.exe"`
AbsoluteManifestPath
+ Gilt nur, wenn Sie verwenden [Anwendungsspezifische Manifeste](#application-specific-manifests)
+ Pfad zur Prewarm-Manifestdatei für diese Anwendung
+ Zwischen 0 und 32767 Zeichen
+ Diese Obergrenze für die Zeichenlänge dient der Unterstützung erweiterter Dateipfade in Windows. Stellen Sie sicher, dass Ihr AMI und Ihre Anwendung ordnungsgemäß konfiguriert sind, um erweiterte Windows-Dateipfade zu unterstützen, wenn Dateipfade mit mehr als 260 Zeichen verwendet werden.
+ Verwenden Sie Escape-Dateipfadzeichenfolgen wie
+ `"C:\\Path\\To\\PrewarmManifest.txt"`
AbsoluteIconPath
+ Pfad zur Symboldatei auf dem AMI, die für die Anwendung verwendet werden soll.
+ Dieses Symbol wird Benutzern angezeigt, wenn sie zu diesem Bild streamen.
+ Wenn keines angegeben wird, wird das Symbol von der ausführbaren Datei selbst abgeleitet.
+ Achten Sie darauf, dass Sie Symboldateien mit entsprechend verwalteter Hintergrundtransparenz auswählen, um Ihren Benutzern ein gutes Kundenerlebnis zu bieten
+ Verwenden Sie PNG-Bilder
+ Zwischen 1 und 32767 Zeichen
+ Diese Obergrenze für die Zeichenlänge dient der Unterstützung erweiterter Dateipfade in Windows. Stellen Sie sicher, dass Ihr AMI und Ihre Anwendung ordnungsgemäß konfiguriert sind, um erweiterte Windows-Dateipfade zu unterstützen, wenn Dateipfade mit mehr als 260 Zeichen verwendet werden.
+ Verwenden Sie Escape-Dateipfadzeichenfolgen wie
+ `"C:\\Path\\To\\ApplicationIcon.png"`
WorkingDirectory
+ Das Arbeitsverzeichnis, in dem Ihre Anwendung gestartet werden soll
+ Zwischen 0 und 32767 Zeichen
+ Diese Obergrenze für die Zeichenlänge dient der Unterstützung erweiterter Dateipfade in Windows. Stellen Sie sicher, dass Ihr AMI und Ihre Anwendung ordnungsgemäß konfiguriert sind, um erweiterte Windows-Dateipfade zu unterstützen, wenn Dateipfade mit mehr als 260 Zeichen verwendet werden.
+ Verwenden Sie Escape-Dateipfadzeichenfolgen wie
+ `"C:\\Path\\To\\Working\\Directory"`
LaunchParameters
+ Eine Zeichenfolge, die als Startparameter für die ausführbare Datei verwendet werden soll, angegeben in `AbsoluteAppPath`
+ Zwischen 0 und 1024 Zeichen
+ Verwenden Sie Escape-Zeichenketten mit der vollständigen Liste der erforderlichen Startparameter, wie das folgende Beispiel zeigt, wie Sie PowerShell Skripts als Ihre Anwendungen verwenden können, indem Sie die PowerShell ausführbare Datei als Ihre App mit einem in den Startparametern bereitgestellten Skript verwenden
+ AbsoluteAppPath
+ `"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"`
+ LaunchParameters
+ `"-File \"C:\\Path\\To\\App\\Script.ps1\""`
### Beispiel AppCatalogConfig
Dies ist ein einfaches Beispiel AppCatalogConfig für Notepad, Google Chrome und Mozilla Firefox
```
[
{
"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/"
}
]
```