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.
# Verwalten Ihrer Basisordner
Lesen Sie die folgenden Themen, um zu erfahren, wie Sie Ihre Home-Ordner verwalten.
**Topics**
+ [Deaktivieren von Basisordnern](home-folders-admin-disabling.md)
+ [Amazon-S3-Bucket-Speicher](home-folders-s3.md)
+ [Synchronisieren von Inhalten der Basisordner](home-folders-content-synchronization.md)
+ [Formate des Basisordners](home-folders-admin-folders.md)
+ [Verwenden von oder AWS Command Line Interface AWS SDKs](home-folders-admin-cli.md)
+ [Weitere Ressourcen](home-folders-admin-additional.md)
# Deaktivieren von Basisordnern
Sie können die Basisordner für einen Stack deaktivieren, ohne den bereits darin gespeicherten Inhalt zu verlieren. Das Deaktivieren von Basisordnern für einen Stack hat folgende Auswirkungen:
+ Benutzer, die für den Stack mit aktiven Streaming-Sitzungen verbunden sind, erhalten eine Fehlermeldung. Sie werden darüber informiert, dass Inhalte nicht länger im Basisordner gespeichert werden können.
+ Basisordner erscheinen nicht für neue Sitzungen, die den Stack mit deaktivierten Basisordnern verwenden.
+ Das Deaktivieren von Basisordnern für einen Stack bedeutet nicht, dass sie auch für andere Stacks deaktiviert sind.
+ Auch wenn Home-Ordner für alle Stacks deaktiviert sind, löscht WorkSpaces Applications die Benutzerinhalte nicht.
Um den Zugriff auf Basisordner für den Stack wiederherzustellen, aktivieren Sie die Basisordner wieder, indem Sie die Schritte ausführen, die weiter oben in diesem Thema beschrieben sind.
**So deaktivieren Sie Basisordner beim Erstellen eines Stacks**
+ Führen Sie die Schritte unter [Erstellen Sie einen Stack in Amazon WorkSpaces Applications](set-up-stacks-fleets-install.md) aus und stellen Sie sicher, dass die Option **Basisordner aktivieren** deaktiviert wurde.
**So deaktivieren Sie Basisordner für einen vorhandenen Stack**
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 **Stacks** aus und klicken Sie dann auf den Stack.
1. Wählen Sie unterhalb der Stack-Liste **Speicher** aus und deaktivieren Sie das Kontrollkästchen für **Basisordner aktivieren**.
1. Geben Sie in das Dialogfenster **Basisordner deaktivieren** `CONFIRM` ein (auf Groß- und Kleinschreibung achten), um Ihre Auswahl zu bestätigen und wählen Sie dann **Deaktivieren** aus.
# Amazon-S3-Bucket-Speicher
WorkSpaces Applications verwaltet Benutzerinhalte, die in Home-Ordnern gespeichert sind, mithilfe von Amazon S3 S3-Buckets, die in Ihrem Konto erstellt wurden. WorkSpaces Applications erstellt für jede AWS Region einen Bucket in Ihrem Konto. Jegliche von Benutzern generierten Inhalte, die aus Streaming-Sitzungen von Stacks in dieser Region stammen, werden in diesem Bucket gespeichert. Die Buckets werden vom Service vollständig ohne Konfiguration oder Eingaben eines Administrators verwaltet.
Die neuen erweiterten Buckets sind in einem bestimmten Format (Version 2) wie folgt benannt:
```
appstream2-36fb080bb8-region-code-account-id-without-hyphens-random-identifier
```
Wo `region-code` ist der AWS Regionalcode, in dem der Stack erstellt wird, und `account-id-without-hyphens` ist Ihre Amazon Web Services Services-Konto-ID. Der erste Teil des Bucket-Namens, `appstream2-36fb080bb8-`, ändert sich konto- oder regionsübergreifend nicht.
Wenn Sie beispielsweise die Basisordner für die Stacks in der Region USA West (Oregon) (us-west-2) für Kontonummer 123456789012 aktivieren, erstellt der Service einen Amazon-S3-Bucket in dieser Region mit dem angegebenen Namen. Nur ein Administrator mit ausreichenden Berechtigungen kann diesen Bucket löschen.
```
appstream2-36fb080bb8-us-west-2-123456789012-abcdefg
```
Die Buckets der alten Version sind wie folgt benannt. Konten, die vor der Einführung der neuen erweiterten Bucket-Benennung in WorkSpaces Applications (Version 2) erstellt wurden, folgen dem alten Benennungsformat.
```
appstream2-36fb080bb8-region-code-account-id-without-hyphens
```
Wo `region-code` ist der AWS Regionalcode, in dem der Stack erstellt wird, und `account-id-without-hyphens` ist Ihre Amazon Web Services Services-Konto-ID. Der erste Teil des Bucket-Namens, `appstream2-36fb080bb8-`, ändert sich konto- oder regionsübergreifend nicht.
Wenn Sie beispielsweise die Basisordner für die Stacks in der Region USA West (Oregon) (us-west-2) für Kontonummer 123456789012 aktivieren, erstellt der Service einen Amazon-S3-Bucket in dieser Region mit dem angegebenen Namen. Nur ein Administrator mit ausreichenden Berechtigungen kann diesen Bucket löschen.
```
appstream2-36fb080bb8-us-west-2-123456789012
```
Wie zuvor erwähnt, werden mit dem Deaktivieren der Basisordner für Stacks keine im Amazon-S3-Bucket gespeicherten Benutzerinhalte gelöscht. Um Benutzerinhalte dauerhaft zu löschen, muss ein Administrator mit entsprechendem Zugriff dies von der Amazon S3 S3-Konsole aus tun. WorkSpaces Applications fügt eine Bucket-Richtlinie hinzu, die ein versehentliches Löschen des Buckets verhindert. Weitere Informationen finden Sie unter [Verwenden von IAM-Richtlinien zum Verwalten des Administratorzugriffs auf den Amazon-S3-Bucket für Basisordner und die Persistenz von Anwendungseinstellungen](s3-iam-policy.md).
# Synchronisieren von Inhalten der Basisordner
Wenn Home-Ordner aktiviert sind, erstellt WorkSpaces Applications für jeden Benutzer einen eigenen Ordner, in dem seine Inhalte gespeichert werden. Der Ordner wird als eindeutiges Amazon-S3-Präfix erstellt, das einen Hash des Benutzernamens innerhalb eines S3-Buckets für Ihr Amazon-Web-Services-Konto und Ihre Region verwendet. Nachdem WorkSpaces Applications den Home-Ordner in Amazon S3 erstellt hat, kopiert es den abgerufenen Inhalt in diesem Ordner aus dem S3-Bucket in die Flotteninstanz. Auf diese Weise kann der Benutzer während seiner Streaming-Sitzung von der Flotten-Instance aus schnell auf den Inhalt seines Basisordners zugreifen. Änderungen, die Sie am Inhalt des Home-Ordners eines Benutzers in einem S3-Bucket vornehmen und die der Benutzer am Inhalt seines Home-Ordners auf einer Flotteninstanz vornimmt, werden zwischen Amazon S3 und WorkSpaces Applications wie folgt synchronisiert.
1. Zu Beginn der WorkSpaces Anwendungs-Streaming-Sitzung eines Benutzers katalogisiert WorkSpaces Applications die Home-Ordnerdateien, die für diesen Benutzer im Amazon S3-Bucket für Ihr Amazon Web Services Services-Konto und Ihre Region gespeichert sind.
1. Der Inhalt des Home-Ordners eines Benutzers wird auch auf der WorkSpaces Applications Fleet-Instance gespeichert, von der aus er streamt. Wenn ein Benutzer auf der WorkSpaces Applications Fleet-Instance auf seinen Basisordner zugreift, wird die Liste der katalogisierten Dateien angezeigt.
1. WorkSpaces Applications lädt eine Datei erst dann aus dem S3-Bucket auf die Flotteninstanz herunter, wenn der Benutzer die Datei während seiner Streaming-Sitzung mit einer Streaming-Anwendung geöffnet hat.
1. Nachdem WorkSpaces Applications die Datei auf die Flotteninstanz heruntergeladen hat, erfolgt die Synchronisation, nachdem auf die Datei zugegriffen wurde
1. Wenn der Benutzer die Datei während seiner Streaming-Sitzung ändert, lädt WorkSpaces Applications die neue Version der Datei regelmäßig oder am Ende der Streaming-Sitzung von der Flotteninstanz in den S3-Bucket hoch. Allerdings wird die Datei während der Streaming-Sitzung nicht erneut aus dem S3-Bucket heruntergeladen.
Die folgenden Abschnitte beschreiben das Synchronisationsverhalten, wenn Sie die Datei des Basisordners eines Benutzers in Amazon S3 hinzufügen, ersetzen oder entfernen.
**Topics**
+ [Synchronisieren von Dateien, die Sie dem Basisordner eines Benutzers in Amazon S3 hinzufügen](#home-folders-content-synchronization-content-added-to-user-home-folder-in-S3)
+ [Synchronisieren von Dateien, die Sie im Basisordner eines Benutzers in Amazon S3 ersetzen](#home-folders-content-synchronization-content-replaced-in-user-home-folder-S3)
+ [Synchronisieren von Dateien, die Sie aus dem Basisordner eines Benutzers in Amazon S3 entfernen](#home-folders-content-synchronization-content-removed-from-user-home-folder-S3)
## Synchronisieren von Dateien, die Sie dem Basisordner eines Benutzers in Amazon S3 hinzufügen
Wenn Sie dem Home-Ordner eines Benutzers in einem S3-Bucket eine neue Datei hinzufügen, katalogisiert WorkSpaces Applications die Datei und zeigt sie innerhalb weniger Minuten in der Dateiliste im Home-Ordner des Benutzers an. Die Datei wird jedoch erst dann vom S3-Bucket auf die Flotten-Instance heruntergeladen, wenn der Benutzer die Datei während seiner Streaming-Sitzung mit einer Anwendung öffnet.
## Synchronisieren von Dateien, die Sie im Basisordner eines Benutzers in Amazon S3 ersetzen
Wenn ein Benutzer während seiner Streaming-Sitzung eine Datei in seinem Basisordner auf der Flotten-Instance öffnet und Sie dieselbe Datei in seinem Basisordner in einem S3-Bucket während der aktiven Streaming-Sitzung dieses Benutzers durch eine neue Version ersetzen, wird die neue Version der Datei nicht sofort auf die Flotten-Instance heruntergeladen. Die neue Version wird erst dann aus dem S3-Bucket auf die Flotten-Instance heruntergeladen, wenn der Benutzer eine neue Streaming-Sitzung startet und die Datei erneut öffnet.
## Synchronisieren von Dateien, die Sie aus dem Basisordner eines Benutzers in Amazon S3 entfernen
Wenn ein Benutzer während seiner Streaming-Sitzung eine Datei in seinem Basisordner auf der Flotten-Instance öffnet und Sie die Datei während der aktiven Streaming-Sitzung dieses Benutzers aus seinem Basisordner in einem S3-Bucket entfernen, wird die Datei erst dann aus der Flotten-Instance entfernt, wenn der Benutzer eine der folgenden Aktionen ausführt:
+ Basisordner erneut öffnen
+ Basisordner aktualisieren
# Formate des Basisordners
Die Hierarchie eines Benutzerordners hängt davon ab, wie ein Benutzer eine Streaming-Sitzung startet. Dies wird in den folgenden Abschnitten beschrieben.
## AWS SDKs und AWS CLI
Bei Sitzungen, die mit `CreateStreamingURL` oder `create-streaming-url` gestartet werden, sieht die Ordnerstruktur wie folgt aus:
```
bucket-name/user/custom/user-id-SHA-256-hash/
```
Wo `bucket-name` steht in dem Format, das unter gezeigt wird, [Amazon-S3-Bucket-Speicher](home-folders-s3.md) und `user-id-SHA-256-hash` ist der benutzerspezifische Ordnername, der mit einer hexadezimalen SHA-256-Hash-Zeichenfolge in Kleinbuchstaben erstellt wurde, die aus dem `UserId` Wert generiert wurde, der an die URL-API-Operation oder den URL-API-Befehl übergeben wurde. CreateStreaming `create-streaming-url` Weitere Informationen finden Sie unter [CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html) in der *Amazon WorkSpaces Applications API-Referenz* und [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html)in der *AWS CLI Befehlsreferenz*.
Die folgende Beispielordnerstruktur gilt für den Sitzungszugriff über die API oder AWS CLI mit einem `UserId` testuser@mydomain.com, Konto-ID 123456789012 in der Region USA West (Oregon) (us-west-2):
```
appstream2-36fb080bb8-us-west-2-123456789012/user/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/
```
Sie können den Ordner für einen Benutzer bestimmen, indem sie mithilfe von Websites oder online verfügbaren Open-Source-Code-Bibliotheken den SHA-256-Hash-Wert der `UserId` in Kleinbuchstaben generieren.
## SAML 2.0
Bei Sitzungen, die mit dem SAML-Verbund erstellt werden, sieht die Ordnerstruktur wie folgt aus:
```
bucket-name/user/federated/user-id-SHA-256-hash/
```
In diesem Fall steht `user-id-SHA-256-hash` für den Ordnernamen, der unter Verwendung einer SHA-256-Hash-Hexadezimal-Zeichenfolge in Kleinbuchstaben angelegt wurde, die aus dem `NameID`-SAML-Attributswert erzeugt und in der SAML-Verbund-Anforderung übergeben wurde. Übermitteln Sie die SAML-Anforderung mit der `NameID` im Format `domainname\username`, um Benutzer mit demselben Namen zu unterscheiden, die jedoch zu zwei unterschiedlichen Domains gehören. Weitere Informationen finden Sie unter [Integration von WorkSpaces Amazon-Anwendungen mit SAML 2.0](external-identity-providers.md).
Die folgende Beispiel-Ordnerstruktur gilt für den Sitzungszugriff mittels SAML-Verbund mit einer `NameID`-BEISPIELDOMAIN\$1testbenutzer, Konto-ID 123456789012 in der Region USA West (Oregon):
```
appstream2-36fb080bb8-us-west-2-123456789012/user/federated/8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901
```
Wenn ein Teil oder die gesamte NameID-Zeichenfolge groß geschrieben wird (wie im Beispiel der Domainname*SAMPLEDOMAIN*), generiert WorkSpaces Applications den Hashwert auf der Grundlage der in der Zeichenfolge verwendeten Großschreibung. In diesem Beispiel lautet der Hashwert für SAMPLEDOMAIN\$1 testuser 8 A642F511609454D344D53 A71190E44 B8 C507012A9901. DD9 CB861 FED2 AF9 FDE0 Im Verzeichnis des Benutzers wird dieser Wert in Kleinbuchstaben angezeigt: 8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901.
Sie können den Ordner für einen Benutzer bestimmen, indem sie den SHA-256-Hash-Wert der `NameID` mithilfe von Websites oder online verfügbaren Open-Source-Code-Bibliotheken generieren.
# Verwenden von oder AWS Command Line Interface AWS SDKs
Sie können Home-Ordner für einen Stack aktivieren und deaktivieren, indem Sie das AWS CLI oder verwenden AWS SDKs.
Der folgende [create-stack](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-stack.html)-Befehl kann verwendet werden, um Basisordner beim Erstellen eines neuen Stacks zu aktivieren:
```
aws appstream create-stack --name ExampleStack --storage-connectors ConnectorType=HOMEFOLDERS
```
Der folgende [update-stack](https://docs.aws.amazon.com/cli/latest/reference/appstream/update-stack.html)-Befehl kann verwendet werden, um Basisordner für einen vorhandenen Stack zu aktivieren:
```
aws appstream update-stack --name ExistingStack --storage-connectors ConnectorType=HOMEFOLDERS
```
Der folgende CLI-Befehl kann verwendet werden, um Basisordner für einen vorhandenen Stack zu deaktivieren. Mit diesem Befehl werden keine Benutzerdaten gelöscht.
```
aws appstream update-stack --name ExistingStack --delete-storage-connectors
```
# Weitere Ressourcen
Weitere Informationen über die Verwaltung von Amazon-S3-Buckets und bewährte Methoden finden Sie in den folgenden Themen im *Benutzerhandbuch für Amazon Simple Storage Service*:
+ Mit Amazon S3-Richtlinien können Sie für Ihre Benutzer einen Offline-Zugriff auf Benutzerdaten ermöglichen. Weitere Informationen finden Sie unter [Amazon S3: Gewährt IAM-Benutzern programmgesteuert und in der Konsole Zugriff auf ihr S3-Stammverzeichnis](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_examples_s3_home-directory-console.html) im *IAM-Benutzerhandbuch*.
+ Sie können die Dateiversionierung für Inhalte aktivieren, die in Amazon S3 S3-Buckets gespeichert sind und von WorkSpaces Anwendungen verwendet werden. Weitere Informationen finden Sie unter [Verwenden der Versionsverwaltung](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Versioning.html).