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.
# Bundles und Bilder für Pools WorkSpaces
Ein *WorkSpace Paket* ist eine Kombination aus einem Betriebssystem sowie Speicher-, Rechen- und Softwareressourcen. Wenn Sie ein starten WorkSpace, wählen Sie das Paket aus, das Ihren Anforderungen entspricht. Die verfügbaren Standardpakete WorkSpaces werden als *öffentliche Bundles* bezeichnet. Weitere Informationen zu den verschiedenen öffentlichen Paketen, die für verfügbar sind WorkSpaces, finden Sie unter [ WorkSpaces Amazon-Pakete](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles).
Wenn Sie ein Windows gestartet WorkSpace und angepasst haben, können Sie daraus ein benutzerdefiniertes Image WorkSpace für die Verwendung mit WorkSpaces Pool erstellen. Linux wird in WorkSpaces Pool nicht unterstützt.
Ein *benutzerdefiniertes Image* enthält nur das Betriebssystem, die Software und die Einstellungen für WorkSpace. Ein *benutzerdefiniertes Paket* ist eine Kombination aus diesem benutzerdefinierten Image und der Hardware, von der aus ein gestartet werden WorkSpace kann.
Nachdem Sie ein benutzerdefiniertes Image erstellt haben, können Sie ein benutzerdefiniertes Paket erstellen, das das benutzerdefinierte WorkSpace Image und die zugrunde liegende Rechen- und Speicherkonfiguration, die Sie auswählen, kombiniert. Sie können dieses benutzerdefinierte Paket dann angeben, wenn Sie neue WorkSpaces Pools erstellen, um sicherzustellen, dass die neuen WorkSpaces Pools dieselbe konsistente Konfiguration (Hardware und Software) haben.
Wenn Sie Softwareupdates durchführen oder zusätzliche Software auf Ihrem installieren müssen WorkSpaces, können Sie Ihr benutzerdefiniertes Paket aktualisieren und damit Ihr Paket neu erstellen WorkSpaces.
WorkSpaces Pools unterstützt verschiedene Betriebssysteme (OS), Streaming-Protokolle und Bundles. Die folgende Tabelle enthält Informationen zu den Lizenzierungen, Streaming-Protokollen und Bundles, die von den einzelnen Betriebssystemen unterstützt werden.
| Betriebssystem | Lizenzen | Streaming-Protokolle | Unterstützte Pakete | Lebenszyklusrichtlinie/Ruhestandsdatum |
| --- | --- | --- | --- | --- |
| Windows Server 2019 | Enthalten | DCV | Wert, Standard, Leistung, Leistung, PowerPro | [9. Januar 2029](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2019) |
| Windows Server 2022 | Enthalten | DCV | Standard, Leistung, Leistung, Grafik.G4DN PowerPro, .G4DN GraphicsPro | [14. Oktober 2013](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2022) |
**Anmerkung**
Für Betriebssystemversionen, die vom Anbieter nicht mehr unterstützt werden, kann nicht garantiert werden, dass sie funktionieren, und sie werden auch nicht vom AWS Support unterstützt.
**Topics**
+ [Bundle-Optionen für WorkSpaces Pools](pools-custom-images-bundles.md)
+ [Erstellen Sie ein benutzerdefiniertes Image und ein Paket für WorkSpaces Pools](pools-images-custom-image.md)
+ [Benutzerdefinierte Images und Bundles für WorkSpaces Pools verwalten](pools-images-managing.md)
+ [Verwenden Sie Sitzungsskripte, um das Streaming-Erlebnis Ihrer Nutzer zu verwalten](pools-images-session-scripts.md)
# Bundle-Optionen für WorkSpaces Pools
Bevor Sie ein Paket für die Verwendung mit WorkSpaces Pool auswählen, stellen Sie sicher, dass das Paket, das Sie auswählen möchten, mit WorkSpaces Ihrem Protokoll, Betriebssystem, Netzwerk und Rechnertyp kompatibel ist. Wir empfehlen, die Leistung der Pakete, die Sie auswählen möchten, in einer Testumgebung zu prüfen, indem Sie Anwendungen ausführen und verwenden, die die täglichen Aufgaben Ihrer Benutzer abbilden. Weitere Informationen zu Protokollen finden Sie unter[Protokolle für WorkSpaces Personal](amazon-workspaces-networking.md#amazon-workspaces-protocols). Weitere Informationen zu Netzwerken finden Sie unter[Client-Netzwerkanforderungen für WorkSpaces Personal](workspaces-network-requirements.md).
Die folgenden öffentlichen Pakete können mit WorkSpaces Pool verwendet werden. Informationen zu Bundles in finden Sie WorkSpaces unter [ WorkSpaces Amazon-Pakete](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles). Wert, Standard, Leistung, Leistung, Leistung, PowerPro
## Value-Paket
Dieses Paket eignet sich ideal für:
+ Grundlegende Textbearbeitung und Dateneingabe
+ Surfen im Internet mit geringer Nutzung
+ Instant-Messaging
Dieses Paket wird nicht für Textverarbeitung, Audio- und Videokonferenzen, Bildschirmübertragung, Softwareentwicklungstools, Business-Intelligence-Anwendungen und Grafikanwendungen empfohlen.
## Standard-Paket
Dieses Paket eignet sich ideal für:
+ Grundlegende Textbearbeitung und Dateneingabe
+ Surfen im Internet
+ Instant-Messaging
+ Email
Dieses Paket wird nicht für Textverarbeitung, Audio- und Videokonferenzen, Bildschirmübertragung, Softwareentwicklungstools, Business-Intelligence-Anwendungen und Grafikanwendungen empfohlen.
## Performance-Paket
Dieses Paket eignet sich ideal für:
+ Surfen im Internet
+ Textverarbeitung
+ Instant-Messaging
+ Email
+ Tabellenkalkulation
+ Audioverarbeitung
+ Courseware
Dieses Paket wird nicht für Audio- und Videokonferenzen, Bildschirmübertragung, Softwareentwicklungstools, Business-Intelligence-Anwendungen und Grafikanwendungen empfohlen.
## Power-Paket
Dieses Paket eignet sich ideal für:
+ Surfen im Internet
+ Textverarbeitung
+ Email
+ Instant-Messaging
+ Tabellenkalkulation
+ Audioverarbeitung
+ Softwareentwicklung (Integrierte Entwicklungsumgebung, IDE)
+ Datenverarbeitung auf niedriger bis mittlerer Ebene
+ Audio- und Videokonferenzen
Dieses Paket wird nicht für Bildschirmübertragung, Softwareentwicklungstools, Business-Intelligence-Anwendungen und Grafikanwendungen empfohlen.
## PowerPro bündeln
Dieses Paket eignet sich ideal für:
+ Surfen im Internet
+ Textverarbeitung
+ Email
+ Instant-Messaging
+ Tabellenkalkulation
+ Audioverarbeitung
+ Softwareentwicklung (Integrierte Entwicklungsumgebung, IDE)
+ Data-Warehousing
+ Business-Intelligence-Anwendungen
+ Audio- und Videokonferenzen
Dieses Paket wird nicht für das Training von Machine-Learning-Modellen und für Grafikanwendungen empfohlen.
## Graphics.g4dn-Paket
Dieses Paket bietet ein hohes Maß an Grafikleistung und ein moderates Maß an CPU-Leistung und Arbeitsspeicher für Sie WorkSpaces und ist für Folgendes gut geeignet:
+ Surfen im Internet
+ Textverarbeitung
+ Email
+ Tabellenkalkulation
+ Instant-Messaging
+ Audiokonferenzen
+ Softwareentwicklung (Integrierte Entwicklungsumgebung, IDE)
+ Datenverarbeitung auf niedriger bis mittlerer Ebene
+ Data-Warehousing
+ Business-Intelligence-Anwendungen
+ Grafikdesign
+ CAD/CAM (computer-aided design/computer-unterstützte Fertigung)
Dieses Paket wird nicht für Audio- und Videokonferenzen, 3D-Rendering, fotorealistisches Design und das Training von Machine-Learning-Modellen empfohlen.
## GraphicsPro.g4dn-Paket
Dieses Paket bietet ein hohes Maß an Grafikleistung, CPU-Leistung und Arbeitsspeicher für Sie WorkSpaces und ist für Folgendes gut geeignet:
+ Surfen im Internet
+ Textverarbeitung
+ Email
+ Tabellenkalkulation
+ Instant-Messaging
+ Audiokonferenzen
+ Softwareentwicklung (Integrierte Entwicklungsumgebung, IDE)
+ Datenverarbeitung auf niedriger bis mittlerer Ebene
+ Data-Warehousing
+ Business-Intelligence-Anwendungen
+ Grafikdesign
+ CAD/CAM (computer-aided design/computer-unterstützte Fertigung)
+ Videotranskodierung
+ 3D-Rendering
+ Fotorealistisches Design
+ Game-Streaming
+ ML-Modelltraining (Machine Learning) und ML-Inferenz
Dieses Paket wird nicht für Audio- und Videokonferenzen empfohlen.
# Erstellen Sie ein benutzerdefiniertes Image und ein Paket für WorkSpaces Pools
WorkSpaces Pool unterstützt nur Windows-Images und -Bundles. Wenn Sie ein Windows gestartet oder WorkSpace es angepasst haben, können Sie ein benutzerdefiniertes Image und daraus benutzerdefinierte Bundles erstellen. WorkSpace
Ein *benutzerdefiniertes Image* enthält nur das Betriebssystem, die Software und die WorkSpace Einstellungen für. Ein *benutzerdefiniertes Paket* ist eine Kombination aus diesem benutzerdefinierten Image und der Hardware, von der aus ein gestartet werden WorkSpace kann.
Nachdem Sie ein benutzerdefiniertes Abbild erstellt haben, können Sie ein benutzerdefiniertes Bundle erstellen, das das benutzerdefinierte Abbild mit der zugrunde liegenden Rechen- und Speicherkonfiguration kombiniert, die Sie auswählen. Sie können dieses benutzerdefinierte Paket dann angeben, wenn Sie ein neues Paket starten, WorkSpaces um sicherzustellen, dass das neue Paket dieselbe konsistente Konfiguration (Hardware und Software) WorkSpaces hat.
Sie können anhand desselben benutzerdefinierten Image verschiedene benutzerdefinierte Bundles erstellen, indem Sie für jedes Bundle verschiedene Rechen- und Speicheroptionen auswählen.
**Wichtig**
Speichervolumes für benutzerdefinierte Pakete dürfen nicht kleiner sein als Image-Speichervolumes.
Benutzerdefinierte Pakete kosten genauso viel wie die öffentlichen Pakete, aus denen sie erstellt wurden. Weitere Informationen zur Preisgestaltung finden Sie unter [ WorkSpaces Amazon-Preise](https://aws.amazon.com/workspaces/pricing/).
**Topics**
+ [Anforderungen zum Erstellen von benutzerdefinierten Windows-Abbildern](#pools-windows_custom_image_requirements)
+ [Best Practices](#pools-custom_image_best_practices)
+ [Schritt 1: Ausführen von Image Checker](#pools-run_image_checker)
+ [Schritt 2: Erstellen Sie ein benutzerdefiniertes Image und ein benutzerdefiniertes Paket](#pools-create_custom_image_bundle)
+ [Was ist in WorkSpaces benutzerdefinierten Windows-Images enthalten](#pools-image_creation_windows)
## Anforderungen zum Erstellen von benutzerdefinierten Windows-Abbildern
**Anmerkung**
Windows definiert 1 GB derzeit als 1.073.741.824 Byte. Sie müssen sicherstellen, dass mehr als 12.884.901.888 Byte (oder 12 GiB) auf Laufwerk C frei sind und das Benutzerprofil weniger als 10.737.418.240 Byte (oder 10 GiB) groß ist, um ein Bild von a zu erstellen. WorkSpace
+ ****Der Status von muss verfügbar sein und sein Änderungsstatus muss „Keine“ lauten WorkSpace .****
+ Alle Anwendungen und Benutzerprofile auf WorkSpaces Images müssen mit Microsoft Sysprep kompatibel sein.
+ Alle Anwendungen, die im Abbild enthalten sein sollen, müssen auf dem Laufwerk `C` installiert sein.
+ Alle Anwendungsdienste, die auf dem ausgeführt werden, WorkSpace müssen ein lokales Systemkonto anstelle von Domänenbenutzeranmeldeinformationen verwenden. Beispielsweise können Sie die Microsoft SQL Server Express-Installation nicht mit den 'Anmeldeinformationen' des Domänenbenutzers ausführen.
+ Das WorkSpace darf nicht verschlüsselt sein. Die Erstellung von Bildern aus einer verschlüsselten WorkSpace Datei wird derzeit nicht unterstützt.
+ Die folgenden Komponenten sind in einem Abbild erforderlich. Ohne diese Komponenten funktioniert WorkSpaces das, was Sie vom Image aus starten, nicht richtig. Weitere Informationen finden Sie unter [Erforderliche Konfiguration und Servicekomponenten für WorkSpaces Personal](required-service-components.md).
+ Windows PowerShell Version 3.0 oder höher
+ Remote Desktop Services
+ AWS PV-Treiber
+ Windows Remote Management (WinRM)
+ Teradici PCo IP-Agenten und -Treiber
+ STXHD-Agenten und Treiber
+ AWS und Zertifikate WorkSpaces
+ Skylight-Agent
+ WorkSpaces Pools unterstützt nur eine maximale Größe des Bundle/Image-Root-Volumes von 200 GB. Wenn Sie ein benutzerdefiniertes Windows-Image erstellen, stellen Sie sicher, dass es unter der Größe des Root-Volumes von 200 GB liegt.
## Best Practices
Bevor Sie ein Abbild aus einem erstellen WorkSpace, gehen Sie wie folgt vor:
+ Verwenden Sie eine separate VPC, die nicht mit Ihrer Produktionsumgebung verbunden ist.
+ Stellen Sie das WorkSpace in einem privaten Subnetz bereit und verwenden Sie eine NAT-Instanz für ausgehenden Datenverkehr.
+ Verwenden Sie ein kleines Simple AD-Verzeichnis.
+ Verwenden Sie die kleinste Volume-Größe für die Quelle und passen Sie dann die Volume-Größe nach Bedarf an WorkSpace, wenn Sie das benutzerdefinierte Bundle erstellen.
+ Installieren Sie alle Betriebssystemupdates (außer Windows-Funktions-/Versionsupdates) und alle Anwendungsupdates auf dem. WorkSpace
+ Löschen Sie zwischengespeicherte Daten aus dem WorkSpace , die nicht im Paket enthalten sein sollten (z. B. den Browserverlauf, zwischengespeicherte Dateien und Browser-Cookies).
+ Löschen Sie die Konfigurationseinstellungen aus den WorkSpace , die nicht im Paket enthalten sein sollten (z. B. E-Mail-Profile).
+ Wechseln Sie mit DHCP zu dynamischen IP-Adresseinstellungen.
+ Vergewissern Sie sich, dass Sie Ihr Kontingent für WorkSpace Bilder, die in einer Region zulässig sind, nicht überschritten haben. Standardmäßig sind dir 40 WorkSpace Bilder pro Region erlaubt. Wenn Sie dieses Kontingent erreicht haben, schlagen neue Versuche, ein Abbild zu erstellen, fehl. Um eine Kontigenterhöhung zu beantragen, verwenden Sie das Formular für [WorkSpaces -Limits](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=workspaces).
+ Stellen Sie sicher, dass Sie nicht versuchen, ein Bild aus einer verschlüsselten Datei zu erstellen WorkSpace. Die Erstellung von Bildern aus einer verschlüsselten WorkSpace Datei wird derzeit nicht unterstützt.
+ Wenn Sie Antivirensoftware auf dem ausführen WorkSpace, deaktivieren Sie diese, während Sie versuchen, ein Image zu erstellen.
+ Wenn Sie auf Ihrem eine Firewall aktiviert haben WorkSpace, stellen Sie sicher, dass sie keine erforderlichen Ports blockiert. Weitere Informationen finden Sie unter [Anforderungen an IP-Adresse und Port für WorkSpaces Personal](workspaces-port-requirements.md).
+ Für Windows WorkSpaces sollten Sie vor der Image-Erstellung keine Gruppenrichtlinienobjekte (GPOs) konfigurieren.
+ Passen Sie unter Windows WorkSpaces das Standardbenutzerprofil (`C:\Users\Default`) nicht an, bevor Sie ein Image erstellen. Es wird empfohlen, alle Anpassungen des Benutzerprofils zunächst vorzunehmen und diese nach der Erstellung des Images anzuwenden. GPOs GPOs können leicht geändert oder rückgängig gemacht werden und sind daher weniger fehleranfällig als Anpassungen, die am Standardbenutzerprofil vorgenommen wurden.
+ Stellen Sie sicher, dass Sie Treiber für Netzwerkabhängigkeiten wie ENA NVMe - und PV-Treiber auf Ihrem WorkSpaces aktualisieren. Sie sollten dies mindestens einmal alle 6 Monate tun. Weitere Informationen finden [Sie unter Installieren oder Aktualisieren des Elastic Network Adapter (ENA) -Treibers AWS-NVMe-Treiber](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/enhanced-networking-ena.html#ena-adapter-driver-install-upgrade-win) [für Windows-Instances](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/aws-nvme-drivers.html) und [Aktualisieren von PV-Treibern auf Windows-Instances](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Upgrading_PV_drivers.html).
+ Stellen Sie sicher, dass Sie die Agenten EC2 Config, EC2 EC2 Launch und Launch V2 regelmäßig auf die neuesten Versionen aktualisieren. Sie sollten dies mindestens einmal alle 6 Monate tun. Weitere Informationen finden Sie unter [ EC2Config aktualisieren und EC2 starten](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/migrating-latest-types.html#upgdate-ec2config-ec2launch).
## Schritt 1: Ausführen von Image Checker
Um sicherzustellen, dass Ihr Windows die Anforderungen für die Image-Erstellung WorkSpace erfüllt, empfehlen wir, die Image Checker-Anwendung auszuführen. Der Image Checker führt eine Reihe von Tests mit dem Gerät durch WorkSpace , das Sie zum Erstellen Ihres Abbilds verwenden möchten, und bietet Anleitungen zur Lösung aller gefundenen Probleme. Der Image Checker ist nur für Windows verfügbar. WorkSpaces
**Wichtig**
Der WorkSpace muss alle vom Image Checker ausgeführten Tests bestehen, bevor Sie ihn für die Image-Erstellung verwenden können.
Bevor Sie den Image Checker ausführen, stellen Sie sicher, dass die neuesten Windows-Sicherheitsupdates und kumulativen Updates auf Ihrem installiert sind. WorkSpace
Führen Sie zum Abrufen von Image Checker einen der folgenden Schritte aus:
+ [Starten Sie Ihr neu](reboot-workspaces.md). WorkSpace Image Checker wird während des Neustarts automatisch heruntergeladen und unter `C:\Program Files\Amazon\ImageChecker.exe` installiert.
+ Laden Sie den Amazon WorkSpaces Image Checker von [https://tools.amazonworkspaces.comImageChecker/.zip ](https://tools.amazonworkspaces.com/ImageChecker.zip) herunter und entpacken Sie die Datei. `ImageChecker.exe` Kopieren Sie diese Datei nach `C:\Program Files\Amazon\`.
**So führen Sie Image Checker aus**
1. Öffnen Sie die `C:\Program Files\Amazon\ImageChecker.exe` Datei.
1. Wählen Sie im Dialogfeld **Amazon WorkSpaces Image Checker** die Option **Ausführen**.
1. Nach dem Abschluss des jeweiligen Tests können Sie dessen Status anzeigen.
Wählen Sie für jeden Test mit dem Status **FEHLGESCHLAGEN** die Option **Info**, um Informationen anzuzeigen, wie Sie das Problem beheben, das den Fehler verursacht hat. Weitere Informationen zum Beheben dieser Probleme finden Sie unter [Tipps zur Lösung von Problemen, die vom Image Checker erkannt wurden](#pools-image_checker_tips).
Wenn bei einem Test der Status **WARNUNG** angezeigt wird, klicken Sie auf die Schaltfläche **Fix All Warnings (Alle Warnungen beheben)**.
Das Werkzeug generiert eine Ausgabeprotokolldatei in demselben Verzeichnis, in dem sich Image Checker befindet. Standardmäßig befindet sich diese Datei im Pfad `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log`. Löschen Sie diese Protokolldatei nicht. Wenn ein Problem auftritt, kann diese Protokolldatei bei der Fehlerbehebung hilfreich sein.
1. Beheben Sie gegebenenfalls alle Probleme, die zu Testfehlern und Warnungen führen, und wiederholen Sie den Vorgang, den Image Checker auszuführen, bis alle Tests WorkSpace bestanden sind. Alle Fehler und Warnungen müssen behoben werden, bevor Sie ein Abbild erstellen können.
1. Nachdem Sie WorkSpace alle Tests bestanden haben, wird die Meldung **Überprüfung erfolgreich abgeschlossen** angezeigt. Sie können nun ein benutzerdefiniertes Bundle erstellen.
### Tipps zur Lösung von Problemen, die vom Image Checker erkannt wurden
Lesen Sie zusätzlich zu den folgenden Tipps zur Behebung von Problemen, die von Image Checker erkannt werden, auch unbedingt die Image Checker-Protokolldatei unter `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log`.
#### PowerShell Version 3.0 oder höher muss installiert sein
Installieren Sie die neueste Version von [Microsoft Windows PowerShell](https://docs.microsoft.com/powershell).
**Wichtig**
Die PowerShell Ausführungsrichtlinie für a WorkSpace muss so eingestellt sein, dass sie **RemoteSigned**Skripts zulässt. Führen Sie den ExecutionPolicy PowerShell Befehl **Get- aus, um** die Ausführungsrichtlinie zu überprüfen. Wenn die Ausführungsrichtlinie nicht auf **Uneingeschränkt** oder festgelegt ist **RemoteSigned**, führen Sie den ExecutionPolicy RemoteSigned Befehl **Set- ExecutionPolicy —** aus, um den Wert der Ausführungsrichtlinie zu ändern. Die **RemoteSigned**Einstellung ermöglicht die Ausführung von Skripten auf Amazon WorkSpaces, was zur Erstellung eines Images erforderlich ist.
#### Nur die C- und D-Laufwerke können vorhanden sein
Auf einem, das für das Imaging verwendet wird, können nur WorkSpace die `D` Laufwerke `C` und vorhanden sein. Entfernen Sie alle anderen Laufwerke, einschließlich virtueller Laufwerke.
#### Es können keine ausstehenden Neustarts aufgrund von Windows-Updates erkannt werden
+ Der Prozess „Image erstellen“ kann erst ausgeführt werden, wenn Windows neu gestartet wurde, um die Installation von Sicherheits- oder kumulativen Updates abzuschließen. Starten Sie Windows neu, um diese Updates anzuwenden, und stellen Sie sicher, dass keine anderen ausstehenden Windows-Sicherheits- oder kumulativen Updates installiert werden müssen.
+ Die Imageerstellung wird auf Windows 10-Systemen nicht unterstützt, die von einer Version von Windows 10 auf eine neuere Version von Windows 10 aktualisiert wurden (ein feature/version Windows-Upgrade). Kumulative Windows-Updates oder Sicherheitsupdates werden jedoch von der WorkSpaces Image-Erstellung unterstützt.
#### Die Sysprep-Datei muss vorhanden sein und darf nicht leer sein
Wenn Probleme mit Ihrer Sysprep-Datei auftreten, wenden Sie sich an das [AWS Support Center](https://console.aws.amazon.com/support/home#/), um Ihre EC2 Config oder Ihren EC2 Launch reparieren zu lassen.
#### Die Benutzerprofilgröße muss weniger als 10 GB betragen.
Für Windows 7 WorkSpaces muss das Benutzerprofil (`D:\Users\username`) insgesamt weniger als 10 GB groß sein. Entfernen Sie Dateien nach Bedarf, um die Größe des Benutzerprofils zu reduzieren.
#### Laufwerk „C“ muss genügend freien Speicherplatz haben
Für Windows 7 WorkSpaces benötigen Sie mindestens 12 GB freien Speicherplatz auf dem Laufwerk`C`. Entfernen Sie Dateien nach Bedarf, um auf Laufwerk `C` Speicherplatz freizugeben. Ignorieren Sie unter Windows 10 WorkSpaces, wenn Sie eine `FAILED` Nachricht erhalten und der Festplattenspeicher mehr als 2 GB beträgt.
#### Unter einem Domänenkonto dürfen derzeit keine Services ausgeführt werden
Um den Prozess „Image erstellen“ auszuführen, dürfen keine Dienste auf dem WorkSpace unter einem Domänenkonto ausgeführt werden. Alle Services müssen unter einem lokalen Konto ausgeführt werden.
**So führen Sie Services unter einem lokalen Konto aus**
1. Öffnen Sie `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log` und suchen Sie die Liste der Dienste, die unter einem Domänenkonto ausgeführt werden.
1. Geben Sie im Windows-Suchfeld **services.msc** ein, um den Windows-Dienst-Manager zu öffnen.
1. Suchen Sie unter **Anmelden als** nach den Diensten, die unter Domänenkonten ausgeführt werden. (Durch Dienste, die als **lokales System**, **lokaler Dienst** oder **Netzwerkdienst** ausgeführt werden, wird die Erstellung von Abbildern nicht beeinträchtigt.)
1. Wählen Sie einen Dienst aus, der unter einem Domänenkonto ausgeführt wird, und wählen Sie dann **Aktion**, **Eigenschaften**.
1. Öffnen Sie die Registerkarte **Anmelden**. Wählen Sie unter **Anmelden als** die Option **Lokales Systemkonto** aus.
1. Wählen Sie **OK** aus.
#### Der WorkSpace muss für die Verwendung von DHCP konfiguriert sein
Sie müssen alle Netzwerkadapter auf dem so konfigurieren WorkSpace , dass sie DHCP anstelle von statischen IP-Adressen verwenden.
**So stellen Sie alle Netzwerkadapter auf die Verwendung von DHCP ein**
1. Geben Sie im Windows-Suchfeld **control panel** ein, um die Systemsteuerung zu öffnen.
1. Wählen Sie **Netzwerk und Internet**.
1. Wählen Sie **Netzwerk- und Freigabecenter**.
1. Wählen Sie **Adaptereinstellungen ändern** und wählen Sie einen Adapter aus.
1. Wählen Sie **Einstellungen dieser Verbindung ändern**.
1. **Wählen Sie auf der Registerkarte **Netzwerk** die Option **Internet Protocol Version 4 (TCP/IPv4)** und dann Eigenschaften aus.**
1. Wählen Sie im Dialogfeld **Eigenschaften von Internetprotokoll Version 4 (TCP/IPv4)** die Option IP-Adresse automatisch **beziehen** aus.
1. Wählen Sie **OK** aus.
1. Wiederholen Sie diesen Vorgang für alle Netzwerkadapter auf dem. WorkSpace
#### Remotedesktopdienste müssen aktiviert sein
Für den Prozess „Image erstellen“ müssen Remotedesktopdienste aktiviert sein.
**So aktivieren Sie Remotedesktopdienste**
1. Geben Sie im Windows-Suchfeld **services.msc** ein, um den Windows-Dienst-Manager zu öffnen.
1. Suchen Sie in der Spalte **Name** nach **Remotedesktopdiensten**.
1. Wählen Sie **Remotedesktopdienste** aus, und wählen Sie dann **Aktion**, **Eigenschaften**.
1. Wählen Sie auf der Registerkarte **Allgemein** für **Starttyp** die Option **Manuell** oder **Automatisch** aus.
1. Wählen Sie **OK** aus.
#### Ein Benutzerprofil muss vorhanden sein
Das WorkSpace , das Sie zum Erstellen von Bildern verwenden, muss über ein Benutzerprofil (`D:\Users\username`) verfügen. Wenn dieser Test fehlschlägt, bitten Sie das [AWS Support -Center](https://console.aws.amazon.com/support/home#/) um Hilfe.
#### Der Pfad der Umgebungsvariablen muss ordnungsgemäß konfiguriert sein
Im Pfad der Umgebungsvariablen für den lokalen Computer fehlen Einträge für System32 und Windows PowerShell. Diese Einträge sind erforderlich, damit „Image erstellen“ ausgeführt werden kann.
**So konfigurieren Sie den Pfad der Umgebungsvariablen**
1. Geben Sie im Windows-Suchfeld **environment variables** ein und wählen Sie **Systemumgebungsvariablen bearbeiten**.
1. Öffnen Sie im Dialogfeld **Systemeigenschaften** die Registerkarte **Erweitert** und wählen Sie **Umgebungsvariablen**.
1. Wählen Sie im Dialogfeld **Umgebungsvariablen** unter **Systemvariablen** den Eintrag **Pfad** aus und wählen Sie dann **Bearbeiten**.
1. Wählen Sie **Neu** und fügen Sie den folgenden Pfad hinzu:
`C:\Windows\System32`
1. Wählen Sie erneut **Neu** und fügen Sie den folgenden Pfad hinzu:
`C:\Windows\System32\WindowsPowerShell\v1.0\`
1. Wählen Sie **OK** aus.
1. Starten Sie den WorkSpace neu.
**Tipp**
Die Reihenfolge, in der Elemente im Pfad der Umgebungsvariablen angezeigt werden, ist wichtig. Um die richtige Reihenfolge zu ermitteln, sollten Sie den Pfad Ihrer Umgebungsvariablen WorkSpace mit dem Pfad einer neu erstellten WorkSpace oder einer neuen Windows-Instanz vergleichen.
#### Windows Modules Installer muss aktiviert sein
Für den Prozess „Image erstellen“ muss der Windows Modules Installer-Dienst aktiviert sein.
**So aktivieren Sie den Windows Modules Installer-Dienst**
1. Geben Sie im Windows-Suchfeld **services.msc** ein, um den Windows-Dienst-Manager zu öffnen.
1. Suchen Sie in der Spalte **Name** nach **Windows Modules Installer**.
1. Wählen Sie **Windows Modules Installer**, aus, und wählen Sie dann **Aktion**, **Eigenschaften**.
1. Wählen Sie auf der Registerkarte **Allgemein** für **Starttyp** die Option **Manuell** oder **Automatisch** aus.
1. Wählen Sie **OK** aus.
#### Amazon SSM Agent muss deaktiviert sein
Für den Prozess „Image erstellen“ muss der Amazon SSM Agent-Dienst deaktiviert sein.
**So deaktivieren Sie den Amazon SSM Agent-Dienst**
1. Geben Sie im Windows-Suchfeld **services.msc** ein, um den Windows-Dienst-Manager zu öffnen.
1. Suchen Sie in der Spalte **Name** nach **Amazon SSM Agent**.
1. Wählen Sie **Amazon SSM Agent** und dann **Aktion**, **Eigenschaften**.
1. Wählen Sie auf der Registerkarte **Allgemein** für **Starttyp** die Option **Deaktiviert** aus.
1. Wählen Sie **OK** aus.
#### SSL3 und TLS Version 1.2 muss aktiviert sein
Informationen zur Konfiguration SSL/TLS für Windows finden Sie unter [How to Enable TLS 1.2](https://docs.microsoft.com/configmgr/core/plan-design/security/enable-tls-1-2) in der Microsoft Windows-Dokumentation.
#### Es kann nur ein Benutzerprofil auf dem existieren WorkSpace
Für das, das Sie zum Erstellen von Bildern verwenden WorkSpace , kann es nur ein WorkSpaces Benutzerprofil (`D:\Users\username`) geben. Löschen Sie alle Benutzerprofile, die nicht dem vorgesehenen Benutzer von gehören WorkSpace.
Damit die Image-Erstellung funktioniert, WorkSpace können Sie nur drei Benutzerprofile darauf haben:
+ Das Benutzerprofil des vorgesehenen Benutzers von WorkSpace (`D:\Users\username`)
+ Das Standardbenutzerprofil (auch als Standardprofil bezeichnet)
+ Das Administrator-Benutzerprofil
Wenn weitere Benutzerprofile vorhanden sind, können Sie sie über die erweiterten Systemeigenschaften in der Windows-Systemsteuerung löschen.
**So löschen Sie ein Benutzerprofil**
1. Führen Sie einen der folgenden Schritte aus, um auf die erweiterten Systemeigenschaften zuzugreifen:
+ Drücken Sie die **Windows-Taste\$1Pause Unterbr** und wählen Sie dann **Erweiterte Systemeinstellungen** im linken Bereich des Dialogfelds **Systemsteuerung** > **System und Sicherheit** > **System** aus.
+ Geben Sie in das Windows-Suchfeld **control panel** ein. Wählen Sie in der Systemsteuerung **System und Sicherheit** aus. Wählen Sie dann „System“ und danach **Erweiterte Systemeinstellungen** im linken Bereich der **Systemsteuerung** > **System und Sicherheit** > **System** aus.
1. Wählen Sie im Dialogfeld **Systemeigenschaften** auf der Registerkarte **Erweitert** unter **Benutzerprofile** die Option **Einstellungen** aus.
1. Wenn ein anderes Profil als das Administratorprofil, das Standardprofil und das Profil des vorgesehenen WorkSpaces Benutzers aufgeführt ist, wählen Sie dieses zusätzliche Profil aus und klicken Sie auf **Löschen**.
1. Wenn Sie gefragt werden, ob Sie das Profil löschen möchten, wählen Sie **Ja**.
1. Falls erforderlich, wiederholen Sie die Schritte 3 und 4, um alle anderen Profile zu entfernen, die nicht zu dem gehören WorkSpace.
1. Wählen Sie zweimal **OK** und schließen Sie die Systemsteuerung.
1. Starten Sie den neu WorkSpace.
#### Keine AppX-Pakete können sich in einem bereitgestellten Zustand befinden
Ein oder mehrere AppX-Pakete befinden sich in einem bereitgestellten Zustand. Dies kann zu einem Sysprep-Fehler während der Abbilderstellung führen.
**So entfernen Sie alle bereitgestellten AppX-Pakete**
1. Geben Sie in das Windows-Suchfeld **powershell** ein. Wählen Sie **Als Administrator ausführen** aus.
1. Wählen Sie auf die Frage „Möchten Sie dieser App erlauben, Änderungen an Ihrem Gerät vorzunehmen?“, **Ja** aus.
1. Geben Sie im PowerShell Windows-Fenster die folgenden Befehle ein, um alle bereitgestellten AppX-Pakete aufzulisten, und drücken Sie nach jedem einzelnen die Eingabetaste.
```
$workSpaceUserName = $env:username
```
```
$allAppxPackages = Get-AppxPackage -AllUsers
```
```
$packages = $allAppxPackages | Where-Object { `
(($_.PackageUserInformation -like "*S-1-5-18*" -and !($_.PackageUserInformation -like "*$workSpaceUserName*")) -and `
($_.PackageUserInformation -like "*Staged*" -or $_.PackageUserInformation -like "*Installed*")) -or `
((!($_.PackageUserInformation -like "*S-1-5-18*") -and $_.PackageUserInformation -like "*$workSpaceUserName*") -and `
$_.PackageUserInformation -like "*Staged*")
}
```
1. Führen Sie den folgenden Befehl mit erhöhten SYSTEM-Rechten aus, um alle bereitgestellten AppX-Paketbereitstellungseinträge zu entfernen, und drücken Sie die Eingabetaste.
```
$packages | Remove-AppxPackage -ErrorAction SilentlyContinue
```
1. Führen Sie Image Checker erneut aus. Wenn dieser Test weiterhin fehlschlägt, geben Sie die folgenden Befehle ein, um alle AppX-Pakete zu entfernen, und drücken Sie nach jedem einzelnen die Eingabetaste.
```
Get-AppxProvisionedPackage -Online | Remove-AppxProvisionedPackage -Online -ErrorAction SilentlyContinue
```
```
Get-AppxPackage -AllUsers | Remove-AppxPackage -ErrorAction SilentlyContinue
```
#### Windows darf nicht von einer früheren Version aktualisiert worden sein
Die Imageerstellung wird auf Windows-Systemen nicht unterstützt, die von einer Version von Windows 10 auf eine neuere Version von Windows 10 aktualisiert wurden (ein feature/version Windows-Upgrade).
Verwenden Sie zum Erstellen von Images eine WorkSpace , für die kein feature/version Windows-Upgrade durchgeführt wurde.
#### Die WindowsRearm-Anzahl darf nicht „0“ sein
Mit der Rearm-Funktion können Sie den Aktivierungszeitraum für die Testversion von Windows verlängern. Der Prozess „Image erstellen“ erfordert, dass die Rearm-Anzahl ein anderer Wert als „0“ ist.
**So überprüfen Sie die Windows-Rearm-Anzahl**
1. Wählen Sie im Windows-**Start**menü **Windows System** und dann **Eingabeaufforderung** aus.
1. Geben Sie an der Eingabeaufforderung den folgenden Befehl ein und drücken Sie anschließend die Eingabetaste.
`cscript C:\Windows\System32\slmgr.vbs /dlv`
Informationen zum Zurücksetzen der Rearm-Anzahl auf einen anderen Wert als „0“ finden Sie unter [Sysprep (Generalize) a Windows installation](https://docs.microsoft.com/windows-hardware/manufacture/desktop/sysprep--generalize--a-windows-installation) in der Microsoft Windows-Dokumentation.
#### Weitere Tipps zur Problembehandlung
Wenn Sie WorkSpace alle vom Image Checker ausgeführten Tests bestanden haben, Sie aber trotzdem kein Image aus dem erstellen können WorkSpace, überprüfen Sie, ob die folgenden Probleme vorliegen:
+ Stellen Sie sicher, dass WorkSpace das keinem Benutzer innerhalb einer **Domain-Gäste-Gruppe** zugewiesen ist. Führen Sie den folgenden PowerShell Befehl aus, um zu überprüfen, ob Domänenkonten vorhanden sind.
```
Get-WmiObject -Class Win32_Service | Where-Object { $_.StartName -like "*$env:USERDOMAIN*" }
```
+ Einige Gruppenrichtlinienobjekte (GPOs) schränken den Zugriff auf den Fingerabdruck des RDP-Zertifikats ein, wenn dieser vom EC2 Config-Dienst oder den EC2 Launch-Skripts während der Windows-Instanzkonfiguration angefordert wird. Bevor Sie versuchen, ein Image zu erstellen, verschieben Sie es in eine neue Organisationseinheit (OU), bei der WorkSpace die Vererbung blockiert und nicht angewendet wird. GPOs
+ Stellen Sie sicher, dass der Windows-Remoteverwaltungsdienst (WinRM) so konfiguriert ist, dass er automatisch gestartet wird. Gehen Sie wie folgt vor:
1. Geben Sie im Windows-Suchfeld `services.msc` ein, um den Windows-Dienst-Manager zu öffnen.
1. Suchen Sie in der Spalte **Name** die **Windows-Remoteverwaltung (WS-Verwaltung)**.
1. Wählen Sie **Windows-Remoteverwaltung (WS-Verwaltung)** aus, und wählen Sie dann **Aktion**, **Eigenschaften**.
1. Wählen Sie auf der Registerkarte **Allgemein** für **Starttyp** die Option **Automatisch** aus.
1. Wählen Sie **OK** aus.
## Schritt 2: Erstellen Sie ein benutzerdefiniertes Image und ein benutzerdefiniertes Paket
Nachdem Sie Ihr WorkSpace Image validiert haben, führen Sie das folgende Verfahren aus, um Ihr benutzerdefiniertes Image und Ihr benutzerdefiniertes Bundle mithilfe der WorkSpaces Konsole zu erstellen. Verwenden Sie die CreateWorkspaceImage API-Aktion, um ein Image programmgesteuert zu erstellen. Weitere Informationen finden Sie [ CreateWorkspaceImage](https://docs.aws.amazon.com/workspaces/latest/api/API_CreateWorkspaceImage.html)in der *Amazon WorkSpaces API-Referenz*. Verwenden Sie die API-Aktion **CreateWorkspaceBundle**, um ein Paket programmgesteuert zu erstellen. Weitere Informationen finden Sie [ CreateWorkspaceBundle](https://docs.aws.amazon.com/workspaces/latest/api/API_CreateWorkspaceBundle.html)in der *Amazon WorkSpaces API-Referenz*.
**So erstellen Sie mit der WorkSpaces Konsole ein benutzerdefiniertes Image und ein benutzerdefiniertes Bundle**
1. Wenn Sie immer noch mit dem verbunden sind WorkSpace, trennen Sie die Verbindung, indem **Sie in der WorkSpaces Client-Anwendung **Amazon WorkSpaces** und Disconnect** auswählen.
1. Öffnen Sie die WorkSpaces Konsole unter [https://console.aws.amazon.com/workspaces/v2/home](https://console.aws.amazon.com/workspaces/v2/home).
1. Wählen Sie im Navigationsbereich **WorkSpaces** aus.
1. Wählen Sie das aus WorkSpace , um die zugehörige Detailseite zu öffnen, und wählen Sie Image **erstellen**. **Wenn der Status von „Gestoppt“ WorkSpace lautet, müssen Sie ihn zuerst starten (wählen Sie „**Aktionen**“, „**Start**“ WorkSpaces), bevor Sie „**Aktionen**“, „**Image erstellen**“ wählen können.**
1. Es wird eine Meldung angezeigt, in der Sie aufgefordert werden, Ihren Computer neu zu starten (neu zu starten), WorkSpace bevor Sie fortfahren. Durch einen Neustart wird Ihre WorkSpaces Amazon-Software auf die neueste Version WorkSpace aktualisiert.
Starten Sie Ihren neu, WorkSpace indem Sie die Nachricht schließen und den Anweisungen unter folgen. [Starten Sie a WorkSpace in WorkSpaces Personal neu](reboot-workspaces.md) Wenn Sie fertig sind, wiederholen Sie [Step 4](create-custom-bundle.md#step_create_image) dieses Vorgangs, aber wählen Sie dieses Mal **Weiter**, wenn die Neustartmeldung angezeigt wird. Um ein Image zu erstellen, WorkSpace muss der Status von „**Verfügbar**“ und der Änderungsstatus „**Keine“ lauten**.
1. Geben Sie einen Namen und eine Beschreibung zur Identifizierung des Image ein und klicken Sie dann auf **Create Image (Image erstellen)**. Während der Erstellung des Images lautet der Status von „Gesperrt WorkSpace “ **und** „ WorkSpace ist nicht verfügbar“.
Verwenden Sie in der Beschreibung keinen Gedankenstrich (`-`) als Sonderzeichen. Es wird einen Fehler verursachen.
1. Wählen Sie im Navigationsbereich **Abbilder** aus. Das Bild ist fertig, wenn sich der Status der WorkSpace Datei auf **Verfügbar** ändert (dies kann bis zu 45 Minuten dauern).
1. Wählen Sie das Abbild und anschließend **Aktionen**, **Paket erstellen** aus.
1. Geben Sie einen Namen und eine Beschreibung für das Paket ein und gehen Sie dann wie folgt vor:
+ Wählen Sie **unter Bundle-Hardwaretyp** die Hardware aus, die beim Starten WorkSpaces aus diesem benutzerdefinierten Paket verwendet werden soll.
+ Die standardmäßig verfügbaren Größenkombinationen für das Root-Volume sind 200 GB pro WorkSpace.
1. Wählen Sie **Pakete** aus und vergewissern Sie sich, dass das Paket aufgeführt ist, um zu überprüfen, ob Ihr Paket erstellt wurde.
## Was ist in WorkSpaces benutzerdefinierten Windows-Images enthalten
Wenn Sie ein Abbild von einem Windows aus erstellen WorkSpace, ist der gesamte Inhalt des `C` Laufwerks enthalten.
+ Kontakte
+ Downloads
+ Musik
+ Bilder
+ Gespeicherte Spiele
+ Videos
+ Podcasts
+ Virtuelle Maschinen
+ .virtualbox
+ Nachverfolgung
+ appdata\$1local\$1temp
+ appdata\$1roaming\$1apple computer\$1mobilesync\$1
+ appdata\$1roaming\$1apple computer\$1logs\$1
+ appdata\$1roaming\$1apple computer\$1itunes\$1iphone software updates\$1
+ appdata\$1roaming\$1macromedia\$1flash player\$1macromedia.com\$1support\$1flashplayer\$1sys\$1
+ appdata\$1roaming\$1macromedia\$1flash player\$1\$1sharedobjects\$1
+ appdata\$1roaming\$1adobe\$1flash player\$1assetcache\$1
+ appdata\$1roaming\$1microsoft\$1windows\$1recent\$1
+ appdata\$1roaming\$1microsoft\$1office\$1recent\$1
+ appdata\$1roaming\$1microsoft office\$1live meeting
+ appdata\$1roaming\$1microsoft shared\$1livemeeting shared\$1
+ appdata\$1roaming\$1mozilla\$1firefox\$1crash reports\$1
+ appdata\$1roaming\$1mcafee\$1common framework\$1
+ appdata\$1local\$1microsoft\$1feeds cache
+ appdata\$1local\$1microsoft\$1windows\$1temporary internet files\$1
+ appdata\$1local\$1microsoft\$1windows\$1history\$1
+ appdata\$1local\$1microsoft\$1internet explorer\$1domstore\$1
+ appdata\$1local\$1microsoft\$1internet explorer\$1imagestore\$1
+ appdata\$1locallow\$1microsoft\$1internet explorer\$1iconcache\$1
+ appdata\$1locallow\$1microsoft\$1internet explorer\$1domstore\$1
+ appdata\$1locallow\$1microsoft\$1internet explorer\$1imagestore\$1
+ appdata\$1local\$1microsoft\$1internet explorer\$1recovery\$1
+ appdata\$1local\$1mozilla\$1firefox\$1profiles\$1
# Benutzerdefinierte Images und Bundles für WorkSpaces Pools verwalten
Das Verfahren zur Verwaltung benutzerdefinierter Images und Bundles ist bei WorkSpaces Personal und WorkSpaces Pool derselbe. Weitere Informationen zur Verwaltung von Images und Bundles finden Sie in der folgenden Dokumentation im Abschnitt WorkSpaces Persönlich dieses Handbuchs:
**Anmerkung**
Der Hauptunterschied zwischen benutzerdefinierten Paketen, die Sie für WorkSpaces Personal verwenden können, und solchen, die Sie für WorkSpaces Pool verwenden können, ist das Betriebssystem und das öffentliche Basispaket, das verwendet werden kann. Informationen zu den Betriebssystemen und Bundles, die in WorkSpaces Pool unterstützt werden, finden Sie unter. [ WorkSpaces Pool-PaketeBundles Erfahren Sie mehr über WorkSpaces Pools-Pakete. Ein *WorkSpace Paket* ist eine Kombination aus einem Betriebssystem sowie Speicher-, Rechen- und Softwareressourcen. Wenn Sie ein starten WorkSpace, wählen Sie das Paket aus, das Ihren Anforderungen entspricht. Die verfügbaren Standardpakete WorkSpaces werden als *öffentliche Bundles* bezeichnet. Weitere Informationen zu den verschiedenen öffentlichen Paketen, die für verfügbar sind WorkSpaces, finden Sie unter [ WorkSpacesAmazon-Pakete](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles). Die folgende Tabelle enthält Informationen zu den Lizenzierungen, Streaming-Protokollen und Bundles, die von den einzelnen Betriebssystemen unterstützt werden.
| Betriebssystem | Lizenzen | Streaming-Protokolle | Unterstützte Pakete |
| --- | --- | --- | --- |
| Windows Server 2019 | Enthalten | DCV | Wert, Standard, Leistung, Leistung, PowerPro |
| Windows Server 2022 | Enthalten | DCV | Standard, Leistung, Leistung, Grafik.G4DN PowerPro, .G4DN GraphicsPro | Für Betriebssystemversionen, die vom Anbieter nicht mehr unterstützt werden, kann nicht garantiert werden, dass sie funktionieren, und sie werden auch nicht vom Support unterstützt. AWS ](instance-types.md#instance-types.title)
+ [Ein benutzerdefiniertes Paket für WorkSpaces Personal aktualisieren](update-custom-bundle.md).
+ [Kopieren Sie ein benutzerdefiniertes Bild in WorkSpaces Personal](copy-custom-image.md).
+ [Ein benutzerdefiniertes Bild in WorkSpaces Personal teilen oder dessen Freigabe rückgängig machen](share-custom-image.md).
+ [Löschen Sie ein benutzerdefiniertes Paket oder Bild in WorkSpaces Personal](delete_bundle.md).
# Verwenden Sie Sitzungsskripte, um das Streaming-Erlebnis Ihrer Nutzer zu verwalten
WorkSpaces Pool stellt Instanz-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 Pools-Umgebung 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 WorkSpace Bild 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)
+ [Ausführen von Skripten nach dem Ende von Streaming-Sitzungen](#run-scripts-after-streaming-sessions-end)
+ [Erstellen und Angeben von Sitzungsskripten](#create-specify-session-scripts)
+ [Sitzungsskript-Konfigurationsdatei](#session-script-configuration-file)
+ [PowerShell Windows-Dateien verwenden](#using-powershell-files-with-session-scripts)
+ [Protokollieren der Ausgaben von Sitzungsskripten](#logging-session-output)
+ [Verwenden Sie persistenten Speicher mit Sitzungsskripten](#use-storage-connectors-with-session-scripts)
+ [Aktivieren der Speicherung von Sitzungsskriptprotokollen in Amazon-S3-Buckets](#enable-S3-bucket-storage-session-script-logs)
## 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 Pools-Umgebung 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:\\Scripts\\Myscript.bat
```
Wenn Sie keinen doppelten Backslash verwenden, wird eine Fehlermeldung angezeigt, die Sie darüber informiert, 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, WorkSpaces wird dem Benutzer die Fehlermeldung angezeigt.
Wenn Sie Skripts ausführen, bevor Streaming-Sitzungen beginnen, läuft der folgende Vorgang ab:
1. Ihre Benutzer stellen eine Verbindung zu einem WorkSpaces Pool her, der nicht WorkSpace in eine Domäne eingebunden ist. Sie stellen mithilfe von SAML 2.0 eine Verbindung her.
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 Pools-Benutzer](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 [Persistenten Speicher für WorkSpaces Pools aktivieren und verwalten](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 Sie persistenten Speicher mit Sitzungsskripten](#use-storage-connectors-with-session-scripts).
1. Die Sitzungsskripte werden abgeschlossen oder überschreiten das Zeitlimit.
1. Die Streaming-Sitzung des Benutzers 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 Client-Symbolleiste die Option **Sitzung beenden** auswählen oder wenn sie die maximal zulässige Sitzungsdauer erreicht haben. Zudem können Sie mit diesen Skripten die WorkSpaces-Umgebung 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:
1. Die WorkSpaces 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. Das WorkSpace ist beendet.
## Erstellen und Angeben von Sitzungsskripten
Gehen Sie wie folgt vor, um Sitzungsskripts für Ihren WorkSpaces In a WorkSpaces Pool zu erstellen und anzugeben.
1. Connect zu dem Windows her, WorkSpaces von dem aus Sie ein benutzerdefiniertes Image erstellen.
1. Erstellen Sie das Verzeichnis`/AWSEUC/SessionScripts`, falls es noch nicht existiert.
1. Erstellen Sie mithilfe der [Sitzungsskriptkonfigurationsvorlage eine Konfigurationsdatei](https://docs.aws.amazon.com/workspaces/latest/adminguide/pools-images-session-scripts.html#session-script-configuration-file), `/AWSEUC/SessionScripts/config.json` falls sie noch nicht vorhanden ist.
1. Navigieren Sie zu `C:\AWSEUC\SessionScripts` und öffnen Sie die Konfigurationsdatei `config.json`.
Informationen zum Ändern von Sitzungsskriptparametern siehe [Sitzungsskript-Konfigurationsdatei](#session-script-configuration-file).
1. Speichern und schließen Sie die Datei `config.json`, nachdem Sie die gewünschten Änderungen vorgenommen haben.
1. Führen Sie die Schritte aus, um ein Bild aus dem zu erstellen WorkSpace. Weitere Informationen finden Sie unter [Erstellen Sie ein benutzerdefiniertes Image und ein Paket für WorkSpaces Pools](pools-images-custom-image.md).
## Sitzungsskript-Konfigurationsdatei
Um die Konfigurationsdatei für Sitzungsskripten in einer Windows-Instanz zu finden, navigieren Sie zu`C:\AWSEUC\SessionScripts\config.json`. Die Datei ist wie folgt formatiert:
**Anmerkung**
Die Konfigurationsdatei ist im JSON-Format. Stellen Sie sicher, dass jeder Text, den Sie in diese Datei eingeben, 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).
**`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 Pool 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 Sie persistenten Speicher mit Sitzungsskripten
Wenn WorkSpaces persistenter Speicher aktiviert ist, beginnt das Mounten des Speichers, sobald die Sitzungsstartskripts ausgeführt werden. Wenn Ihr Skript darauf angewiesen ist, dass persistenter Speicher bereitgestellt wird, können Sie warten, bis die Konnektoren verfügbar sind. WorkSpaces verwaltet den Bereitstellungsstatus der Speicherconnectors in der Windows-Registrierung unter Windows unter WorkSpaces dem folgenden Schlüssel:
```
HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\AWSEUC\Storage\\
```
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 SAMAccount Name eines Domänenbenutzers), 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
Jeder Registrierungsschlüssel für den Storage Connector 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 |
## Aktivieren der Speicherung von Sitzungsskriptprotokollen in Amazon-S3-Buckets
Wenn Sie die Amazon S3 S3-Protokollierung in Ihrer Sitzungsskriptkonfiguration aktivieren, erfasst WorkSpaces Pool die Standardausgabe Ihres Sitzungsskripts. Die Ausgabe wird regelmäßig in einen S3-Bucket im Amazon-Web-Services-Konto hochgeladen. Für jede AWS Region erstellt WorkSpaces Pool 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 Dienst 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:
```
wspool-logs---random-identifier
```
**``**
Dies ist der AWS Regionalcode, in dem der WorkSpaces Pool mit aktiviertem Amazon S3 S3-Bucket-Speicher für Sitzungsskriptprotokolle erstellt wird.
**``**
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, `wspool-logs`, ändert sich konto- oder regionsübergreifend nicht.
Wenn Sie beispielsweise Sitzungsskripte in einem Bild in der Region USA West (Oregon) () anhand der Kontonummer angeben`123456789012`, erstellt WorkSpaces Pool innerhalb Ihres Kontos in dieser Region einen Amazon S3 S3-Bucket mit dem angezeigten Namen. `us-west-2` Nur ein Administrator mit ausreichenden Berechtigungen kann diesen Bucket löschen.
```
wspool-logs-us-west-2-1234567890123-abcdefg
```
Durch das Deaktivieren von Sitzungsskripten werden keine Protokolldateien gelöscht, die im S3-Bucket gespeichert sind. 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 Pools fügt eine Bucket-Richtlinie hinzu, die ein versehentliches Löschen des Buckets verhindert.
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:
```
//////SessionScriptsLogs/
```
******
Name des S3-Buckets, in dem die Sitzungsskripte gespeichert werden. Auf das Format des Namens wird weiter oben in diesem Abschnitt eingegangen.
******
Name des Stacks, aus dem die Sitzung stammt.
******
Der Name des WorkSpaces Pools, auf dem das Sitzungsskript ausgeführt wird.
******
Die Identitätsmethode des Benutzers: `custom` für die WorkSpaces API oder CLI, `federated` für SAML und `userpool` für Benutzer im Benutzerpool.
******
Der benutzerspezifische Ordnername. Der Name wird aus einer aus der Benutzer-ID generierten hexadezimalen SHA-256-Hash-Zeichenfolge in Kleinbuchstaben gebildet.
******
ID der Streaming-Sitzung des Benutzers. Für jede Streaming-Sitzung eines Benutzers wird eine eindeutige ID generiert.
******
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 mit der Benutzer-ID `testuser@mydomain.com` aus einer AWS-Konto ID von `123456789012` und der Einstellungsgruppe `test-stack` in der Region USA West (Oregon) (`us-west-2`):
```
wspool-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).