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.
# Bilder
Sie können Amazon WorkSpaces Applications-Images erstellen, die Anwendungen enthalten, die Sie an Ihre Benutzer streamen können, sowie Standardsystem- und Anwendungseinstellungen, damit Ihre Benutzer schnell mit diesen Anwendungen beginnen können. Ein einmal erstelltes Abbild kann jedoch nicht mehr geändert werden. Wenn Sie andere Anwendungen hinzufügen, vorhandene Anwendungen aktualisieren oder Abbildeinstellungen ändern möchten, müssen Sie den Image Builder starten, mit dem Sie das Abbild erstellt haben, und wieder eine Verbindung zu ihm herstellen. Sollte dieser Image Builder bereits gelöscht worden sein, starten Sie basierend auf Ihrem Abbild einen neuen Image Builder. Nehmen Sie dann Ihre Änderungen vor und erstellen Sie ein neues Abbild. Weitere Informationen erhalten Sie unter [Starten eines Image Builder zum Installieren und Konfigurieren von Streaming-Anwendungen](tutorial-image-builder-create.md) und [Tutorial: Erstellen eines benutzerdefinierten WorkSpaces Anwendungsabbilds mithilfe der WorkSpaces Anwendungskonsole](tutorial-image-builder.md).
Bilder, die Ihnen zur Verfügung stehen, sind in der **Image-Registrierung** in der WorkSpaces Anwendungskonsole aufgeführt. Sie sind als öffentlich, privat oder freigegeben kategorisiert. Sie können jeden dieser Image-Typen verwenden, um einen Image Builder zu starten und eine WorkSpaces Anwendungsflotte einzurichten. Freigegebene Abbilder befinden sich im Besitz von anderen Amazon-Web-Services-Konten und sind zur gemeinsamen Nutzung mit Ihnen freigegeben. Berechtigungen, die für Abbilder festgelegt wurden, die für Sie freigegeben sind, schränken möglicherweise ein, welche Aktionen Sie mit diesen Abbildern ausführen können. Weitere Informationen finden Sie unter [Verwalte deine Amazon WorkSpaces Applications Images](administer-images.md).
**Topics**
+ [Standardanwendungs- und Windows-Einstellungen sowie Leistung beim Starten von WorkSpaces Anwendungen in Amazon Applications](customizing-appstream-images.md)
+ [WorkSpaces Agent-Versionen von Anwendungen verwalten](base-images-agent.md)
+ [WorkSpaces Versionshinweise zum Applications Agent](agent-software-versions.md)
+ [Tutorial: Erstellen eines benutzerdefinierten WorkSpaces Anwendungsabbilds mithilfe der WorkSpaces Anwendungskonsole](tutorial-image-builder.md)
+ [Verwalte deine Amazon WorkSpaces Applications Images](administer-images.md)
+ [Erstellen Sie Ihr WorkSpaces Amazon-Anwendungs-Image programmgesteuert mithilfe der Cli-Operationen von Image Assistant](programmatically-create-image.md)
+ [Erstellen Sie Ihre Linux-basierten Images](create-linux-based-images.md)
+ [Verwenden Sie Sitzungsskripten, um das Streaming-Erlebnis Ihrer Amazon WorkSpaces Applications-Benutzer zu verwalten](use-session-scripts.md)
# Standardanwendungs- und Windows-Einstellungen sowie Leistung beim Starten von WorkSpaces Anwendungen in Amazon Applications
Sie können Standardanwendungs- und -Windows-Einstellungen erstellen, um Ihren Benutzern einen schnellen Einstieg in ihre Anwendungen zu ermöglichen, sodass sie die Einstellungen nicht selbst erstellen oder konfigurieren müssen.
WorkSpaces Applications optimiert die Startleistung Ihrer Anwendungen für die Streaming-Sitzungen Ihrer Benutzer. Um sicherzustellen, dass alle erforderlichen Dateien in diesem Prozess enthalten sind, müssen Sie möglicherweise bestimmte Dateien und Ordner manuell zum Optimierungsmanifest hinzufügen.
**Topics**
+ [Erstellen von Standardanwendungs- und Windows-Einstellungen für Ihre WorkSpaces Anwendungsbenutzer](creating-default-app-Windows-settings.md)
+ [Optimierung der Startleistung Ihrer Anwendungen in Amazon WorkSpaces Applications](optimizing-app-launch-performance.md)
# Erstellen von Standardanwendungs- und Windows-Einstellungen für Ihre WorkSpaces Anwendungsbenutzer
Anwendungs-Anpassungen und Windows-Einstellungen, die im Ordner des Windows-Benutzerprofils oder in der Benutzer-Registrierungsstruktur gespeichert werden, können als Standardwerte festgelegt werden. Wenn Sie die Standardeinstellungen mithilfe des **Vorlagenbenutzers** in Image Assistant speichern, ersetzt WorkSpaces Applications das Windows-Standardbenutzerprofil durch das Profil, das Sie konfigurieren. Anhand des Windows-Standard-Benutzerprofils werden dann die anfänglichen Einstellungen für Benutzer in der Flotten-Instance erstellt. Falls die von Ihnen konfigurierten Anwendungs- oder Windows-Einstellungen in der Flotte nicht funktionieren, bestätigen Sie, dass sie im Windows-Benutzerprofil gespeichert wurden. Weitere Informationen finden Sie in „Schritt 3: Erstellen Sie Standardanwendungs- und Windows-Einstellungen“ im [Tutorial: Erstellen eines benutzerdefinierten WorkSpaces Anwendungsabbilds mithilfe der WorkSpaces Anwendungskonsole](tutorial-image-builder.md).
Unter anderem können Sie die folgenden Standardeinstellungen erstellen und konfigurieren:
+ Anwendungsvoreinstellungen, einschließlich einer Browser-Homepage, benutzerdefinierten Symbolleisten und Sicherheitseinstellungen.
+ Einstellungen für Anwendungsdaten einschließlich Browser-Lesezeichen und Verbindungsprofilen.
+ Windows-Erlebniseinstellungen, einschließlich der Anzeige von Dateinamenerweiterungen und verborgenen Verzeichnissen.
Darüber hinaus können Sie Internet Explorer-Sicherheitseinstellungen, wie z. B. die verstärkte Sicherheitskonfiguration, ändern oder deaktivieren. Weitere Informationen finden Sie unter [Deaktivieren Sie die verstärkte Sicherheitskonfiguration für Internet Explorer in WorkSpaces Amazon-Anwendungen](customize-fleets-disable-ie-esc.md).
# Optimierung der Startleistung Ihrer Anwendungen in Amazon WorkSpaces Applications
Wenn Sie ein Image erstellen, müssen Sie in WorkSpaces Applications die Startleistung Ihrer Anwendungen für die Streaming-Sitzungen Ihrer Benutzer optimieren. Wenn Ihre Anwendungen während dieses Prozesses geöffnet werden, stellen Sie sicher, dass sie die anfänglichen Komponenten verwenden, die von Ihren Benutzern benötigt werden. Auf diese Weise wird sichergestellt, dass diese Komponenten durch den Optimierungsvorgang erfasst werden. In einigen Fällen werden nicht alle der Dateien erkannt, die für die Optimierungen erforderlich sind. Beispiele für solche Dateien sind z. B. Plug-Ins oder Komponenten, die nicht im Image Builder geöffnet werden. Um sicherzustellen, dass alle Dateien erfasst werden, die für Ihre Anwendung erforderlich sind, können Sie sie in das Optimierungsmanifest einschließen. Wenn Dateien zum Optimierungsmanifest hinzugefügt werden, kann es länger dauern, bis Flotten-Instances erstellt und Benutzern zur Verfügung gestellt wurden. Dadurch verkürzt sich jedoch die Zeit, die benötigt wird, um die Anwendung beim ersten Start auf der Flotten-Instance zu starten.
Um alle Dateien in einem Ordner zu optimieren, öffnen Sie den folgenden PowerShell Befehl PowerShell und verwenden Sie ihn:
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```
Standardmäßig ersetzt Image Assistant das Anwendungsoptimierungsmanifest jedes Mal, wenn der Schritt **Optimieren** von Image Assistant ausgeführt wird. Sie müssen den PowerShell Befehl ausführen, um alle Dateien in einem Ordner zu optimieren:
+ Jedes Mal, nachdem der Schritt **Optimieren** ausgeführt wurde.
+ Bevor Sie auf der Seite **Verbindung trennen und Abbild erstellen** die Option **Überprüfen** auswählen.
Alternativ können Sie das Optimierungsmanifest auch mithilfe der Image Assistant-Befehlszeilenschnittstelle (CLI) jeweils für die Anwendung eingeben. Wenn Sie das Optimierungsmanifest mithilfe der Image Assistant-CLI-Operationen angeben, führt WorkSpaces Applications das angegebene Anwendungsoptimierungsmanifest mit den Dateien zusammen, die im Image Assistant-Schritt **Optimieren** identifiziert wurden. Weitere Informationen finden Sie unter [Erstellen Sie Ihr WorkSpaces Amazon-Anwendungs-Image programmgesteuert mithilfe der Cli-Operationen von Image Assistant](programmatically-create-image.md).
# WorkSpaces Agent-Versionen von Anwendungen verwalten
Der WorkSpaces Applications Agent ist eine Software, die auf Ihren Streaming-Instances ausgeführt wird und es Benutzern ermöglicht, Anwendungen zu streamen. Wenn Sie ein neues Abbild erstellen, ist die Option **Always use latest agent version (Immer neueste Agentenversion verwenden)** standardmäßig ausgewählt. Wenn diese Option ausgewählt ist, verwenden neue Image Builder oder Flotteninstanzen, die von Ihrem Image aus gestartet werden, immer die neueste Version des WorkSpaces Applicationsagenten. Möglicherweise möchten Sie die Agenten-Updates kontrollieren, um die Kompatibilität mit Ihrer Software sicherzustellen oder um die aktualisierte Umgebung zu qualifizieren, bevor Sie sie für Ihre Endbenutzer bereitstellen.
In den folgenden Verfahren wird beschrieben, wie die Versionen von WorkSpaces Applications Agent verwaltet werden.
**Topics**
+ [Erstellen Sie ein Image, das immer die neueste Version des WorkSpaces Applications Agent verwendet](create-image-that-always-uses-latest-agent.md)
+ [Erstellen Sie ein Image, das eine bestimmte Version des WorkSpaces Applications Agent verwendet](create-image-that-uses-specific-agent.md)
+ [Erstellen Sie ein Image, das eine neuere Version des WorkSpaces Applications Agent verwendet](create-image-that-uses-newer-agent.md)
# Erstellen Sie ein Image, das immer die neueste Version des WorkSpaces Applications Agent verwendet
Wenn Ihre Images so konfiguriert sind, dass sie immer die neueste Version des WorkSpaces Applications Agents verwenden, werden Ihre Streaming-Instances automatisch mit den neuesten Funktionen, Leistungsverbesserungen und Sicherheitsupdates aktualisiert, die ab AWS der Veröffentlichung einer neuen Agentenversion verfügbar sind.
**Anmerkung**
In einigen Fällen kann eine neue Version des WorkSpaces Applications Agents zu Konflikten mit Ihrer Software führen. Wir empfehlen, dass Sie die neue Version des WorkSpaces Anwendungsagenten qualifizieren, bevor Sie sie in Ihren Produktionsflotten einsetzen.
**Um ein Image zu erstellen, das immer die neueste Version des WorkSpaces Applications Agent verwendet**
1. Öffnen Sie die WorkSpaces Anwendungskonsole zu [https://console.aws.amazon.com/appstream2/Hause](https://console.aws.amazon.com/appstream2/home).
1. Führen Sie eine der folgenden Aufgaben aus:
+ Wenn Sie das Abbild mit einem Image Builder erstellen möchten, starten Sie den Image Builder und stellen Sie eine Verbindung mit ihm her. Wenn der Image Builder nicht die neueste Version des WorkSpaces Applications Agent ausführt, werden Sie aufgefordert, auszuwählen, ob der Image Builder mit dem neuesten Agenten gestartet werden soll. Stellen Sie sicher, dass diese Option aktiviert ist, klicken Sie auf **Start (Starten)** und stellen Sie dann eine Verbindung mit dem Image Builder her.
+ Wenn Sie über keinen Image Builder verfügen, den Sie zum Erstellen des Abbilds verwenden möchten, starten Sie einen neuen Image Builder. Wählen Sie in **Schritt 1: Image auswählen** ein AWS Basis-Image oder ein benutzerdefiniertes Image aus. In **Schritt 2: Image Builder konfigurieren** wird der Abschnitt Anwendungen angezeigt, wenn auf dem von Ihnen ausgewählten Image nicht die neueste Version des WorkSpaces **WorkSpaces Anwendungsagenten** ausgeführt wird. Wählen Sie in der Liste **Agentenversion** die neueste Agentenversion aus. Führen Sie die restlichen Schritte aus, um den Image Builder zu erstellen und eine Verbindung mit ihm herzustellen. Weitere Informationen finden Sie unter [Starten eines Image Builder zum Installieren und Konfigurieren von Streaming-Anwendungen](tutorial-image-builder-create.md).
1. Öffnen Sie auf dem Image-Builder-Desktop den Image Assistant und befolgen Sie die Schritte zum Erstellen eines neuen Abbilds. Stellen Sie für den Schritt **Configure Image (Abbild konfigurieren)** sicher, dass die Option **Always use the latest agent version (Immer die neueste Agentenversion verwenden)** aktiviert ist. Weitere Informationen finden Sie unter [Tutorial: Erstellen eines benutzerdefinierten WorkSpaces Anwendungsabbilds mithilfe der WorkSpaces Anwendungskonsole](tutorial-image-builder.md).
Wenn Sie später entscheiden, nicht immer die neueste Version des WorkSpaces Applications Agent zu verwenden, müssen Sie ein neues Image erstellen und diese Option deaktivieren.
1. Erstellen Sie eine neue Flotte oder ändern Sie die vorhandene. Wählen Sie beim Konfigurieren der Flotte das neue von Ihnen erstellte Abbild aus. Weitere Informationen finden Sie unter [Erstellen Sie eine WorkSpaces Amazon-Anwendungsflotte und einen Stack](set-up-stacks-fleets.md).
1. Erstellen Sie einen neuen Stack oder wandeln Sie einen vorhandenen ab und verknüpfen Sie ihn mit Ihrer Flotte.
# Erstellen Sie ein Image, das eine bestimmte Version des WorkSpaces Applications Agent verwendet
Möglicherweise möchten Sie die Updates des WorkSpaces Anwendungsagenten kontrollieren, anstatt immer die neueste Version zu verwenden, damit Sie zuerst die Kompatibilität testen können. Um sicherzustellen, dass die Version des WorkSpaces Anwendungs-Agents, die Sie verwenden, mit Ihren Streaming-Anwendungen kompatibel ist, können Sie ein Image erstellen, das eine bestimmte Version der Agentsoftware verwendet. Führen Sie dann Ihre Qualifikationsprüfungen in einer separaten Flotte durch, bevor Sie die Software für Ihre Produktionsflotte bereitstellen.
Wenn Sie ein neues Abbild erstellen, stellen Sie sicher, dass die Option **Always use latest agent version (Immer die neueste Agentenversion verwenden)** deaktiviert ist. Dadurch wird Ihr Image an die Version des WorkSpaces Applications Agents angehängt, die Sie beim Start des Image Builders ausgewählt haben, anstatt immer die neueste Version zu verwenden. Nachdem Sie Ihre Qualifikationsprüfungen abgeschlossen haben, können Sie Ihre Produktionsflotte mit dem Abbild aktualisieren.
**Um ein Image zu erstellen, das eine bestimmte Version des WorkSpaces Applications Agent verwendet**
1. Öffnen Sie die WorkSpaces Anwendungskonsole zu [https://console.aws.amazon.com/appstream2/Hause](https://console.aws.amazon.com/appstream2/home).
1. Führen Sie eine der folgenden Aufgaben aus:
+ Wenn Sie das Abbild mit einem Image Builder erstellen möchten, starten Sie den Image Builder und stellen Sie eine Verbindung mit ihm her.
+ Wenn Sie über keinen Image Builder verfügen, den Sie zum Erstellen des Abbilds verwenden möchten, starten Sie einen neuen Image Builder. Wählen Sie in **Schritt 1: Bild auswählen** ein AWS Basis-Image oder ein benutzerdefiniertes Image aus. In **Schritt 2: Image Builder konfigurieren** wird der Abschnitt Anwendungen angezeigt, wenn auf dem von Ihnen ausgewählten Image nicht die neueste Version des WorkSpaces **WorkSpaces Anwendungsagenten** ausgeführt wird. Wählen Sie in der Liste **Agent version (Agentenversion)** nicht die neueste Agentenversion aus. Führen Sie die restlichen Schritte aus, um den Image Builder zu erstellen und eine Verbindung mit ihm herzustellen. Weitere Informationen finden Sie unter [Starten eines Image Builder zum Installieren und Konfigurieren von Streaming-Anwendungen](tutorial-image-builder-create.md).
1. Öffnen Sie auf dem Image-Builder-Desktop den Image Assistant und befolgen Sie die Schritte zum Erstellen eines neuen Abbilds. Stellen Sie für den Schritt **Configure Image (Abbild konfigurieren)** im Image Assistant sicher, dass die Option **Always use the latest agent version (Immer die neueste Agentenversion verwenden)** deaktiviert ist. Weitere Informationen finden Sie unter [Tutorial: Erstellen eines benutzerdefinierten WorkSpaces Anwendungsabbilds mithilfe der WorkSpaces Anwendungskonsole](tutorial-image-builder.md).
Wenn Sie sich später dafür entscheiden, immer die neueste Version des WorkSpaces Applications Agent zu verwenden, müssen Sie ein neues Image erstellen und diese Option auswählen.
1. Erstellen Sie eine neue Flotte oder ändern Sie die vorhandene. Wählen Sie beim Konfigurieren der Flotte das neue von Ihnen erstellte Abbild aus. Weitere Informationen finden Sie unter [Erstellen Sie eine WorkSpaces Amazon-Anwendungsflotte und einen Stack](set-up-stacks-fleets.md).
1. Erstellen Sie einen neuen Stack oder wandeln Sie einen vorhandenen ab und verknüpfen Sie ihn mit Ihrer Flotte.
1. Stellen Sie eine Verbindung mit Ihrer Flotte her und prüfen Sie Ihre Anwendungen auf Kompatibilität.
# Erstellen Sie ein Image, das eine neuere Version des WorkSpaces Applications Agent verwendet
Wenn Sie Ihr Image an eine bestimmte Version des WorkSpaces Applicationsagenten anheften, müssen Sie auf eine neuere Version aktualisieren, indem Sie ein neues Image erstellen. Mit dieser Methode können Sie jede einzelne Agentenaktualisierung zuerst auf Kompatibilität prüfen und Ihre Flotte dann schrittweise aktualisieren.
Wenn Sie ein neues Abbild erstellen, stellen Sie sicher, dass die Option **Always use latest agent version (Immer die neueste Agentenversion verwenden)** deaktiviert ist. Nachdem Sie Ihr Abbild erstellt haben, führen Sie Ihre Qualifikationsprüfungen in einer separaten Flotte durch, bevor Sie die Software für Ihre Produktionsflotte bereitstellen. Nachdem Sie Ihre Qualifikationsprüfungen abgeschlossen haben, können Sie Ihre Produktionsflotte mit dem Abbild aktualisieren.
**Um ein Image zu erstellen, das eine neuere Version des WorkSpaces Applications Agent verwendet**
1. Öffnen Sie die WorkSpaces Anwendungskonsole zu [https://console.aws.amazon.com/appstream2/Hause](https://console.aws.amazon.com/appstream2/home).
1. Führen Sie eine der folgenden Aufgaben aus:
+ Wenn Sie das Abbild mit einem Image Builder erstellen möchten, starten Sie den Image Builder und stellen Sie eine Verbindung mit ihm her. Wenn der Image Builder nicht die neueste Version des WorkSpaces Applications Agent ausführt, werden Sie aufgefordert, auszuwählen, ob der Image Builder mit dem neuesten Agenten gestartet werden soll. Stellen Sie sicher, dass diese Option aktiviert ist, klicken Sie auf **Start (Starten)** und stellen Sie dann eine Verbindung mit dem Image Builder her.
+ Wenn Sie über keinen Image Builder verfügen, den Sie zum Erstellen des Abbilds verwenden möchten, starten Sie einen neuen Image Builder. Wählen Sie in **Schritt 1: Image auswählen** ein AWS Basis-Image oder ein benutzerdefiniertes Image aus. In **Schritt 2: Image Builder konfigurieren** wird der Abschnitt Anwendungen angezeigt, wenn auf dem von Ihnen ausgewählten Image nicht die neueste Version des WorkSpaces **WorkSpaces Anwendungsagenten** ausgeführt wird. Wählen Sie in der Liste **Agentenversion** die neueste Agentenversion aus. Führen Sie die restlichen Schritte aus, um den Image Builder zu erstellen und eine Verbindung mit ihm herzustellen. Weitere Informationen finden Sie unter [Starten eines Image Builder zum Installieren und Konfigurieren von Streaming-Anwendungen](tutorial-image-builder-create.md).
1. Öffnen Sie auf dem Image-Builder-Desktop den Image Assistant und befolgen Sie die Schritte zum Erstellen eines neuen Abbilds. Stellen Sie für den Schritt **Configure Image (Abbild konfigurieren)** im Image Assistant sicher, dass die Option **Always use the latest agent version (Immer die neueste Agentenversion verwenden)** deaktiviert ist. Weitere Informationen finden Sie unter [Tutorial: Erstellen eines benutzerdefinierten WorkSpaces Anwendungsabbilds mithilfe der WorkSpaces Anwendungskonsole](tutorial-image-builder.md).
Wenn Sie sich später dafür entscheiden, immer die neueste Version des WorkSpaces Applications Agent zu verwenden, müssen Sie ein neues Image erstellen und diese Option auswählen.
1. Erstellen Sie eine neue Flotte oder ändern Sie die vorhandene. Wählen Sie beim Konfigurieren der Flotte das neue von Ihnen erstellte Abbild aus. Weitere Informationen finden Sie unter [Erstellen Sie eine WorkSpaces Amazon-Anwendungsflotte und einen Stack](set-up-stacks-fleets.md).
1. Erstellen Sie einen neuen Stack oder wandeln Sie einen vorhandenen ab und verknüpfen Sie ihn mit Ihrer Flotte.
1. Stellen Sie eine Verbindung mit Ihrer Flotte her und prüfen Sie Ihre Anwendungen auf Kompatibilität.
# WorkSpaces Versionshinweise zum Applications Agent
Die Agentensoftware von Amazon WorkSpaces Applications wird auf Ihren Streaming-Instances ausgeführt und ermöglicht es Endbenutzern, eine Verbindung zu ihren Streaming-Anwendungen herzustellen und diese zu starten. Ab dem 7. Dezember 2017 können Ihre Streaming-Instances automatisch mit den neuesten Funktionen, Leistungsverbesserungen und Sicherheitsupdates aktualisiert werden, die unter verfügbar sind AWS. Vor dem 7. Dezember 2017 waren Agent-Updates in den neuen Basis-Image-Versionen enthalten.
Um die neueste WorkSpaces Applications Agent-Software verwenden zu können, müssen Sie Ihre Images neu erstellen, indem Sie neue Basis-Images verwenden, die AWS am oder nach dem 7. Dezember 2017 veröffentlicht wurden. Wenn Sie dies tun, wird die Option, automatische Updates des Agenten zuzulassen, vom Image-Assistenten standardmäßig ausgewählt. Wir empfehlen, dass Sie diese Option beibehalten, sodass jeder neue Image-Builder und jede neue Flotten-Instance, die von Ihrem Image aus gestartet werden, immer die neueste Version des Agenten verwenden. Weitere Informationen finden Sie unter [Tutorial: Erstellen eines benutzerdefinierten WorkSpaces Anwendungsabbilds mithilfe der WorkSpaces Anwendungskonsole](tutorial-image-builder.md).
In der folgenden Tabelle werden die neuesten Updates beschrieben, die in veröffentlichten Versionen des WorkSpaces Applications Agent für Windows-Instances verfügbar sind.
| Agentenversion WorkSpaces von Amazon Applications | Änderungen |
| --- | --- |
| 02-09-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-04-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-06-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-02-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-30-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 15.07.2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 29.05.2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-05-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-07-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 31.10.2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 21.10.2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 18.09.2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 21.05.2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 15.04.2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 17.01.2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-07-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-06-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 30.05.2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-08-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 13.04.2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 21.03.2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 13.10.2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 20.06.2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 14.03.2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 21.02.2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 20.12.2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 19.10.2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-02-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-01-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 25.06.2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 17.05.2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 04.03.2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 17.12.2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 01.04.2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 17.12.2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-08-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-01-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 30.07.2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-27-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 04-20-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-19-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 13.01.2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 13.11.2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-08-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-23-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 03.09.2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 08.08.2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 26.07.2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 19.06.2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 07.05.2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 02.04.2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 07.03.2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 22.01.2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 08.01.2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 19.12.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 17.12.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 04.12.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 14.11.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 30.10.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 24.10.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 01.10.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 29.08.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 07.26.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 19.06.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 06.06.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 31.05.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 21.05.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 19.03.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 24.01.2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
| 07.12.2017 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/agent-software-versions.html) |
# Tutorial: Erstellen eines benutzerdefinierten WorkSpaces Anwendungsabbilds mithilfe der WorkSpaces Anwendungskonsole
In diesem Tutorial wird beschrieben, wie Sie WorkSpaces Anwendungs-Images erstellen, die auf Microsoft Windows Server-Betriebssystemen basieren. Wenn Sie benutzerdefinierte Images erstellen möchten, die auf den Betriebssystemen Amazon Linux 2, Rocky Linux oder Red Hat Enterprise Linux basieren, finden Sie weitere Informationen unter[Tutorial: Erstellen Sie ein benutzerdefiniertes Linux-basiertes WorkSpaces Anwendungs-Image](tutorial-create-linux-image.md).
In diesem Tutorial erfahren Sie, wie Sie ein benutzerdefiniertes Amazon WorkSpaces Applications-Image erstellen, das Anwendungen enthält, die Sie an Ihre Benutzer streamen können, sowie Standardanwendungs- und Windows-Einstellungen, damit Ihre Benutzer schnell mit ihren Anwendungen beginnen können. Um dieses Tutorial durcharbeiten zu können, müssen Sie bereits über einen Image Builder verfügen. Falls Sie keinen Image Builder besitzen, finden Sie unter [Starten eines Image Builder zum Installieren und Konfigurieren von Streaming-Anwendungen](tutorial-image-builder-create.md) weitere Informationen.
**Wichtig**
Dieses Tutorial enthält Informationen, die für das neueste Release des Basisabbilds gelten. Weitere Informationen finden Sie unter [WorkSpaces Versionshinweise für das Basis-Image und das Managed Image-Update für Anwendungen](base-image-version-history.md).
**Topics**
+ [Schritt 1: Installieren von Anwendungen auf dem Image Builder](#tutorial-image-builder-install)
+ [Schritt 2: Erstellen Sie einen WorkSpaces Anwendungskatalog](#tutorial-image-builder-add)
+ [Schritt 3: Erstellen Sie Standardanwendungs- und Windows-Einstellungen](#tutorial-image-builder-create-default-app-settings)
+ [Schritt 4: Testen von Anwendungen](#tutorial-image-builder-test-applications)
+ [Schritt 5: Anwendungen optimieren](#tutorial-image-builder-optimize)
+ [Schritt 6: Beenden Sie das Erstellen Ihres Abbilds](#tutorial-image-builder-finish-create-image)
+ [Schritt 7 (optional): Kennzeichnen und Kopieren eines Abbilds](#tutorial-image-builder-tag-copy)
+ [Schritt 8: Bereinigen](#tutorial-image-builder-finish)
## Schritt 1: Installieren von Anwendungen auf dem Image Builder
In diesem Schritt verbinden Sie einen Image Builder und installieren Ihre Anwendungen auf dem Image Builder.
**Wichtig**
Melden Sie sich beim Image Builder mit dem lokalen **Administratorkonto** oder einem Domain-Benutzerkonto mit lokalen Administratorberechtigungen an, um diesen Schritt abzuschließen. Benennen Sie das lokale integrierte **Administratorkonto** nicht um oder löschen Sie es nicht. Wenn Sie dieses Konto umbenennen oder löschen, wird der Image Builder nicht gestartet und die Abbilderstellung schlägt fehl.
**So installieren Sie Anwendungen auf dem Image Builder**
1. Stellen Sie eine Verbindung zum Image Builder her, indem Sie einen der folgenden Schritte ausführen:
+ [Verwenden Sie die WorkSpaces Anwendungskonsole](managing-image-builders-connect-console.md) (nur für Webverbindungen)
+ [Erstellen Sie eine Streaming-URL](managing-image-builders-connect-streaming-URL.md) (für Web- oder WorkSpaces Anwendungs-Client-Verbindungen)
**Anmerkung**
Wenn der Image Builder, zu dem Sie eine Verbindung herstellen möchten, zu einer Active Directory-Domäne gehört und Ihre Organisation eine Smartcard-Anmeldung erfordert, müssen Sie eine Streaming-URL erstellen und den WorkSpaces Applications Client für die Verbindung verwenden. Informationen zur Smartcard-Anmeldung finden Sie unter [Smartcards](feature-support-USB-devices-qualified.md#feature-support-USB-devices-qualified-smart-cards).
1. Installieren Sie Anwendungen von einer Anwendungs-Website oder einer anderen Download-Adresse. Installieren Sie die gewünschten Anwendungen, bevor Sie mit dem nächsten Schritt fortfahren.
**Anmerkung**
Laden Sie Anwendungen nur von vertrauenswürdigen Websites herunter und installieren Sie sie.
Wenn für eine Anwendung ein Neustart des Windows-Betriebssystems erforderlich ist, lassen Sie dies zu. Bevor das Betriebssystem neu gestartet wird, werden Sie von Ihrem Image Builder getrennt. Nachdem der Neustart abgeschlossen ist, stellen Sie erneut eine Verbindung zum Image Builder her und schließen Sie die Installation der Anwendung ab.
## Schritt 2: Erstellen Sie einen WorkSpaces Anwendungskatalog
In diesem Schritt erstellen Sie einen Anwendungskatalog für WorkSpaces Anwendungen, indem Sie Anwendungen (*.exe*), Batchskripts (*.bat*) und Anwendungsverknüpfungen (*.lnk*) für Ihr Image angeben. 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. Wenn Sie ein Tastaturkürzel für die Anwendung auswählen, werden diese Werte vorab für Sie ausgefüllt.
**Wichtig**
Melden Sie sich beim Image Builder mit dem lokalen **Administratorkonto** oder einem Domain-Benutzerkonto mit lokalen Administratorberechtigungen an, um diesen Schritt abzuschließen.
**Um einen Anwendungskatalog für Anwendungen zu erstellen WorkSpaces**
1. Öffnen Sie vom Image-Builder-Desktop aus den Image Assistant. Der Image Assistant führt Sie durch den Prozess zum Erstellen eines Abbilds.
![\[Row of icons representing different functions in Image Assistant interface.\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/images/Image-Builder-Desktop-Image-Assistant.png)
1. Wählen Sie unter **1. Apps hinzufügen** die Option **\$1 App hinzufügen** aus und navigieren Sie zum Speicherort, an dem sich die hinzuzufügende Anwendung bzw. das Skript oder die Verknüpfung befindet. Klicken Sie auf **Open**.
1. Im Dialogfenster der **App Launch Settings (App Starteinstellungen)** können Sie die Standardeinstellungen für **Name (Name)**, **Display Name (Anzeigenname)** und **Icon Path (Symbolpfad)** beibehalten oder ändern. Optional können Sie Startparameter (zusätzliche Argumente, die beim Start an die Anwendung übergeben werden) und ein Arbeitsverzeichnis für die Anwendung festlegen. Klicken Sie abschließend auf **Speichern**.
Die Einstellungen für **Display Name (Anzeigename)** und **Icon Path (Symbol-Pfad)** bestimmen, wie Anwendungsname und Symbol im Anwendungskatalog angezeigt werden. Der Katalog wird Benutzern angezeigt, wenn sie sich bei einer WorkSpaces Anwendungs-Streaming-Sitzung anmelden.
1. Wiederholen Sie die Schritte 2 und 3 für jede Anwendung im Image Assistant und bestätigen Sie, dass die Anwendungen in der Registerkarte **Add Apps (Apps hinzufügen)** angezeigt werden. Wenn Sie fertig sind, wählen Sie **Next (Weiter)**, um weiter mit dem Image Assistant Ihr Abbild zu erstellen.
## Schritt 3: Erstellen Sie Standardanwendungs- und Windows-Einstellungen
In diesem Schritt erstellen Sie Standardanwendungs- und Windows-Einstellungen für Ihre WorkSpaces Anwendungsbenutzer. Auf diese Weise können Ihre Benutzer während ihrer Anwendungs-Streaming-Sitzungen schnell mit WorkSpaces Anwendungen beginnen, ohne diese Einstellungen selbst erstellen oder konfigurieren zu müssen.
**Wichtig**
Um diesen Schritt abzuschließen, müssen Sie am Image Builder mit dem lokalen Konto **Template User (Vorlagenbenutzer)** oder einem Domänenbenutzerkonto, das keine lokalen Administratorberechtigungen hat, angemeldet sein.
**So erstellen Sie Standardanwendungs- und Windows-Einstellungen für Benutzer**
1. Wählen Sie im Image Assistant unter **2. Apps konfigurieren** die Option **Benutzer wechseln** aus. Damit wird Ihre aktuelle Sitzung getrennt und das Anmeldemenü angezeigt.
1. Führen Sie eine der folgenden Aufgaben aus:
+ Wenn der Image Builder nicht mit einer Active-Directory-Domain verbunden ist, wählen Sie in der Registerkarte **Lokaler Benutzer** die Option **Vorlagenbenutzer** aus. Mit diesem Konto können Sie Standardanwendungs- und Windows-Einstellungen erstellen.
+ Wenn Ihr Image Builder mit einer Active Directory-Domäne verbunden ist, wählen Sie **Directory User (Directory-Benutzer)** und melden Sie sich als Domänenbenutzer ohne lokale Administratorberechtigungen an.
1. Öffnen Sie vom Image-Builder-Desktop den Image Assistant, der die Anwendungen anzeigt, die Sie beim Erstellen des Anwendungskatalogs hinzugefügt haben.
1. Wählen Sie die Anwendung aus, für die Sie die Standardanwendungseinstellungen erstellen möchten.
1. Erstellen Sie nach dem Öffnen der Anwendung die Einstellungen nach Ihrem Bedarf.
1. Wenn Sie fertig sind, schließen Sie die Anwendung und kehren Sie zum Image Assistant zurück.
1. Wenn Sie mehr als eine Anwendung im Image Assistant festgelegt haben, wiederholen Sie die Schritte 4 bis 6 für jede Anwendung nach Bedarf.
1. Wenn Sie Windows-Standardeinstellungen möchten, erstellen Sie diese jetzt. Wenn Sie fertig sind, kehren Sie zum Image Assistant zurück.
1. Wählen Sie **Switch user (Benutzer wechseln)** und melden Sie sich mit demselben Konto an, das Sie zum Erstellen des Anwendungskatalogs verwendet haben (ein Konto mit lokalen Administratorberechtigungen).
1. Führen Sie im Image Assistant unter **2. Apps konfigurieren** einen der folgenden Schritte aus:
+ Wenn Ihr Image Builder nicht mit einer Active Directory-Domäne verbunden ist, wählen Sie **Save settings (Einstellungen speichern)**.
+ Wenn Ihr Image Builder mit einer Active Directory-Domäne verbunden ist, wählen Sie in der Liste **Choose which user settings to copy (Zu kopierende Benutzereinstellungen auswählen) **dasselbe Konto aus, das Sie verwendet haben, um sich beim Image Builder anzumelden, als Sie die Standardanwendungs- und Windows-Einstellungen erstellt haben, und wählen Sie dann die Option **Save settings (Einstellungen speichern)**.
Die Liste **Zu kopierende Einstellungen auswählen** zeigt alle Benutzerkonten, deren Einstellungen derzeit auf dem Image Builder gespeichert sind.
1. Wenn Sie fertig sind, wählen Sie **Next (Weiter)**, um mit dem Erstellen Ihres Abbilds fortzufahren.
## Schritt 4: Testen von Anwendungen
In diesem Schritt stellen Sie sicher, dass die Anwendungen, die Sie hinzugefügt haben, sich korrekt öffnen und wie erwartet funktionieren. Beginnen Sie hierfür eine neue Windows-Sitzung als Benutzer mit denselben Zugriffsberechtigungen wie Ihre Benutzer.
**Wichtig**
Melden Sie sich beim Image Builder mit dem Konto **Testbenutzer** oder einem Domain-Benutzerkonto ohne lokale Administratorberechtigungen an, um diesen Schritt abzuschließen.
**So testen Sie Ihre Anwendungen**
1. Führen Sie im Image Assistant unter **3. Test** einen der folgenden Schritte aus:
+ Wenn Ihr Image Builder nicht mit einer Active-Directory-Domain verbunden ist, wählen Sie **Benutzer wechseln** aus.
+ Wenn Ihr Image Builder mit einer Active-Directory-Domain verbunden ist, benötigen Sie ein Domain-Konto zum Testen Ihrer Anwendungen. Verfügt der Benutzer bereits über Einstellungen im Image Builder, müssen Sie die Anwendungseinstellungen für diesen Benutzer zurückzusetzen. Um dies zu tun, wählen Sie den Benutzer aus der Liste **User to reset (Zurückzusetzende Benutzer)** aus und anschließend **Reset (Zurücksetzen)**. Klicken Sie abschließend auf **Switch user (Benutzer wechseln)**.
**Anmerkung**
Wenn Ihr Image Builder neu ist und noch keine Benutzereinstellungen auf dem Image Builder vorhanden sind, zeigt die Liste keine Benutzer an.
1. Wählen Sie einen Benutzer zum Testen aus und führen Sie einen der folgenden Schritte aus:
+ Wenn Ihr Image Builder nicht mit einer Active Directory-Domäne verbunden ist, wählen Sie **Test User (Testbenutzer)** aus. Dieses Konto ermöglicht es Ihnen, Ihre Anwendungen testen, indem Sie die gleichen Richtlinien und Berechtigungen wie Ihre Benutzer verwenden.
+ Wenn Ihr Image Builder mit einer Active-Directory-Domain verbunden ist, wählen Sie **Directory-Benutzer** aus. Geben Sie die Anmeldeinformationen für ein Domain-Konto ein, das keine lokalen Administratorrechte hat, und wählen Sie anschließend **Anmelden** aus.
1. Öffnen Sie vom Image-Builder-Desktop den Image Assistant, der die Anwendungen anzeigt, die Sie beim Erstellen des Anwendungskatalogs angegeben haben.
1. Wählen Sie die Anwendung aus, die Sie testen möchten, um zu bestätigen, dass sie korrekt geöffnet wird und dass alle Standardanwendungseinstellungen angewendet werden, die Sie erstellt haben.
1. Nachdem die Anwendung geöffnet wird, testen Sie sie nach Ihren Wünschen. Wenn Sie fertig sind, schließen Sie die Anwendung und kehren Sie zum Image Assistant zurück.
1. Wenn Sie mehr als eine Anwendung im Image Assistant festgelegt haben, wiederholen Sie die Schritte 4 bis 5, um jede Anwendung nach Ihren Wünschen zu testen.
1. Wenn Sie fertig sind, wählen Sie **Switch user (Benutzer wechseln)** und führen Sie einen der folgenden Schritte aus:
+ Wenn der Image Builder nicht mit einer Active Directory-Domäne verbunden ist, wählen Sie in der Registerkarte **Local User (Lokaler Benutzer)** die Option **Administrator**.
+ Wenn Ihr Image Builder mit einer Active Directory-Domäne verbunden ist und Sie sich als Domänen-Benutzer mit lokalen Administratorberechtigungen angemeldet haben, um Anwendungen im Image Assistant festzulegen, melden Sie sich als dieser Benutzer an.
1. Wählen Sie **Next (Weiter)** aus, um mit dem Erstellen Ihres Abbildes fortzufahren.
## Schritt 5: Anwendungen optimieren
In diesem Schritt öffnet der Image Assistant Ihre Anwendungen nacheinander, identifiziert ihre Startabhängigkeiten und nimmt Optimierungen vor, um sicherzustellen, dass die Anwendungen schnell starten. Diese Schritte sind zwingend erforderlich und werden für alle Anwendungen in der Liste ausgeführt.
**So optimieren Sie Ihre Anwendungen**
1. Wählen Sie im Image Assistant unter **4. Optimieren** die Option **Starten** aus.
1. WorkSpaces Applications startet automatisch die erste Anwendung in Ihrer Liste. Wenn die Anwendung vollständig gestartet wird, machen Sie die notwendigen Eingaben, um die erste Ausführung der Anwendung durchzuführen. Beispielsweise könnte ein Webbrowser Sie zum Import von Einstellungen auffordern, damit er mit vollem Funktionsumfang ausführbar ist.
1. Nachdem Sie den ersten Probelauf durchgeführt haben und geprüft haben, ob die Anwendung läuft, wie erwartet, wählen Sie **Continue (Fortfahren)**. Wenn Sie mehr als eine Anwendung zu Ihrem Abbild hinzugefügt haben, wird jede Anwendung automatisch geöffnet. Wiederholen Sie diesen Schritt bei Bedarf für jede Anwendung, sodass alle Anwendungen laufen.
1. Wenn Sie fertig sind, wird die nächste Registerkarte im Image Assistant, **5. Abbild konfigurieren**, automatisch angezeigt.
## Schritt 6: Beenden Sie das Erstellen Ihres Abbilds
In diesem Schritt wählen Sie einen Namen für das Abbild aus und beenden das Erstellen des Abbilds.
**So erstellen Sie das Abbild**
1. Geben Sie einen eindeutigen Abbildnamen und einen optionalen Anzeigenamen sowie eine optionale Beschreibung für das Abbild ein. Der Bildname darf nicht mit „Amazon“AWS, "“ oder "“ beginnenAppStream.
Sie können dem Abbild auch Tags hinzufügen. Wählen Sie zu diesem Zweck **Add Tag (Tag hinzufügen)** und geben Schüssel und 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). Wählen Sie abschließend **Weiter**.
**Anmerkung**
Wenn Sie ein Basis-Image wählen, das AWS am oder nach dem 7. Dezember 2017 veröffentlicht wird, wird die Option **Immer die neueste Agentenversion verwenden** angezeigt. Diese Option ist standardmäßig ausgewählt. Wir empfehlen, dass Sie diese Option beibehalten, sodass Streaming-Instances, die von dem Image aus gestartet werden, immer die neueste Version des Agenten verwenden. Wenn Sie diese Option deaktivieren, können Sie sie nicht wieder aktivieren, nachdem Sie das Abbild erstellt haben. Informationen zur neuesten Version des WorkSpaces Applications Agent finden Sie unter[WorkSpaces Versionshinweise zum Applications Agent](agent-software-versions.md).
1. Überprüfen Sie unter **6. Prüfen** die Details des Abbilds. Um Änderungen vorzunehmen, wählen Sie **Previous (Zurück)** aus, navigieren Sie zur entsprechenden Registerkarte im Image Assistant, nehmen Sie die gewünschten Änderungen vor und führen Sie dann die erforderlichen Schritte im Image Assistant aus.
1. Nachdem Sie die Abbilddetails überprüft haben, wählen Sie **Disconnect and Create Image (Trennen der Verbindung und Abbild erstellen)** aus.
1. Die Remote-Sitzung wird innerhalb weniger Augenblicke getrennt. Wenn die Nachricht **Lost Connectivity (Konnektivität unterbrochen)** angezeigt wird, schließen Sie die Browser-Registerkarte. Während das Image erstellt wird, wird der Status des Image Builder als **Snapshotting** angezeigt. Sie können keine Verbindung mit dem Image Builder herstellen, bis dieser Vorgang beendet ist.
1. Kehren Sie zur Konsole zurück und rufen Sie **Images** und **Image Registry** auf. Vergewissern Sie sich, dass Ihr neues Abbild in der Liste angezeigt wird.
Während Ihr Abbild erstellt wird, lautet der Abbildstatus im Abbildverzeichnis der Konsole **Pending (Ausstehend)** und Sie können keine Verbindung herstellen.
1. Wählen Sie das Symbol **Refresh (Aktualisieren)** in regelmäßigen Abständen, um den Status zu aktualisieren. Nachdem Ihr Abbild erstellt wurde, ändert sich der Image-Status in **Available (Verfügbar)** und der Image Builder wird automatisch angehalten.
Zum Erstellen weiterer Abbilder starten Sie den Image Builder und stellen Sie eine Verbindung von der Konsole her oder erstellen Sie einen neuen Image Builder.
**Anmerkung**
Nachdem Sie Ihr Abbild erstellt haben, sind Sie für die Wartung der Updates für das Windows-Betriebssystem verantwortlich. Zu diesem Zweck können Sie Image-Updates WorkSpaces für verwaltete Anwendungen verwenden. Sie sind auch für die Wartung von Updates für Ihre Anwendungen und deren Abhängigkeiten verantwortlich. Weitere Informationen finden Sie unter [Behalten Sie Ihr WorkSpaces Amazon-Anwendungsimage Up-to-Date](keep-image-updated.md).
Wenn Sie andere Anwendungen hinzufügen, vorhandene Anwendungen aktualisieren oder Abbildeinstellungen ändern möchten, müssen Sie den Image Builder starten, mit dem Sie das Abbild erstellt haben, und wieder eine Verbindung zu ihm herstellen. Sollte dieser Image Builder bereits gelöscht worden sein, starten Sie basierend auf Ihrem Abbild einen neuen Image Builder. Nehmen Sie dann Ihre Änderungen vor und erstellen Sie ein neues Abbild.
## Schritt 7 (optional): Kennzeichnen und Kopieren eines Abbilds
Sie können einem Abbild während dessen Erstellung oder auch später Tags hinzufügen. Sie können das Abbild auch innerhalb einer Region oder in eine neue Region desselben Amazon-Web-Services-Kontos kopieren. Das Kopieren eines Quell-Images führt zu einem identischen, aber unterschiedlichen Ziel-Image. AWS kopiert jedoch keine benutzerdefinierten Tags. Außerdem können Sie nur benutzerdefinierte Abbilder kopieren, die Sie erstellt haben, nicht die Basisabbilder, die von AWS bereitgestellt werden.
**Anmerkung**
Sie können bis zu zwei Images gleichzeitig in einen Ziel kopieren. Wenn das Ziel, in das Sie ein Image kopieren, keine weiteren Images aufnehmen kann, erhalten Sie eine Fehlermeldung. Um das Image in diesem Fall zu kopieren, müssen Sie zunächst Images vom Ziel entfernen. Sobald das Ziel unterhalb der Grenze des Abbildkontingents (auch als Limit bezeichnet) liegt, starten Sie das Kopieren des Abbildes aus der Quellregion. Weitere Informationen finden Sie unter [Kontingente WorkSpaces für Amazon Applications Service](limits.md).
**Hinzufügen von Tags zu einem vorhandenen Abbild**
1. Wählen Sie im linken Navigationsbereich **Images** und **Image Registry** aus.
1. Wählen Sie in der Image-Liste das Image aus, dem Sie Tags hinzufügen möchten.
1. Wählen Sie **Tags**, **Add/Edit Tags** und **Add Tag**, geben Sie den Schlüssel und den Wert für das Tag an, und wählen Sie dann **Save**.
Weitere Informationen finden Sie unter [Kennzeichnen Ihrer WorkSpaces Amazon-Anwendungsressourcen](tagging-basic.md).
**Ein Image kopieren**
Durch das Kopieren eines Image über geografisch verteilte Regionen können Sie Anwendungen aus mehreren Regionen basierend auf demselben Image streamen. Indem Sie Ihre Anwendungen in größerer Nähe zu Ihren Benutzern streamen, können Sie das Nutzererlebnis beim Streamen von Anwendungen mit WorkSpaces Anwendungen verbessern.
1. Wählen Sie im linken Navigationsbereich **Images** und **Image Registry** aus.
1. Wählen Sie in der Image-Liste das zu kopierende Image aus.
1. Wählen Sie **Aktionen**, **Kopieren**.
1. Geben Sie im Dialogfeld **Copy Image** (Image kopieren) die folgenden Informationen an und wählen Sie anschließend **Copy Image:** (Image kopieren:)
+ Wählen Sie für **Destination region** (Zielregion) die Region aus, in die das neue Image kopiert werden soll.
+ Geben Sie für **Name**einen Namen ein, den das Image in dem Ziel haben soll, in das es kopiert wird.
+ Geben Sie für **Description** (Beschreibung) (optional) eine Beschreibung für das Image in dem Ziel ein, in das es kopiert wird.
1. Um den Fortschritt der Kopieroperation zu überprüfen, kehren Sie auf die Konsole zurück und wählen **Images**, **Image-Registry**. Verwenden Sie die Navigationsleiste, um zur Zielregion zu wechseln (falls zutreffend), und vergewissern Sie sich, dass Ihr neues Image in der Image-Liste enthalten ist.
Das neue Image wird in der Image-Registry Ihrer Konsole zunächst mit dem Status **Copying** (Kopieren) angegeben. Nachdem das Abbild erfolgreich erstellt wurde, ändert sich der Status in **Available**. Nun können Sie das Abbild nutzen, um einen Stack zu starten und Ihre Anwendungen zu streamen.
## Schritt 8: Bereinigen
Abschließend stoppen Sie die ausgeführten Image Builder und setzen die Ressourcen frei, damit für Ihr Konto keine ungewollten Kosten entstehen. Es wird empfohlen, die Ausführung aller ungenutzter Image Builder zu stoppen. Weitere Informationen finden Sie unter [Preise für WorkSpaces Anwendungen](https://aws.amazon.com/appstream2/pricing/).
**So stoppen Sie einen ausgeführten Image Builder**
1. Wählen Sie im Navigationsbereich **Images** und **Image Builders** und dann die ausgeführte Image Builder-Instance aus.
1. Wählen Sie **Actions** und **Stop** aus.
# Verwalte deine Amazon WorkSpaces Applications Images
Verfügbare Images sind in der **Image-Registrierung** in der WorkSpaces Anwendungskonsole aufgeführt und nach Sichtbarkeit wie folgt kategorisiert:
+ **Öffentlich** — Basis-Images, die Eigentum von sind und von ihnen zur Verfügung gestellt werden AWS. Die Basisimages enthalten das neueste Windows-Betriebssystem und die WorkSpaces Applications Agent-Software. Sie können mithilfe dieser Basisabbilder neue Abbilder erstellen, die Ihre eigenen Anwendungen enthalten. Informationen zu den von AWS veröffentlichten Basis-Images finden Sie unter[WorkSpaces Versionshinweise für das Basis-Image und das Managed Image-Update für Anwendungen](base-image-version-history.md).
+ **Privat** — Bilder, die Sie erstellen und besitzen und die Sie nicht mit anderen AWS Konten geteilt haben.
+ **Mit anderen geteilt** — Bilder, die du selbst erstellst und die du besitzt und die du mit einem oder mehreren AWS Konten in derselben AWS Region geteilt hast. Wenn Sie ein Bild mit einem anderen AWS Konto teilen, können Sie angeben, ob das Image für einen Image Builder (um ein neues Image zu erstellen), für eine Flotte oder für beides verwendet werden kann.
+ **Mit mir geteilt** — Bilder, die von einem anderen AWS Konto in derselben AWS Region erstellt wurden und von diesem verwaltet werden und die mit Ihrem AWS Konto geteilt werden. Abhängig von den Berechtigungen, die der Eigentümer bei der Freigabe des Abbilds für Ihr Konto gewährt hat, können Sie dieses Abbild für Image Builder, für Flotten oder für beides verwenden.
**Topics**
+ [Löschen Sie ein privates Bild in Amazon WorkSpaces Applications](delete-private-image.md)
+ [Kopieren Sie ein Bild, das Sie besitzen, in eine andere AWS Region in WorkSpaces Amazon-Anwendungen](copy-image-different-region.md)
+ [Teilen Sie ein Bild, das Sie besitzen, mit einem anderen AWS Konto in Amazon WorkSpaces Applications](share-image-with-another-account.md)
+ [Beenden Sie das Teilen eines Bilds, das Sie besitzen, in WorkSpaces Amazon-Anwendungen](stop-sharing-image-with-all-accounts.md)
+ [Behalten Sie Ihr WorkSpaces Amazon-Anwendungsimage Up-to-Date](keep-image-updated.md)
+ [Windows Update und Antivirensoftware auf WorkSpaces Amazon-Anwendungen](windows-update-antivirus-software.md)
+ [Programmgesteuertes Erstellen eines neuen Images in Amazon-Anwendungen WorkSpaces](create-image-programmatically.md)
+ [In Amazon WorkSpaces Applications enthaltene Anwendungen auf Ihrem Bild verwalten](license-included-applications.md)
+ [Bild importieren](import-image.md)
+ [Bild exportieren](export-image.md)
# Löschen Sie ein privates Bild in Amazon WorkSpaces Applications
Sie können Ihre privaten Abbilder löschen, wenn Sie sie nicht mehr benötigen. Sie können kein Bild löschen, das von Flotten verwendet oder mit anderen AWS Konten geteilt wird. Um ein Abbild löschen zu können, das von Flotten genutzt oder freigegeben wird, müssen Sie das Abbild zuerst aus allen Flotten entfernen und alle Bildfreigabe-Berechtigungen aufheben. Ein einmal gelöschtes Abbild kann nicht wiederhergestellt werden.
**So löschen Sie ein privates Abbild**
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 **Image Registry** aus.
1. Wählen Sie in der Liste der Abbilder das private Abbild aus, das Sie löschen möchten.
1. Klicken Sie auf **Aktionen**, **Löschen** und dann erneut auf **Löschen**.
Das Abbild wird aus der Abbildregistrierung entfernt und gelöscht.
# Kopieren Sie ein Bild, das Sie besitzen, in eine andere AWS Region in WorkSpaces Amazon-Anwendungen
**Wichtig**
Für die AWS-Regionen Asien-Pazifik (Malaysia), Europa (Mailand), Europa (Spanien) und Israel (Tel Aviv): Das regionsübergreifende Kopieren von Bildern wird nur für Images mit WorkSpaces Applications Agent-Versionen unterstützt, die am 02. on/after Oktober 2025 veröffentlicht wurden, oder für Bilder mit verwalteten Updates, die am 05. on/after September 2025 veröffentlicht wurden. Ältere Versionen können nicht zwischen Regionen kopiert werden. Aktualisieren Sie Ihre Images so, dass sie diese Mindestanforderungen an die Version erfüllen, damit Sie regionsübergreifendes Kopieren nutzen können.
Sie können Bilder, die Sie besitzen, in eine andere AWS Region kopieren. Die Verwendung desselben Images in verschiedenen AWS Regionen kann dazu beitragen, die globale Bereitstellung Ihrer Anwendungen in WorkSpaces Anwendungen zu vereinfachen. Indem Sie Ihre Anwendungen in den AWS Regionen bereitstellen, die Ihren Benutzern geografisch am nächsten sind, können Sie dazu beitragen, Ihren Benutzern ein reaktionsschnelleres Erlebnis zu bieten.
**Um ein Bild, das Ihnen gehört, in eine andere AWS Region zu kopieren**
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 **Image Registry** aus.
1. Wählen Sie in der Bilderliste das Bild aus, das Sie in eine andere Region kopieren möchten. AWS
1. Wählen Sie **Aktionen**, **Kopieren**.
1. Wählen **Sie im Dialogfeld Bild kopieren** unter **Zielregion** die AWS Region aus, in die Sie das Bild kopieren möchten.
1. Geben Sie unter **Destination region (Zielregion)** einen eindeutigen Namen und optional eine Beschreibung für das Abbild ein.
1. Klicken Sie auf **Copy Image (Abbild kopieren)**.
# Teilen Sie ein Bild, das Sie besitzen, mit einem anderen AWS Konto in Amazon WorkSpaces Applications
WorkSpaces Anwendungsbilder sind eine regionale Ressource, sodass Sie ein Bild, das Sie besitzen, mit anderen AWS Konten in derselben AWS Region teilen können. Dies kann sich in verschiedenen Situationen als hilfreich erweisen. Wenn Sie beispielsweise Ihre Entwicklungs- und Produktionsressourcen trennen, indem Sie unterschiedliche AWS Konten verwenden, können Sie mithilfe Ihres Entwicklungskontos ein Image erstellen. Sie können das Abbild dann für Ihr Produktionskonto freigeben. Wenn Ihre Organisation ein unabhängiger Softwareanbieter (ISV) ist, können Sie optimierte Abbilder für Ihre Kunden freigeben. Optimierte Abbilder, auf denen die erforderlichen Anwendungen bereits installiert und konfiguriert sind, ermöglichen Ihren Kunden einen schnellen Einstieg in Ihre Anwendungen, da sie diese Anwendungen nicht selbst installieren und konfigurieren müssen.
Wenn Sie ein Image mit einem anderen AWS Konto teilen, geben Sie an, ob das Zielkonto das Image in einer Flotte verwenden oder neue Images erstellen kann, indem Sie einen Image Builder erstellen. Sie sind weiterhin der Eigentümer der von Ihnen freigegebenen Abbilder. Auf diese Weise können Sie ganz nach Bedarf Berechtigungen für Ihre freigegebenen Abbilder hinzufügen, ändern oder entfernen.
Wenn Sie ein Abbild für ein Konto freigeben und dem Konto Flottenberechtigungen erteilen, können anhand des freigegebenen Abbilds im betreffenden Konto Flotten erstellt oder aktualisiert werden. Wenn Sie diese Berechtigungen zu einem späteren Zeitpunkt entfernen, kann das Konto das Abbild nicht mehr verwenden. Für Flotten in dem Konto, die das freigegebene Abbild nutzen, ist als gewünschte Kapazität "0" eingestellt. Dadurch wird verhindert, dass neue Flotten-Instances erstellt werden. Vorhandene Sitzungen werden fortgesetzt, bis die Streaming-Sitzung endet. Damit neue Flotten-Instances erstellt werden können, muss die Flotte im betreffenden Konto mit einem gültigen Abbild aktualisiert werden.
Wenn Sie ein Abbild für ein Konto freigeben und dem Konto-Image Builder die entsprechenden Berechtigungen erteilen, können anhand des freigegebenen Abbilds im betreffenden Konto Image Builder und Abbilder erstellt werden. Wenn Sie diese Berechtigungen zu einem späteren Zeitpunkt entfernen, sind Image Builder und Abbilder, die anhand Ihres Abbilds erstellt wurden, nicht betroffen.
**Wichtig**
Nachdem Sie ein Abbild für ein Konto freigegeben haben, können Sie Image Builder oder Abbilder im betreffenden Konto, die anhand Ihres Abbilds erstellt werden, nicht steuern. Gewähren Sie einem Konto daher nur dann Image-Builder-Berechtigungen, wenn es zum Erstellen einer Kopie Ihres Abbilds fähig sein soll. Behalten Sie weiterhin den Zugriff auf die Kopie, nachdem Sie die Freigabe Ihres Abbilds beendet haben.
**Um ein Bild, das Ihnen gehört, mit einem anderen AWS Konto zu teilen**
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 **Image Registry** aus.
1. Wählen Sie in der Liste der Abbilder das Abbild aus, das Sie freigeben möchten.
1. Klicken Sie auf **Actions (Aktionen)**, **Share (Freigeben)**.
1. Klicken Sie im Dialogfeld **Share Image (Abbild freigeben)** auf **Add account (Konto hinzufügen)**.
1. Geben Sie die 12-stellige AWS Konto-ID des Kontos ein, mit dem Sie das Bild teilen möchten, und wählen Sie dann aus, ob das Konto eine oder beide der folgenden Aktionen ausführen kann:
+ Starten eines Image Builders über das Abbild, wenn Sie ein neues Abbild erstellen möchten.
+ Verwenden des Abbilds mit einer Flotte.
Um ein Konto aus der Liste der Konten zu entfernen, für die das Abbild freigegeben ist, wählen Sie in der Zeile für das Konto, das Sie entfernen möchten, das X-Symbol rechts neben der Option **Use for fleet (Für Flotte verwenden)**.
1. Um das Bild mit weiteren AWS Konten zu teilen, wiederholen Sie Schritt 6 für jedes Konto, mit dem Sie das Bild teilen möchten.
1. Klicken Sie auf **Share Image (Abbild freigeben)**.
**So verfahren Sie zum Hinzufügen oder Aktualisieren der Abbild-Freigabeberechtigungen für ein Abbild in Ihrem Besitz**
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 **Image Registry** aus.
1. Wählen Sie in der Liste der Abbilder das Abbild aus, für das Sie die Berechtigungen ändern möchten.
1. Wählen Sie unterhalb der Liste der Abbilder die Registerkarte **Permissions (Berechtigungen)** für das von Ihnen ausgewählte Abbild. Klicken Sie dann auf **Edit (Bearbeiten)**.
1. Wählen oder deaktivieren Sie im Dialogfeld **Bildberechtigungen bearbeiten** je nach Bedarf eine oder beide der folgenden Optionen zum Teilen von Bildern für ein oder mehrere Konten. AWS Wenn Sie beide Optionen für ein Konto deaktivieren, wird das Abbild nicht mehr für das betreffende Konto freigegeben.
+ Starten eines Image Builders über das Abbild, wenn Sie ein neues Abbild erstellen möchten.
+ Verwenden des Abbilds mit einer Flotte.
Um ein Konto aus der Liste der Konten zu entfernen, für die das Abbild freigegeben ist, wählen Sie in der Zeile für das Konto, das Sie entfernen möchten, das X-Symbol rechts neben der Option **Use for fleet (Für Flotte verwenden)**.
1. Um die Berechtigungen zum Teilen von Bildern für weitere AWS Konten zu bearbeiten, wiederholen Sie Schritt 5 für jedes Konto, für das Sie die Berechtigungen aktualisieren möchten.
1. Klicken Sie auf **Update image sharing permissions (Abbildfreigabe-Berechtigungen aktualisieren)**.
# Beenden Sie das Teilen eines Bilds, das Sie besitzen, in WorkSpaces Amazon-Anwendungen
Gehen Sie wie folgt vor, um das Teilen eines Bilds, das Sie besitzen, mit einem anderen AWS Konto zu beenden.
**Um ein Bild, das dir gehört, nicht mehr mit einem anderen AWS Konto zu teilen**
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 **Image Registry** aus.
1. Wählen Sie in der Liste der Abbilder das Abbild aus, für das Sie die Berechtigungen ändern möchten.
1. Wählen Sie unterhalb der Liste der Abbilder die Registerkarte **Permissions (Berechtigungen)** für das von Ihnen ausgewählte Abbild. Klicken Sie dann auf **Edit (Bearbeiten)**.
1. Wählen **Sie im Dialogfeld Bildberechtigungen bearbeiten** in der Zeile für alle AWS Konten, mit denen das Bild geteilt wurde, das X-Symbol rechts neben der Option **Für Flotte verwenden** aus.
1. Klicken Sie auf **Update image sharing permissions (Abbildfreigabe-Berechtigungen aktualisieren)**.
# Behalten Sie Ihr WorkSpaces Amazon-Anwendungsimage Up-to-Date
Sie können Ihr WorkSpaces Anwendungs-Image behalten, up-to-date indem Sie einen der folgenden Schritte ausführen:
+ [Aktualisieren Sie ein Image mithilfe von Image-Updates WorkSpaces für verwaltete Anwendungen](keep-image-updated-managed-image-updates.md)— Diese Aktualisierungsmethode bietet die neuesten Betriebssystem- und Treiberupdates sowie die neueste WorkSpaces Applications Agent-Software.
+ [Aktualisieren Sie die WorkSpaces Applications Agent-Software mithilfe von Managed WorkSpaces Applications Agent-Versionen](keep-image-updated-manage-image-versions.md)— Diese Aktualisierungsmethode stellt die neueste WorkSpaces Applications Agent-Software bereit.
# Aktualisieren Sie ein Image mithilfe von Image-Updates WorkSpaces für verwaltete Anwendungen
WorkSpaces Applications bietet eine automatisierte Möglichkeit, Ihr Image mit den neuesten Betriebssystemupdates, Anwendungsupdates, Treiberupdates und WorkSpaces Applications Agent-Software zu aktualisieren, die in der Lizenz enthalten sind. Bei Image-Updates für verwaltete WorkSpaces Anwendungen wählen Sie das Image aus, das Sie aktualisieren möchten. WorkSpaces Applications erstellt einen Image Builder für dasselbe AWS Konto und dieselbe Region, um die Updates zu installieren und das neue Image zu erstellen. Nachdem das neue Image erstellt wurde, können Sie es in einer Vorproduktionsflotte testen, bevor Sie Ihre Produktionsflotten aktualisieren oder das Image mit anderen AWS Konten teilen.
**Anmerkung**
Managed WorkSpaces Applications Image Updates sind für die Betriebssysteme Microsoft Windows Server, Red Hat Enterprise Linux und Rocky Linux verfügbar.
**Anmerkung**
Nachdem Ihr neues Image erstellt wurde, sind Sie für die Wartung der Updates für das Betriebssystem verantwortlich. Zu diesem Zweck können Sie weiterhin Image-Updates für verwaltete WorkSpaces Anwendungen verwenden.
Sie sind für die Wartung der Updates für den Amazon EC2 Windows Paravirtual (PV) -Treiber, den ENA-Treiber und den Treiber verantwortlich. AWS NVMe Weitere Informationen zum Aktualisieren der Treiber finden Sie unter [Gerätetreiber für Ihre EC2-Instance verwalten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-device-drivers.html).
Sie sind auch für die Wartung Ihrer Anwendungen und deren Abhängigkeiten verantwortlich. Wenn Sie andere Anwendungen hinzufügen, vorhandene Anwendungen aktualisieren oder Abbildeinstellungen ändern möchten, müssen Sie den Image Builder starten, mit dem Sie das Abbild erstellt haben, und wieder eine Verbindung zu ihm herstellen. Sollte dieser Image Builder bereits gelöscht worden sein, starten Sie basierend auf Ihrem Abbild einen neuen Image Builder. Nehmen Sie dann Ihre Änderungen vor und erstellen Sie ein neues Abbild.
## Voraussetzungen
Im Folgenden werden die Voraussetzungen und Überlegungen für die Arbeit mit verwalteten Abbildaktualisierungen beschrieben.
+ Stellen Sie sicher, dass die Kontingente Ihres WorkSpaces Anwendungskontos (auch als Limits bezeichnet) ausreichen, um die Erstellung eines neuen Image Builders und eines neuen Images zu unterstützen. Um eine Erhöhung des Kontingents zu beantragen, können Sie die Service Quotas Quotas-Konsole unter verwenden [https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/). Informationen zu den standardmäßigen WorkSpaces Anwendungskontingenten finden Sie unter[Kontingente WorkSpaces für Amazon Applications Service](limits.md).
+ Sie müssen Eigentümer des von Ihnen aktualisierten Abbilds sein. Sie können kein Abbild aktualisieren, das für Sie freigegeben wurde.
+ Wenn WorkSpaces Applications einen Image Builder erstellt, um die neuesten Betriebssystemupdates, Treiberupdates und WorkSpaces Applications Agent-Software zu installieren, und das neue Image erstellt, wird Ihnen die Image Builder-Instanz während der Aktualisierung in Rechnung gestellt.
+ Unterstützte Abbilder müssen aus einem Basisabbild erstellt werden, das am 24.07.2017 00:00:00 oder später veröffentlicht wurde.
+ Unterstützte Anzeigesprachen sind Englisch und Japanisch. Weitere Informationen finden Sie unter [Festlegen einer Standardanzeigesprache](configure-default-display-language.md).
+ Verwenden Sie die neueste Version des SSM-Agenten. Versionsinformationen finden Sie unter [WorkSpaces Versionshinweise für das Basis-Image und das Managed Image-Update für Anwendungen](base-image-version-history.md). Weitere Informationen zur Installation finden Sie unter [Manuelles Installieren eines SSM-Agents auf EC2-Instances für Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html).
## Wie aktualisiert man ein Image mithilfe von Image-Updates WorkSpaces für verwaltete Anwendungen
Gehen Sie wie folgt vor, um ein WorkSpaces Anwendungs-Image mit den neuesten Patches, Treiberupdates und WorkSpaces Applications Agent-Software zu aktualisieren.
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 **Image Registry** aus.
1. Wählen Sie in der Abbildliste das zu aktualisierende Abbild aus. Stellen Sie sicher, dass der Status des Abbilds **verfügbar** ist.
1. Wählen Sie **Aktionen**, **Aktualisieren**.
1. Führen Sie im Dialogfeld **Abbild aktualisieren** die folgenden Schritte aus:
+ Geben Sie unter **Neuer Image-Name** einen Imagenamen ein, der innerhalb des AWS Kontos und der Region eindeutig ist. Der Bildname darf nicht mit „Amazon“AWS, "“ oder "“ beginnenAppStream.
+ Unter **Anzeigename für neues Abbild** können Sie optional einen Namen eingeben, der für das Abbild angezeigt werden soll.
+ Unter **Neue Abbildbeschreibung** können Sie optional eine Beschreibung des Abbilds eingeben.
+ Für **Tags** können Sie **Tag hinzufügen** auswählen und den Schlüssel und den Wert für das Tag eingeben. Wiederholen Sie diesen Schritt, um weitere Tags hinzuzufügen. Weitere Informationen finden Sie unter [Kennzeichnen Ihrer WorkSpaces Amazon-Anwendungsressourcen](tagging-basic.md).
1. Wählen Sie **Abbild aktualisieren** aus.
Wenn Ihr derzeitiges Abbild bereits aktuell ist, werden Sie in einer Meldung darüber informiert.
1. Wählen Sie im Navigationsbereich **Abbilder** und dann **Image Builder** aus.
1. Vergewissern Sie sich in der Liste der Image Builder, dass ein neuer Image Builder mit dem Status **Aktualisiert** angezeigt wird. Der Name des Image Builders enthält ein zufälliges 10-stelliges Suffix.
Der Image Builder ist das kleinste Element der Instance-Produktreihe, die Sie in Schritt 5 für das neue Abbild ausgewählt haben. Es wurde kein Subnetz angegeben, da der Image Builder nicht mit Ihrer Virtual Private Cloud (VPC) verbunden ist.
1. Wählen Sie **Image-Registry** und vergewissern Sie sich, dass Ihr neues Abbild in der Liste angezeigt wird.
Während Ihr Abbild erstellt wird, lautet der Abbildstatus in der Abbildregistrierung der Konsole **Wird erstellt**.
1. Nachdem Ihr Image erstellt wurde, führt WorkSpaces Applications einen Qualifizierungsprozess durch, um zu überprüfen, ob das Image erwartungsgemäß funktioniert.
Während dieser Zeit wird der Image Builder, der auch für diesen Prozess verwendet wird, in der Liste **Image Builder** mit dem Status **Ausstehende Qualifizierung** angezeigt.
1. Nachdem der Qualifizierungsprozess erfolgreich abgeschlossen wurde, wird oben in der Konsole eine **Erfolgsmeldung** angezeigt, und der Abbildstatus in der Abbildregistrierung wird als **Verfügbar** angezeigt.
Darüber hinaus wird der Image Builder, den WorkSpaces Applications erstellt hat, automatisch gelöscht.
**Anmerkung**
Je nach Umfang der Betriebssystemupdates kann es mehrere Stunden dauern, bis ein Image-Update abgeschlossen ist. Wenn ein Problem die Aktualisierung des Abbilds verhindert, wird neben dem Abbildnamen ein rotes Symbol mit einem Ausrufezeichen angezeigt, und der Abbildstatus in der Abbildregistrierung wird als **Fehlgeschlagen** angezeigt. Wählen Sie in diesem Fall das Abbild aus, klicken Sie auf die Registerkarte **Benachrichtigungen** und überprüfen Sie alle Fehlerbenachrichtigungen. Weitere Informationen finden Sie im [Abbild „Interner Service“](troubleshooting-notification-codes.md#troubleshooting-notification-codes-image)-Abschnitt zur Fehlerbehebung bei Benachrichtigungscodes in der Dokumentation.
Wenn der Qualifizierungsprozess nicht erfolgreich ist, wird der Image Builder, den WorkSpaces Applications erstellt hat, trotzdem automatisch gelöscht.
1. Nachdem WorkSpaces Applications das neue Image erstellt hat, testen Sie das Image auf einer Vorserienflotte. Nachdem Sie verifiziert haben, dass die Anwendungen erwartungsgemäß arbeiten, aktualisieren Sie die Produktionsflotte mit dem neuen Abbild.
# Aktualisieren Sie die WorkSpaces Applications Agent-Software mithilfe von Managed WorkSpaces Applications Agent-Versionen
WorkSpaces Applications bietet eine automatisierte Möglichkeit, Ihren Image Builder mit neuerer WorkSpaces Applications Agent-Software zu aktualisieren. So können Sie sofort ein neues Abbild erstellen, wenn eine neue Version des Agenten veröffentlicht wird. Anschließend können Sie das Abbild testen, bevor Sie die Produktionsflotten aktualisieren. Weitere Informationen zur Verwaltung der WorkSpaces Applications Agent-Software finden Sie unter[WorkSpaces Agent-Versionen von Anwendungen verwalten](base-images-agent.md).
**Anmerkung**
Sie sind für die Installation und Pflege der Updates für das Windows-Betriebssystem, der Anwendungen und der relevanten Abhängigkeiten verantwortlich.
Gehen Sie wie folgt vor, um Ihr WorkSpaces Anwendungsabbild mit den neuesten Windows-Betriebssystemupdates auf dem neuesten Stand zu halten:
+ Installieren Sie die Anwendungen jedes Mal im neuesten Basisabbild, wenn ein neues Abbild freigegeben wird.
+ Installieren Sie die Updates für das Windows-Betriebssystem, die Anwendungen und die relevanten Abhängigkeiten in einem vorhandenen Image Builder.
+ Installieren Sie die Updates für das Windows-Betriebssystem, die Anwendungen und die relevanten Abhängigkeiten aus einem vorhandenen Abbild in einem neuen Image Builder.
Nachdem Sie ein neues Image mit dem neuesten Windows-Betriebssystem, den Anwendungen und ihren Abhängigkeiten sowie der WorkSpaces Applications Agent-Software erstellt haben, testen Sie das Image auf einer Entwicklungsflotte. Nachdem Sie verifiziert haben, dass die Anwendungen erwartungsgemäß arbeiten, aktualisieren Sie die Produktionsflotte mit dem neuen Abbild.
# Windows Update und Antivirensoftware auf WorkSpaces Amazon-Anwendungen
WorkSpaces Anwendungs-Streaming-Instanzen sind nicht persistent. Wenn eine Benutzer-Streaming-Sitzung endet, beendet WorkSpaces Applications die von der Sitzung verwendete Instance und stellt, abhängig von Ihren Skalierungsrichtlinien, eine neue Instance bereit, die sie in Ihrer Flotte ersetzt. Alle Flotten-Instances werden vom selben Abbild bereitgestellt. Da Abbilder nach der Erstellung nicht mehr geändert werden können, verfügen alle Flotten-Instances, die in Benutzer-Streaming-Sitzungen verwendet werden, nur über die Windows- und Anwendungs-Updates, die bei der Erstellung des Abbilds auf dem zugrunde liegenden Abbild installiert wurden. Da darüber hinaus eine Flotten-Instance, die für eine Streaming-Sitzung verwendet wird, am Ende der Sitzung beendet wird, werden alle Updates an Windows oder an Anwendungen auf der Instance während der Streaming-Sitzung nicht für zukünftige Sitzungen desselben Benutzers oder anderer Benutzer beibehalten.
**Anmerkung**
Wenn Sie die Persistenz von Anwendungseinstellungen für Ihren Stack aktiviert haben, speichert WorkSpaces Applications Windows- und Anwendungskonfigurationsänderungen, die von einem Benutzer vorgenommen wurden, in future Sitzungen für denselben Benutzer, sofern diese Konfigurationsänderungen im Windows-Profil des Benutzers gespeichert werden. Die Persistenzfunktion der Anwendungseinstellungen behält jedoch nur Windows- und Anwendungskonfigurationseinstellungen bei. Software-Updates für Windows oder Anwendungen auf der Streaming-Instance werden nicht beibehalten.
Aus diesen Gründen verfolgt WorkSpaces Applications in Bezug auf Windows Update und Antivirensoftware auf WorkSpaces Applications-Instanzen den folgenden Ansatz.
## Windows Update
Windows Update ist auf WorkSpaces Anwendungs-Basisimages standardmäßig nicht aktiviert. Wenn Sie Windows-Update auf einem Image-Builder aktivieren und dann versuchen, ein Abbild zu erstellen, zeigt Image-Assistant eine Warnung an und deaktiviert Windows-Update während der Abbilderstellung. Um sicherzustellen, dass auf Ihren Flotten-Instances die neuesten Windows-Updates installiert sind, empfehlen wir, dass Sie Windows-Updates auf Ihrem Image-Builder installieren, ein neues Abbild erstellen und Ihre Flotte regelmäßig mit dem neuen Abbild aktualisieren.
## Antivirensoftware
Wenn Sie sich für die Installation von Antivirensoftware auf Ihrem Abbild entscheiden, empfehlen wir, automatische Updates für die Antivirensoftware nicht zu aktivieren. Andernfalls versucht die Antivirensoftware möglicherweise, sich selbst während der Benutzersitzungen mit den neuesten Definitionsdateien oder anderen Updates zu aktualisieren. Dies kann sich auf die Leistung auswirken. Darüber hinaus bleiben Updates an der Antivirensoftware über die aktuelle Benutzersitzung hinaus nicht erhalten. Um sicherzustellen, dass Ihre Flotten-Instances immer über die neuesten Antiviren-Updates verfügen, empfehlen wir, dass Sie einen der folgenden Schritte ausführen:
+ Aktualisieren Sie Ihren Image-Builder und erstellen Sie regelmäßig ein neues Abbild (z. B. mithilfe der [Image Assistant-CLI-Operationen](https://docs.aws.amazon.com/appstream2/latest/developerguide/programmatically-create-image.html)).
+ Verwenden Sie eine Antivirenanwendung, die Scans oder andere Vorgänge an einen always-up-to-date externen Server delegiert.
**Anmerkung**
Auch wenn Sie keine automatischen Updates für Ihre Antivirensoftware aktivieren, führt die Antivirensoftware möglicherweise Festplattenscans oder andere Vorgänge durch, die sich auf die Leistung Ihrer Flotten-Instances während der Benutzersitzungen auswirken können.
Auf Basisimages für Windows Server 2025/2022/2019/2016 für WorkSpaces Anwendungen, die am oder nach dem 10. September 2019 veröffentlicht wurden, ist Windows Defender standardmäßig nicht aktiviert. In den am 24. Juni 2019 veröffentlichten Basisimages der WorkSpaces Anwendungen Windows Server 2016 und Windows Server 2019 ist Windows Defender standardmäßig aktiviert.
**So aktivieren Sie Windows Defender manuell:**
Wenn Windows Defender auf dem Basisabbild nicht aktiviert ist, können Sie es manuell aktivieren. Führen Sie dazu die folgenden Schritte aus:
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 **Abbilder** und **Image Builder** aus.
1. Wählen Sie den Image Builder aus, für den Windows Defender aktiviert werden soll, überprüfen Sie, ob er sich im Status **Running (Ausführen)** befindet, und wählen Sie **Connect (Verbinden)**.
1. Um diesen Schritt abzuschließen, melden Sie sich am Image Builder mit dem lokalen **Administrator**-Konto oder einem Domainkonto mit lokalen Administratorberechtigungen an.
1. Öffnen Sie den Registrierungs-Editor.
1. Navigieren Sie zum folgenden Speicherort in der Registrierung: **HKLM\$1 SOFTWARE\$1 Policies\$1 Microsoft\$1 Windows Defender\$1**. DisableAntiSpyware
1. Um diesen Registrierungsschlüssel zu bearbeiten, doppelklicken Sie darauf, oder klicken Sie mit der rechten Maustaste auf den Registrierungsschlüssel, und wählen Sie **Modify (Ändern)**.
1. Ändern Sie im Dialogfeld **Edit DWORD (32-bit) Value (DWORD-Wert (32-Bit) ändern)** unter **Value data (Wertdaten)** **1** zu **0**.
1. Wählen Sie **OK** aus.
1. Schließen Sie den Registrierungseditor.
1. Öffnen Sie das Microsoft Management Console(MMC)**-Services**-Snap-In (`services.msc`).
1. Führen Sie in der Liste der Dienste einen der folgenden Schritte aus.
Wenn Sie Microsoft Windows Server 2022/2025 verwenden, gehen Sie wie folgt vor:
+ Klicken Sie mit der rechten Maustaste auf **Microsoft Defender Antivirus Service** und wählen Sie **Start**.
+ Doppelklicken Sie auf **Microsoft Defender Antivirus Service**, wählen Sie im Eigenschaftendialogfeld **Start** und anschließend **OK**.
Wenn Sie Microsoft Windows Server 2019 oder 2016 verwenden, gehen Sie wie folgt vor:
+ Klicken Sie mit der rechten Maustaste auf **Windows Defender Antivirus Service**, und wählen Sie **Start**.
+ Doppelklicken Sie auf **Windows Defender Antivirus Service**, wählen Sie **Start** im Eigenschaftendialogfeld, und wählen Sie dann **OK**.
1. Schließen Sie das **Services**-Snap-in.
# Programmgesteuertes Erstellen eines neuen Images in Amazon-Anwendungen WorkSpaces
Sie können WorkSpaces Anwendungs-Images programmgesteuert erstellen, indem Sie eine Verbindung zu einem Image Builder herstellen und die Befehlszeilenschnittstellen (CLI) von Image Assistant verwenden. Weitere Informationen finden Sie unter [Erstellen Sie Ihr WorkSpaces Amazon-Anwendungs-Image programmgesteuert mithilfe der Cli-Operationen von Image Assistant](programmatically-create-image.md).
# In Amazon WorkSpaces Applications enthaltene Anwendungen auf Ihrem Bild verwalten
Sie können die folgenden in der Microsoft-Lizenz enthaltenen WorkSpaces Anwendungen mithilfe von Applications streamen. Sie können diese Anwendungen auf Ihrem Windows-Abbild installieren, dieses benutzerdefinierte Abbild verwenden, um eine (n) Flotte (n) zu erstellen, und diese Anwendungen dann streamen. Alle folgenden Anwendungen sind in 32-Bit- und 64-Bit-Architektur verfügbar:
+ Microsoft Office LTSC Professional Plus 2021/2024
+ Microsoft Visio LTSC Professional 2021/2024
+ Microsoft Project Professional 2021/2024
+ Microsoft Office LTSC-Standard 2021/2024
+ Microsoft Visio LTSC-Standard 2021/2024
+ Microsoft Projektstandard 2021/2024
**Wichtig**
Microsoft Office, Visio und Project müssen denselben Versionen folgen. Sie können beispielsweise nicht 2021-Anwendungen mit 2024-Anwendungen mischen.
Microsoft Office, Visio und Project müssen derselben Architektur folgen. Beispielsweise können Sie 32-Bit-Anwendungen nicht mit 64-Bit-Anwendungen kombinieren.
Die Standard/Professional versions are supported on Microsoft Windows Server 2019/2022/2025. Microsoft Office, Visio, and Project 2024 Standard/Professional Versionen Microsoft Office, Visio und Project 2021 werden auf Microsoft Windows Server 2022 und 2025 unterstützt.
Um diese Funktion zu aktivieren, müssen Sie einen WorkSpaces Applications Image Builder verwenden, der einen WorkSpaces Applications Agent verwendet, der am oder nach dem 2. Oktober 2025 veröffentlicht wurde. Weitere Informationen finden Sie unter [WorkSpaces Agent-Versionen von Anwendungen verwalten](base-images-agent.md). Oder Ihr Image muss Image-Updates für verwaltete WorkSpaces Anwendungen verwenden, die am oder nach dem 3. Oktober 2025 veröffentlicht wurden. Weitere Informationen finden Sie unter [Behalten Sie Ihr WorkSpaces Amazon-Anwendungsimage Up-to-Date](keep-image-updated.md).
Ausgehendes TCP auf Port 1688 muss auf der Verwaltungsnetzwerkschnittstelle aller Streaming-Instanzen geöffnet sein.
Allen Benutzern, die über eine Flotte streamen, die von einem Image mit einer oder mehreren lizenzierten Apps betrieben wird, werden diese Apps unabhängig von ihrer Nutzung monatlich in Rechnung gestellt. Die Funktion für Anwendungsberechtigungen schränkt den Zugriff für bestimmte Benutzer nicht ein.
In der Lizenz enthaltene Anwendungen in Image Builder sind nicht aktiviert, da sie zu Verwaltungszwecken installiert wurden. Die Aktivierung erfolgt, wenn Benutzer über eine Flotteninstanz streamen.
**Topics**
+ [Sehen Sie sich die Liste der in der Lizenz enthaltenen Anwendungen an, die auf Ihrem Image installiert sind](view-list-image.md)
+ [Sehen Sie sich die Liste der in der Lizenz enthaltenen Anwendungen in Ihrem Image Builder an](view-list-apps.md)
+ [Installieren oder deinstallieren Sie in der Lizenz enthaltene Anwendungen](install-uninstall-apps.md)
+ [Aktivieren Sie Updates für Anwendungen, die in der Lizenz enthalten sind, auf Image Builder](updates-image-builder.md)
+ [Aktivieren Sie Updates für lizenzierte Anwendungen auf Image Builder mit Powershell](enable-updates-managed-powershell.md)
+ [Aktivieren Sie Updates für lizenzierte Anwendungen auf Image Builder mit Managed Image Update](enable-updates-managed.md)
# Sehen Sie sich die Liste der in der Lizenz enthaltenen Anwendungen an, die auf Ihrem Image installiert sind
**Sehen Sie sich die Liste der in der Lizenz enthaltenen Anwendungen an, die auf Ihrem Image installiert sind**
Gehen Sie wie folgt vor, um die Liste der auf Ihrem Image installierten lizenzierten Anwendungen anzuzeigen.
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 und auf der Registerkarte Image-Registrierung die Option **Images** aus.**
1. Wählen Sie ein Bild aus und wählen Sie „**Details anzeigen**“.
1. Sehen Sie sich die Liste aller installierten Anwendungen unter In der **Lizenz enthaltene Anwendungen** an.
# Sehen Sie sich die Liste der in der Lizenz enthaltenen Anwendungen in Ihrem Image Builder an
**Sehen Sie sich die Liste der in der Lizenz enthaltenen Anwendungen auf Ihrem Image Builder an**
Gehen Sie wie folgt vor, um die Liste der in Lizenz enthaltenen Anwendungen auf Ihrem Image Builder anzuzeigen.
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 und auf der Registerkarte Image Builder die Option **Images** aus.**
1. Wählen Sie einen Image Builder aus und klicken Sie **auf Details anzeigen**.
1. Sehen Sie sich die Liste der Anwendungen und deren Status unter In der **Lizenz enthaltene Anwendungen** an.
# Installieren oder deinstallieren Sie in der Lizenz enthaltene Anwendungen
**Installieren oder deinstallieren Sie Anwendungen, die in der Lizenz enthalten sind**
Gehen Sie wie folgt vor, um eine oder mehrere in der Lizenz enthaltene (n) Anwendung (en) auf Ihrem Image zu installieren oder zu deinstallieren.
1. Führen Sie eine der folgenden Optionen aus:
+ Starten Sie einen Image Builder und konfigurieren Sie die in der Lizenz enthaltenen Anwendungen. Weitere Informationen finden Sie unter [Starten eines Image Builder zum Installieren und Konfigurieren von Streaming-Anwendungen](tutorial-image-builder-create.md).
+ Verwalten Sie Anwendungen, die in der Lizenz enthalten sind, auf Ihrem Image Builder. Weitere Informationen finden Sie unter [Attributbasierte Anwendungsberechtigungen mithilfe eines Drittanbieter-SAML-2.0-Identitätsanbieters](application-entitlements-saml.md).
1. Wenn Sie ein Image mit einer oder mehreren in der Lizenz enthaltenen Anwendungen erstellt haben, können Sie dieses Image verwenden, um Flotten zu erstellen. Benutzer, die eine Verbindung zu dieser Flotte herstellen, können auf diese Anwendungen zugreifen.
**Wichtig**
Allen Benutzern, die über eine Flotte streamen, die von einem Image mit einer oder mehreren lizenzierten Apps betrieben wird, werden diese Apps unabhängig von ihrer Nutzung monatlich in Rechnung gestellt. Die Funktion für Anwendungsberechtigungen schränkt den Zugriff für bestimmte Benutzer nicht ein.
Wenn bei der Installation oder Deinstallation von Apps, die eine Lizenz enthalten, Fehler auftreten, wird auf der Detailseite von Image Builder ein Fehlerstatus angezeigt. Um diese Probleme zu beheben, empfehlen wir, eine Verbindung zu Ihrem Image Builder herzustellen und die ausführliche Protokollierung zu aktivieren. Weitere Informationen finden Sie unter [So aktivieren Sie Microsoft 365-Apps für die Unternehmensprotokollierung](https://learn.microsoft.com/en-us/troubleshoot/microsoft-365-apps/diagnostic-logs/how-to-enable-office-365-proplus-uls-logging). Wenn das Problem nach der Überprüfung der Protokolle und der Problembehandlung weiterhin besteht, wenden Sie sich an uns, um Hilfe AWS Support zu erhalten.
# Aktivieren Sie Updates für Anwendungen, die in der Lizenz enthalten sind, auf Image Builder
**Aktivieren Sie Updates für in der Lizenz enthaltene Anwendungen auf Image Builder**
Updates für alle in der Lizenz enthaltenen Anwendungen sind standardmäßig deaktiviert. Sie können Updates für diese Anwendungen im Image Builder mit einem Image aktivieren, das eine oder mehrere dieser Anwendungen enthält. Updates für Flotteninstanzen bleiben deaktiviert, um eine Installation während der Sitzungseinrichtung zu verhindern.
Es gibt drei Optionen für die Aktivierung von Updates für Anwendungen, die eine Lizenz enthalten, in Image Builder.
Gehen Sie wie folgt vor, um Updates für lizenzierte Anwendungen in Image Builder über das Anwendungsmenü zu aktivieren.
1. Öffnen Sie eine beliebige Anwendung, in der eine Lizenz enthalten ist.
1. Wählen Sie „**Datei**“, „**Konto**“, **„Aktualisierungsoptionen**“ und „**Updates aktivieren**“.
# Aktivieren Sie Updates für lizenzierte Anwendungen auf Image Builder mit Powershell
Gehen Sie folgendermaßen vor, um Updates für lizenzierte Anwendungen auf Image Builder mit Powershell zu aktivieren.
+ Führen Sie den folgenden Befehl PowerShell als Administrator aus:
`Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration" -Name UpdatesEnabled -Value True `
# Aktivieren Sie Updates für lizenzierte Anwendungen auf Image Builder mit Managed Image Update
Gehen Sie wie folgt vor, um Updates für lizenzierte Anwendungen auf Image Builder mit Managed Image Update zu aktivieren.
+ Verwenden Sie Managed Image Update, um Updates für Anwendungen zu erhalten, die in der Microsoft-Lizenz enthalten sind. Die Ausgabe des obigen Befehls sieht in etwa folgendermaßen aus (JSON format).
[Aktualisieren Sie ein Image mithilfe von Image-Updates WorkSpaces für verwaltete Anwendungen](keep-image-updated-managed-image-updates.md).
# 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/"
}
]
```
# Bild exportieren
Sie können Ihre Bilder exportieren, um sie zu erstellen EC2 AMIs. Später können Sie [Bild importieren](import-image.md) diese AMIs wieder verwenden, um WorkSpaces Anwendungs-Images zu erstellen. Dies hilft Ihnen, Ihre eigenen AMI-Anpassungstools für die Anpassung Ihrer Bilder zu verwenden.
**Anmerkung**
Während des Exports werden folgende Komponenten aus Ihren Bildern entfernt
WorkSpaces Anwendungsagent
Die Microsoft-Lizenz umfasste Anwendungen, die mit Image Builder hinzugefügt wurden
Nur Microsoft Windows Server 2022- und 2025-Bilder können exportiert werden.
## Anforderungen an die IAM-Rolle
**Wichtig**
Erstellen Sie eine IAM-Rolle mit den folgenden Berechtigungen, die Sie für den Exportimport verwenden können:
```
{
"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": "*"
}
]
}
```
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 exportieren
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 **Image Registry** aus.
1. Wählen Sie in der Bilderliste das private Image aus, das Sie exportieren möchten.
1. Wählen Sie **Aktionen**, **Exportieren**.
1. Geben **Sie im Dialogfeld Image exportieren** einen eindeutigen **AMI-Namen** und optional eine **AMI-Beschreibung** für das AMI ein.
1. **IAM-Rolle** — Wählen Sie die IAM-Rolle aus, die Sie für den Image-Export erstellt haben.
1. Sie können optional Tags von Ihrem Image in das AMI kopieren, indem **Sie das Kontrollkästchen Tags im Export kopieren** aktivieren.
1. Wählen Sie **Bild exportieren**.
# Erstellen Sie Ihr WorkSpaces Amazon-Anwendungs-Image programmgesteuert mithilfe der Cli-Operationen von Image Assistant
Sie können Amazon WorkSpaces Applications-Images erstellen, indem Sie eine Verbindung zu einem Image Builder herstellen und die grafische Benutzeroberfläche (GUI) oder die Befehlszeilenschnittstelle (CLI) von Image Assistant verwenden. Die Image Assistant-CLI-Operationen bieten Funktionen ähnlich wie die Image Assistant-GUI. Mit diesen Operationen können Sie programmgesteuert Folgendes tun:
+ Verwalten der Anwendungen, die in einem Abbild enthalten sind
+ Speichern, Aktualisieren und Zurücksetzen der Standardanwendungseinstellungen
+ Aktivieren oder deaktivieren Sie das dynamische WorkSpaces Anwendungs-Framework für Anwendungen.
+ Eingeben von Tags
+ Erstellen eines Abbilds
Sie können diese Operationen verwenden, um die Erstellung von WorkSpaces Anwendungs-Images in Ihren kontinuierlichen Integrations- oder Bereitstellungsprozess für Software zu integrieren.
Um mit den CLI-Operationen des Image Assistant zu arbeiten, verwenden Sie die Befehlszeilen-Shell Ihrer Wahl auf einem Image Builder. Sie können beispielsweise die Windows-Eingabeaufforderung oder verwenden PowerShell.
**Anmerkung**
Der Image Builder muss eine Version des WorkSpaces Applications Agent verwenden, die am oder nach dem 26. Juli 2019 veröffentlicht wurde. Wenn Sie nicht über einen Image Builder verfügen, müssen Sie einen erstellen. Weitere Informationen finden Sie unter [Starten eines Image Builder zum Installieren und Konfigurieren von Streaming-Anwendungen](tutorial-image-builder-create.md).
**Topics**
+ [Erstellen von Standardanwendungs- und -Windows-Einstellungen mit den CLI-Operationen des Image Assistant](create-default-app-windows-settings-image-assistant.md)
+ [Optimieren der Startleistung Ihrer Anwendungen mit den CLI-Operationen des Image Assistant](optimize-app-launch-performance-image-assistant-cli.md)
+ [Prozessübersicht für die programmgesteuerte Erstellung eines Amazon WorkSpaces Applications-Images](process-overview-creating-image-programmatically-image-assistant-cli.md)
+ [Image Assistant CLI-Operationen zum Erstellen und Verwalten Ihres Amazon WorkSpaces Applications-Images](cli-operations-managing-creating-image-image-assistant.md)
# Erstellen von Standardanwendungs- und -Windows-Einstellungen mit den CLI-Operationen des Image Assistant
Sie können Standardanwendungen und Windows-Einstellungen erstellen, damit Ihre Benutzer schnell mit ihren Anwendungen beginnen können. Wenn Sie diese Einstellungen erstellen, ersetzt WorkSpaces Applications das Windows-Standardbenutzerprofil durch das Profil, das Sie konfigurieren. Anhand des Windows-Standard-Benutzerprofils werden dann die anfänglichen Einstellungen für Benutzer in der Flotten-Instance erstellt. Wenn Sie diese Einstellungen mit Hilfe der Image Assistant CLI-Operationen erstellen, sollte Ihr Anwendungsinstallationsprogramm oder die Automatisierung das Windows-Standardbenutzerprofil direkt ändern.
Um das Windows-Standardbenutzerprofil mit dem eines anderen Windows-Benutzers zu überschreiben, können Sie auch die CLI-Operation `update-default-profile` des Image Assistant verwenden.
Weitere Informationen zur Konfiguration der Standardanwendungs- und Windows-Einstellungen finden Sie unter *Erstellen von Standardanwendungs- und Windows-Einstellungen für Ihre WorkSpaces Anwendungsbenutzer* in[Standardanwendungs- und Windows-Einstellungen sowie Leistung beim Starten von WorkSpaces Anwendungen in Amazon Applications](customizing-appstream-images.md).
# Optimieren der Startleistung Ihrer Anwendungen mit den CLI-Operationen des Image Assistant
WorkSpaces Mit Anwendungen können Sie die Startleistung Ihrer Anwendungen für die Streaming-Sitzungen Ihrer Benutzer optimieren. Wenn Sie dies tun, indem Sie die Image Assistant-CLI-Operationen verwenden, können Sie die zu optimierenden Dateien für Ihre Anwendung einzlen angeben. Das Hinzufügen von Dateien zum Manifest zur Anwendungsoptimierung verkürzt die Zeit, die die Anwendung benötigt, um zum ersten Mal auf einer neuen Flotten-Instance zu starten. Dadurch dauert es aber auch länger, bis die Flotten-Instances den Nutzern zur Verfügung gestellt werden. Das Optimierungsmanifest ist eine zeilengetrennte Textdatei, die für jede Anwendung erstellt wird.
**Anmerkung**
Wenn Sie Anwendungsoptimierungsmanifeste sowohl mit den CLI-Operationen des Image Assistant als auch mit der Image Assistant GUI integrieren, werden die Manifeste zusammengeführt.
Im Folgenden finden Sie ein Beispiel für eine Manifestdatei zur Anwendungsoptimierung:
```
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
```
Weitere Informationen zum Optimieren der Startleistung Ihrer Anwendungen finden Sie unter *Optimieren der Startleistung Ihrer Anwendungen* in [Standardanwendungs- und Windows-Einstellungen sowie Leistung beim Starten von WorkSpaces Anwendungen in Amazon Applications](customizing-appstream-images.md).
# Prozessübersicht für die programmgesteuerte Erstellung eines Amazon WorkSpaces Applications-Images
Sie können die CLI-Operationen von Image Assistant zusammen mit der Automatisierung Ihrer Anwendungsinstallation verwenden, um einen vollständig programmgesteuerten Workflow für die Erstellung von WorkSpaces Anwendungs-Images zu erstellen. Nachdem die Automatisierung der Anwendungsinstallation abgeschlossen ist, aber bevor das Abbild erstellt wird, verwenden Sie die CLI-Operationen des Image Assistant, um Folgendes festzulegen:
+ Die ausführbaren Dateien, die Ihre Benutzer starten können
+ Die Optimierungsmanifeste für Ihre Anwendungen
+ WorkSpaces Bildmetadaten für andere Anwendungen
In der folgenden allgemeinen Übersicht wird der Prozess zum programmgesteuerten Erstellen eines WorkSpaces Anwendungsabbilds beschrieben.
1. Verwenden Sie die Installationsautomatisierung Ihrer Anwendung, um die erforderlichen Anwendungen auf Ihrem Image Builder zu installieren. Diese Installation kann Anwendungen enthalten, die Ihre Benutzer starten werden, sowie mögliche Abhängigkeiten und Hintergrundanwendungen.
1. Bestimmen Sie die zu optimierenden Dateien und Ordner.
1. Verwenden Sie gegebenenfalls den `add-application` CLI-Vorgang Image Assistant, um die Anwendungsmetadaten und das Optimierungsmanifest für das WorkSpaces Anwendungs-Image anzugeben.
1. Um weitere Anwendungen für das WorkSpaces Anwendungs-Image anzugeben, wiederholen Sie die Schritte 1 bis 3 für jede Anwendung nach Bedarf.
1. Falls zutreffend, verwenden Sie die CLI-Operation `update-default-profile` des Image Assistant, um das Standard-Windows-Profil zu überschreiben und Standardanwendungs- und -Windows-Einstellungen für Ihre Benutzer zu erstellen.
1. Verwenden Sie die CLI-Operation `create-image` des Image Assistant, um das Abbild zu erstellen.
# Image Assistant CLI-Operationen zum Erstellen und Verwalten Ihres Amazon WorkSpaces Applications-Images
In diesem Abschnitt werden die CLI-Operationen von Image Assistant beschrieben, mit denen Sie Ihr WorkSpaces Anwendungs-Image erstellen und verwalten können.
In Windows Image Buildern befindet sich die ausführbare Datei, die die Befehlszeilenschnittstelle enthält, unter: C:\$1Program Files\$1 Amazon\$1 Photon\$1ConsoleImageBuilder\$1 Image-Assistant.exe. Praktischerweise ist diese ausführbare Datei in der Windows PATH-Variablen enthalten. So können Sie die CLI-Operationen des Image Assistant aufrufen, ohne den absoluten Pfad zur ausführbaren Datei anzugeben. Um diese Operationen aufzurufen, geben Sie den **image-assistant.exe**-Befehl ein.
Auf Linux-Image-Buildern befindet sich das Image-Assistant-Tool unter/usr/local/appstream/image-assistant/AppStreamImageAssistant, with a symbolic link at /bin/AppStreamImageAssistant.
## `help`-Operation
Ruft eine Liste aller CLI-Operationen des Image Assistant ab. Für jede Operation in der Liste wird eine Beschreibung und Verwendungssyntax angegeben. Um Hilfe für eine bestimmte Operation anzuzeigen, geben Sie den Namen der Operation und den Parameter **--help** ein. Beispiel:
```
add-application --help
```
**Syntax**
```
help
```
**Ausgabe**
Druckt die Liste der verfügbaren Operationen mit einer Beschreibung der Funktion an die Standardausgabe.
## `add-application`-Operation
Fügt die Anwendung der Anwendungsliste für WorkSpaces Anwendungsbenutzer hinzu. Anwendungen in dieser Liste sind im Anwendungskatalog enthalten. Der Anwendungskatalog wird Benutzern angezeigt, wenn sie sich bei einer WorkSpaces Anwendungs-Streaming-Sitzung anmelden.
**Anmerkung**
Wenn Sie Änderungen an einer Anwendungskonfiguration vornehmen müssen, entfernen Sie die Anwendung und fügen Sie die Anwendung mit den aktualisierten Einstellungen hinzu.
**Syntax**
```
add-application
--name
--absolute-app-path
[--display-name ]
[--absolute-icon-path ]
[--working-directory ]
[--launch-parameters <""-escaped value>]
[--absolute-manifest-path ]
```
**Optionen**
**`--name` (string)**
Ein eindeutiger Name für die Anwendung. Die maximale Länge beträgt 256 Zeichen. Sie können bis zu 50 Anwendungen hinzufügen. Sie können keine Leerzeichen verwenden.
**`--absolute-app-path` (string)**
Der absolute Pfad zu der ausführbaren Datei, eine Batchdatei oder ein Skript für die Anwendung. Der Pfad muss auf eine gültige Datei verweisen.
**`--display-name` (string)**
Der Anzeigename für die Anwendung im Anwendungskatalog. Wenn Sie keinen Anzeigenamen angeben, erstellt WorkSpaces Applications einen Namen, der vom Namen der ausführbaren Datei abgeleitet ist. Der Name wird ohne Dateierweiterung und mit Unterstrichen anstelle von Leerzeichen erstellt. Die maximale Länge beträgt 256 Zeichen.
**`--absolute-icon-path` (string)**
Der absolute Pfad zum Symbol für die Anwendung. Der Pfad muss auf eine gültige Symboldatei eines der folgenden Dateitypen verweisen: .jpg, .png oder .bmp. Die maximalen Abmessungen lauten: 256 px x 256 px. Wenn Sie keinen Pfad angeben, wird das Standardsymbol der ausführbaren Datei verwendet, sofern verfügbar. Wenn für die ausführbare Datei kein Standardsymbol verfügbar ist, wird ein Standardsymbol für WorkSpaces Anwendungen verwendet.
**`--working-directory` (string)**
Das anfängliche Arbeitsverzeichnis für die Anwendung beim Start der Anwendung.
**`--absolute-manifest-path` (string)**
Der Pfad zu einer neuen zeilengetrennte Textdatei. Die Datei gibt die absoluten Pfade der zu optimierenden Dateien an, bevor die Flotten-Instance einem Benutzer zum Streaming zur Verfügung gestellt wird. Der Pfad muss auf eine gültige Textdatei verweisen.
**Message Ausgabe**
| Beendigungscode | An Standardausgang gedruckte Nachricht | Description |
| --- | --- | --- |
| 0 | \$1"Status": 0, "Nachricht": "Erfolgreich"\$1 | Die Anwendung wurde erfolgreich hinzugefügt. |
| 1 | \$1"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"\$1 | Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen. |
| 1 | \$1"Status": 1, "Nachricht": "Fehler beim Hinzufügen von mehr als 50 Anwendungen zum Katalog."\$1 | Die Anwendung konnte nicht hinzugefügt werden, da die maximale Anzahl von Anwendungen, die dem WorkSpaces Anwendungskatalog hinzugefügt werden können, 50 beträgt. |
| 1 | \$1"Status": 1, "Nachricht": "Name ist nicht eindeutig"\$1 | Eine Anwendung mit diesem Namen ist bereits im WorkSpaces Anwendungskatalog vorhanden. |
| 1 | \$1"status“: 1, „message“: „Datei nicht gefunden (absolute-app-path)"\$1 | Die für absolute-app-path angegebene Datei konnte nicht gefunden werden. |
| 1 | \$1"Status": 1, "Nachricht": "Nicht unterstützte Dateierweiterung"\$1 | Der Parameter Absolute-app-path unterstützt nur die folgenden Dateitypen: .exe und.bat |
| 1 | \$1"Status": 1, "Nachricht": "Verzeichnis nicht gefunden (Arbeitsverzeichnis)" | Das für working-directory angegebene Verzeichnis konnte nicht gefunden werden. |
| 1 | \$1"status": 1, "message": "Optimization-manifest not found: "\$1 | Die für optimization-manifest angegebene Datei konnte nicht gefunden werden. |
| 1 | \$1"Status": 1, "Nachricht": "Datei nicht gefunden: "\$1 | Eine Datei, die innerhalb des Optimierungsmanifests angegeben wurde, konnte nicht gefunden werden. |
| 255 | \$1"Status": 255, "Nachricht": \$1 | Ein unerwarteter Fehler ist aufgetreten. Versuchen Sie es erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an, AWS Support um Unterstützung zu erhalten. Weitere Informationen finden Sie unter [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
## `remove-application`-Operation
Entfernt eine Anwendung aus der Anwendungsliste für das WorkSpaces Anwendungs-Image. Die Anwendung wurde nicht deinstalliert oder geändert, aber Benutzer können sie nicht über den Anwendungskatalog der WorkSpaces Anwendungen starten.
**Syntax**
```
remove-application
--name
```
**Optionen**
**`--name` (string)**
Die eindeutige Kennung der zu entfernenden Anwendung.
**Message Ausgabe**
| Beendigungscode | An Standardausgang gedruckte Nachricht | Description |
| --- | --- | --- |
| 0 | \$1"Status": 0, "Nachricht": "Erfolgreich"\$1 | Die Anwendung wurde erfolgreich entfernt. |
| 1 | \$1"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"\$1 | Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen. |
| 1 | \$1"Status": 1, "Nachricht": "Anwendung nicht gefunden"\$1 | Die angegebene Anwendung konnte im WorkSpaces Anwendungskatalog nicht gefunden werden. |
| 255 | \$1"Status": 255, "Nachricht": \$1 | Ein unerwarteter Fehler ist aufgetreten. Versuchen Sie es erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an, AWS Support um Unterstützung zu erhalten. Weitere Informationen finden Sie unter [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
## `list-applications`-Operation
Listet alle Anwendungen auf, die im Anwendungskatalog aufgeführt sind.
**Syntax**
```
list-applications
```
**Message Ausgabe**
| Beendigungscode | An Standardausgang gedruckte Nachricht | Description |
| --- | --- | --- |
| 0 | \$1"Status": "0", "Nachricht": "Erfolgreich", "Anwendungen": [\$1"app1"\$1, \$1........ app2"\$1]\$1 | Liste der Anwendungen im WorkSpaces Anwendungskatalog. |
| 255 | \$1"Status": 255, "Nachricht": \$1 | Ein unerwarteter Fehler ist aufgetreten. Versuchen Sie es erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an uns, AWS Support um Unterstützung zu erhalten. Weitere Informationen finden Sie unter [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
## `update-default-profile`-Operation
Kopiert das angegebene Windows-Benutzerprofil in das Windows-Standard-Benutzerprofil. Neue streamende Benutzer erben die im angegebenen Profil gespeicherten Einstellungen.
**Anmerkung**
Dieser Vorgang wird vom CLI-Tool des Linux Image Assistant nicht unterstützt.
**Syntax**
```
update-default-profile
[--profile ]
```
**Optionen**
**`--profile` (string)**
Der Name des Benutzers, dessen Windows-Profil in das Windows-Standardbenutzerprofil kopiert wird. Verwenden Sie das folgende Format für den Namen:
"\$1"
Wenn Ihr Image Builder nicht mit einer Microsoft Active Directory-Domäne verknüpft ist, geben Sie einen Punkt "." für die Domäne ein. Wenn Sie keinen Benutzer angeben, wird das WorkSpaces Applications Template-Benutzerkonto verwendet.
**Message Ausgabe**
| Beendigungscode | An Standardausgang gedruckte Nachricht | Description |
| --- | --- | --- |
| 0 | \$1"Status": 0, "Nachricht": "Erfolgreich"\$1 | Die Benutzereinstellungen wurden erfolgreich in das Standardprofil von Windows kopiert. |
| 1 | \$1"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"\$1 | Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen. |
| 1 | \$1"Status": 1, "Nachricht": "Datei oder Ordner konnte nicht kopiert werden: . "\$1 | Die Benutzereinstellungen konnten nicht kopiert werden, da eine Datei oder ein Ordner nicht verfügbar war. |
| 1 | \$1"Status": 1, "Nachricht": "Ein Domänenbenutzer, der nicht mit einer Domäne verknüpft ist, kann nicht kopiert werden""\$1 | Es wurde ein Microsoft Active Directory-Domänenbenutzer angegeben, aber der Image Builder ist nicht mit einer Active Directory-Domäne verbunden. |
| 255 | \$1"Status": 255, "Nachricht": \$1 | Ein unerwarteter Fehler ist aufgetreten. Versuchen Sie es erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an, AWS Support um Unterstützung zu erhalten. Weitere Informationen finden Sie unter [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
## `reset-user-profile`-Operation
Löscht das Windows-Benutzerprofil für den angegebenen Benutzer.
**Anmerkung**
Dieser Vorgang wird vom CLI-Tool des Linux Image Assistant nicht unterstützt.
**Syntax**
```
reset-user-profile
[--profile ]
```
**Optionen**
**`--profile` (string)**
Der Name des Windows-Benutzers, dessen Windows-Profil gelöscht wird. Verwenden Sie das folgende Format für den Namen:
"\$1"
Wenn Ihr Image Builder nicht mit einer Microsoft Active Directory-Domäne verknüpft ist, geben Sie einen Punkt "." für die Domäne ein.
**Message Ausgabe**
| Beendigungscode | An Standardausgang gedruckte Nachricht | Description |
| --- | --- | --- |
| 0 | \$1"Status": 0, "Nachricht": "Erfolgreich"\$1 | Die angegebenen Benutzereinstellungen wurden erfolgreich gelöscht. |
| 1 | \$1"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"\$1 | Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen. |
| 1 | \$1"Status": 1, "Nachricht": "Datei oder Ordner konnte nicht kopiert werden: . "\$1 | Die Benutzereinstellungen konnten nicht zurückgesetzt werden, da eine Datei oder ein Ordner nicht verfügbar war. |
| 1 | \$1"Status": 1, "Nachricht": "Ein Domänenbenutzer, der nicht mit einer Domäne verknüpft ist, kann nicht kopiert werden""\$1 | Es wurde ein Microsoft Active Directory-Domänenbenutzer angegeben, aber der Image Builder ist nicht mit einer Active Directory-Domäne verbunden. |
| 255 | \$1"Status": 255, "Nachricht": \$1 | Ein unerwarteter Fehler ist aufgetreten. Versuchen Sie es erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an, um Unterstützung AWS Support zu erhalten. Weitere Informationen finden Sie unter [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
## `create-image`-Operation
Startet den Workflow zur Image-Erstellung, was zu einem WorkSpaces Anwendungs-Image führt, das für WorkSpaces Anwendungsflotten verwendet werden kann.
**Syntax**
```
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]
```
**Optionen**
**`--name` (string)**
Der Name für das WorkSpaces Anwendungs-Image. Der Name muss innerhalb des Amazon Web Services Services-Kontos und der AWS Region eindeutig sein. Die maximale Länge beträgt 100 Zeichen. Zulässige Zeichen sind:
a-z, A-Z, 0-9, Unterstriche (\$1), Bindestriche (-) und Punkte (.)
Der Abbildname darf nicht mit einem der folgenden Präfixe beginnen: "aws", "appstream" und "amazon". Diese Präfixe sind für die Verwendung in AWS reserviert.
**`--description` (string)**
Die Beschreibung, die für das Abbild angezeigt werden soll. Die maximale Länge beträgt 256 Zeichen.
**`--display-name` (string)**
Der Anzeigename für das Abbild. Die maximale Länge beträgt 256 Zeichen.
**`--enable-dynamic-app-catalog` \$1 `--no-enable-dynamic-app-catalog`**
Aktiviert oder deaktiviert die Unterstützung für das WorkSpaces Applications Dynamic Application Framework. Wenn Sie keinen der beiden Parameter angeben, ist die Unterstützung für das dynamische Anwendungs-Framework nicht aktiviert.
Das dynamische Anwendungsframework bietet Operationen innerhalb einer WorkSpaces Anwendungs-Streaming-Instanz, die Sie verwenden können, um einen dynamischen Anwendungsanbieter zu erstellen. Anbieter dynamischer Apps können diese Operationen zum Ändern des Katalogs der Anwendungen verwenden, auf die Ihre Benutzer in Echtzeit zugreifen können. Weitere Informationen finden Sie unter [Verwenden Sie das WorkSpaces Applications Dynamic Application Framework, um einen dynamischen Anwendungsanbieter zu erstellen](build-dynamic-app-provider.md).
**`--use-latest-agent-version` \$1 `--no-use-latest-agent-version`**
Gibt an, ob das Image an die Version des WorkSpaces Applications Agents angehängt werden soll, die aktuell installiert ist, oder ob immer die neueste Agentenversion verwendet werden soll. Wenn Sie keinen der beiden Parameter angeben, wird das Image an die Version des WorkSpaces Applications Agents angeheftet, die derzeit installiert ist. Weitere Informationen finden Sie unter [WorkSpaces Agent-Versionen von Anwendungen verwalten](base-images-agent.md).
**`--tags` (string)**
Die Tags, die dem Abbild zugeordnet werden sollen. Ein Tag ist ein Schlüsselwertpaar. Verwenden Sie das folgende Format:
--Tags "mykey" "myval" "mykey2" "myval2"
Weitere Informationen zu Tags erhalten Sie unter [Kennzeichnen Ihrer WorkSpaces Amazon-Anwendungsressourcen](tagging-basic.md).
**`--dry-run` (string)**
Führt die Validierung aus, ohne das Abbild zu erstellen. Verwenden Sie diesen Befehl, um festzustellen, ob es bei Ihrem Abbild Probleme gibt, bevor Sie es erstellen.
**Message Ausgabe**
| Beendigungscode | An Standardausgang gedruckte Nachricht | Description |
| --- | --- | --- |
| 0 | \$1"Status": 0, "Nachricht": "Erfolgreich"\$1 | Der Workflow zum Erstellen des Abbilds wurde erfolgreich gestartet. |
| 1 | \$1"Status": 1, "Nachricht": "Administrator-Berechtigungen sind erforderlich, um diesen Vorgang auszuführen"\$1 | Es sind Administrator-Berechtigungen erforderlich, um die Operation abzuschließen. |
| 1 | \$1"Status": 1, "Nachricht": "Ein Abbild mit dem angegebenen Namen ist bereits vorhanden"\$1 | Ein Abbild mit dem angegebenen Namen ist bereits im Amazon-Web-Services-Konto vorhanden. |
| 1 | \$1"Status": 1, "Nachricht": "Ungültiger Wert (Tags)"\$1 | Die angegebenen Tags sind nicht gültig. |
| 255 | \$1"Status": 255, "Nachricht": \$1 | Ein unerwarteter Fehler ist aufgetreten. Versuchen Sie es erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich an, um Unterstützung AWS Support zu erhalten. Weitere Informationen finden Sie unter [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
# Erstellen Sie Ihre Linux-basierten Images
Sie können Linux-basierte Amazon WorkSpaces Applications-Images erstellen, indem Sie eine Verbindung zu einem Linux-Image-Builder herstellen, die benötigten Anwendungen installieren, Standardanwendungseinstellungen und Umgebungsvariablen erstellen und diese Anwendungen mithilfe eines Befehlszeilenschnittstellentools (CLI) oder eines Image Assistant (GUI) Tools zum Anwendungskatalog hinzufügen. Um das GUI-Tool zu öffnen, suchen Sie in der Liste der Anwendungen nach **Image Assistant**.
**Topics**
+ [Erstellen von Standardeinstellungen für Anwendungen für Ihre Benutzer](create-default-app-settings.md)
+ [Erstellen von Standardumgebungsvariablen für Ihre Linux-Benutzer](create-default-variables-linux.md)
+ [Optimieren der Startleistung Ihrer Linux-Anwendungen](optimize-launch-performance.md)
+ [Erstellen von Sitzungsskripts](create-session-scripts.md)
+ [Verwenden des Image Assistant-CLI-Tools für Linux](image-assistant-cli.md)
+ [Aktivieren und Deaktivieren der Webcam-Unterstützung](webcam-support.md)
+ [Aktivieren und Deaktivieren des Modus „Heavy File Sync“ für Basisordner](heavy-file-sync.md)
+ [Tutorial: Erstellen Sie ein benutzerdefiniertes Linux-basiertes WorkSpaces Anwendungs-Image](tutorial-create-linux-image.md)
+ [Tutorial: Aktivieren der Unterstützung für Japanisch für Ihre Linux-Abbilder](enable-japanese-support-linux.md)
# Erstellen von Standardeinstellungen für Anwendungen für Ihre Benutzer
Gehen Sie wie folgt vor, um Standardanwendungseinstellungen für Ihre Benutzer zu erstellen.
**Topics**
+ [Schritt 1: Installieren von Linux-Anwendungen auf dem Image Builder](#app-settings-image-install)
+ [Schritt 2: Erstellen Sie ein Konto TemplateUser](#app-settings-template-user)
+ [Schritt 3: Erstellen von Standardeinstellungen für Anwendungen](#app-settings-image-create-default-app-settings)
+ [Schritt 4: Speichern der Standardeinstellungen für Anwendungen](#app-settings-image-save-default-app-settings)
+ [Schritt 5: Testen der Standardeinstellungen für Anwendungen (optional)](#app-settings-image-test-applications)
+ [Schritt 6: Aufräumen](#app-settings-image-finish)
## Schritt 1: Installieren von Linux-Anwendungen auf dem Image Builder
In diesem Schritt stellen Sie eine Verbindung zu einem Linux Image Builder her und installieren dort Ihre Anwendungen.
**So installieren Sie Anwendungen auf dem Image Builder**
1. Stellen Sie eine Verbindung zum Image Builder her, indem Sie einen der folgenden Schritte ausführen:
+ [Verwenden Sie die WorkSpaces Anwendungskonsole](managing-image-builders-connect-console.md) (nur für Webverbindungen)
+ [Erstellen Sie eine Streaming-URL](managing-image-builders-connect-streaming-URL.md) (für Web- oder WorkSpaces Anwendungs-Client-Verbindungen)
**Anmerkung**
Sie werden als ImageBuilderAdmin Benutzer am Amazon Linux GNOME-Desktop angemeldet und haben Root-Administratorrechte.
1. Installieren Sie die benötigten Anwendungen. Öffnen Sie zunächst die Terminal-Anwendung und führen Sie den folgenden Befehl aus, um zum Beispiel einen Chromium-Browser aus einem öffentlichen yum-Repository zu installieren:
**[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164**
## Schritt 2: Erstellen Sie ein Konto TemplateUser
In diesem Schritt erstellen Sie ein TemplateUser Konto, das die Standardanwendungseinstellungen für Ihre Streaming-Benutzer erstellt.
**Um ein TemplateUser Konto zu erstellen**
1. Erstellen Sie ein TemplateUser Konto ohne Root-Rechte. Führen Sie beispielsweise in einem Terminalfenster die folgenden Befehle aus, um TemplateUser im Image Builder zu erstellen:
**[ImageBuilderAdmin]\$1 sudo useradd -m TemplateUser**
**[ImageBuilderAdmin]\$1 echo -e '<*password*>\$1n<*password*>\$1n' \$1 sudo passwd TemplateUser**
1. Wechseln Sie zum TemplateUser Konto:
**[ImageBuilderAdmin]\$1 su - TemplateUser**
## Schritt 3: Erstellen von Standardeinstellungen für Anwendungen
In diesem Schritt erstellen Sie Standardanwendungseinstellungen für Ihre WorkSpaces Anwendungsbenutzer. Auf diese Weise können Ihre Benutzer während ihrer Anwendungs-Streaming-Sitzungen schnell mit WorkSpaces Anwendungen beginnen, ohne diese Einstellungen selbst erstellen oder konfigurieren zu müssen.
**So erstellen Sie Standardeinstellungen für Anwendungen für Benutzer**
1. Starten Sie die Anwendung, für die Sie die Standardeinstellungen erstellen möchten. Führen Sie beispielsweise in einem Terminalfenster den folgenden Befehl aus, um den Chromium-Browser zu starten:
**[TemplateUser]\$1 chromium-browser**
1. Konfigurieren Sie die Anwendungseinstellungen. Legen Sie beispielsweise **https://aws.amazon.com** als Startseite für den Chromium-Browser fest.
1. Schließen Sie die Anwendungen.
1. Abmelden:
**[TemplateUser]\$1 logout**
## Schritt 4: Speichern der Standardeinstellungen für Anwendungen
In diesem Schritt kopieren Sie die Standardeinstellungen für Anwendungen, die Sie dem Verzeichnis **/etc/skel/** hinzugefügt haben, und stellen sie Ihren Streaming-Benutzern zur Verfügung.
**So speichern Sie die Standardeinstellungen für Anwendungen**
+ Führen Sie den folgenden Befehl in einem Terminalfenster aus, um die Standardeinstellungen für Anwendungen für Ihre Streaming-Benutzer zu kopieren:
**[ImageBuilderAdmin]\$1 sudo cp -r -f /home/TemplateUser/. /etc/skel**
## Schritt 5: Testen der Standardeinstellungen für Anwendungen (optional)
Stellen Sie in diesem Schritt sicher, dass die von Ihnen hinzugefügten Anwendungen ordnungsgemäß ausgeführt werden und dass die Standardeinstellungen für Anwendungen erwartungsgemäß funktionieren.
**So testen Sie Ihre Anwendungen und Standardeinstellungen im Image Builder**
1. Erstellen Sie einen Testbenutzer ohne Root-Berechtigungen. Führen Sie beispielsweise in einem **Terminalfenster** die folgenden Befehle aus, um **test-user** im Image Builder zu erstellen:
**[ImageBuilderAdmin]\$1 sudo useradd -m test-user**
**[ImageBuilderAdmin]\$1 echo -e '*password*>\$1n<*password*>\$1n' \$1 sudo passwd test-user**
1. Wechseln Sie zum Testbenutzer:
**[ImageBuilderAdmin]\$1 su - test-user**
1. Starten Sie die Anwendung (z. B. Chromium) als Testbenutzer:
**[test-user]\$1 /usr/bin/chromium-browser**
1. Stellen Sie sicher, dass die Standardeinstellungen für den Testbenutzer verfügbar sind (z. B. ist die Chromium-Startseite https://aws.amazon.com/).
1. Abmelden:
**[test-user]\$1 logout**
## Schritt 6: Aufräumen
Der letzte Schritt besteht im Aufräumen.
**So räumen Sie auf**
1. Löschen TemplateUser:
**[ImageBuilderAdmin]\$1 sudo killall -u TemplateUser**
**[ImageBuilderAdmin]\$1 sudo userdel -r TemplateUser**
1. Testbenutzer löschen (nicht erforderlich, wenn Sie Schritt 5 übersprungen haben):
**[ImageBuilderAdmin]\$1 sudo killall -u test-user**
**ImageBuilderAdmin]\$1 sudo userdel -r test-user**
# Erstellen von Standardumgebungsvariablen für Ihre Linux-Benutzer
Sie können Umgebungsvariablen auf einer Linux Image-Builder-Instance erstellen. Durch das Erstellen von Umgebungsvariablen werden diese auf Streaming-Instances verfügbar, die mit diesem Image erstellt wurden.
**Anmerkung**
Auf Linux-Flotteninstanzen werden Umgebungsvariablen, die mit dem Tool Image Assistant (GUI) festgelegt wurden, und die Standardsystemumgebungsvariablen über das Skript/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 in Ihre Anwendungen exportiert.
**So erstellen Sie Umgebungsvariablen für Ihre Benutzer**
1. Wenn der Ordner `/etc/profile` nicht vorhanden ist, führen Sie den folgenden Befehl aus, um ihn zu erstellen:
**[ImageBuilderAdmin]\$1 sudo mkdir -p /etc/profile.d**
1. Um eine neue Shell-Skriptdatei (z. B. my-environment.sh) in diesem Ordner zu erstellen, führen Sie den folgenden Befehl aus:
**[ImageBuilderAdmin]\$1 vim my-environment.sh**
1. Fügen Sie in der ersten Zeile der Skriptdatei den folgenden Inhalt ein:
**\$1\$1/bin/sh **
1. Fügen Sie für jede nachfolgende Zeile einen **export**-Befehl hinzu, um die Umgebungsvariablen für Ihr Image festzulegen. Im folgenden Beispiel wird `$HOME/bin` zur Variable `PATH` hinzugefügt.
**export PATH=”\$1HOME/bin:\$1PATH”**
1. Drücken Sie die **Esc-Taste**, um in den Befehlsmodus in vim zurückzukehren, und führen Sie dann den folgenden Befehl aus, um Ihr Skript zu speichern und vim zu beenden:
**:x**
1. Führen Sie den folgenden Befehl aus, um die Ausführung des Skripts als Programm zu erlauben:
**[ImageBuilderAdmin]\$1 chmod \$1x my-environment.sh**
# Optimieren der Startleistung Ihrer Linux-Anwendungen
Wenn Sie das GUI-Tool Image Assistant verwenden, optimiert das Tool die Startleistung Ihrer Anwendungen automatisch.
Wenn Sie die Image Assistant-CLI verwenden, führen Sie die folgenden Schritte aus, um die Startleistung manuell zu optimieren. Wenn Sie Dateien erstellen und zu einem Anwendungsoptimierungsmanifest hinzufügen, wird die Anwendung schneller gestartet, wenn sie zum ersten Mal auf einer neuen Flotten-Instance gestartet wird. Dadurch dauert es aber auch länger, bis die Flotten-Instances den Nutzern zur Verfügung gestellt werden. Das Optimierungsmanifest ist eine Textdatei mit Zeilenumbrüchen als Trennzeichen, die für jede Anwendung erstellt wird.
Sie können eine Manifestdatei (z. B. < *your-app* >-manifest.txt) entweder manuell oder mithilfe der folgenden Schritte erstellen.
**So erstellen Sie eine Manifestdatei**
1. Stellen Sie sicher, dass die Anwendung, die Sie optimieren möchten, gestartet ist und ausgeführt wird.
1. Führen Sie über ein Terminal im Linux Image Builder den folgenden Befehl aus:
**ps -ef \$1 grep <*application-process-name*>**
1. Suchen Sie in der Ausgabe des letzten Schritts nach der kleinsten PID-Nummer. Dies ist die PID für den übergeordneten Root-Prozess der Anwendung.
1. Führen Sie die Anwendung weiter aus und stellen Sie sicher, dass Sie die ersten Komponenten verwenden, die von Ihren Benutzern benötigt werden. Auf diese Weise wird sichergestellt, dass diese Komponenten durch den Optimierungsvorgang erfasst werden.
1. Erstellen Sie eine Skriptdatei (z. B. `~/getfilestool.sh`) mit dem folgenden Inhalt:
```
#!/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. Stellen Sie sicher, dass die Datei mit dem folgenden Befehl ausgeführt werden kann:
**[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**
1. Führen Sie den folgenden Befehl aus, um alle ausgeführten Dateien des in Schritt 3 gefundenen übergeordneten Root-Prozesses zu erfassen und in einer temporären Manifestdatei zu speichern.
**[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh <*root-parent-pid*> > /tmp/-manifest.txt **
1. Überprüfen Sie den Inhalt des Optimierungsmanifests, der sich in einer durch Zeilen getrennten Textdatei für jede Anwendung befindet.
Alternativ können Sie das Optimierungsmanifest auch mithilfe der Image Assistant-Befehlszeilenschnittstelle (CLI) jeweils für die Anwendung eingeben. Weitere Informationen finden Sie unter [Verwenden des Image Assistant-CLI-Tools für Linux](image-assistant-cli.md).
# Erstellen von Sitzungsskripts
WorkSpaces Applications stellt Instanz-Sitzungsskripts sowohl für Windows- als auch für Linux-basierte Streaming-Instances bereit. Weitere Hinweise zu Sitzungsskripts finden Sie unter [Verwenden Sie Sitzungsskripten, um das Streaming-Erlebnis Ihrer Amazon WorkSpaces Applications-Benutzer zu verwalten](use-session-scripts.md).
Sitzungsskripts werden in einem WorkSpaces Anwendungs-Image angegeben. Um die Konfigurationsdatei für Sitzungsskripts auf einer Linux-Instance zu finden, navigieren Sie zu `/opt/appstream/SessionScripts/config.json`. Der folgende Code ist eine `config.json`-Beispieldatei, die ein Sitzungsstartskript mit dem Namen „`test-session-start`“ und ein Sitzungsendskript mit dem Namen „`test-session-stop`“ zusammen mit ihren jeweiligen Laufzeitparametern angibt. Stellen Sie sicher, dass die Skripts, auf die in `config.json` verwiesen wird, über Ausführungsberechtigungen verfügen und dass ein Befehlsinterpreter definiert ist (z. B. \$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
}
}
```
# Verwenden des Image Assistant-CLI-Tools für Linux
Auf einem Linux-basierten Image Builder können Sie das Image Assistant CLI Tool verwenden, **AppStreamImageAssistant**um Ihr WorkSpaces Anwendungs-Image zu erstellen und zu verwalten. Das Tool befindet sich unter `/usr/local/appstream/image-assistant/AppStreamImageAssistant` mit einem symbolischen Link unter `/bin/AppStreamImageAssistant`. Dieses CLI-Tool für Linux unterstützt viele derselben Operationen wie das Image Assistant-CLI-Tool für Windows. Weitere Informationen zu diesen Operationen finden Sie unter [Image Assistant CLI-Operationen zum Erstellen und Verwalten Ihres Amazon WorkSpaces Applications-Images](cli-operations-managing-creating-image-image-assistant.md).
# Aktivieren und Deaktivieren der Webcam-Unterstützung
WorkSpaces Applications unterstützt Audio-Video (AV) in Echtzeit, indem lokale Webcam-Videoeingaben an Anwendungs-Streaming-Sitzungen weitergeleitet werden WorkSpaces . Diese Funktion ermöglicht es Ihren Benutzern, ihre lokale Webcam für Video- und Audiokonferenzen innerhalb einer WorkSpaces Anwendungs-Streaming-Sitzung zu verwenden. Dank Echtzeit-AV und Unterstützung für Echtzeit-Audio können Ihre Benutzer mithilfe vertrauter Video- und Audiokonferenzanwendungen zusammenarbeiten, ohne ihre WorkSpaces Anwendungs-Streaming-Sitzung verlassen zu müssen.
Um diese Funktion nutzen zu können, müssen Sie ein WorkSpaces Linux-Anwendungsimage verwenden, das einen WorkSpaces Linux-Anwendungsagenten verwendet, der am oder nach dem 21. September 2022 veröffentlicht wurde.
**Anmerkung**
Echtzeit-AV wird für stream.standard.small-Instances, die von Rocky Linux oder Red Hat Enterprise Linux betrieben werden, nicht unterstützt. Benutzern werden die Kamera- und Mikrofonsymbole in der Client-Symbolleiste nicht angezeigt.
Die Echtzeit-AV-Funktion ist standardmäßig für Linux-Streaming-Sitzungen aktiviert. Um Webcam-Berechtigungen für Ihre Benutzer in einem Linux Image Builder zu konfigurieren, erstellen Sie `/etc/appstream/appstream.conf` und fügen Sie die folgenden Inhalte hinzu:
**Anmerkung**
Geben Sie **1** an, um die Webcam zu aktivieren, oder **0**, um die Webcam zu deaktivieren.
```
[webcam]
permission = 1
```
# Aktivieren und Deaktivieren des Modus „Heavy File Sync“ für Basisordner
Sie können die Optionen für Amazon Simple Storage Service Basisordner für Ihre Organisation aktivieren. Wenn Sie Amazon S3 Home Folders für einen WorkSpaces Anwendungsstapel aktivieren, können Benutzer des Stacks während ihrer Anwendungs-Streaming-Sitzungen auf einen persistenten Speicherordner zugreifen. Für den Zugriff auf die Basisordner ist keine weitere Konfiguration durch die Benutzer erforderlich. Daten, die von Benutzern in ihrem Home-Ordner gespeichert werden, werden automatisch in einem Amazon S3 S3-Bucket in Ihrem AWS-Konto gespeichert und diesen Benutzern in nachfolgenden Sitzungen zur Verfügung gestellt. Weitere Informationen finden Sie unter [Aktivieren und verwalten Sie Basisordner für Ihre Anwendungsbenutzer WorkSpaces](home-folders.md).
Um einen reibungslosen Ablauf zu gewährleisten und einige bestehende Einschränkungen zu beheben, bei denen es zu einer inkonsistenten Dateisynchronisierung kommen kann, wenn Benutzer große Textdateien aus ihren Streaming-Instances in ihren Home-Ordnern speichern, können WorkSpaces Anwendungsadministratoren die Konfigurationsoption **heavy\$1sync** aktivieren, wenn das Hochladen großer Dateien auf Amazon S3 ein übliches Benutzerszenario bei der Verwendung von Anwendungen ist. WorkSpaces Wenn Sie diese Option aktivieren, kann dies zu einer gewissen Latenz bei der Dateisynchronisierung des Basisordners führen, aber die Vollständigkeit aller Synchronisierungen mit Amazon S3 ist garantiert.
Diese Funktion ist auf allen Red Hat Enterprise Linux-Images und WorkSpaces Linux-Anwendungs-Images verfügbar, die einen Linux WorkSpaces Applications Agent verwenden, der am oder nach dem 12. September 2024 veröffentlicht wurde.
Die Heavy-Sync-Funktion ist standardmäßig für Red Hat Enterprise Linux- und Amazon Linux-Streaming-Sitzungen deaktiviert. Um die Heavy-Sync-Berechtigung für Ihre Benutzer auf einem Red Hat Enterprise Linux oder Amazon Linux Image Builder zu konfigurieren, erstellen Sie die folgenden Inhalte `/etc/appstream/appstream.conf` und fügen Sie sie hinzu:
**Anmerkung**
Geben Sie **1** an, ob Heavy Sync aktiviert oder Heavy Sync deaktiviert werden **0** soll.
```
[storage]
heavy_sync = 1
```
# Tutorial: Erstellen Sie ein benutzerdefiniertes Linux-basiertes WorkSpaces Anwendungs-Image
In diesem Tutorial wird beschrieben, wie Sie ein benutzerdefiniertes Linux-basiertes Amazon WorkSpaces Applications-Image erstellen, das Anwendungen enthält, die Sie an Ihre Benutzer streamen können.
**Wichtig**
Erstellen Sie in Ihrem Image Builder keinen Benutzer mit dem Namen „as2-streaming-user“. Dies ist ein reservierter Benutzername für Fleet. Wenn Sie diesen Benutzernamen außerhalb des WorkSpaces Anwendungs-Workflows erstellen, können Streaming-Probleme in Fleets auftreten.
**Topics**
+ [Schritt 1: Installieren von Linux-Anwendungen auf dem Image Builder](#tutorial-linux-image-install)
+ [Schritt 2: Generieren der Manifestdatei zur Anwendungsoptimierung](#tutorial-linux-image-manifest)
+ [Schritt 3: Erstellen Sie einen WorkSpaces Anwendungskatalog für Anwendungen](#tutorial-linux-image-catalog)
+ [Schritt 4: Erstellen von Standardanwendungseinstellungen und Umgebungsvariablen](#tutorial-linux-image-create-default-app-settings)
+ [Schritt 5: Testen der Anwendungen und Einstellungen](#tutorial-linux-image-test-applications)
+ [Schritt 6: Beenden Sie das Erstellen Ihres Abbilds](#tutorial-linux-image-finish-create-image)
+ [Schritt 7 (optional): Kennzeichnen und Kopieren eines Abbilds](#tutorial-linux-image-tag-copy)
+ [Schritt 8: Bereinigen](#tutorial-linux-image-finish)
## Schritt 1: Installieren von Linux-Anwendungen auf dem Image Builder
In diesem Schritt stellen Sie eine Verbindung zu einem Linux Image Builder her und installieren dort Ihre Anwendungen.
**So installieren Sie Anwendungen auf dem Image Builder**
1. Stellen Sie eine Verbindung zum Image Builder her, indem Sie einen der folgenden Schritte ausführen:
+ [Verwenden Sie die WorkSpaces Anwendungskonsole](managing-image-builders-connect-console.md) (nur für Webverbindungen)
+ [Erstellen Sie eine Streaming-URL](managing-image-builders-connect-streaming-URL.md) (für Web- oder WorkSpaces Anwendungs-Client-Verbindungen)
**Anmerkung**
Sie werden als ImageBuilderAdmin Benutzer am Amazon Linux GNOME-Desktop angemeldet und haben Root-Administratorrechte.
1. Installieren Sie die benötigten Anwendungen. Öffnen Sie zunächst die Terminal-Anwendung und führen Sie den folgenden Befehl aus, um zum Beispiel einen Chromium-Browser aus einem öffentlichen yum-Repository zu installieren:
**[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164**
**Anmerkung**
Laden Sie Anwendungen nur von vertrauenswürdigen Websites herunter und installieren Sie sie.
## Schritt 2: Generieren der Manifestdatei zur Anwendungsoptimierung
In diesem Schritt erstellen Sie eine Manifestdatei für jede Anwendung, die Sie in Schritt 1 installiert haben.
**So erstellen Sie eine Manifestdatei zur Optimierung der Startleistung einer Anwendung**
1. Stellen Sie sicher, dass die Anwendung (z. B. Chromium), die Sie optimieren möchten, gestartet ist und ausgeführt wird.
1. Führen Sie in einem Terminalfenster den folgenden Befehl aus, um die mit der Anwendung verbundenen Prozesse aufzulisten:
**[ImageBuilderAdmin]\$1 ps -ef \$1 grep chromium **
1. Suchen Sie die übergeordnete Stamm-PID in der Ausgabe des obigen Befehls. Nachfolgend sehen Sie ein Beispiel für eine Ausgabe. Die übergeordnete Stamm-PID lautet 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. Führen Sie die Anwendung weiter aus und stellen Sie sicher, dass Sie die ersten Komponenten verwenden, die von Ihren Benutzern benötigt werden. Auf diese Weise wird sichergestellt, dass diese Komponenten durch den Optimierungsvorgang erfasst werden.
1. Erstellen Sie eine Skriptdatei (z. B. `~/getfilestool.sh`) mit dem folgenden Inhalt:
```
#!/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. Stellen Sie sicher, dass die Datei ausgeführt werden kann, indem Sie den folgenden Befehl ausführen:
**[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**
1. Führen Sie den folgenden Befehl aus, um alle laufenden Dateien des in Schritt 3 gefundenen übergeordneten Root-Prozesses zu erfassen und in einer temporären Manifestdatei zu speichern:
**[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh 16712 > /tmp/chromium-manifest.txt **
1. Überprüfen Sie den Inhalt des Optimierungsmanifests, bei dem es sich um eine durch Zeilen getrennte Textdatei für die einzelnen Anwendungen handelt.
## Schritt 3: Erstellen Sie einen WorkSpaces Anwendungskatalog für Anwendungen
In diesem Schritt verwenden Sie das CLI-Tool `AppStreamImageAssistant` im Image Builder, um einen Anwendungskatalog für WorkSpaces Anwendungen zu erstellen, indem Sie Anwendungen für Ihr Image angeben. Für jede Anwendung, die Sie streamen möchten, können Sie den Namen, den Anzeigenamen, die ausführbare Datei, die gestartet werden soll, und das Symbol, das angezeigt werden soll, angeben.
**Um einen Anwendungskatalog WorkSpaces für Anwendungen zu erstellen**
1. Öffnen Sie **Terminal** auf dem Image-Builder-Desktop entweder von der Seitenleiste aus oder indem Sie das App-Raster öffnen.
1. Führen Sie **AppStreamImageAssistant --help** aus, um die Liste der verfügbaren Befehle anzuzeigen. Sie werden diese Befehle verwenden, um Anwendungen hinzuzufügen und ein Abbild zu erstellen.
1. Führen Sie den folgenden Befehl aus, um eine installierte Anwendung (z. B. Chromium) zur Anwendungsliste für WorkSpaces Anwendungsbenutzer hinzuzufügen:
```
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
```
Alternativ können Sie auch den folgenden Befehl ausführen:
```
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. Wiederholen Sie Schritt 3 für jede weitere Anwendung, um weitere Anwendungen hinzuzufügen.
1. Führen Sie den folgenden Befehl aus, um die Liste der Anwendungen anzuzeigen, die dem Katalog zusammen mit Metadaten wie Symbolpfaden und Startparametern hinzugefügt wurden:
**AppStreamImageAssistant list-applications**
1. Führen Sie den folgenden Befehl aus, um Anwendungen aus dem Katalog zu entfernen:
**AppStreamImageAssistant remove-application –-name *application\$1name***
## Schritt 4: Erstellen von Standardanwendungseinstellungen und Umgebungsvariablen
In diesem Schritt erstellen Sie Standardanwendungseinstellungen und Umgebungsvariablen für Ihre WorkSpaces Anwendungsbenutzer. Auf diese Weise können Ihre Benutzer während ihrer Anwendungs-Streaming-Sitzungen schnell mit WorkSpaces Anwendungen beginnen, ohne diese Einstellungen selbst erstellen oder konfigurieren zu müssen.
**So erstellen Sie Standardanwendungs- und Umgebungsvariablen für Ihre Benutzer**
1. Starten Sie die Anwendung, für die Sie die Standardeinstellungen erstellen möchten. Führen Sie beispielsweise in einem Terminalfenster den folgenden Befehl aus, um den Chromium-Browser zu starten:
**[ImageBuilderAdmin]\$1 chromium-browser**
1. Konfigurieren Sie die Anwendungseinstellungen. Legen Sie beispielsweise **https://aws.amazon.com** als Startseite für den Chromium-Browser fest.
1. Stellen Sie sicher, dass die Chromium-Anwendung geschlossen ist, und führen Sie dann die folgenden Befehle aus, um die Konfiguration für Chromium nach **/etc/skel** zu kopieren:
**[ImageBuilderAdmin]\$1 sudo mkdir /etc/skel/.config**
**[ImageBuilderAdmin]\$1 sudo cp -R \$1/.config/chromium /etc/skel/.config**
1. Legen Sie die Umgebungsvariablen fest und fügen Sie sie der Skriptdatei hinzu. Führen Sie z. B. die folgenden Befehle aus:
**[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**
## Schritt 5: Testen der Anwendungen und Einstellungen
Überprüfen Sie in diesem Schritt, ob die von Ihnen hinzugefügten Anwendungen korrekt ausgeführt werden und ob die Standardanwendungseinstellungen und Umgebungsvariablen wie erwartet funktionieren.
**So testen Sie Ihre Anwendungen und Standardeinstellungen im Image Builder**
1. Erstellen Sie einen Testbenutzer ohne Root-Berechtigungen. Führen Sie beispielsweise in einem **Terminalfenster** die folgenden Befehle aus, um **test-user** im Image Builder zu erstellen:
**[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. Wechseln Sie zum Testbenutzer:
**[ImageBuilderAdmin]\$1 su - test-user**
1. Starten Sie die Anwendung (z. B. Chromium) als Testbenutzer:
**[test-user]\$1 /usr/bin/chromium-browser**
1. Stellen Sie sicher, dass die Standardeinstellungen für den Testbenutzer verfügbar sind (z. B. ist die Chromium-Startseite https://aws.amazon.com/).
1. Stellen Sie sicher, dass die Umgebungsvariablen für den Testbenutzer verfügbar sind. Führen Sie z. B. den folgenden Befehl aus:
**[test-user]\$1 echo \$1*FOO***
Dieser Befehl sollte die Ausgabe ***BAR*** im Terminal anzeigen.
1. Führen Sie die folgenden Befehle aus, um den Testbenutzer zu löschen, bevor Sie mit diesem Image Builder ein Abbild erstellen:
**\$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**
## Schritt 6: Beenden Sie das Erstellen Ihres Abbilds
In diesem Schritt wählen Sie einen Namen für das Abbild aus und beenden das Erstellen des Abbilds.
**So erstellen Sie das Abbild**
1. Erstellen Sie in einem **Terminal**-Fenster ein Abbild in Ihrem Image Builder, indem Sie **AppStreamImageAssistant create-image**ausführen. Dieses Abbild enthält Ihre installierten und registrierten Anwendungen sowie alle Sitzungsskripts und Standardanwendungseinstellungen, die Sie konfiguriert haben.
Führen Sie **AppStreamImageAssistant create-image --help** aus, um die Liste der verfügbaren Optionen zu sehen. Weitere Informationen finden Sie unter der Operation **create-image** unter [Erstellen Sie Ihr WorkSpaces Amazon-Anwendungs-Image programmgesteuert mithilfe der Cli-Operationen von Image Assistant](programmatically-create-image.md).
1. Die Remote-Sitzung wird innerhalb weniger Augenblicke getrennt. Wenn die Nachricht **Lost Connectivity (Konnektivität unterbrochen)** angezeigt wird, schließen Sie die Browser-Registerkarte. Während das Image erstellt wird, wird der Status des Image Builder als **Snapshotting** angezeigt. Sie können keine Verbindung mit dem Image Builder herstellen, bis dieser Vorgang beendet ist.
1. Kehren Sie zur Konsole zurück und rufen Sie **Images** und **Image Registry** auf. Vergewissern Sie sich, dass Ihr neues Abbild in der Liste angezeigt wird.
Während Ihr Abbild erstellt wird, lautet der Abbildstatus im Abbildverzeichnis der Konsole **Pending (Schwebend)**. Sie können keine Verbindung zu Abbildern herstellen, die sich im Status **Ausstehend** befinden.
1. Wählen Sie das Symbol **Aktualisieren** aus, um den Status zu aktualisieren. Nachdem Ihr Abbild erstellt wurde, ändert sich der Image-Status in **Available (Verfügbar)** und der Image Builder wird automatisch angehalten.
Zum Erstellen weiterer Abbilder starten Sie den Image Builder und stellen Sie eine Verbindung von der Konsole her oder erstellen Sie einen neuen Image Builder.
## Schritt 7 (optional): Kennzeichnen und Kopieren eines Abbilds
Sie können einem Abbild während dessen Erstellung oder auch später Tags hinzufügen. Sie können das Abbild auch innerhalb einer Region oder in eine neue Region desselben Amazon-Web-Services-Kontos kopieren. Das Kopieren eines Quellbilds führt zu einem identischen, aber unterschiedlichen Zielbild. AWS kopiert jedoch keine benutzerdefinierten Tags. Außerdem können Sie nur benutzerdefinierte Abbilder kopieren, die Sie erstellt haben, nicht die Basisabbilder, die von AWS bereitgestellt werden.
**Anmerkung**
Sie können bis zu zwei Images gleichzeitig in einen Ziel kopieren. Wenn das Ziel, in das Sie ein Image kopieren, keine weiteren Images aufnehmen kann, erhalten Sie eine Fehlermeldung. Um das Image in diesem Fall zu kopieren, müssen Sie zunächst Images vom Ziel entfernen. Sobald das Ziel unterhalb der Grenze des Abbildkontingents (auch als Limit bezeichnet) liegt, starten Sie das Kopieren des Abbildes aus der Quellregion. Weitere Informationen finden Sie unter [Kontingente WorkSpaces für Amazon Applications Service](limits.md).
**Hinzufügen von Tags zu einem vorhandenen Abbild**
1. Wählen Sie im linken Navigationsbereich **Images** und **Image Registry** aus.
1. Wählen Sie in der Image-Liste das Image aus, dem Sie Tags hinzufügen möchten.
1. Wählen Sie zunächst **Tags**, dann **Tags hinzufügen/bearbeiten** und schließlich Tag hinzufügen aus. Geben Sie den Schlüssel und den Wert für das Tag an und wählen Sie anschließend **Speichern** aus.
Weitere Informationen finden Sie unter [Kennzeichnen Ihrer WorkSpaces Amazon-Anwendungsressourcen](tagging-basic.md).
**Ein Image kopieren**
Durch das Kopieren eines Image über geografisch verteilte Regionen können Sie Anwendungen aus mehreren Regionen basierend auf demselben Image streamen. Indem Sie Ihre Anwendungen in größerer Nähe zu Ihren Benutzern streamen, können Sie das Nutzererlebnis beim Streamen von Anwendungen mit WorkSpaces Anwendungen verbessern.
1. Wählen Sie im linken Navigationsbereich **Images** und **Image Registry** aus.
1. Wählen Sie in der Image-Liste das zu kopierende Image aus.
1. Wählen Sie **Aktionen**, **Kopieren**.
1. Geben Sie im Dialogfeld **Copy Image** (Image kopieren) die folgenden Informationen an und wählen Sie anschließend **Copy Image:** (Image kopieren:)
+ Wählen Sie für **Destination region** (Zielregion) die Region aus, in die das neue Image kopiert werden soll.
+ Geben Sie für **Name**einen Namen ein, den das Image in dem Ziel haben soll, in das es kopiert wird.
+ Geben Sie für **Description** (Beschreibung) (optional) eine Beschreibung für das Image in dem Ziel ein, in das es kopiert wird.
1. Um den Fortschritt der Kopieroperation zu überprüfen, kehren Sie auf die Konsole zurück und wählen **Images**, **Image-Registry**. Verwenden Sie die Navigationsleiste, um zur Zielregion zu wechseln (falls zutreffend), und vergewissern Sie sich, dass Ihr neues Image in der Image-Liste enthalten ist.
Das neue Image wird in der Image-Registry Ihrer Konsole zunächst mit dem Status **Copying** (Kopieren) angegeben. Nachdem das Abbild erfolgreich erstellt wurde, ändert sich der Status in **Available**. Nun können Sie das Abbild nutzen, um einen Stack zu starten und Ihre Anwendungen zu streamen.
## Schritt 8: Bereinigen
Abschließend stoppen Sie die ausgeführten Image Builder und setzen die Ressourcen frei, damit für Ihr Konto keine ungewollten Kosten entstehen. Es wird empfohlen, die Ausführung aller ungenutzter Image Builder zu stoppen. Weitere Informationen finden Sie unter [Preise für WorkSpaces Anwendungen](https://aws.amazon.com/appstream2/pricing/).
**So stoppen Sie einen ausgeführten Image Builder**
1. Wählen Sie im Navigationsbereich **Images** und **Image Builders** und dann die ausgeführte Image Builder-Instance aus.
1. Wählen Sie **Actions** und **Stop** aus.
# Tutorial: Aktivieren der Unterstützung für Japanisch für Ihre Linux-Abbilder
In dieser Anleitung wird beschrieben, wie Sie die Unterstützung für Japanisch für ein Linux-Abbild aktivieren. Dies ermöglicht es Anwendungen auf Abbildern, japanische Zeichen anzuzeigen, und Benutzern der Streaming-Dienste, die japanische Eingabemethode in den Streaming-Sitzungen von Abbildern zu verwenden.
**Topics**
+ [Schritt 1: Installieren japanischer Schrift und Eingabemethoden](#tutorial-japanese-font)
+ [Schritt 2: Festlegen der Systemzeitzone](#tutorial-japanese-zone)
+ [Schritt 3: Festlegen des Systemgebietsschemas und der Anzeigesprache](#tutorial-japanese-locale)
+ [Schritt 4: Konfigurieren der Eingabemethoden](#tutorial-japanese-input)
+ [Schritt 5: Festlegen des Tastatur-Layouts](#tutorial-japense-keyboard)
+ [Schritt 6: Überprüfen des Image Builders](#tutorial-japense-verify)
+ [Schritt 1: Erstellen des Abbilds](#tutorial-japanese-create)
## Schritt 1: Installieren japanischer Schrift und Eingabemethoden
In diesem Schritt verbinden Sie einen Linux-Image-Builder und installieren die Schrift- und Eingabemethodenpakete Ihrer Wahl.
**So installieren Sie die japanische Schriftart und Eingabemethode**
1. Stellen Sie eine Verbindung zum Image Builder her, indem Sie einen der folgenden Schritte ausführen:
+ [Verwenden Sie die WorkSpaces Anwendungskonsole](managing-image-builders-connect-console.md) (nur für Webverbindungen)
+ [Erstellen Sie eine Streaming-URL](managing-image-builders-connect-streaming-URL.md) (für Web- oder WorkSpaces Anwendungs-Client-Verbindungen)
**Anmerkung**
Sie werden als ImageBuilderAdmin Benutzer am Amazon Linux GNOME-Desktop angemeldet und haben Root-Administratorrechte.
1. Installieren Sie die Schriftart und die Eingabemethode, die Sie benötigen. Öffnen Sie dazu die Terminal-Anwendung und führen Sie dann die folgenden Befehle aus:
**sudo yum install vlgothic-p-fonts.noarch**
**sudo yum install ibus-kkc.x86\$164**
1. Führen Sie zusätzlich zu den oben genannten Befehlen für Rocky Linux und Red Hat Enterprise Linux den folgenden Befehl aus:
**sudo yum install glibc-langpack-ja**
## Schritt 2: Festlegen der Systemzeitzone
Führen Sie den folgenden Befehl aus, um die Systemzeitzone festzulegen:
**sudo timedatectl set-timezone "Asia/Tokyo"**
## Schritt 3: Festlegen des Systemgebietsschemas und der Anzeigesprache
Führen Sie die folgenden Befehle aus, um das Systemgebietsschema und die Anzeigesprache festzulegen.
**So legen Sie das Systemgebietsschema und die Anzeigesprache fest**
1. Aktualisieren Sie die Datei `cloud-init config`, indem Sie den Befehl **sudo vim /etc/cloud/cloud.cfg** ausführen, und ändern Sie das **Gebietsschema** unter **locale: ja\$1JP.utf8**, speichern und schließen Sie anschließend die Datei.
1. Aktualisieren **sudo localectl set-locale LANG=ja\$1JP.utf8** Sie die Systemeinstellungen, indem Sie den Befehl ausführen.
1. Aktualisieren Sie die Einstellungen der Gnome-Shell, indem Sie **sudo gsettings set org.gnome.system.locale region "ja\$1JP.utf8"** ausführen.
## Schritt 4: Konfigurieren der Eingabemethoden
Konfigurieren Sie die Eingabemethoden für die Anwendung, die Sie dem Abbild hinzufügen möchten. Weitere Informationen darüber, wie Sie eine Anwendung installieren, eine Manifestdatei erzeugen und Standardeinstellungen erstellen, finden Sie unter [Tutorial: Erstellen Sie ein benutzerdefiniertes Linux-basiertes WorkSpaces Anwendungs-Image](tutorial-create-linux-image.md). In diesem Schritt gehen wir davon aus, dass Sie die Anwendung Firefox bereits installiert haben. Diese befindet sich unter `/usr/local/firefox/firefox`.
**So konfigurieren Sie die Eingabemethoden**
1. Erstellen Sie ein Skript, indem Sie den Befehl **sudo vim /usr/local/bin/update-input-method.sh** ausführen, und fügen Sie dem Skript den folgenden Inhalt hinzu:
```
#!/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"
```
Im obigen Skript ist die erste Eingabequelle ('ibus', 'kkc') die Standardeingabemethode. Sie können die Standardeingabemethode ändern, indem Sie die Reihenfolge der Eingabequellen ändern. Darüber hinaus sind „Steuerungstaste \$1 Leertaste“ und „Umschalttaste \$1 Steueruntstaste \$1 Leertaste“ als Tastenkombinationen für den Wechsel zwischen den Eingabemethoden festgelegt. Sie können Ihre eigenen Tastenkombinationen festlegen, mit denen Ihre Benutzer während Streaming-Sitzungen zwischen den Eingabemethoden wechseln können.
1. Erstellen Sie das Skript zum Starten der Anwendung (Firefox), die Sie dem Abbild hinzufügen möchten. Führen Sie dazu den Befehl aus **sudo vim /usr/local/bin/firefox-jp.sh** und fügen Sie dem Skript dann den folgenden Inhalt hinzu:
```
#!/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. Fügen Sie beiden Skripts Ausführungsberechtigungen hinzu, indem Sie die folgenden Befehle ausführen:
**sudo chmod \$1x /usr/local/bin/update-input-method.sh**
**sudo chmod \$1x /usr/local/bin/firefox-jp.sh**
1. Wenn Sie die Optimierungsmanifestdatei für die Anwendung bereits erstellt haben, führen Sie die folgenden Befehle aus, um das Anwendungsstartskript zum Anwendungskatalog hinzuzufügen:
```
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
```
Alternativ können Sie die Eingabemethoden auch konfigurieren, indem Sie das Skript update-input-method .sh als separate Anwendung zum Anwendungskatalog für das Image hinzufügen. Während Streaming-Sitzungen können Ihre Benutzer diese Anwendung starten, um die japanische Eingabe zu aktivieren, und innerhalb derselben Sitzung mit bestimmten Tastenkombinationen zwischen den Eingabemethoden wechseln.
## Schritt 5: Festlegen des Tastatur-Layouts
Stellen Sie das Tastatur-Layout so ein, dass es den Tastaturen entspricht, die Ihre Benutzer während Streaming-Sitzungen verwenden werden. Sie können mithilfe des Befehls **localectl list-keymaps** alle verfügbaren Tastenzuordnungen auflisten und mithilfe des Befehls **sudo localectl set-keymap jp106** die Tastenzuordnung auf die japanische Tastatur mit z. B. 106 Tasten einstellen.
## Schritt 6: Überprüfen des Image Builders
Starten Sie zum Überprüfen zunächst den Image Builder neu, indem Sie den Befehl **sudo shutdown -r now** ausführen. Stellen Sie nach dem Neustart erneut eine Verbindung zum Image Builder her und überprüfen Sie, ob alles, einschließlich Zeitzone, Gebietsschema, Sprache und Eingabemethode, wie erwartet funktioniert.
## Schritt 1: Erstellen des Abbilds
Erstellen Sie das Abbild im Image Builder. Weitere Informationen finden Sie unter [Tutorial: Erstellen Sie ein benutzerdefiniertes Linux-basiertes WorkSpaces Anwendungs-Image](tutorial-create-linux-image.md). Stellen Sie sicher, dass Sie Standardanwendungseinstellungen erstellen, einschließlich der regionalen Einstellungen, die Sie gerade konfiguriert haben. Weitere Informationen finden Sie unter „Erstellen von Standardanwendungseinstellungen für Ihre Benutzer“ unter [Erstellen Sie Ihre Linux-basierten Images](create-linux-based-images.md).
Alle mit diesem Abbild erstellten Linux-Flotten-Instances haben dieselben Standardeinstellungen für Zeitzone, Gebietsschema, Sprache und Eingabemethode, die Sie für das Abbild konfiguriert haben.
# Verwenden Sie Sitzungsskripten, um das Streaming-Erlebnis Ihrer Amazon WorkSpaces Applications-Benutzer zu verwalten
WorkSpaces Applications stellt auf der Instanz installierte Sitzungsskripte bereit. Sie können diese Skripte verwenden, um benutzerdefinierte Skripte auszuführen, wenn in den Streaming-Sitzungen der Benutzer bestimmte Ereignisse auftreten. Sie können beispielsweise benutzerdefinierte Skripts verwenden, um Ihre WorkSpaces Anwendungsumgebung vorzubereiten, bevor die Streaming-Sitzungen Ihrer Benutzer beginnen. Sie können benutzerdefinierte Skripte auch einsetzen, um Streaming-Instances zu bereinigen, nachdem die Benutzer ihre Streaming-Sitzungen beendet haben.
Sitzungsskripts werden in einem WorkSpaces Anwendungs-Image angegeben. Diese Skripte werden im Benutzer- oder Systemkontext ausgeführt. Wenn die Sitzungsskripts den Standardausgang verwenden, um Informationen, Fehler- oder Debugging-Meldungen zu schreiben, können diese optional in einem Amazon-S3-Bucket im Amazon-Web-Services-Konto gespeichert werden.
**Topics**
+ [Ausführen von Skripten vor dem Beginn von Streaming-Sitzungen](run-scripts-before-streaming-sessions-begin.md)
+ [Ausführen von Skripten nach dem Ende von Streaming-Sitzungen](run-scripts-after-streaming-sessions-end.md)
+ [Erstellen und Angeben von Sitzungsskripten](create-specify-session-scripts.md)
+ [Sitzungsskript-Konfigurationsdatei](session-script-configuration-file.md)
+ [PowerShell Windows-Dateien verwenden](using-powershell-files-with-session-scripts.md)
+ [Protokollieren der Ausgaben von Sitzungsskripten](logging-session-output.md)
+ [Verwenden von Speicher-Connectors mit Sitzungsskripten](use-storage-connectors-with-session-scripts.md)
+ [Aktivieren der Speicherung von Sitzungsskriptprotokollen in Amazon-S3-Buckets](enable-S3-bucket-storage-session-script-logs.md)
+ [Verwenden Sie Sitzungsskripten auf Flotten mit mehreren Sitzungen](session-scripts-multi-session-fleets.md)
# Ausführen von Skripten vor dem Beginn von Streaming-Sitzungen
Sie können die Skripte so konfigurieren, dass sie maximal 60 Sekunden vor dem Start der Anwendungen der Benutzer und dem Beginn der Streaming-Sitzungen ausgeführt werden. Auf diese Weise können Sie die WorkSpaces Anwendungsumgebung anpassen, bevor Benutzer mit dem Streaming ihrer Anwendungen beginnen. Wenn die Sitzungsskripte ausgeführt werden, wird den Benutzern ein Ladekreisel anzeigt. Nach erfolgreicher Ausführung der Skripte oder nach Ablauf der maximalen Wartezeit beginnen die Streaming-Sitzungen der Benutzer. Können die Skripts nicht abgeschlossen werden, wird den Benutzern eine Fehlermeldung angezeigt. Die Benutzer werden jedoch nicht daran gehindert, ihre Streaming-Sitzung zu nutzen.
Bei der Angabe eines Dateinamens auf einer Windows Instance müssen Sie einen doppelten umgekehrten Schrägstrich verwenden. Beispiel:
C:\$1\$1Scripts\$1\$1Myscript.bat
Wenn Sie keinen doppelten umgekehrten Schrägstrich verwenden, werden Sie in einer Fehlermeldung darauf hingewiesen, dass die JSON-Datei falsch formatiert ist.
**Anmerkung**
Wenn die Skripte erfolgreich ausgeführt wurden, müssen sie den Wert 0 zurückgeben. Wenn Ihre Skripts einen anderen Wert als 0 zurückgeben, zeigt WorkSpaces Applications dem Benutzer die Fehlermeldung an.
Wenn Sie Skripts ausführen, bevor Streaming-Sitzungen beginnen und das dynamische Anwendungsframework für WorkSpaces Anwendungen nicht aktiviert ist, läuft der folgende Vorgang ab:
![\[WorkSpaces Applications workflow diagram showing connection, application selection, and session launch steps.\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/images/session-scripts-without-DAF-non-domain-joined2.png)
1. Ihre Benutzer stellen eine Verbindung zu einer WorkSpaces Applications-Flotteninstanz her, die nicht in eine Domäne eingebunden ist. Die Verbindung wird unter Verwendung einer der folgenden Zugriffsmethoden hergestellt:
+ WorkSpaces Benutzerpool für Anwendungen
+ SAML 2.0
+ WorkSpaces Anwendungs-API
1. Der Anwendungskatalog wird im WorkSpaces Anwendungsportal angezeigt, und Ihre Benutzer wählen eine Anwendung zum Starten aus.
1. Nun erfolgt einer dieser Schritte:
+ Wenn die Persistenz von Anwendungseinstellungen für die Benutzer aktiviert ist, wird die Virtual Hard Disk (VHD)-Datei mit den Anwendungseinstellungen – Anpassungen sowie Windows-Einstellungen für die Benutzer – heruntergeladen und bereitgestellt. In diesem Fall ist eine Windows-Benutzeranmeldung erforderlich.
Weitere Informationen zur Persistenz von Anwendungseinstellungen siehe [Aktivieren Sie die Persistenz der Anwendungseinstellungen für Ihre WorkSpaces Anwendungsbenutzer](app-settings-persistence.md).
+ Wenn die Persistenz von Anwendungseinstellungen nicht aktiviert ist, ist der Windows-Benutzer bereits angemeldet.
1. Das Sitzungsskript startet. Wenn für die Benutzer persistenter Speicher aktiviert ist, beginnt auch die Bereitstellung des Speicher-Connectors. Informationen zu persistentem Speicher siehe [Aktivieren und verwalten Sie persistenten Speicher für Ihre WorkSpaces Anwendungsbenutzer](persistent-storage.md).
**Anmerkung**
Die Bereitstellung des Speicher-Connectors muss nicht abgeschlossen sein, damit die Streaming-Sitzung startet. Wenn die Sitzungsskripte abgeschlossen werden, bevor die Bereitstellung des Speicher-Connectors abgeschlossen ist, wird die Streaming-Sitzung gestartet.
Informationen zum Überwachen des Bereitstellungsstatus von Speicher-Connectors siehe [Verwenden von Speicher-Connectors mit Sitzungsskripten](use-storage-connectors-with-session-scripts.md).
1. Die Sitzungsskripte werden abgeschlossen oder überschreiten das Zeitlimit.
1. Die Streaming-Sitzung des Benutzers startet.
1. Die vom Benutzer gewählte Anwendung startet.
Informationen zum Dynamic Application Framework für WorkSpaces Anwendungen finden Sie unter[Verwenden Sie das WorkSpaces Applications Dynamic Application Framework, um einen dynamischen Anwendungsanbieter zu erstellen](build-dynamic-app-provider.md).
Wenn Sie Skripts ausführen, bevor Streaming-Sitzungen beginnen und das Framework für dynamische WorkSpaces Anwendungen für Anwendungen aktiviert ist, läuft der folgende Vorgang ab:
![\[WorkSpaces Applications workflow from user login to application launch, including SAML authentication and session scripts.\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/images/session-scripts-with-DAF-domain-joined2.png)
1. Ihre Benutzer besuchen das SAML 2.0-Anwendungsportal für Ihr Unternehmen und wählen den WorkSpaces Anwendungsstapel aus.
1. Sie stellen eine Verbindung zu einer WorkSpaces Applications-Flotteninstanz her, die mit einer Domäne verknüpft ist.
1. Wenn die Persistenz von Anwendungseinstellungen für die Benutzer aktiviert ist, wird die VHD-Datei mit den Anwendungseinstellungen – Anpassungen sowie Windows-Einstellungen für die Benutzer – heruntergeladen und bereitgestellt.
1. Die Windows-Benutzeranmeldung erfolgt.
1. Der Anwendungskatalog wird im Anwendungsportal angezeigt, und Ihre Benutzer wählen eine Anwendung zum Starten aus. WorkSpaces
1. Das Sitzungsskript startet. Wenn für die Benutzer persistenter Speicher aktiviert ist, beginnt auch die Bereitstellung des Speicher-Connectors.
**Anmerkung**
Die Bereitstellung des Speicher-Connectors muss nicht abgeschlossen sein, damit die Streaming-Sitzung startet. Wenn die Sitzungsskripte abgeschlossen werden, bevor die Bereitstellung des Speicher-Connectors abgeschlossen ist, wird die Streaming-Sitzung gestartet.
Informationen zum Überwachen des Bereitstellungsstatus von Speicher-Connectors siehe [Verwenden von Speicher-Connectors mit Sitzungsskripten](use-storage-connectors-with-session-scripts.md).
1. Die Sitzungsskripte werden abgeschlossen oder überschreiten das Zeitlimit.
1. Die Streaming-Sitzung des Benutzers startet.
1. Die vom Benutzer gewählte Anwendung startet.
# Ausführen von Skripten nach dem Ende von Streaming-Sitzungen
Sie können Skripte auch so konfigurieren, dass sie nach Beendigung der Streaming-Sitzungen von Benutzern ausgeführt werden. Sie können beispielsweise ein Skript ausführen, wenn Benutzer in der WorkSpaces Anwendungs-Symbolleiste die Option **Sitzung beenden** auswählen oder wenn sie die maximal zulässige Sitzungsdauer erreicht haben. Sie können diese Sitzungsskripts auch verwenden, um Ihre WorkSpaces Anwendungsumgebung zu bereinigen, bevor eine Streaming-Instance beendet wird. Sie können beispielsweise Skripte einsetzen, um Dateisperren aufzuheben oder Protokolldateien hochzuladen. Wenn Sie nach Beendigung von Streaming-Sitzungen Skripte ausführen lassen, geschieht Folgendes:
![\[Flowchart showing WorkSpaces Applications session termination process with scripts and storage actions.\]](http://docs.aws.amazon.com/de_de/appstream2/latest/developerguide/images/session-scripts-termination.png)
1. Die WorkSpaces Anwendungs-Streaming-Sitzung Ihrer Benutzer wird beendet.
1. Die Skripte zur Sitzungsbeendigung werden gestartet.
1. Die Skripte zur Sitzungsbeendigung werden abgeschlossen oder überschreiten das Zeitlimit.
1. Die Windows-Benutzerabmeldung erfolgt.
1. Eine der folgenden Operationen wird ausgeführt (bzw. beide gleichzeitig, falls relevant):
+ Wenn die Persistenz von Anwendungseinstellungen für die Benutzer aktiviert ist, wird die Bereitstellung der VHD-Datei mit den Anwendungseinstellungen – Anpassungen sowie Windows-Einstellungen für die Benutzer – aufgehoben und die Datei in einen Amazon-S3-Bucket Ihres Kontos hochgeladen.
+ Wenn für die Benutzer persistenter Speicher aktiviert ist, führt der Speicher-Connector eine abschließende Synchronisierung durch, bevor seine Bereitstellung aufgehoben wird.
1. Die Flotten-Instance wird beendet.
# Erstellen und Angeben von Sitzungsskripten
Sie können Sitzungsskripts für Always-On-, On-Demand- und Elastic-Flotten konfigurieren und angeben.
**So konfigurieren und spezifizieren Sie Sitzungsskripts für Always-On- und On-Demand-Flotten**
1. Öffnen Sie die WorkSpaces Anwendungskonsole unter [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. Wählen Sie im Navigationsbereich **Images (Abbilder)**, **Image Builder** aus.
1. Wählen Sie einen Image Builder mit dem Status **Running (Wird ausgeführt)** und dann **Connect (Verbinden)** aus.
1. Wählen Sie nach Aufforderung **Administrator**.
1. Navigieren Sie zu `C:\AppStream\SessionScripts` und öffnen Sie die Konfigurationsdatei `config.json`.
Informationen zum Ändern von Sitzungsskriptparametern siehe [Sitzungsskript-Konfigurationsdatei](session-script-configuration-file.md).
1. Speichern und schließen Sie die Datei `config.json`, nachdem Sie die gewünschten Änderungen vorgenommen haben.
1. Öffnen Sie auf dem Image-Builder-Desktop den **Image Assistant**.
1. (Optional) Geben Sie optional alle anderen Anwendungen an, die in das Abbild eingeschlossen werden sollen.
1. Führen Sie die erforderlichen Schritte im Image Assistant aus, um Ihr Abbild fertigzustellen.
Wenn die Konfiguration der Sitzungsskripts nicht validiert werden kann (weil beispielsweise die JSON-Datei nicht richtig formatiert ist), werden Sie benachrichtigt, sobald Sie **Verbindung trennen und Abbild erstellen** auswählen.
**Anmerkung**
Navigieren Sie zu `/opt/appstream/SessionScripts/config.json`, um die Konfigurationsdatei für Sitzungsskripts für Linux-basierte Image Builder zu finden.
**So konfigurieren und spezifizieren Sie Sitzungsskripts für Elastic-Flotten**
1. Erstellen Sie eine ZIP-Datei mit den Sitzungsskripts und der config.json-Datei. Die Skriptdateien werden an die folgenden Speicherorte kopiert. Sie müssen diese Speicherorte für Ihre config.json-Datei verwenden.
+ Für Windows, verwenden Sie `C:\AppStream\SessionScripts\SessionScript`.
+ Für Linux, verwenden Sie `/opt/appstream/SessionScripts/SessionScript`.
**Anmerkung**
Überprüfen Sie zur Ausführung der Sitzungsskriptdateien, dass die Zip-Datei nur die Sitzungsskripts und `config.json`-Dateien enthält und nicht den enthaltenen Ordner. Weitere Informationen finden Sie unter [Sitzungsskript-Konfigurationsdatei](session-script-configuration-file.md).
1. Laden Sie die Zip-Datei in einen Amazon-S3-Bucket in Ihrem Konto hoch.
**Anmerkung**
Ihre VPC muss den Zugriff auf den Amazon-S3-Bucket ermöglichen. Weitere Informationen finden Sie unter [Verwendung von Amazon S3 S3-VPC-Endpunkten für Anwendungsfunktionen WorkSpaces](managing-network-vpce-iam-policy.md).
Ihr S3-Bucket und Ihre WorkSpaces Anwendungsflotte müssen identisch sein. AWS-Region
Sie benötigen IAM-Berechtigungen, um die Aktion `S3:GetObject` für das Sitzungsskriptobjekt im Amazon-S3-Bucket auszuführen. Weitere Informationen zum Speichern der Sitzungsskripts in einem Amazon-S3-Bucket finden Sie unter [Speichern der Anwendungssymbole, Setup-Skripts, Sitzungsskripts und VHDs in einem S3-Bucket](store-s3-bucket.md).
1. Öffnen Sie die WorkSpaces Anwendungskonsole unter [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2)
1. Klicken Sie im Navigationsbereich auf **Fleets (Flotten)**.
1. Wählen Sie eine Elastic-Flotte aus, die Sie aktualisieren möchten, und klicken Sie dann auf **Details anzeigen**.
1. Wählen Sie auf der Registerkarte **Einstellungen für Sitzungsskripts** die Option **Bearbeiten** aus.
1. Geben Sie unter **Sitzungsskriptobjekt in S3** entweder die S3 URI ein, die das Sitzungsskriptobjekt darstellt, oder wählen Sie **S3 durchsuchen** aus, um zu Ihren S3-Buckets zu navigieren und das Sitzungsskriptobjekt zu finden.
1. Wenn Sie die gewünschten Änderungen vorgenommen haben, wählen Sie **Änderungen speichern** aus.
1. Zu diesem Zeitpunkt sind die Sitzungsskripts für alle gestarteten Flotten-Instances verfügbar.
**Anmerkung**
Sie können die Sitzungsskripts auch konfigurieren, wenn Sie eine neue Elastic-Flotte erstellen.
# Sitzungsskript-Konfigurationsdatei
Um die Konfigurationsdatei für Sitzungsskripten in einer Windows-Instanz zu finden, navigieren Sie zu C:\$1\$1AppStream\$1 SessionScripts config.json. Navigieren Sie auf einer Linux-Instanz zu/opt/appstream/SessionScripts/config.json. Die Datei ist wie folgt formatiert:
**Anmerkung**
Die Konfigurationsdatei liegt im JSON-Format vor. Verifizieren Sie, dass der gesamte eingegebene Text ein gültiges JSON-Format hat.
```
{
"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
}
}
```
Sie können die folgenden Parameter in der Sitzungsskript-Konfigurationsdatei verwenden.
***SessionStart/SessionTermination ***
Welche Sitzungsskripte bei Auftreten eines Sitzungsereignisses ausgeführt werden, hängt vom Namen des Objekts ab.
**Typ:** Zeichenfolge
**Required**: No
**Zulässige Werte:** **SessionStart**, **SessionTermination**
***WaitingTime***
Maximale Dauer der Sitzungsskripte in Sekunden.
**Typ**: Ganzzahl
**Required**: No
**Einschränkungen:** Die maximale Dauer beträgt 60 Sekunden. Wenn die Sitzungsskripte nicht innerhalb dieser Zeit abgeschlossen werden, werden sie beendet. Wenn ein Skript weiter ausgeführt werden soll, starten Sie es als einen separaten Prozess.
***Executables***
Die Details für die auszuführenden Sitzungsskripte.
**Typ:** Zeichenfolge
**Erforderlich**: Ja
**Einschränkungen:** Pro Sitzungsereignis können maximal 2 Skripte ausgeführt werden (eines für den Benutzerkontext, eines für den Systemkontext).
***Context***
Der Kontext, in dem das Sitzungsskript ausgeführt werden soll.
**Typ:** Zeichenfolge
**Erforderlich**: Ja
**Zulässige Werte:** **user**, **system**
***Filename***
Der vollständige Pfad des auszuführenden Sitzungsskripts. Wenn dieser Parameter nicht angegeben wird, wird das Sitzungsskript nicht ausgeführt.
**Typ:** Zeichenfolge
**Required**: No
**Einschränkungen:** Die maximale Länge für Dateiname und vollständigen Pfad beträgt 1000 Zeichen.
**Zulässige Werte:****.bat**,, **.exe** **.sh**
Sie können auch PowerShell Windows-Dateien verwenden. Weitere Informationen finden Sie unter [PowerShell Windows-Dateien verwenden](using-powershell-files-with-session-scripts.md).
***Arguments***
Die Argumente für das Sitzungsskript oder die ausführbare Datei.
**Typ:** Zeichenfolge
**Required**: No
**Längenbeschränkungen:** Die maximale Länge beträgt 1000 Zeichen.
***S3LogEnabled***
Wenn der Wert für diesen Parameter auf **True** gesetzt ist, wird im Amazon-Web-Services-Konto ein S3-Bucket zum Speichern der vom Sitzungsskript generierten Protokolle erstellt. Standardmäßig ist dieser Wert auf **True** festgelegt. Weitere Informationen finden Sie im Abschnitt *Protokollieren der Ausgaben von Sitzungsskripten* unten in diesem Thema.
**Typ**: Boolesch
**Required**: No
**Zulässige Werte:** **True**, **False**
# PowerShell Windows-Dateien verwenden
Um PowerShell Windows-Dateien zu verwenden, geben Sie den vollständigen Pfad zur PowerShell Datei im **filename** Parameter an:
```
"filename":
"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
```
Geben Sie das Sitzungsskript im Parameter **arguments** an:
```
"arguments": "-File \"C:\\path\\to\\session\\script.ps1\"",
```
Stellen Sie abschließend sicher, dass die PowerShell Ausführungsrichtlinie die Ausführung Ihrer PowerShell Datei zulässt.
# Protokollieren der Ausgaben von Sitzungsskripten
Wenn diese Option in der Konfigurationsdatei aktiviert ist, erfasst WorkSpaces Applications automatisch die Ausgabe des Sitzungsskripts, die in die Standardausgabe geschrieben wird. Diese Ausgabe wird in einen Amazon S3-Bucket im Konto hochgeladen. Sie können die Protokolldateien im Rahmen der Fehlerbehebung und des Debuggings heranziehen.
**Anmerkung**
Die Protokolldateien werden hochgeladen, wenn das Sitzungsskript einen Wert zurückgibt oder die in **WaitingTime** festgelegte Zeit abgelaufen ist (je nachdem, welches Ereignis zuerst eintritt).
# Verwenden von Speicher-Connectors mit Sitzungsskripten
Wenn die Speicherconnectors für WorkSpaces Anwendungen aktiviert sind, beginnen sie mit dem Mounten, sobald die Sitzungsstartskripts ausgeführt werden. Wenn Ihr Skript darauf angewiesen ist, dass die Speicherconnectors bereitgestellt werden, können Sie warten, bis die Konnektoren verfügbar sind. WorkSpaces Applications behält den Bereitstellungsstatus der Speicherconnectors in der Windows-Registrierung auf Windows-Instances unter dem folgenden Schlüssel bei:
HKEY\$1LOCAL\$1MACHINE\$1 SOFTWARE\$1 Amazon\$1\$1 Speicher\$1\$1 AppStream
Die Werte des Registrierungsschlüssels lauten wie folgt:
+ Bereitgestellter Benutzername – die über den Zugriffsmodus bereitgestellte Benutzer-ID. Die verfügbaren Zugriffsmodi und die jeweils zugehörigen Werte lauten:
+ Benutzerpool – die E-Mail-Adresse des Benutzers
+ Streaming-URL – die UserID
+ SAML – die NameID. Wenn der Benutzername einen Schrägstrich enthält (z. B. der Name eines Domänenbenutzers SAMAccount), wird der Schrägstrich durch ein „-“ -Zeichen ersetzt.
+ Speicher-Connector – der Connector für die persistente Speicheroption, die für den Benutzer aktiviert ist. Mögliche Werte für den Speicher-Connector:
+ HomeFolder
+ GoogleDrive
+ OneDrive
Jeder Storage Connector-Registrierungsschlüssel enthält einen **MountStatus**DWORD-Wert. In der folgenden Tabelle sind die möglichen Werte für **MountStatus**aufgeführt.
**Anmerkung**
Um diese Registrierungsschlüssel anzuzeigen, müssen Sie Microsoft.NET Framework Version 4.7.2 oder höher auf Ihrem Abbild installiert haben.
| Wert | Description |
| --- | --- |
| 0 | Der Speicher-Connector wurde für diesen Benutzer nicht aktiviert. |
| 1 | Die Bereitstellung des Speicher-Connectors läuft. |
| 2 | Der Speicher-Connector wurde bereitgestellt. |
| 3 | Der Speicher-Connector konnte nicht bereitgestellt werden. |
| 4 | Mounting des Speicher-Connectors ist aktiviert, aber noch nicht gemountet |
Auf Linux-Instances können Sie den Bereitstellungsstatus des Home-Ordners überprüfen, indem Sie sich den Wert von appstream\$1home\$1folder\$1mount\$1status in der Datei \$1/ ansehen. config/appstream-home-folder/appstreamhome-folder-mount-status-.
| Wert | Description |
| --- | --- |
| Wahr | Der Basisordner wurde erfolgreich bereitgestellt. |
| Falsch | Der Basisordner ist noch nicht bereitgestellt. |
# Aktivieren der Speicherung von Sitzungsskriptprotokollen in Amazon-S3-Buckets
Wenn Sie die Amazon S3 S3-Protokollierung in Ihrer Sitzungsskriptkonfiguration aktivieren, erfasst WorkSpaces Applications die Standardausgabe Ihres Sitzungsskripts. Die Ausgabe wird regelmäßig in einen S3-Bucket im Amazon-Web-Services-Konto hochgeladen. WorkSpaces Applications erstellt für jede AWS Region einen Bucket in Ihrem Konto, der für Ihr Konto und die Region einzigartig ist.
Konfigurationsschritte zum Verwalten dieser S3-Buckets sind nicht erforderlich. Sie werden vollständig vom WorkSpaces Applications Service verwaltet. Die in einem Bucket gespeicherten Protokolldateien werden während der Übertragung mit Amazon-S3-SSL-Endpunkten und im Ruhezustand mit Amazon-S3-verwalteten Verschlüsselungsschlüsseln verschlüsselt. Die Benennung der Buckets erfolgt wie folgt in einem bestimmten Format:
```
appstream-logs-region-code-account-id-without-hyphens-random-identifier
```
***region-code***
Dies ist der AWS Regionalcode, in dem der Stack erstellt wird, wobei der Amazon S3 S3-Bucket-Speicher für Sitzungsskriptprotokolle aktiviert ist.
***account-id-without-hyphens***
Ihre Konto-ID für Amazon Web Services. Die zufällige ID stellt sicher, dass keine Konflikte mit anderen Buckets in dieser Region auftreten. Der erste Teil des Bucket-Namens, `appstream-logs`, ändert sich konto- oder regionsübergreifend nicht.
Wenn Sie beispielsweise Sitzungsskripte in einem Bild in der Region USA West (Oregon) (us-west-2) unter der Kontonummer 123456789012 angeben, erstellt WorkSpaces Applications innerhalb Ihres Kontos in dieser Region einen Amazon S3 S3-Bucket mit dem angezeigten Namen. Nur ein Administrator mit ausreichenden Berechtigungen kann diesen Bucket löschen.
```
appstream-logs-us-west-2-1234567890123-abcdefg
```
Durch das Deaktivieren von Sitzungsskripten werden die im S3-Bucket gespeicherten Protokolldateien nicht gelöscht. Um Protokolldateien dauerhaft zu löschen, müssen Sie oder ein anderer Administrator mit entsprechenden Berechtigungen die Amazon S3 S3-Konsole oder API verwenden. WorkSpaces Applications fügt eine Bucket-Richtlinie hinzu, die ein versehentliches Löschen des Buckets verhindert. Weitere Informationen finden Sie unter *IAM-Richtlinien und der Amazon-S3-Bucket für Basisordner und Persistenz von Anwendungseinstellungen* in [Identity and Access Management für WorkSpaces Amazon-Anwendungen](controlling-access.md).
Wenn Sitzungsskripte aktiviert sind, wird für jede gestartete Streaming-Sitzung ein eindeutiger Ordner erstellt.
Der Pfad für den Ordner, in dem die Protokolldateien im S3-Bucket in Ihrem Konto gespeichert werden, hat die folgende Struktur:
```
bucket-name/stack-name/fleet-name/access-mode/user-id-SHA-256-hash/session-id/SessionScriptsLogs/session-event
```
***bucket-name***
Name des S3-Buckets, in dem die Sitzungsskripte gespeichert werden. Auf das Format des Namens wird weiter oben in diesem Abschnitt eingegangen.
***stack-name***
Name des Stacks, aus dem die Sitzung stammt.
***fleet-name***
Name der Flotte, für die das Sitzungsskript ausgeführt wird.
***access-mode***
Die Identitätsmethode des Benutzers: `custom` für die WorkSpaces Anwendungs-API oder CLI, `federated` für SAML und `userpool` für Benutzer im Benutzerpool.
***user-id-SHA-256-hash***
Der benutzerspezifische Ordnername. Der Name wird aus einer aus der Benutzer-ID generierten hexadezimalen SHA-256-Hash-Zeichenfolge in Kleinbuchstaben gebildet.
***session-id***
ID der Streaming-Sitzung des Benutzers. Für jede Streaming-Sitzung eines Benutzers wird eine eindeutige ID generiert.
***session-event***
Ereignis, das zum Generieren des Sitzungsprotokolls geführt hat. Die Ereigniswerte lauten `SessionStart` und `SessionTermination`.
Das folgende Beispiel für eine Ordnerstruktur gilt für eine Streaming-Sitzung, die von test-stack und test-fleet gestartet wurde. Die Sitzung verwendet die API der Benutzer-ID `testuser@mydomain.com` aus einer AWS-Konto ID von `123456789012` und die Einstellungsgruppe `test-stack` in der Region USA West (Oregon) (us-west-2):
```
appstream-logs-us-west-2-1234567890123-abcdefg/test-stack/test-fleet/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/05yd1391-4805-3da6-f498-76f5x6746016/SessionScriptsLogs/SessionStart/
```
Dieses Beispiel für eine Ordnerstruktur enthält eine Protokolldatei eines Startskripts für eine Benutzerkontextsitzung sowie eine Protokolldatei eines Startskripts für eine Systemkontextsitzung (sofern relevant).
# Verwenden Sie Sitzungsskripten auf Flotten mit mehreren Sitzungen
Bei der Verwendung von Sitzungsskripten für Flotten mit mehreren Sitzungen gelten zusätzliche Anforderungen und Überlegungen, um optimale Leistung und Sicherheit zu gewährleisten.
## Voraussetzungen
Bei einer Flotte mit nur einer Sitzung werden die **SessionStart**SessionTermination****And-Hooks für eine bestimmte Instanz garantiert nur einmal ausgeführt. Das liegt daran, dass es eine 1:1 -Zuordnung von Sitzungen zu Instanzen gibt. Bei der Verwendung von Multi-Session-Flotten gibt es eine N:M-Zuordnung von Sessions zu Instances, wobei jede Session ihren eigenen und einen eigenen Hook ausführt. **SessionStart**SessionTermination**** Das bedeutet, dass die **SessionTermination**Hooks **SessionStart**und die Hooks auf einer bestimmten Instanz viele Male und in vielen verschiedenen Reihenfolgen ausgeführt werden können. Für eine optimale Benutzererfahrung sollte Folgendes für Ihre Session-Skripte gelten, wenn Sie sie auf Multi-Session-Flotten verwenden:
+ Skripte sind idempotent.
Wenn eine Aktion bereits ausgeführt wurde, sollten Skripte mehr als eine Ausführung auf derselben Instanz problemlos verarbeiten.
+ Skripten sind unabhängig.
Da Skripten pro Sitzung ausgeführt werden, sollten sie, wenn eine Sitzung ausgeführt wird **SessionStart**, **SessionTermination**während eine andere läuft, sich gegenseitig oder die Erfahrung anderer Sitzungen nicht beeinträchtigen.
+ Skripts sind performant.
Auf Instanzen mit mehreren Sitzungen können mehrere Sitzungen gleichzeitig bereitgestellt werden. Das bedeutet, dass die Sitzungsskripten mehrfach gleichzeitig ausgeführt werden können. Skripts sollten effizient sein, keine übermäßigen Ressourcen verbrauchen und die Erfahrung anderer Benutzer auf der Instanz oder die Stabilität der Sitzungen nicht beeinträchtigen.
Viele dieser Anforderungen können erfüllt werden, indem die Logik des Sitzungsskripts auf die spezifische Benutzersitzung ausgerichtet wird, für die das Skript ausgeführt wird.
## Sicherheitsüberlegungen
WorkSpaces Anwendungs-Images sollten nicht so konfiguriert werden, dass Benutzern Schreibberechtigungen für Sitzungsskriptdateien gewährt werden. Dadurch entsteht ein kritischer Angriffsvektor für böswillige Benutzer, bei dem sie Skriptdateien ändern könnten. Diese Dateien können dann je nach Konfiguration als SYSTEM oder als anderer Benutzer ausgeführt werden.
**Wichtig**
Es liegt in Ihrer Verantwortung, sicherzustellen, dass Ihre WorkSpaces Anwendungs-Images sicher konfiguriert sind. Dies ist besonders wichtig für Instanzen mit mehreren Sitzungen, bei denen mehrere Benutzer dieselbe Instanz verwenden. Wenn Images nicht sicher konfiguriert sind, besteht ein Sicherheitsrisiko für alle Benutzer dieser Instanz.
Folgendes sollte für Ihre Bilder und Sitzungsskriptdateien gelten:
+ Benutzer sind nicht berechtigt, Sitzungsskriptdateien zu ändern.
+ Benutzer sind nicht berechtigt, das Sitzungsskript config.json zu ändern. Das Standardverhalten des Images schränkt den Zugriff auf Administratoren ein.
Die ausführbaren Dateien von Sitzungsskripten sollten an einem sicheren Ort gespeichert werden, an dem sie während der Laufzeit vor Änderungen geschützt sind.
Wenn der Service feststellt, dass eine ausführbare Datei eines Sitzungsskripts geändert wurde, schlägt er alle nachfolgenden Ausführungen dieses Hooks auf dieser Instance fehl, lädt Protokolldateien auf Amazon S3 hoch (falls die Amazon S3 S3-Protokollierung aktiviert ist), und Sie erhalten die folgende Meldung:
**Das Sitzungsskript wurde nicht ausgeführt, da die ausführbare Datei nach der Instance-Bereitstellung geändert wurde. Die Ausführung wurde aus Sicherheitsgründen übersprungen.**
Wenn Ihr Anwendungsfall eine Änderung der ausführbaren Datei des Sitzungsskripts zur Laufzeit erfordert (wenn Sie beispielsweise auf eine EXE-Datei verweisen, die zur Laufzeit durch einen automatischen Aktualisierungsprozess geändert wurde), werden die obigen Prüfungen nicht bestanden. Verwenden Sie in diesem Fall ein Skript, um die Ausführung an Ihre geänderte ausführbare Datei weiterzuleiten. Lassen Sie das Skript zur Laufzeit unverändert, wenn der Dienst Sicherheitsüberprüfungen durchführt.
Wenn Ihre Sitzungsskriptdateien zu groß sind (mehr als 100 MB), kann dies zu Verzögerungen bei der Instanz- und Sitzungsbereitstellung führen, und die Sicherheitsprüfungen nehmen zusätzliche Zeit in Anspruch (abhängig vom Instanztyp und den verfügbaren Ressourcen). Wenn Ihr Anwendungsfall umfangreiche Sitzungsskripten erfordert, sollten Sie die Verwendung kleinerer Skripts in Betracht ziehen, um die Ausführung umzuleiten. Dies wird die Erfahrung bei der Bereitstellung von Instanzen und Sitzungen verbessern.
Beachten Sie, dass der Dienst nur die in den Sitzungsskripten config.json definierte ausführbare Datei überprüft, und dies ist nur ein fallback/best Aufwandsmechanismus. Es liegt in Ihrer Verantwortung sicherzustellen, dass alle Codepfade in den ausführbaren Dateien von Sitzungsskripten sicher sind und nicht von Endbenutzern geändert werden können.