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.
# Tutorial: Installieren Sie den Amazon WorkSpaces Applications Client und passen Sie das Client-Erlebnis für Ihre Benutzer an
In den folgenden Abschnitten wird beschrieben, wie Sie den WorkSpaces Applications Client installieren und das Client-Erlebnis für Ihre Benutzer anpassen. Wenn Sie den Client für Ihre Benutzer herunterladen und installieren möchten, laden Sie zuerst das Enterprise-Bereitstellungstool herunter. Anschließend können Sie PowerShell Skripts ausführen, um den WorkSpaces Applications Client zu installieren und die Client-Einstellungen remote zu konfigurieren.
**Anmerkung**
Die Verwendung des Enterprise Deployment Tools mit dem macOS-Client für WorkSpaces Anwendungen wird nicht unterstützt.
**Topics**
+ [Enterprise-Bereitstellungstool herunterladen](#install-client-use-remote-deployment-tool)
+ [Installieren Sie den Anwendungsclient und den USB-Treiber WorkSpaces](#run-powershell-script-install-client-usb-driver-silently)
+ [Mit dem WorkSpaces Applications Client auf WorkSpaces Anwendungen zugreifen](#access-appstream-with-client)
+ [Legen Sie den StartURL-Registrierungswert für WorkSpaces Applications Client-Benutzer fest](#set-start-url-registry-value)
+ [Stellen Sie den TrustedDomains Registrierungswert so ein, dass andere Domänen für den Applications Client aktiviert werden WorkSpaces](#set-trusted-domains-registry-value)
+ [Erstellen AS2 TrustedDomains Sie den DNS-TXT-Eintrag, um Ihre Domain für den WorkSpaces Applications Client ohne Änderungen in der Registrierung zu aktivieren](#create-AS2TrustedDomains-DNS-TXT-record-client)
+ [Deaktivieren der DNS-TXT-Datensatzsuche für vertrauenswürdige Domänen](#disable-DNS-TXT-record-lookup-client)
+ [Festlegen, ob automatische Client-Updates deaktiviert werden sollen](#disable-automatic-updates-client)
+ [Festlegen, ob On-Demand-Uploads von Diagnoseprotokollen deaktiviert werden sollen](#disable-on-demand-diagnostic-log-uploads)
+ [Wählen, ob der native Anwendungsmodus deaktiviert werden soll](#disable-native-application-mode-client)
+ [Auswählen, ob die lokale Druckerumleitung deaktiviert werden soll](#disable-local-printer-redirection-client)
+ [Festlegen, ob die Smartcard-Umleitung deaktiviert werden soll](#disable-local-smart-card-support-client)
+ [Konfigurieren Sie zusätzliche WorkSpaces Applications Client-Einstellungen für Ihre Benutzer](#configure-client)
+ [Verwenden von Gruppenrichtlinien zur Anpassung des WorkSpaces Anwendungsclients](#configure-client-with-adm-template-group-policy)
## Enterprise-Bereitstellungstool herunterladen
Das Enterprise Deployment Tool enthält die Installationsdateien WorkSpaces für den Applicationsclient und eine administrative Gruppenrichtlinienvorlage.
1. Um das Enterprise Deployment Tool herunterzuladen, wählen Sie unten rechts auf der Seite [WorkSpaces Applications supported clients](https://clients.amazonappstream.com) den Link **Enterprise Deployment Tool** aus. Dieser Link öffnet eine ZIP-Datei mit den erforderlichen Dateien für die neueste Version des Tools.
1. Um die erforderlichen Dateien zu extrahieren, navigieren Sie zu dem Speicherort, an dem Sie das Tool heruntergeladen haben, klicken Sie mit der rechten Maustaste auf den Ordner **AmazonAppStreamClientEnterpriseSetup\$1 \$1** und wählen Sie **Alle extrahieren**. Der Ordner enthält zwei Installationsprogramme und eine administrative Gruppenrichtlinienvorlage:
+ WorkSpaces Installationsprogramm für den Anwendungsclient (AmazonAppStreamClientSetup\$1 .msi) — Installiert den WorkSpaces Anwendungsclient.
+ WorkSpaces USB-Treiber-Installationsprogramm für Anwendungen (AmazonAppStreamUsbDriverSetup\$1 .exe) — Installiert den USB-Treiber für WorkSpaces Anwendungen, der für die Verwendung von USB-Geräten mit Anwendungen erforderlich ist, die über WorkSpaces Anwendungen gestreamt werden.
+ WorkSpaces Administrative Gruppenrichtlinien-Vorlage für den Anwendungsclient (as2\$1client\$1config.adm) — Ermöglicht die Konfiguration des Anwendungsclients über Gruppenrichtlinien. WorkSpaces
## Installieren Sie den Anwendungsclient und den USB-Treiber WorkSpaces
Nachdem Sie die Installationsdateien für den WorkSpaces Anwendungsclient heruntergeladen haben, führen Sie das folgende PowerShell Skript auf den Computern der Benutzer aus, um die Installationsdatei für den WorkSpaces Anwendungsclient ( AppStreamClient.exe) und den USB-Treiber im Hintergrund zu installieren.
**Anmerkung**
Zum Ausführen dieses Skripts müssen Sie mit Administratorberechtigungen an dem betreffenden Computer angemeldet sein. Sie können das Skript auch remote über das Systemkonto während des Starts ausführen.
```
Start-Process msiexec.exe -Wait -ArgumentList '/i AmazonAppStreamClientSetup_.msi /quiet'
Start-Process AmazonAppStreamUsbDriverSetup_.exe -Wait -ArgumentList '/quiet'
```
Nachdem Sie das Enterprise Deployment Tool auf dem Computer eines Benutzers installiert haben, wird der WorkSpaces Applications Client wie folgt installiert:
1. Die Installationsdatei für den WorkSpaces Applications Client wird in den folgenden Pfad auf dem Computer des Benutzers kopiert: C:\$1Program Files (x86)\$1 Amazon WorkSpaces Applications Client Installer\$1 AppStreamClient .exe.
1. Wenn sich der Benutzer nach der Installation des Enterprise Deployment Tools zum ersten Mal an seinem Computer anmeldet, wird der WorkSpaces Applications Client installiert.
**Anmerkung**
Wenn das Enterprise Deployment Tool feststellt, dass der Ordner WorkSpaces Applications Client **AppStreamClient**, bereits in **%localappdata%** vorhanden ist, installiert das Tool den Client nicht.
Wenn ein Benutzer den WorkSpaces Applications Client deinstalliert, wird der Client erst wieder installiert, wenn Sie das Applications Enterprise Deployment Tool aktualisieren. WorkSpaces
## Mit dem WorkSpaces Applications Client auf WorkSpaces Anwendungen zugreifen
Standardmäßig können Benutzer, wenn sie den WorkSpaces Applications Client starten, nur Verbindungen zu URLs den Domänen herstellen, die die WorkSpaces Anwendungsdomäne oder Domänen enthalten, die einen DNS-TXT-Eintrag enthalten, der die Verbindung ermöglicht. Sie können Client-Benutzern den Zugriff auf andere Domänen als die WorkSpaces Anwendungsdomäne ermöglichen, indem Sie einen der folgenden Schritte ausführen:
+ Legen Sie den Registrierungswert `StartURL` fest, um eine benutzerdefinierte URL anzugeben, auf die Benutzer zugreifen können, wie etwa die URL für das Anmeldeportal Ihrer Organisation.
+ Legen Sie den Registrierungswert `TrustedDomains` fest, um vertrauenswürdige Domänen anzugeben, auf die Benutzer zugreifen können.
+ Erstellen Sie den DNS-TXT-Eintrag `AS2TrustedDomains`, um vertrauenswürdige Domänen anzugeben, auf die Benutzer zugreifen können. Mit dieser Methode können Sie Registrierungsänderungen vermeiden.
**Anmerkung**
Die Konfiguration des WorkSpaces Anwendungsclients und des DNS-TXT-Eintrags verhindern nicht, URLs dass Benutzer andere Verbindungsmethoden verwenden, um auf die von Ihnen angegebenen Domänen zuzugreifen. Benutzer können beispielsweise auf bestimmte Domänen zugreifen oder URLs einen Webbrowser verwenden, wenn sie Netzwerkzugriff auf die Domänen haben oder URLs.
## Legen Sie den StartURL-Registrierungswert für WorkSpaces Applications Client-Benutzer fest
Sie können den `StartUrl` Registrierungswert verwenden, um eine benutzerdefinierte URL festzulegen, die im WorkSpaces Applications Client aufgefüllt wird, wenn ein Benutzer den Client startet. Sie können diesen HKLM-Registrierungsschlüssel während der Installation des Clients erstellen, sodass Ihre Benutzer beim Start des Clients keine URL angeben müssen.
Nach der Installation des WorkSpaces Applications Client können Sie das folgende PowerShell Skript ausführen, um diesen Registrierungsschlüssel zu erstellen, oder Sie können die administrative Vorlage verwenden, die im Enterprise Deployment Tool für den WorkSpaces Applications Client enthalten ist, um den Client über Gruppenrichtlinien zu konfigurieren.
Ersetzen Sie den `StartUrl`-Wert durch eine URL für Ihren Identitätsanbieter (IdP). Die URL muss ein Zertifikat verwenden, das für das Gerät vertrauenswürdig ist. Das bedeutet, dass das Zertifikat, das von der `StartUrl`-Webseite verwendet wird, einen alternativen Antragstellernamen (Subject Alternative Name, SAN) enthalten muss, der den Domänennamen der URL enthält. Wenn Ihr beispielsweise auf eingestellt `StartUrl` ist, muss das SSL-Zertifikat über ein SAN verfügen https://appstream.example.com, das appstream.example.com enthält.
**Anmerkung**
Zum Ausführen dieses Skripts müssen Sie mit Administratorberechtigungen an dem betreffenden Computer angemeldet sein. Sie können das Skript auch remote über das Systemkonto während des Starts ausführen.
```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force
New-ItemProperty -Path $registryPath -Name "StartUrl" -Value "https://www.example.com" -PropertyType String -Force | Out-Null
```
## Stellen Sie den TrustedDomains Registrierungswert so ein, dass andere Domänen für den Applications Client aktiviert werden WorkSpaces
Sie können den WorkSpaces Anwendungsclient so konfigurieren, dass er eine Verbindung URLs zu vertrauenswürdigen Domänen herstellt, die Sie angeben. Beispielsweise könnten Sie Benutzern erlauben, eine Verbindung zu einer beliebigen URL in Ihrer Organisationsdomäne oder zu einer beliebigen URL in mindestens einer Ihrer IdP-Domänen herzustellen. Verwenden Sie bei der Angabe der URL das folgende Format: \$1. *example*-*idp*. *com*.
Sie können eine Liste vertrauenswürdiger Domänen in einem Format kommagetrennter Werte angeben. Fügen Sie diese Liste als Registrierungswert zum `TrustedDomains` HKLM-Registrierungsschlüssel WorkSpaces Applications hinzu. Es wird empfohlen, diesen Registrierungsschlüssel zu erstellen und die Liste der vertrauenswürdigen Domänen anzugeben, wenn Sie den WorkSpaces Applications Client installieren oder, wenn Sie Microsoft Active Directory verwenden, über Gruppenrichtlinien. Auf diese Weise können Ihre Benutzer unmittelbar nach der Installation des Clients eine Verbindung zu einer URL in jeder vertrauenswürdigen Domäne herstellen.
Nach der Installation des WorkSpaces Applications Client können Sie das folgende PowerShell Skript ausführen, um diesen Registrierungsschlüssel zu erstellen. Oder Sie können die administrative Vorlage verwenden, die im Enterprise Deployment Tool für den WorkSpaces Applications Client enthalten ist, um den Client mithilfe von Gruppenrichtlinien zu konfigurieren.
Ersetzen Sie den Wert `TrustedDomains` durch eine durch Kommas getrennte Liste für eine oder mehrere Ihrer Organisations- oder IdP-Domänen. Das von der Webseite der vertrauenswürdigen Domäne verwendete Zertifikat muss einen SAN enthalten, der die Domäne der URL enthält. Wenn Ihre vertrauenswürdige Domäne z. B. \$1.example.com umfasst und die Benutzer angeben, muss das SSL-Zertifikat über ein SAN verfügen https://appstream.example.com, das appstream.example.com enthält.
**Anmerkung**
Zum Ausführen dieses Skripts müssen Sie mit Administratorberechtigungen an dem betreffenden Computer angemeldet sein. Sie können das Skript auch remote über das Systemkonto während des Starts ausführen.
```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force
New-ItemProperty -Path $registryPath -Name "TrustedDomains" -Value "*.example1.com, *.example2.com, aws.amazon.com" -PropertyType String -Force | Out-Null
```
Im Folgenden werden Anforderungen und Überlegungen für die Formatierung vertrauenswürdiger Domänennamen aufgeführt.
+ Folgende Zeichen werden unterstützt: a-z, 0-9, -, \$1
+ Abhängig von seiner Position im Domänennamen wird das \$1-Zeichen vom DNS entweder als Platzhalter oder als das \$1-Zeichen (ASCII 42) behandelt. Im Folgenden sind Einschränkungen bei der Verwendung von \$1 als Platzhalter im Namen eines DNS-Eintrags aufgeführt:
+ Das „\$1“ muss den Bezeichner ganz links in einem Domänennamen ersetzen. Beispielsweise \$1.example.com oder \$1.prod.example.com. Wenn Sie „\$1“ in anderen Positionen verwenden (z. B. prod.\$1.example.com), wird es von DNS wie ein \$1-Zeichen (ASCII-42) und nicht als Platzhalter behandelt.
+ Das „\$1“ muss den gesamten Bezeichner ersetzen. Sie können z. B. nicht „\$1prod.beispiel.de“ oder „prod\$1.beispiel.de“ angeben.
+ \$1 gilt für die Subdomänen-Ebene, die die \$1 enthält, und für alle Subdomänen dieser Subdomäne. Wenn ein Eintrag beispielsweise \$1.example.com heißt, erlaubt der WorkSpaces Applications Client zenith.example.com, acme.zenith.example.com und pinnacle.acme.zenith.example.com.
## Erstellen AS2 TrustedDomains Sie den DNS-TXT-Eintrag, um Ihre Domain für den WorkSpaces Applications Client ohne Änderungen in der Registrierung zu aktivieren
Sie können Benutzern die Verbindung zu einer beliebigen URL in Ihrer Organisationsdomäne (z. B. \$1.example.com) oder zu einer beliebigen URL in Ihren IdP-Domänen (z. B. \$1.example-idp.com) ermöglichen, indem Sie einen DNS-TXT-Eintrag in dieser Domäne erstellen. Wenn Sie den DNS-TXT-Eintrag erstellen, sind die Registrierungswerte `StartURL` oder `TrustedDomains` nicht erforderlich, damit ein Benutzer eine Verbindung zu einer URL herstellen kann.
Sie können eine Liste vertrauenswürdiger Subdomänen in einem durch Kommas getrennten Format mit dem Präfix `AS2TrustedDomains=` angeben. Erstellen Sie dann einen DNS-TXT-Eintrag für die entsprechende Domäne. Der DNS-TXT-Eintrag `AS2TrustedDomains` kann nur dieselbe Domäne oder Subdomänen der Domäne aktivieren, in der der DNS-TXT-Eintrag erstellt wird. Sie können den DNS-TXT-Eintrag nicht verwenden, um andere Domänen zu aktivieren.
Weitere Informationen zum Einrichten des DNS-Eintrags finden Sie unter [Aktivieren Ihrer Organisationsdomäne für den AppStream 2.0-Client mit einem Route 53 53-DNS-TXT-Eintrag](https://aws.amazon.com/blogs/desktop-and-application-streaming/enable-your-organizational-domain-for-the-appstream-2-0-client-with-a-route-53-dns-txt-record/) und [Erstellen eines AS2 TrustedDomains DNS-TXT-Eintrags, um den systemeigenen AppStream 2.0-Client an einen externen Identitätsanbieter umzuleiten](https://aws.amazon.com/blogs/desktop-and-application-streaming/creating-an-as2trusteddomains-dns-txt-record-to-redirect-the-appstream-2-0-native-client-to-a-third-party-identity-provider/).
**Anmerkung**
Wenn Sie DNS-TXT-Einträge erstellen, können Benutzer von aktivierten Domänen streamen, die nicht in den Registrierungswerten `StartURL` oder `TrustedDomains` enthalten sind. Die Konfiguration des WorkSpaces Anwendungsclients und des DNS-TXT-Eintrags verhindern nicht, URLs dass Benutzer andere Verbindungsmethoden verwenden, um auf die von Ihnen angegebenen Domänen zuzugreifen. Benutzer können beispielsweise auf bestimmte Domänen zugreifen oder URLs einen Webbrowser verwenden, wenn sie Netzwerkzugriff auf die Domänen haben oder URLs.
### Beispiel für die Konfiguration des DNS-TXT-Eintrags
Im Folgenden finden Sie ein Beispiel für eine DNS-TXT-Eintragskonfiguration. Mit der Konfiguration für dieses Beispiel können Benutzer den WorkSpaces Applications Client starten und eine Verbindung zu appstream.example.com oder appstream-dev.example.com herstellen. Sie können jedoch keine Verbindung zu example.com herstellen.
+ `Domains to enable` – appstream.example.com, appstream-dev.example.com
+ `DNS TXT record location` – example.com
+ `DNS TXT record value`— AS2 TrustedDomains =appstream.example.com, appstream-dev.example.com
### Anforderungen und Überlegungen
Beachten Sie die folgenden Anforderungen und Überlegungen zum Erstellen eines DNS-TXT-Eintrags:
+ Sie müssen den TXT-Eintrag in der Domäne der zweiten Ebene erstellen. Wenn Ihre Domäne beispielsweise prod.appstream.example.com ist, müssen Sie den DNS-TXT-Eintrag unter example.com erstellen.
+ Der TXT-Datensatzwert muss mit `AS2TrustedDomains=` beginnen.
+ Folgende Zeichen werden unterstützt: a-z, 0-9, -, \$1
+ Abhängig von seiner Position im Domänennamen wird das \$1-Zeichen vom DNS entweder als Platzhalter oder als das \$1-Zeichen (ASCII 42) behandelt. Im Folgenden sind Einschränkungen bei der Verwendung von \$1 als Platzhalter im Namen eines DNS-Eintrags aufgeführt:
+ Das „\$1“ muss den Bezeichner ganz links in einem Domänennamen ersetzen. Beispielsweise \$1.example.com oder \$1.prod.example.com. Wenn Sie „\$1“ in anderen Positionen verwenden (z. B. prod.\$1.example.com), wird es von DNS wie ein \$1-Zeichen (ASCII-42) und nicht als Platzhalter behandelt.
+ Das „\$1“ muss den gesamten Bezeichner ersetzen. Sie können z. B. nicht „\$1prod.beispiel.de“ oder „prod\$1.beispiel.de“ angeben.
+ \$1 gilt für die Subdomänen-Ebene, die die \$1 enthält, und für alle Subdomänen dieser Subdomäne. Wenn ein Eintrag beispielsweise \$1.example.com heißt, erlaubt der WorkSpaces Applications Client Verbindungen zu den folgenden Domänen: zenith.example.com, acme.zenith.example.com und pinnacle.acme.zenith.example.com.
## Deaktivieren der DNS-TXT-Datensatzsuche für vertrauenswürdige Domänen
Wenn Benutzer die Anwendungen starten und eine URL angeben, die keine Anwendungsdomäne ist, führt der Client standardmäßig eine DNS-TXT-Datensatzsuche durch. WorkSpaces WorkSpaces Die Suche wird für die Domäne der zweiten Ebene der URL durchgeführt, sodass der Client feststellen kann, ob die Domäne in der Liste `AS2TrustedDomains` enthalten ist. Durch dieses Verhalten können Benutzer eine Verbindung zu Domänen herstellen, die nicht in den `TrustedDomains` Registrierungsschlüsseln `StartURL` oder WorkSpaces Anwendungsdomänen angegeben sind.
Sie können dieses Verhalten deaktivieren, indem Sie den Wert für den Registrierungsschlüssel `DnsTxtRecordQueryDisabled` auf `true` festlegen. Sie können diesen Registrierungsschlüssel erstellen, wenn Sie den WorkSpaces Applications Client installieren. Auf diese Weise stellt der Client nur eine Verbindung zu den Registrierungsschlüsseln her URLs , die in den `TrustedDomains` Registrierungsschlüsseln `StartURL` oder angegeben sind.
Nachdem der WorkSpaces Applications Client installiert wurde, können Sie das folgende PowerShell Skript ausführen, um diesen Registrierungsschlüssel zu erstellen. Oder Sie können die administrative Vorlage verwenden, die im Enterprise Deployment Tool für den WorkSpaces Applications Client enthalten ist, um den Client mithilfe von Gruppenrichtlinien zu konfigurieren.
**Anmerkung**
Zum Ausführen dieses Skripts müssen Sie mit Administratorberechtigungen an dem betreffenden Computer angemeldet sein. Sie können das Skript auch remote über das Systemkonto während des Starts ausführen.
```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force
New-ItemProperty -Path $registryPath -Name "DnsTxtRecordQueryDisabled" -Value "true" -PropertyType String -Force | Out-Null
```
## Festlegen, ob automatische Client-Updates deaktiviert werden sollen
Wenn eine neue Version des WorkSpaces Applications Client verfügbar ist, wird der Client standardmäßig automatisch auf die neueste Version aktualisiert. Sie können automatische Updates deaktivieren, indem Sie den Wert für den Registrierungsschlüssel `AutoUpdateDisabled` auf `true` festlegen. Sie können diesen Registrierungsschlüssel erstellen, wenn Sie den WorkSpaces Applications Client installieren. Auf diese Weise wird der Client nicht automatisch aktualisiert, wenn eine neue Version verfügbar ist.
Nach der Installation des WorkSpaces Applicationsclients können Sie das folgende PowerShell Skript ausführen, um diesen Registrierungsschlüssel zu erstellen. Oder Sie können die administrative Vorlage verwenden, die im Enterprise Deployment Tool für den WorkSpaces Applications Client enthalten ist, um den Client mithilfe von Gruppenrichtlinien zu konfigurieren.
**Anmerkung**
Zum Ausführen dieses Skripts müssen Sie mit Administratorberechtigungen an dem betreffenden Computer angemeldet sein. Sie können das Skript auch remote über das Systemkonto während des Starts ausführen.
```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force
New-ItemProperty -Path $registryPath -Name "AutoUpdateDisabled" -Value "True" -PropertyType String -Force | Out-Null
```
## Festlegen, ob On-Demand-Uploads von Diagnoseprotokollen deaktiviert werden sollen
Standardmäßig ermöglicht der WorkSpaces Applications Client Benutzern, Diagnoseprotokolle und Minidumps bei Bedarf in WorkSpaces Applications ()AWS hochzuladen. Wenn eine Ausnahme auftritt oder der WorkSpaces Applications Client nicht mehr reagiert, werden Benutzer außerdem aufgefordert, auszuwählen, ob sie den Minidump und die zugehörigen Protokolle hochladen möchten. Weitere Informationen zur On-Demand-Diagnoseprotokollierung finden Sie unter [Automatische und On-Demand-Uploads von Diagnoseprotokollen](feature-support-diagnostic-log-upload.md).
Sie können dieses Verhalten deaktivieren, indem Sie den Wert für den Registrierungsschlüssel `UserUploadOfClientLogsAllowed` auf `false` festlegen. Sie können diesen HKLM-Registrierungsschlüssel erstellen, wenn Sie den Applications Client installieren. WorkSpaces
Nach der Installation des WorkSpaces Applications Client können Sie das folgende PowerShell Skript ausführen, um diesen Registrierungsschlüssel zu erstellen. Oder Sie können die administrative Vorlage verwenden, die im Enterprise Deployment Tool für den WorkSpaces Applications Client enthalten ist, um den Client mithilfe von Gruppenrichtlinien zu konfigurieren.
**Anmerkung**
Zum Ausführen dieses Skripts müssen Sie mit Administratorberechtigungen an dem betreffenden Computer angemeldet sein. Sie können das Skript auch remote über das Systemkonto während des Starts ausführen.
```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force
New-ItemProperty -Path $registryPath -Name "UserUploadOfClientLogsAllowed" -Value "false" -PropertyType String -Force | Out-Null
```
## Wählen, ob der native Anwendungsmodus deaktiviert werden soll
Standardmäßig kann der WorkSpaces Applications Client entweder im klassischen Modus oder im systemeigenen Anwendungsmodus ausgeführt werden. Sie können den nativen Anwendungsmodus deaktivieren, indem Sie den Wert für den Registrierungsschlüssel `NativeAppModeDisabled` auf `true` setzen. Sie können diesen HKLM-Registrierungsschlüssel erstellen, wenn Sie den WorkSpaces Applications Client installieren. Wenn der Wert auf `true` gesetzt ist, wird der Client nur im klassischen Modus ausgeführt. Hinweise zum nativen Anwendungsmodus finden Sie unter [Nativer Anwendungsmodus](feature-support-native-application-mode.md).
Nach der Installation des WorkSpaces Applications Client können Sie das folgende PowerShell Skript ausführen, um diesen Registrierungsschlüssel zu erstellen. Oder Sie können die administrative Vorlage verwenden, die im Enterprise Deployment Tool für den WorkSpaces Applications Client enthalten ist, um den Client mithilfe von Gruppenrichtlinien zu konfigurieren.
**Anmerkung**
Zum Ausführen dieses Skripts müssen Sie mit Administratorberechtigungen an dem betreffenden Computer angemeldet sein. Sie können das Skript auch remote über das Systemkonto während des Starts ausführen.
```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force
New-ItemProperty -Path $registryPath -Name "NativeAppModeDisabled" -Value "True" -PropertyType String -Force | Out-Null
```
## Auswählen, ob die lokale Druckerumleitung deaktiviert werden soll
Standardmäßig ermöglicht der WorkSpaces Applications Client Benutzern, Druckaufträge von ihren Streaming-Anwendungen auf einen Drucker umzuleiten, der mit ihrem lokalen Computer verbunden ist. Sie können die lokale Druckerumleitung deaktivieren, indem Sie den Wert für den Registrierungsschlüssel `PrinterRedirectionDisabled` auf `true` festlegen. Sie können diesen HKLM-Registrierungsschlüssel erstellen, wenn Sie den WorkSpaces Applications Client installieren. Wenn der Wert auf `true` gesetzt ist, leitet der Client keine Druckaufträge von den Streaming-Anwendungen der Benutzer an einen Drucker um, der mit ihrem lokalen Computer verbunden ist.
Nachdem Sie den WorkSpaces Applications Client installiert haben, können Sie das folgende PowerShell Skript ausführen, um diesen Registrierungsschlüssel zu erstellen. Oder Sie können die administrative Vorlage verwenden, die im Enterprise Deployment Tool für den WorkSpaces Applications Client enthalten ist, um den Client mithilfe von Gruppenrichtlinien zu konfigurieren.
**Anmerkung**
Zum Ausführen dieses Skripts müssen Sie mit Administratorberechtigungen an dem betreffenden Computer angemeldet sein. Sie können das Skript auch remote über das Systemkonto während des Starts ausführen.
```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force
New-ItemProperty -Path $registryPath -Name "PrinterRedirectionDisabled" -Value "True" -PropertyType String -Force | Out-Null
```
## Festlegen, ob die Smartcard-Umleitung deaktiviert werden soll
Standardmäßig ist die Smartcard-Umleitung für den WorkSpaces Applications Client aktiviert. Wenn diese Funktion aktiviert ist, können Benutzer während WorkSpaces Anwendungsstreamingsitzungen ohne USB-Umleitung Smartcard-Lesegeräte verwenden, die mit ihren lokalen Computern und ihren Smartcards verbunden sind. Während der WorkSpaces Anwendungsstreamingsitzungen können die Benutzer weiterhin auf die Smartcard-Lesegeräte und Smartcards zugreifen, sodass sie mit lokalen Anwendungen verwendet werden können. Der Client leitet die Smartcard-API-Aufrufe von den Streaming-Anwendungen der Benutzer an ihre lokale Smartcard weiter. Sie können die Smartcard-Umleitung deaktivieren, indem Sie den Wert für den Registrierungsschlüssel `SmartCardRedirectionDisabled` auf `true` festlegen. Sie können diesen HKLM-Registrierungsschlüssel erstellen, wenn Sie den WorkSpaces Applications Client installieren.
Wenn der Wert auf gesetzt ist`true`, können Ihre Benutzer ihre Smartcard-Lesegeräte und Smartcards während einer WorkSpaces Anwendungs-Streaming-Sitzung ohne USB-Umleitung nicht verwenden. In diesem Fall können sich Benutzer nicht mit einer Smartcard, die mit ihrem lokalen Computer verbunden ist, bei ihren Streaming-Anwendungen anmelden, es sei denn, Sie [qualifizieren das Gerät](qualify-usb-devices.md). Nachdem Sie das Gerät qualifiziert haben, müssen Benutzer [das Gerät für WorkSpaces Anwendungen freigeben](client-application-windows-how-to-share-usb-devices-user.md). Wenn die Smartcard-Umleitung deaktiviert ist, können Benutzer während der WorkSpaces Anwendungs-Streamingsitzungen nicht auf ihre Smartcard-Lesegeräte und Smartcards zugreifen, um sie mit lokalen Anwendungen zu verwenden.
Nachdem Sie den WorkSpaces Applications Client installiert haben, können Sie das folgende PowerShell Skript ausführen, um diesen Registrierungsschlüssel zu erstellen. Oder Sie können die administrative Vorlage verwenden, die im Enterprise Deployment Tool für den WorkSpaces Applications Client enthalten ist, um den Client mithilfe von Gruppenrichtlinien zu konfigurieren.
**Anmerkung**
Zum Ausführen dieses Skripts müssen Sie mit Administratorberechtigungen an dem betreffenden Computer angemeldet sein. Sie können das Skript auch remote über das Systemkonto während des Starts ausführen.
```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force
New-ItemProperty -Path $registryPath -Name "SmartCardRedirectionDisabled" -Value "True" -PropertyType String -Force | Out-Null
```
## Konfigurieren Sie zusätzliche WorkSpaces Applications Client-Einstellungen für Ihre Benutzer
Der WorkSpaces Applications Client verwendet Registrierungsschlüssel, um die folgenden zusätzlichen Client-Einstellungen zu konfigurieren:
+ WorkSpaces Annahme der Endbenutzer-Lizenzvereinbarung (EULA) für den Anwendungsclient
+ WorkSpaces Die EULA-Version des Anwendungsclients wird akzeptiert
+ Automatische Uploads von Diagnoseprotokollen für den WorkSpaces Applications Client
+ Automatische Updates für den USB-Treiber, der zur Weitergabe von USB-Treibern an WorkSpaces Anwendungen verwendet wird
+ Hardware-Rendering im WorkSpaces Applications Client aktivieren
+ Einstellung benutzerdefinierter Ordnerpfade für die Dateisystemumleitung im WorkSpaces Applications Client
+ URL für Ihren Identitätsanbieter (IdP) im Standardbrowser des Systems öffnen
+ Hinzufügen eines Indikators für visuelles Feedback in Echtzeit zum Verlust von Streaming-Daten
In der folgenden Tabelle sind die Registrierungswerte für zusätzliche Clienteinstellungen zusammengefasst, mit denen Sie die Benutzeroberfläche des WorkSpaces Applications-Clients für Ihre Benutzer anpassen können.
**Anmerkung**
Bei diesen Werten muss die Groß- und Kleinschreibung beachtet werden.
| Wert | Registry-Pfad | Typ | Description | Daten |
| --- | --- | --- | --- | --- |
| EULAAccepted | HKCU\$1Software\$1Amazon\$1Appstream Client | Zeichenfolge | Legen Sie diesen Wert auf fest, true um die EULA des WorkSpaces Applications-Clients im Namen Ihrer Benutzer zu akzeptieren. | true/false |
| AcceptedEULAVersion | HKCU\$1Software\$1Amazon\$1Appstream Client | Zeichenfolge | Die akzeptierte EULA-Version. Wenn sich die aktuelle Version der EULA für den WorkSpaces Applications Client von der akzeptierten Version der EULA unterscheidet, werden die Benutzer aufgefordert, die aktuelle Version der EULA zu akzeptieren. | 1.0 |
| DiagnosticInfoCollectionAllowed | HKCU\$1Software\$1Amazon\$1Appstream Client | Zeichenfolge | Legen Sie diesen Wert auf festtrue , damit WorkSpaces Anwendungen automatisch Diagnoseprotokolle vom WorkSpaces Applications Client an Applications () senden können WorkSpaces .AWS | true/false |
| USBDriverOptIn | HKCU\$1Software\$1Amazon\$1Appstream Client | Zeichenfolge | Legen Sie diesen Wert true auf fest, damit WorkSpaces Anwendungen den USB-Treiber, der zur Weitergabe von USB-Treibern an WorkSpaces Anwendungen verwendet wird, automatisch aktualisieren können. | true/false |
| HardwareRenderingEnabled | HKCU\$1Software\$1Amazon\$1Appstream Client | Zeichenfolge | Legen Sie diesen Wert auf festtrue, um das Hardware-Rendern im WorkSpaces Applications Client zu aktivieren. | true/false |
| FileRedirectionCustomDefaultFolders | HKCU\$1Software\$1Amazon\$1Appstream Client | Zeichenfolge | Legen Sie fest, dass in diesem Wert mindestens ein Ordnerpfad für die Dateisystemumleitung enthalten ist. Trennen Sie mehrere Ordnerpfade durch '\$1'. Standardmäßig werden die folgenden Ordnerpfade angegeben: %USERPROFILE%\$1Desktop\$1%USERPROFILE%\$1Dokumente\$1%USERPROFILE%\$1Downloads | Valid folder path |
| OpenIdpUrlInSystemBrowser | HKCU\$1Software\$1Amazon\$1Appstream Client | Zeichenfolge | Setzen Sie diesen Wert auftrue, damit der WorkSpaces Applications Client die IdP-URL in einem Standardbrowser des Systems öffnen kann. Diese Funktion wird auf der Client-Version 1.1.1360 und höher unterstützt. | true/false |
| DataLossIndicator | HKCU\$1Software\$1Amazon\$1Appstream Client | Zeichenfolge | Setzen Sie diesen Wert auf SHOW\$1ON\$1LOSSY, um eine rote Warnanzeige anzuzeigen, wenn Streaming-Daten verloren gehen. Setzen Sie diesen Wert auf SHOW\$1ON\$1LOSSLESS, um eine grüne Anzeige für fehlerfreie Daten anzuzeigen, wenn keine Streaming-Daten verloren gehen. | DISABLED/SHOW\$1ON\$1LOSSY/SHOW\$1ON\$1LOSSLESS |
Nach der Installation des WorkSpaces Applications Client können Sie das folgende PowerShell Skript ausführen, um diese Registrierungsschlüssel zu erstellen. Wenn Sie nicht alle Registrierungsschlüssel erstellen möchten, ändern Sie das Skript nach Bedarf, um nur die gewünschten Registrierungschlüssel zu erstellen. Oder Sie können die administrative Vorlage verwenden, die im Enterprise Deployment Tool für den WorkSpaces Applications Client bereitgestellt wird, um den Client mithilfe von Gruppenrichtlinien zu konfigurieren.
**Anmerkung**
Sie müssen die folgenden Einträge für jeden Benutzer festlegen.
```
$registryPath="HKCU:\Software\Amazon\AppStream Client"
New-Item -Path "HKCU:\Software\Amazon" -Name "AppStream Client" -Force
New-ItemProperty -Path $registryPath -Name "EULAAccepted" -Value "true" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "AcceptedEULAVersion" -Value "1.0" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "DiagnosticInfoCollectionAllowed" -Value "true" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "USBDriverOptIn" -Value "true" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "HardwareRenderingEnabled" -Value "true" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "FileRedirectionCustomDefaultFolders" -Value "%USERPROFILE%\Desktop|%USERPROFILE%\Documents|%USERPROFILE%\Downloads" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "OpenIdpUrlInSystemBrowser" -Value "true" -PropertyType String -Force | Out-Null
```
## Verwenden von Gruppenrichtlinien zur Anpassung des WorkSpaces Anwendungsclients
Sie können die administrative Vorlage verwenden, die im Enterprise Deployment Tool für den WorkSpaces Applications Client bereitgestellt wird, um den Client mithilfe von Gruppenrichtlinien zu konfigurieren. Informationen zum Laden von administrativen Vorlagen in die Group Policy Management Console (GPMC) finden Sie unter [Empfehlungen für die Verwaltung administrativer Vorlagendateien (.adm) von Gruppenrichtlinien](https://support.microsoft.com/en-us/help/816662/recommendations-for-managing-group-policy-administrative-template-adm) in der Microsoft Support-Dokumentation.