Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Installation et configuration du client WorkSpaces d'applications
Vous pouvez demander à vos utilisateurs d'installer eux-mêmes le client WorkSpaces Applications ou vous pouvez installer le client WorkSpaces Applications pour eux en exécutant PowerShell des scripts à distance.
Vous devez qualifier les périphériques USB que vous voulez autoriser vos utilisateurs à utiliser avec leur session de streaming. Si leur périphérique USB n'est pas qualifié, il ne sera pas détecté par WorkSpaces les applications et ne pourra pas être partagé avec la session.
Les rubriques suivantes décrivent comment installer et configurer le client WorkSpaces Applications.
**Topics**
+ [Demandez à vos utilisateurs d'installer eux-mêmes le client d' WorkSpaces applications](user-install-client.md)
+ [Tutoriel : Installation du client Amazon WorkSpaces Applications et personnalisation de l'expérience client pour vos utilisateurs](install-client-configure-settings.md)
+ [Mettre à jour manuellement l'outil de déploiement d' WorkSpaces Applications Enterprise, le client et le pilote USB](update-enterprise-deployment-tool-client-usb-driver-manually.md)
+ [Qualification des périphériques USB pour une utilisation avec des applications de streaming](qualify-usb-devices.md)
+ [Configurer une méthode de connexion pour les utilisateurs de vos WorkSpaces applications clientes](use-client-start-streaming-session.md)
+ [Permettre aux utilisateurs de partager un périphérique USB avec une session de streaming d' WorkSpaces applications](share-usb-devices-with-session.md)
+ [Rediriger une session de streaming du navigateur Web vers le client WorkSpaces Applications](redirect-streaming-session-from-web-to-client.md)
+ [Activez la redirection du système de fichiers pour les utilisateurs de vos WorkSpaces applications](enable-file-system-redirection.md)
+ [Activez la redirection d'imprimante locale pour les utilisateurs de vos WorkSpaces applications](enable-local-printer-redirection.md)
# Demandez à vos utilisateurs d'installer eux-mêmes le client d' WorkSpaces applications
Pour step-by-step obtenir des conseils que vous pouvez fournir à vos utilisateurs pour les aider à installer le client WorkSpaces Applications, consultez [Configuration pour Windows](client-application-windows-installation-user.md) ou[Configuration et installation pour macOS](client-application-mac-installation-user.md).
**Important**
Pour le client Windows, si votre entreprise a déployé un logiciel antivirus qui empêche les utilisateurs d'exécuter des fichiers .exe, vous devez ajouter une exception pour permettre aux utilisateurs d'exécuter le programme .exe d'installation du client WorkSpaces Applications. Sinon, lorsque les utilisateurs essaient d'installer le client, soit rien ne se passe, soit ils reçoivent une erreur après avoir lancé le programme d'installation.
Une fois que les utilisateurs ont installé le client, si vous prévoyez de les autoriser à utiliser des périphériques USB pendant leurs sessions de streaming d' WorkSpaces applications, les conditions suivantes doivent être remplies :
+ Vous devez qualifier les périphériques USB qui peuvent être utilisés avec WorkSpaces les applications. Pour de plus amples informations, veuillez consulter [Qualification des périphériques USB pour une utilisation avec des applications de streaming](qualify-usb-devices.md).
+ Une fois leurs appareils qualifiés, vos utilisateurs doivent les partager avec les WorkSpaces applications chaque fois qu'ils démarrent une nouvelle session de streaming. Pour obtenir des conseils que vous pouvez fournir à vos utilisateurs afin d’effectuer cette tâche, consultez [Périphériques USB](client-application-windows-how-to-share-usb-devices-user.md).
# Tutoriel : Installation du client Amazon WorkSpaces Applications et personnalisation de l'expérience client pour vos utilisateurs
Les sections suivantes décrivent comment installer le client WorkSpaces Applications et personnaliser l'expérience client pour vos utilisateurs. Si vous prévoyez de télécharger et d'installer le client pour vos utilisateurs, téléchargez d'abord le Enterprise Deployment Tool (Outil de déploiement Enterprise). Vous pouvez ensuite exécuter PowerShell des scripts pour installer le client WorkSpaces Applications et configurer les paramètres du client à distance.
**Note**
L'utilisation de l'outil de déploiement d'entreprise avec le client WorkSpaces Applications macOS n'est pas prise en charge.
**Topics**
+ [Télécharger Enterprise Deployment Tool](#install-client-use-remote-deployment-tool)
+ [Installation du client WorkSpaces d'applications et du pilote USB](#run-powershell-script-install-client-usb-driver-silently)
+ [Accès aux WorkSpaces applications avec le client WorkSpaces Applications](#access-appstream-with-client)
+ [Définissez la valeur WorkSpaces de registre StartURL pour les utilisateurs du client Applications](#set-start-url-registry-value)
+ [Définissez la valeur de TrustedDomains registre pour activer d'autres domaines pour le client WorkSpaces d'applications](#set-trusted-domains-registry-value)
+ [Créez l' AS2TrustedDomains enregistrement DNS TXT pour activer votre domaine pour le client WorkSpaces Applications sans modifier le registre](#create-AS2TrustedDomains-DNS-TXT-record-client)
+ [Désactiver la recherche d'enregistrements TXT DNS pour les domaines approuvés](#disable-DNS-TXT-record-lookup-client)
+ [Choisir si vous souhaitez désactiver les mises à jour automatiques du client](#disable-automatic-updates-client)
+ [Indiquer s'il faut désactiver les chargements de journaux de diagnostic à la demande](#disable-on-demand-diagnostic-log-uploads)
+ [Choisir si le mode application native doit être désactivé](#disable-native-application-mode-client)
+ [Choisir si la redirection d’imprimante locale doit être désactivée](#disable-local-printer-redirection-client)
+ [Choisir si la redirection de carte à puce doit être désactivée](#disable-local-smart-card-support-client)
+ [Configurer des paramètres clients d' WorkSpaces applications supplémentaires pour vos utilisateurs](#configure-client)
+ [Utilisation de la stratégie de groupe pour personnaliser l'expérience client WorkSpaces des applications](#configure-client-with-adm-template-group-policy)
## Télécharger Enterprise Deployment Tool
L'outil de déploiement d'entreprise inclut les fichiers d'installation du client WorkSpaces Applications et un modèle d'administration de stratégie de groupe.
1. Pour télécharger l'outil de déploiement d'entreprise, en bas à droite de la page des [clients pris en charge par les WorkSpaces applications](https://clients.amazonappstream.com), sélectionnez le lien de l'**outil de déploiement d'entreprise**. Ce lien ouvre un fichier .zip contenant les fichiers requis pour la dernière version de l'outil.
1. Pour extraire les fichiers requis, accédez à l'emplacement où vous avez téléchargé l'outil, cliquez avec le bouton droit sur le dossier **AmazonAppStreamClientEnterpriseSetup\$1 \$1**, puis choisissez **Extraire tout**. Le dossier contient deux programmes d'installation et un modèle d’administration de stratégie de groupe :
+ WorkSpaces Programme d'installation du client Applications (AmazonAppStreamClientSetup\$1 .msi) — Installe le client WorkSpaces Applications.
+ WorkSpaces Programme d'installation du pilote USB des applications (AmazonAppStreamUsbDriverSetup\$1 .exe) : installe le pilote USB WorkSpaces des applications requis pour utiliser des périphériques USB avec des applications diffusées via WorkSpaces Applications.
+ WorkSpaces Modèle administratif de stratégie de groupe du client Applications (as2\$1client\$1config.adm) : vous permet de configurer le client Applications via la stratégie de groupe. WorkSpaces
## Installation du client WorkSpaces d'applications et du pilote USB
Après avoir téléchargé les fichiers d'installation du client WorkSpaces Applications, exécutez le PowerShell script suivant sur les ordinateurs des utilisateurs pour installer le fichier d'installation du client WorkSpaces Applications, AppStreamClient .exe, et le pilote USB en mode silencieux.
**Note**
Pour exécuter ce script, vous devez être connecté à l’ordinateur approprié avec les autorisations d’administrateur. Vous pouvez également exécuter le script à distance sous le compte Système au démarrage.
```
Start-Process msiexec.exe -Wait -ArgumentList '/i AmazonAppStreamClientSetup_.msi /quiet'
Start-Process AmazonAppStreamUsbDriverSetup_.exe -Wait -ArgumentList '/quiet'
```
Après avoir installé l'outil de déploiement d'entreprise sur l'ordinateur d'un utilisateur, le client WorkSpaces Applications est installé comme suit :
1. Le fichier d'installation du client WorkSpaces Applications est copié sur le chemin suivant sur l'ordinateur de l'utilisateur : C:\$1Program Files (x86) \$1 Amazon WorkSpaces Applications Client Installer \$1 AppStreamClient .exe.
1. La première fois que l'utilisateur ouvre une session sur son ordinateur après l'installation de l'outil de déploiement d'entreprise, le client WorkSpaces Applications est installé.
**Note**
Si l'outil de déploiement d'entreprise détecte que le dossier WorkSpaces Applications Client existe déjà dans **%localappdata%**, il n'installe pas le client. **AppStreamClient**
Si un utilisateur désinstalle le client WorkSpaces Applications, celui-ci n'est pas réinstallé tant que vous n'avez pas mis à jour l'outil de déploiement d' WorkSpaces Applications Enterprise.
## Accès aux WorkSpaces applications avec le client WorkSpaces Applications
Par défaut, lorsque les utilisateurs lancent le client WorkSpaces Applications, ils ne peuvent se connecter URLs qu'aux domaines qui incluent le WorkSpaces ou les domaines qui incluent un enregistrement DNS TXT permettant la connexion. Vous pouvez autoriser les utilisateurs clients à accéder à des domaines autres que le domaine WorkSpaces Applications en procédant de l'une des manières suivantes :
+ Définissez la valeur de registre `StartURL` pour spécifier une URL personnalisée à laquelle les utilisateurs peuvent accéder, notamment l'URL du portail de connexion de votre organisation.
+ Définissez la valeur de registre `TrustedDomains` pour spécifier les domaines approuvés auxquels les utilisateurs peuvent accéder.
+ Créez l'enregistrement TXT DNS `AS2TrustedDomains` pour spécifier les domaines approuvés auxquels les utilisateurs peuvent accéder. Cette méthode vous permet d'éviter les modifications de registre.
**Note**
La configuration du client WorkSpaces Applications et de l'enregistrement DNS TXT n'empêche pas les utilisateurs d'utiliser d'autres méthodes de connexion pour accéder aux domaines ou URLs que vous spécifiez. Par exemple, les utilisateurs peuvent accéder à des domaines spécifiques ou URLs à l'aide d'un navigateur Web, s'ils ont un accès réseau aux domaines ou URLs.
## Définissez la valeur WorkSpaces de registre StartURL pour les utilisateurs du client Applications
Vous pouvez utiliser la valeur de `StartUrl` registre pour définir une URL personnalisée qui est renseignée dans le client WorkSpaces Applications lorsqu'un utilisateur lance le client. Vous pouvez créer cette clé de registre HKLM lors de l'installation du client, de sorte que vos utilisateurs n'aient pas besoin de spécifier une URL lorsqu’ils lancent le client.
Une fois le client WorkSpaces Applications installé, vous pouvez exécuter le PowerShell script suivant pour créer cette clé de registre, ou vous pouvez utiliser le modèle administratif inclus dans l'outil de déploiement d'entreprise du client WorkSpaces Applications pour configurer le client via une stratégie de groupe.
Remplacez la valeur `StartUrl` par une URL pour votre fournisseur d'identité (IdP). L’URL doit utiliser un certificat approuvé par l’appareil. Cela signifie que le certificat utilisé par la page web `StartUrl` doit contenir un nom alternatif d’objet (SAN) qui inclut le nom de domaine de l’URL. Par exemple, si votre paramètre `StartUrl` est défini sur https://appstream.example.com, le certificat SSL doit disposer d'un SAN incluant appstream.example.com.
**Note**
Pour exécuter ce script, vous devez être connecté à l’ordinateur approprié avec les autorisations d’administrateur. Vous pouvez également exécuter le script à distance sous le compte Système au démarrage.
```
$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
```
## Définissez la valeur de TrustedDomains registre pour activer d'autres domaines pour le client WorkSpaces d'applications
Vous pouvez configurer le client WorkSpaces Applications pour qu'il se URLs connecte aux domaines approuvés que vous spécifiez. Par exemple, vous pouvez autoriser les utilisateurs à se connecter à n'importe quelle URL du domaine de votre organisation ou à n'importe quelle URL d'un ou de plusieurs de vos domaines IdP. Lorsque vous spécifiez l'URL, utilisez le format suivant :\$1. *example*-*idp*. *com*.
Vous pouvez spécifier une liste de domaines approuvés avec un format de valeurs séparées par des virgules. Ajoutez cette liste en tant que valeur de registre à la clé de registre WorkSpaces Applications `TrustedDomains` HKLM. Nous vous recommandons de créer cette clé de registre et de spécifier la liste des domaines approuvés lorsque vous installez le client WorkSpaces Applications ou, si vous utilisez Microsoft Active Directory, via la stratégie de groupe. De cette façon, vos utilisateurs peuvent se connecter à une URL dans n'importe quel domaine approuvé immédiatement après l'installation du client.
Une fois le client WorkSpaces Applications installé, vous pouvez exécuter le PowerShell script suivant pour créer cette clé de registre. Vous pouvez également utiliser le modèle administratif inclus dans l'outil de déploiement d'entreprise du client WorkSpaces Applications pour configurer le client via une stratégie de groupe.
Remplacez la valeur `TrustedDomains` par une liste séparée par des virgules pour un ou plusieurs de vos domaines idP ou d’organisation. Le certificat utilisé par la page Web du domaine approuvé doit contenir un SAN qui inclut le domaine de l'URL. Par exemple, si votre domaine approuvé inclut \$1.exemple.com et que les utilisateurs le spécifient https://appstream.example.com, le certificat SSL doit disposer d'un SAN qui inclut appstream.example.com.
**Note**
Pour exécuter ce script, vous devez être connecté à l’ordinateur approprié avec les autorisations d’administrateur. Vous pouvez également exécuter le script à distance sous le compte Système au démarrage.
```
$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
```
Les exigences et les considérations relatives au formatage des noms de domaine approuvés sont les suivantes.
+ Les caractères suivants sont pris en charge : a-z, 0-9, -, \$1
+ DNS traite le caractère \$1 comme un caractère générique ou comme le caractère \$1 (ASCII 42) en fonction de son emplacement dans le nom. Voici des restrictions lors de l’utilisation de \$1 comme caractère générique dans le nom d’un enregistrement DNS :
+ Le \$1 doit remplacer l’étiquette la plus à gauche dans un nom de domaine. Par exemple, \$1.example.com ou \$1.prod.example.com. Si vous incluez \$1 à un autre endroit, tel que prod.\$1.example.com, DNS le traite comme un caractère \$1 (ASCII 42), et non comme un caractère générique.
+ Le caractère \$1 doit remplacer l’étiquette entière. Par exemple, vous ne pouvez pas spécifier \$1prod.example.com ou prod\$1.example.com.
+ Le \$1 s’applique au niveau du sous-domaine qui inclut le \$1, et à tous les sous-domaines de ce sous-domaine. Par exemple, si une entrée s'appelle \$1.exemple.com, le client WorkSpaces Applications autorise zenith.example.com, acme.zenith.example.com et pinnacle.acme.zenith.example.com.
## Créez l' AS2TrustedDomains enregistrement DNS TXT pour activer votre domaine pour le client WorkSpaces Applications sans modifier le registre
Vous pouvez permettre aux utilisateurs de se connecter à n'importe quelle URL de votre domaine d'organisation (par exemple, \$1.example.com) ou à n'importe quelle URL de vos domaines IdP (par exemple, \$1.example-idp.com) en créant un enregistrement TXT DNS dans ce domaine. Lorsque vous créez l'enregistrement TXT DNS, les valeurs de registre `StartURL` ou `TrustedDomains` ne sont pas nécessaires pour permettre à un utilisateur de se connecter à une URL.
Vous pouvez spécifier une liste de sous-domaines approuvés dans un format séparé par des virgules, préfixé par `AS2TrustedDomains=`. Ensuite, créez un enregistrement TXT DNS pour le domaine approprié. L'enregistrement TXT DNS `AS2TrustedDomains` ne peut activer que le même domaine, ou les sous-domaines, du domaine dans lequel l'enregistrement TXT DNS est créé. Vous ne pouvez pas utiliser l'enregistrement TXT DNS pour activer d'autres domaines.
Pour plus d'informations sur la configuration de l'enregistrement DNS, consultez [Activer le domaine de votre organisation pour le client AppStream 2.0 avec un enregistrement TXT DNS Route 53](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/) et [Création d'un enregistrement AS2 TrustedDomains DNS TXT pour rediriger le client natif AppStream 2.0 vers un fournisseur d'identité tiers](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/).
**Note**
Lorsque vous créez des enregistrements TXT DNS, tous les utilisateurs peuvent diffuser en continu à partir de domaines activés qui ne sont pas inclus dans les valeurs de registre `StartURL` ou `TrustedDomains`. La configuration du client WorkSpaces Applications et de l'enregistrement DNS TXT n'empêche pas les utilisateurs d'utiliser d'autres méthodes de connexion pour accéder aux domaines ou URLs que vous spécifiez. Par exemple, les utilisateurs peuvent accéder à des domaines spécifiques ou URLs à l'aide d'un navigateur Web, s'ils ont un accès réseau aux domaines ou URLs.
### Exemple de configuration d'enregistrement TXT DNS
Voici un exemple de configuration d'enregistrement TXT DNS. Avec la configuration de cet exemple, les utilisateurs peuvent lancer le client WorkSpaces Applications et se connecter à appstream.example.com ou appstream-dev.example.com. Toutefois, ils ne peuvent pas se connecter à example.com.
+ `Domains to enable` : appstream.example.com, appstream-dev.example.com
+ `DNS TXT record location` : example.com
+ `DNS TXT record value`— AS2 TrustedDomains = appstream.exemple.com, appstream-dev.exemple.com
### Exigences et considérations
Gardez à l'esprit les exigences et considérations suivantes pour créer un enregistrement TXT DNS :
+ Vous devez créer l'enregistrement TXT sur le domaine de deuxième niveau. Par exemple, si votre domaine est prod.appstream.example.com, vous devez créer l'enregistrement TXT DNS sur example.com.
+ La valeur d'enregistrement TXT doit commencer par `AS2TrustedDomains=`
+ Les caractères suivants sont pris en charge : a-z, 0-9, -, \$1
+ DNS traite le caractère \$1 comme un caractère générique ou comme le caractère \$1 (ASCII 42) en fonction de son emplacement dans le nom. Voici des restrictions lors de l’utilisation de \$1 comme caractère générique dans le nom d’un enregistrement DNS :
+ Le \$1 doit remplacer l’étiquette la plus à gauche dans un nom de domaine. Par exemple, \$1.example.com ou \$1.prod.example.com. Si vous incluez \$1 à un autre endroit, tel que prod.\$1.example.com, DNS le traite comme un caractère \$1 (ASCII 42), et non comme un caractère générique.
+ Le caractère \$1 doit remplacer l’étiquette entière. Par exemple, vous ne pouvez pas spécifier \$1prod.example.com ou prod\$1.example.com.
+ Le \$1 s’applique au niveau du sous-domaine qui inclut le \$1, et à tous les sous-domaines de ce sous-domaine. Par exemple, si une entrée s'appelle \$1.exemple.com, le client WorkSpaces Applications autorise les connexions aux domaines suivants : zenith.example.com, acme.zenith.example.com et pinnacle.acme.zenith.example.com.
## Désactiver la recherche d'enregistrements TXT DNS pour les domaines approuvés
Par défaut, lorsque les utilisateurs lancent les WorkSpaces applications et spécifient une URL qui n'est pas un domaine d' WorkSpaces applications, le client effectue une recherche d'enregistrement DNS TXT. La recherche est effectuée sur le domaine de deuxième niveau de l'URL afin que le client puisse déterminer si le domaine est inclus dans la liste `AS2TrustedDomains`. Ce comportement permet aux utilisateurs de se connecter à des domaines qui ne sont pas spécifiés dans les domaines des clés de `TrustedDomains` registre `StartURL` ou WorkSpaces des applications.
Vous pouvez désactiver ce comportement en définissant la valeur de la clé de registre `DnsTxtRecordQueryDisabled` sur `true`. Vous pouvez créer cette clé de registre lorsque vous installez le client WorkSpaces Applications. De cette façon, le client ne se connecte URLs qu'aux clés spécifiées par les clés de `TrustedDomains` registre `StartURL` or.
Une fois le client WorkSpaces Applications installé, vous pouvez exécuter le PowerShell script suivant pour créer cette clé de registre. Vous pouvez également utiliser le modèle administratif inclus dans l'outil de déploiement d'entreprise du client WorkSpaces Applications pour configurer le client via une stratégie de groupe.
**Note**
Pour exécuter ce script, vous devez être connecté à l’ordinateur approprié avec les autorisations d’administrateur. Vous pouvez également exécuter le script à distance sous le compte Système au démarrage.
```
$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
```
## Choisir si vous souhaitez désactiver les mises à jour automatiques du client
Par défaut, lorsqu'une nouvelle version du client WorkSpaces Applications est disponible, le client est automatiquement mis à jour vers la dernière version. Vous pouvez désactiver les mises à jour automatiques en définissant la valeur de la clé de registre `AutoUpdateDisabled` sur `true`. Vous pouvez créer cette clé de registre lorsque vous installez le client WorkSpaces Applications. De cette façon, le client n'est pas mis à jour automatiquement chaque fois qu'une nouvelle version est disponible.
Une fois le client WorkSpaces Applications installé, vous pouvez exécuter le PowerShell script suivant pour créer cette clé de registre. Vous pouvez également utiliser le modèle administratif inclus dans l'outil de déploiement d'entreprise du client WorkSpaces Applications pour configurer le client via une stratégie de groupe.
**Note**
Pour exécuter ce script, vous devez être connecté à l’ordinateur approprié avec les autorisations d’administrateur. Vous pouvez également exécuter le script à distance sous le compte Système au démarrage.
```
$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
```
## Indiquer s'il faut désactiver les chargements de journaux de diagnostic à la demande
Par défaut, le client WorkSpaces Applications permet aux utilisateurs de télécharger des journaux de diagnostic et des minidumps à la demande dans WorkSpaces Applications ()AWS. En outre, si une exception se produit ou si le client WorkSpaces Applications cesse de répondre, les utilisateurs sont invités à choisir s'ils souhaitent télécharger le minidump et les journaux associés. Pour de plus amples informations sur la journalisation des diagnostics à la demande, consultez [Chargements automatiques et à la demande de journaux de diagnostic](feature-support-diagnostic-log-upload.md).
Vous pouvez désactiver ces comportements en définissant la valeur de la clé de registre `UserUploadOfClientLogsAllowed` sur `false`. Vous pouvez créer cette clé de registre HKLM lorsque vous installez le client WorkSpaces Applications.
Une fois le client WorkSpaces Applications installé, vous pouvez exécuter le PowerShell script suivant pour créer cette clé de registre. Vous pouvez également utiliser le modèle administratif inclus dans l'outil de déploiement d'entreprise du client WorkSpaces Applications pour configurer le client via une stratégie de groupe.
**Note**
Pour exécuter ce script, vous devez être connecté à l’ordinateur approprié avec les autorisations d’administrateur. Vous pouvez également exécuter le script à distance sous le compte Système au démarrage.
```
$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
```
## Choisir si le mode application native doit être désactivé
Par défaut, le client WorkSpaces Applications peut s'exécuter en mode classique ou en mode application native. Vous pouvez désactiver le mode application native en définissant la valeur de la clé de registre `NativeAppModeDisabled` sur `true`. Vous pouvez créer cette clé de registre HKLM lorsque vous installez le client WorkSpaces Applications. Si la valeur est définie sur `true`, le client s'exécute uniquement en mode classique. Pour plus d’informations sur le mode application native, consultez [Mode application native](feature-support-native-application-mode.md).
Une fois le client WorkSpaces Applications installé, vous pouvez exécuter le PowerShell script suivant pour créer cette clé de registre. Vous pouvez également utiliser le modèle administratif inclus dans l'outil de déploiement d'entreprise du client WorkSpaces Applications pour configurer le client via une stratégie de groupe.
**Note**
Pour exécuter ce script, vous devez être connecté à l’ordinateur approprié avec les autorisations d’administrateur. Vous pouvez également exécuter le script à distance sous le compte Système au démarrage.
```
$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
```
## Choisir si la redirection d’imprimante locale doit être désactivée
Par défaut, le client WorkSpaces Applications permet aux utilisateurs de rediriger les tâches d'impression de leurs applications de streaming vers une imprimante connectée à leur ordinateur local. Vous pouvez désactiver la redirection d’imprimante locale en définissant la valeur de la clé de registre `PrinterRedirectionDisabled` sur `true`. Vous pouvez créer cette clé de registre HKLM lorsque vous installez le client WorkSpaces Applications. Si la valeur est définie sur `true`, le client ne redirige pas les tâches d’impression des applications de streaming des utilisateurs vers une imprimante connectée à leur ordinateur local.
Après avoir installé le client WorkSpaces Applications, vous pouvez exécuter le PowerShell script suivant pour créer cette clé de registre. Vous pouvez également utiliser le modèle administratif inclus dans l'outil de déploiement d'entreprise du client WorkSpaces Applications pour configurer le client via une stratégie de groupe.
**Note**
Pour exécuter ce script, vous devez être connecté à l’ordinateur approprié avec les autorisations d’administrateur. Vous pouvez également exécuter le script à distance sous le compte Système au démarrage.
```
$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
```
## Choisir si la redirection de carte à puce doit être désactivée
Par défaut, la redirection par carte à puce est activée pour le client WorkSpaces Applications. Lorsque cette fonctionnalité est activée, les utilisateurs peuvent utiliser des lecteurs de cartes à puce connectés à leurs ordinateurs locaux et à leurs cartes à puce pendant WorkSpaces les sessions de streaming d'applications sans redirection USB. Pendant WorkSpaces les sessions de streaming d'applications, les lecteurs de cartes à puce et les cartes à puce des utilisateurs restent accessibles pour une utilisation avec les applications locales. Le client redirige les appels d’API de carte à puce des applications de streaming des utilisateurs vers leur carte à puce locale. Vous pouvez désactiver la redirection de carte à puce en définissant la valeur de la clé de registre `SmartCardRedirectionDisabled` sur `true`. Vous pouvez créer cette clé de registre HKLM lorsque vous installez le client WorkSpaces Applications.
Si la valeur est définie sur`true`, vos utilisateurs ne peuvent pas utiliser leurs lecteurs de cartes à puce ni leurs cartes à puce pendant une session de streaming d' WorkSpaces applications sans redirection USB. Dans ce cas, les utilisateurs ne peuvent pas se connecter à leurs applications de streaming à l’aide d’une carte à puce connectée à leur ordinateur local, sauf si vous [qualifiez l’appareil](qualify-usb-devices.md). Après avoir qualifié l'appareil, les utilisateurs doivent [le partager avec WorkSpaces les applications](client-application-windows-how-to-share-usb-devices-user.md). Lorsque la redirection par carte à puce est désactivée, pendant les sessions de streaming d' WorkSpaces applications des utilisateurs, leurs lecteurs de cartes à puce et leurs cartes à puce ne sont pas accessibles pour une utilisation avec les applications locales.
Après avoir installé le client WorkSpaces Applications, vous pouvez exécuter le PowerShell script suivant pour créer cette clé de registre. Vous pouvez également utiliser le modèle administratif inclus dans l'outil de déploiement d'entreprise du client WorkSpaces Applications pour configurer le client via une stratégie de groupe.
**Note**
Pour exécuter ce script, vous devez être connecté à l’ordinateur approprié avec les autorisations d’administrateur. Vous pouvez également exécuter le script à distance sous le compte Système au démarrage.
```
$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
```
## Configurer des paramètres clients d' WorkSpaces applications supplémentaires pour vos utilisateurs
Le client WorkSpaces Applications utilise des clés de registre pour configurer les paramètres client supplémentaires suivants :
+ WorkSpaces Acceptation du contrat de licence utilisateur final (EULA) du client d'applications
+ WorkSpaces Applications : version EULA du client acceptée
+ Téléchargement automatique du journal de diagnostic pour le client WorkSpaces Applications
+ Mises à jour automatiques du pilote USB utilisé pour transmettre les pilotes USB aux WorkSpaces applications
+ Activation du rendu matériel dans le client WorkSpaces Applications
+ Définition de chemins de dossier personnalisés pour la redirection du système de fichiers dans le client WorkSpaces Applications
+ URL d'ouverture de votre fournisseur d'identité (IdP) dans le navigateur par défaut du système
+ Ajout d'un indicateur pour fournir des informations visuelles en temps réel sur la perte de données en streaming
Le tableau suivant récapitule les valeurs de registre pour les paramètres client supplémentaires que vous pouvez utiliser pour personnaliser l'expérience client WorkSpaces Applications pour vos utilisateurs.
**Note**
Ces valeurs sont sensibles à la casse.
| Value | Chemin de registre | Type | Description | Données |
| --- | --- | --- | --- | --- |
| EULAAccepted | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Définissez cette valeur sur true pour accepter le CLUF du client WorkSpaces Applications au nom de vos utilisateurs. | true/false |
| AcceptedEULAVersion | HKCU\$1Software\$1Amazon\$1Appstream Client | String | La version de CLUF qui est acceptée. Si la version actuelle du CLUF du client WorkSpaces Applications est différente de la version du CLUF acceptée, les utilisateurs sont invités à accepter la version actuelle du CLUF. | 1.0 |
| DiagnosticInfoCollectionAllowed | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Définissez cette valeur sur true pour permettre aux WorkSpaces applications d'envoyer automatiquement les journaux de diagnostic du client WorkSpaces Applications à WorkSpaces Applications (AWS). | true/false |
| USBDriverOptIn | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Définissez cette valeur sur true pour permettre aux WorkSpaces applications de mettre à jour automatiquement le pilote USB utilisé pour transmettre les pilotes USB aux WorkSpaces applications. | true/false |
| HardwareRenderingEnabled | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Définissez cette valeur sur true pour activer le rendu matériel dans le client WorkSpaces Applications. | true/false |
| FileRedirectionCustomDefaultFolders | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Définissez cette valeur pour inclure au moins un chemin de dossier pour la redirection du système de fichiers. Séparez plusieurs chemins de dossier par « \$1 ». Par défaut, les chemins de dossier suivants sont spécifiés :%USERPROFILE%\$1Desktop\$1%USERPROFILE%\$1Documents\$1%USERPROFILE%\$1Downloads | Valid folder path |
| OpenIdpUrlInSystemBrowser | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Définissez cette valeur sur pour true permettre au client WorkSpaces Applications d'ouvrir l'URL de l'IdP dans un navigateur par défaut du système. Cette fonctionnalité est prise en charge sur les versions du client 1.1.1360 et ultérieures. | true/false |
| DataLossIndicator | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Définissez cette valeur sur SHOW\$1ON\$1LOSSY pour inclure un indicateur d'avertissement rouge en cas de perte de données de streaming. Définissez cette valeur sur SHOW\$1ON\$1LOSSLESS pour inclure un indicateur vert sain en l'absence de perte de données de streaming. | DISABLED/SHOW\$1ON\$1LOSSY/SHOW\$1ON\$1LOSSLESS |
Une fois le client WorkSpaces Applications installé, vous pouvez exécuter le PowerShell script suivant pour créer ces clés de registre. Si vous ne souhaitez pas créer toutes les clés de registre, modifiez le script pour créer uniquement les clés de registre que vous souhaitez. Vous pouvez également utiliser le modèle administratif fourni dans l'outil de déploiement d'entreprise du client WorkSpaces Applications pour configurer le client via une stratégie de groupe.
**Note**
Vous devez définir les entrées suivantes pour chaque utilisateur.
```
$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
```
## Utilisation de la stratégie de groupe pour personnaliser l'expérience client WorkSpaces des applications
Vous pouvez utiliser le modèle administratif fourni dans l'outil de déploiement d'entreprise du client WorkSpaces Applications pour configurer le client via une stratégie de groupe. Pour découvrir comment charger des modèles d’administration dans la console de gestion des stratégies de groupe, consultez [Recommendations for managing Group Policy administrative template (.adm) files](https://support.microsoft.com/en-us/help/816662/recommendations-for-managing-group-policy-administrative-template-adm) dans la documentation Microsoft.
# Mettre à jour manuellement l'outil de déploiement d' WorkSpaces Applications Enterprise, le client et le pilote USB
Par défaut, le client WorkSpaces Applications et le pilote USB sont mis à jour automatiquement lorsqu'une nouvelle version du client est publiée. Toutefois, si vous avez utilisé l'outil de déploiement d'entreprise pour installer le client WorkSpaces Applications pour vos utilisateurs et que vous avez désactivé les mises à jour automatiques, vous devez mettre à jour l'outil de déploiement d' WorkSpaces applications d'entreprise, le client et le pilote USB manuellement. Pour ce faire, effectuez les étapes suivantes pour exécuter les PowerShell commandes requises sur les ordinateurs des utilisateurs.
**Note**
Pour exécuter ces commandes, vous devez être connecté à l'ordinateur concerné en tant qu'administrateur ; vous pouvez également exécuter le script à distance sous le compte SYSTEM au démarrage.
L'utilisation de l'outil de déploiement d'entreprise pour gérer le client MacOS WorkSpaces Applications n'est pas prise en charge.
1. Désinstallez l'outil de déploiement d' WorkSpaces Applications Enterprise en mode silencieux :
```
Start-Process msiexec.exe -Wait -ArgumentList '/x AmazonAppStreamClientSetup_.msi /quiet'
```
1. Désinstallez le pilote USB WorkSpaces des applications en mode silencieux :
```
Start-Process -Wait AmazonAppStreamUsbDriverSetup_.exe -ArgumentList '/uninstall /quiet /norestart'
```
1. Désinstallez le client WorkSpaces Applications en mode silencieux :
```
Start-Process "$env:LocalAppData\AppStreamClient\Update.exe" -ArgumentList '--uninstall'
```
**Note**
Ce processus supprime également les clés de registre utilisées pour configurer le client WorkSpaces Applications. Après avoir réinstallé le client WorkSpaces Applications, vous devez recréer ces clés.
1. Nettoyez le répertoire d'installation de l'application :
```
Remove-Item -Path $env:LocalAppData\AppStreamClient -Recurse -Confirm:$false –Force
```
1. Redémarrez l'ordinateur :
```
Restart-computer
```
1. Installez la dernière version de l'outil de déploiement d' WorkSpaces Applications Enterprise en mode silencieux :
```
Start-Process msiexec.exe -Wait -ArgumentList '/i AmazonAppStreamClientSetup_.msi /quiet'
```
1. Installez la dernière version du pilote USB WorkSpaces Applications en mode silencieux :
```
Start-Process AmazonAppStreamUsbDriverSetup_.exe -Wait -ArgumentList '/quiet'
```
# Qualification des périphériques USB pour une utilisation avec des applications de streaming
Il existe deux méthodes pour spécifier les périphériques USB que vos utilisateurs peuvent rediriger vers leurs instances de streaming d' WorkSpaces applications :
**Note**
La redirection USB n'est actuellement prise en charge que sur les instances de streaming d' WorkSpaces applications Windows. Il n'est pas pris en charge sur le client macOS.
+ Vous pouvez créer les chaînes de filtre de périphérique USB dans le fichier de configuration enregistré sur une image. Cette méthode ne peut être utilisée qu’avec les flottes toujours actives et à la demande.
+ Vous pouvez spécifier des chaînes de filtre pour les périphériques USB lorsque vous créez le parc, soit à l'aide de la console AWS de gestion, soit à l'aide de l'`CreateFleet`API. Pour des informations détaillées sur ces chaînes, consultez la section ci-dessous. Cette méthode ne peut être utilisée qu’avec les flottes Elastic.
Vous pouvez créer un fichier sur l'image de vos WorkSpaces applications qui indique les périphériques USB qu'un utilisateur peut mettre à disposition pour ses applications de streaming. Procédez comme suit pour qualifier les périphériques USB de vos utilisateurs afin qu'ils puissent être utilisés avec des applications de streaming.
**Note**
Pour des raisons de sécurité, ne qualifiez que les périphériques USB provenant de sources fiables approuvées. Le fait de qualifier tous les périphériques génériques ou toutes les classes de périphériques peut permettre l’utilisation de périphériques non approuvés avec vos applications de streaming.
1. Si ce n'est pas déjà fait, installez le client WorkSpaces Applications. Pour plus d'informations, consultez [Installation et configuration du client WorkSpaces d'applications](install-configure-client.md).
1. Connectez le périphérique USB que vous souhaitez qualifier à votre ordinateur.
1. Accédez à **C:\$1Users \$1 < logged-in-user > \$1 \$1 Local AppData \$1 AppStreamClient**, puis double-cliquez sur **dcvusblist.exe**.
1. La liste des périphériques USB qui sont connectés à votre ordinateur local s'affiche dans la boîte de dialogue **Périphériques DCV - SUB**. La colonne **Filtre** affiche la chaîne de filtre pour chaque périphérique USB. Cliquez avec le bouton droit de la souris sur la saisie de liste d'un périphérique USB que vous souhaitez activer, puis choisissez **Copier la chaîne de filtrage**.
1. Sur votre bureau, cliquez sur le bouton **Démarrer** de Windows et recherchez Notepad. Double-cliquez sur **Bloc-notes** pour ouvrir un nouveau fichier, copiez la chaîne de filtrage dans le fichier et enregistrez-le. Vous utiliserez la chaîne de filtrage plus tard pour qualifier le périphérique USB.
1. Lancer une nouvelle instance Image Builder Pour de plus amples informations, veuillez consulter [Lancer un Image Builder pour l'installation et la configuration d'applications de streaming](tutorial-image-builder-create.md).
1. Une fois que votre générateur d'images est en **cours d'exécution**, effectuez les étapes suivantes pour créer une URL de diffusion et vous connecter au générateur d'images à l'aide du client WorkSpaces Applications.
1. Avec votre instance Image Builder sélectionnée dans la liste, choisissez **Actions**, **Create streaming URL (Créer une URL de streaming)**.
1. Dans la boîte de dialogue **Create streaming URL (Créer une URL de streaming)**, choisissez **Copy link (Copier le lien)**, puis copiez et collez l'adresse web dans un fichier distinct pour une utilisation ultérieure. Vous utiliserez cette URL pour vous reconnecter à l'instance Image Builder à l'étape 12.
1. Choisissez **Launch in Client (Lancer dans le client)**.
1. Si la boîte de dialogue **Launch Application** s'ouvre et vous invite à choisir l'application à utiliser lors de l'ouverture du lien, choisissez **Amazon AppStream**, **Open link**. Pour empêcher cette boîte de dialogue de s'afficher la prochaine fois que vous effectuez cette étape pour vous connecter à une instance Image Builder, activez la case à cocher **Remember my choice for amazonappstream links (Mémoriser mon choix pour les liens amazonappstream)**.
1. Si le client WorkSpaces Applications affiche des liens vers le contrat AWS client, les conditions de AWS service, l'avis de AWS confidentialité et les avis de tiers, consultez ces informations, puis choisissez **Terminer**.
1. Si la page de connexion du client s'affiche, le champ d'adresse web est prérempli avec l'URL de streaming. Choisissez **Se connecter**.
1. Si vous y êtes invité, connectez-vous à l'instance Image Builder en tant qu'administrateur.
1. Une fois que vous êtes connecté à l'instance Image Builder, si votre périphérique USB nécessite l'installation de pilotes avant son utilisation, téléchargez et installez-les sur l’instance Image Builder. Par exemple, si vous utilisez la souris Connexion 3D, vous devez télécharger et installer les pilotes Connexion nécessaires sur l’instance Image Builder
1. Sur le bureau de l’instance Image Builder, cliquez sur le bouton **Démarrer** de Windows et recherchez Notepad. Cliquez avec le bouton droit de la souris sur **Notepad**, puis choisissez **Exécuter en tant qu'administrateur**.
1. Choisissez **File (Fichier)**, **Open (Ouvrir)**, puis ouvrez le fichier suivant : `C:\ProgramData\Amazon\Photon\DCV\usb_device_allowlist.txt`. Vous pouvez également autoriser toute une catégorie de périphériques ou tous les périphériques provenant du même fabricant à l'aide d'expressions à caractère générique dans le fichier `usb_device_allowlist.txt`.
1. Copiez la chaîne de filtre de votre ordinateur local vers l’instance Image Builder. **La chaîne de filtre pour un périphérique USB spécifique est une chaîne séparée par des virgules contenant les champs suivants : **Nom**, **Classe de base**, **Protocole **SubClass****, **ID Vendor, ID** **Product**, **Support Autoshare** et Skip Reset.** Pour de plus amples informations sur ces chaînes, consultez [Utilisation des chaînes de filtre de périphériques USB](USB-device-filter-strings.md).
1. Déconnectez-vous de votre générateur d'images, redémarrez-le et reconnectez-vous à l'aide du client WorkSpaces Applications. Pour ce faire, ouvrez le client WorkSpaces Applications et collez l'URL de streaming que vous avez créée à l'étape 7 dans le champ d'adresse Web de connexion du client, puis choisissez **Connect**.
1. Testez votre périphérique USB sur l’instance Image Builder pour confirmer qu'il fonctionne comme prévu.
1. Avant que vos utilisateurs puissent utiliser le périphérique USB dans une session WorkSpaces Applications, ils doivent d'abord partager le périphérique avec leur session. Pour obtenir des conseils à fournir à vos utilisateurs afin de les aider à effectuer cette tâche, consultez [Périphériques USB](client-application-windows-how-to-share-usb-devices-user.md).
1. Si le périphérique USB fonctionne comme prévu avec l’instance Image Builder, créez une image. Pour de plus amples informations, veuillez consulter [Tutoriel : Création d'une image d' WorkSpaces applications personnalisée à l'aide de la console WorkSpaces d'applications](tutorial-image-builder.md).
1. Une fois que vous avez fini de créer l'image, mettez à jour votre parc d' WorkSpaces applications pour utiliser la nouvelle image.
# Utilisation des chaînes de filtre de périphériques USB
Cette section décrit les chaînes de filtre disponibles pour les périphériques USB éligibles pour les sessions de streaming d' WorkSpaces applications. Elle fournit également des conseils pour travailler avec ces chaînes. Les chaînes de filtre suivantes sont disponibles :
+ `Name` : la valeur par défaut de cette chaîne de filtre est le nom du périphérique, mais vous pouvez spécifier votre propre valeur.
+ `Base Class,SubClass,Protocol` : code de classe USB du périphérique. Pour plus d’informations, consultez [Codes de classe définis](https://www.usb.org/defined-class-codes).
+ `ID Vendor (VID)` : identifiant unique attribué par l’organisation USB au fabricant du périphérique USB.
+ `ID Product (PID)` : identifiant unique attribué par le fabricant au périphérique USB.
+ `Support Autoshare`— Permet au client WorkSpaces Applications de partager automatiquement l'appareil lorsqu'une session de streaming démarre. Définissez cette valeur sur `1` pour autoriser le partage automatique de périphériques. Définissez cette valeur sur `0` pour ne pas autoriser le partage automatique de périphériques.
+ `Skip Reset`— Par défaut, lorsqu'un périphérique USB est partagé par WorkSpaces Applications avec une session de streaming, l'appareil est réinitialisé pour garantir son bon fonctionnement. Toutefois, certains périphériques USB ne fonctionnent pas correctement pendant la session de streaming s'ils sont réinitialisés. Pour éviter que ce problème ne se produise, définissez la valeur de cette chaîne de filtre sur `1` pour indiquer au client WorkSpaces Applications de ne pas réinitialiser l'appareil lorsqu'il est partagé avec une session de streaming. Pour vous assurer que le périphérique est réinitialisé pendant qu'il est partagé avec une session de streaming, définissez cette valeur sur `0`. Lorsque vous définissez une valeur pour `Skip Reset`, assurez-vous que vous définissez la valeur pour `Support Autoshare` sur `0` ou `1`.
La chaîne de filtre copiée à partir de l'ordinateur local est spécifique à un périphérique USB. Dans certains cas, vous pouvez autoriser toute une catégorie de périphériques au lieu d'autoriser tous les périphériques USB possibles. Par exemple, vous pouvez autoriser vos utilisateurs à utiliser n'importe quel type de tablette Wacom ou n'importe quel périphérique de stockage de masse USB. Dans de tels scénarios, vous pouvez fournir des caractères génériques pour des champs de chaîne de filtre spécifiques. Si vous ne connaissez pas le VID et le PID de vos périphériques USB, vous pouvez rechercher ces informations dans la [base de données des ID USB](https://www.the-sz.com/products/usbid/index.php).
Les exemples suivants montrent comment configurer des chaînes de filtre pour le partage de périphériques USB pendant les sessions de streaming :
+ Autoriser automatiquement tous les périphériques de stockage de masse au démarrage d’une session de streaming : « Stockage de masse, 8, \$1, \$1, \$1, \$1,1,0 »
+ Autoriser tous les appareils Wacom automatiquement au démarrage d’une session de streaming « Tablettes Wacom, 3, \$1, \$1, 1386, \$1,1,0 »
+ Autoriser tous les périphériques qui fournissent une interface audio : « Audio, 1, \$1, \$1, \$1, \$1,1,0 »
+ Autorisez le périphérique X, mais ne le réinitialisez pas lorsqu'il est partagé. Ne pas partager automatiquement le périphérique au démarrage d’une session de streaming : « X, Y, \$1, \$1, 1386, \$1,0,1 »
# Configurer une méthode de connexion pour les utilisateurs de vos WorkSpaces applications clientes
Après avoir installé le client WorkSpaces Applications sur les ordinateurs locaux de vos utilisateurs, ceux-ci peuvent utiliser le client WorkSpaces Applications pour se connecter à une session de streaming. En fonction des besoins de votre organisation, vous pouvez fournir aux utilisateurs clients l'accès aux WorkSpaces applications en procédant de l'une des manières suivantes : configurer la fédération d'identité à l'aide de SAML 2.0, utiliser un groupe d'utilisateurs d' WorkSpaces applications ou créer une URL de streaming.
**Topics**
+ [SAML 2.0](use-client-start-streaming-session-SAML.md)
+ [WorkSpaces Groupe d'utilisateurs d'applications](use-client-start-streaming-session-user-pool.md)
+ [URL de streaming](use-client-start-streaming-session-streaming-URL.md)
+ [Étapes suivantes](use-client-start-streaming-session-next-steps.md)
# SAML 2.0
Si vous utilisez des fournisseurs d'identité externes pour fédérer vos utilisateurs dans une pile d' WorkSpaces applications, vous devez créer une valeur de registre pour configurer le client WorkSpaces Applications avec une URL préremplie chaque fois que le client est lancé. L’URL doit utiliser un certificat approuvé par l’appareil. Le certificat doit contenir un SAN (Subject Alternative Name) incluant le nom de domaine de l'URL.
Pour en savoir plus, consultez :
+ [Configuration de SAML](external-identity-providers-setting-up-saml.md)
+ [Définissez la valeur WorkSpaces de registre StartURL pour les utilisateurs du client Applications](install-client-configure-settings.md#set-start-url-registry-value)
# WorkSpaces Groupe d'utilisateurs d'applications
Lorsque vous créez un nouvel utilisateur dans le groupe d'utilisateurs WorkSpaces Applications ou que vous assignez un utilisateur du groupe d'utilisateurs à une WorkSpaces pile d' WorkSpaces applications, Applications envoie des e-mails aux utilisateurs en votre nom. Les utilisateurs saisissent l’URL qui leur a été fournie dans l’e-mail de bienvenue, saisissent leurs informations d’identification, puis choisissent **Se connecter**.
Pour plus d’informations, consultez [Groupes d'utilisateurs d'Amazon WorkSpaces Applications](user-pool.md).
# URL de streaming
Pour créer une URL de streaming, utilisez l’une des méthodes suivantes :
+ WorkSpaces Console d'applications
+ L'action de l'API [CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html)
+ Commande [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html) AWS CLI .
Pour créer une URL de streaming à l'aide de la console WorkSpaces Applications, suivez les étapes de la procédure suivante.
**Pour créer une URL de streaming à l'aide de la console WorkSpaces Applications**
1. Ouvrez la console WorkSpaces Applications à la [https://console.aws.amazon.com/appstream2/maison](https://console.aws.amazon.com/appstream2/home).
1. Dans le volet de navigation, sélectionnez **Flottes**.
1. Dans la liste des flottes, choisissez la flotte associée à la pile pour laquelle vous souhaitez créer une URL de streaming. Vérifiez que le statut de la flotte est **En cours d’exécution**.
1. Dans le volet de navigation, choisissez **Stack (Piles)**. Choisissez la pile, puis sélectionnez **Actions**, **Créer une URL de streaming**.
1. Dans **ID utilisateur**, saisissez l’ID utilisateur.
1. Dans le champ **Expiration de l’URL**, choisissez un délai d’expiration, qui détermine la durée pendant laquelle l’URL générée est valide. Cette URL est valide pour une durée maximale de sept jours.
1. Choisissez **Obtenir l’URL**.
1. Copiez l’URL, enregistrez-la dans un emplacement accessible, puis communiquez-la à vos utilisateurs.
Sur la page de connexion du client WorkSpaces Applications, les utilisateurs saisissent l'URL de streaming que vous avez créée comme adresse Web, puis choisissent **Connect**.
# Étapes suivantes
Après avoir configuré une méthode de connexion client, vous pouvez fournir à vos utilisateurs les step-by-step conseils suivants pour les aider à se connecter aux WorkSpaces applications et à démarrer une session de streaming : [Se connecter aux WorkSpaces applications sur le client Windows](client-application-windows-start-streaming-session-user.md) ou[Se connecter aux WorkSpaces applications sur le client macOS](client-application-mac-start-streaming-session-user.md).
# Permettre aux utilisateurs de partager un périphérique USB avec une session de streaming d' WorkSpaces applications
Avant que les utilisateurs ne partagent leurs périphériques USB avec une session WorkSpaces Applications, les périphériques USB doivent être qualifiés. Sinon, lorsque les utilisateurs démarrent une session de streaming, leur périphérique USB n'est pas détecté par WorkSpaces les applications et ne peut pas être partagé avec la session. Pour de plus amples informations, veuillez consulter [Qualification des périphériques USB pour une utilisation avec des applications de streaming](qualify-usb-devices.md).
**Note**
Le partage d'un périphérique USB avec une session de streaming d' WorkSpaces applications n'est pas pris en charge sur le client macOS.
# Rediriger une session de streaming du navigateur Web vers le client WorkSpaces Applications
Vous pouvez configurer WorkSpaces les applications pour rediriger une session de streaming depuis un navigateur Web vers le client WorkSpaces Applications. Ainsi, lorsque vos utilisateurs se connectent à WorkSpaces Applications et démarrent une session de streaming dans leur navigateur Web, leur session est redirigée vers le client WorkSpaces Applications. Pour ce faire, procédez comme suit.
1. Utilisez l'action `CreateStreamingURL` API WorkSpaces Applications pour générer une URL de streaming.
1. Ajoutez le préfixe suivant pour le gestionnaire client WorkSpaces Applications personnalisé à l'URL de diffusion : **amazonappstream:**
Le préfixe et l'URL de streaming sont conjointement formatés comme suit :
**amazonappstream:***base64encoded(streamingURL)*
**Note**
Lorsque vous codez l'URL, assurez-vous que le codage est en UTF-8.
Exemple de PowerShell à encoder : `[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes("Streaming/IdpURL"))`
1. Lorsque les utilisateurs sont redirigés vers l'URL de diffusion, leur navigateur détecte que le lien doit être ouvert par le client WorkSpaces Applications.
1. Les utilisateurs sont invités à choisir s'ils souhaitent démarrer la session de streaming à l'aide du client WorkSpaces Applications.
1. Après l'invite de commande, l'une des actions suivantes se produit :
+ Si le client WorkSpaces Applications est installé, l'utilisateur peut choisir de poursuivre la session de streaming à l'aide du client WorkSpaces Applications.
+ Si le client WorkSpaces Applications n'est pas installé, le comportement du navigateur varie comme suit :
+ Chrome : aucun message ne s’affiche.
+ Firefox — Un message indique que l'utilisateur a besoin d'une nouvelle application pour ouvrir Amazon AppStream.
+ Microsoft Edge : aucun message ne s’affiche.
+ Internet Explorer : un message indique à l'utilisateur que le client WorkSpaces Applications n'est pas installé.
Dans ce cas, les utilisateurs peuvent sélectionner le lien **Download AppStream Client** pour télécharger le client. Après avoir téléchargé le client, ils peuvent l'installer et actualiser leur navigateur pour démarrer la session de streaming à l'aide du client.
## Création d'un raccourci sur le bureau Windows à l'aide du navigateur par défaut
Pour créer un raccourci sur le bureau Windows à l'aide du navigateur par défaut pour lancer le client, utilisez l'exemple de script Powershell suivant.
```
$StringToEncode = 'your URL string'
$encodedUrl = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($StringToEncode))
$shortcutContent = "
[{000214A0-0000-0000-C000-000000000046}]
Prop3=19,0
[InternetShortcut]
IDList=
URL=amazonappstream:$encodedUrl
IconIndex=0
HotKey=0
IconFile=$env:USERPROFILE\AppData\Local\AppStreamClient\appstreamclient.exe
"
Set-Content -Path "$env:USERPROFILE\Desktop\AppStream 2.0 Client Launcher.url" -Value $shortcutContent
```
# Activez la redirection du système de fichiers pour les utilisateurs de vos WorkSpaces applications
WorkSpaces La redirection du système de fichiers des applications permet aux utilisateurs sur WorkSpaces lesquels le client Applications est installé d'accéder aux fichiers sur leur ordinateur local depuis leur session de streaming. Lorsque vous activez la redirection du système de fichiers, vous pouvez spécifier la liste des lecteurs et dossiers locaux auxquels vos utilisateurs peuvent choisir d'accéder. Lorsque les utilisateurs se connectent à WorkSpaces Applications et démarrent une session de streaming, ils peuvent choisir le lecteur ou le dossier auquel ils souhaitent accéder dans la liste. Ils peuvent ensuite partager le lecteur ou le dossier avec WorkSpaces Applications. Le lecteur ou le dossier reste accessible à ces utilisateurs pendant leurs sessions de streaming. Les utilisateurs peuvent cesser de partager leurs disques ou dossiers locaux à tout moment.
**Note**
La redirection du système de fichiers n'est actuellement pas prise en charge pour les instances de flotte basées sur Linux ou lors de l'utilisation du client macOS.
**Topics**
+ [Conditions préalables à la redirection du système de fichiers](file-system-redirection-prerequisites.md)
+ [Comment activer la redirection du système de fichiers](how-to-enable-file-system-redirection.md)
+ [Mettez les lecteurs et dossiers par défaut à la disposition de vos utilisateurs pour les partager](prepopulate-drives-folders-system-redirection.md)
+ [Fournissez aux utilisateurs de vos WorkSpaces applications des conseils sur l'utilisation de la redirection du système de fichiers](end-user-guidance-file-system-redirection.md)
# Conditions préalables à la redirection du système de fichiers
Pour activer la redirection de fichiers d' WorkSpaces applications :
+ Vous devez utiliser une image qui utilise une version de l'agent d' WorkSpaces applications publiée le 8 août 2019 ou après cette date. Pour de plus amples informations, veuillez consulter [WorkSpaces Notes de mise à jour des agents d'applications](agent-software-versions.md).
+ La version 1.0.480 ou ultérieure du client WorkSpaces Applications doit être installée sur vos utilisateurs. Pour de plus amples informations, veuillez consulter [WorkSpaces Notes de mise à jour des applications Windows Client](client-release-versions.md).
+ Le chargement et le téléchargement de fichiers doivent être activés sur la pile à laquelle vos utilisateurs accèdent pour les sessions de streaming. Consultez la procédure suivante.
# Comment activer la redirection du système de fichiers
Effectuez les étapes suivantes pour activer le chargement et le téléchargement de fichiers sur la pile à laquelle vos utilisateurs accèdent pour les sessions de streaming.
1. Ouvrez la console WorkSpaces Applications à la [https://console.aws.amazon.com/appstream2/maison](https://console.aws.amazon.com/appstream2/home).
1. Dans le volet de navigation de gauche, choisissez **Stacks (Piles)**.
1. Choisissez la pile pour laquelle vous souhaitez activer la redirection du système de fichiers.
1. Choisissez l'onglet **User Settings (Paramètres utilisateur)** puis développez la section **Clipboard, file transfer and local print permissions (Autorisations relatives au presse-papiers, au transfert de fichiers et aux impressions locales)**.
1. Vérifiez que **Upload and download (Charger et télécharger)** est sélectionné pour **File transfer (Transfert de fichiers)**. Si ce n'est pas le cas, choisissez **Edit (Modifier)**, puis **Upload and download (Charger et télécharger)**.
1. Choisissez **Mettre à jour**.
# Mettez les lecteurs et dossiers par défaut à la disposition de vos utilisateurs pour les partager
Par défaut, lorsque vous activez la redirection de fichier pour les utilisateurs d'une pile, les lecteurs et dossiers suivants sont mis à disposition pour que ces utilisateurs puissent les partager au sein de leur session de streaming :
+ Lecteurs :
+ Tous les disques durs locaux (disques physiques, tels que les disques C et D)
+ Tous les lecteurs virtuels (lecteurs réseau et virtuels tels que les lettres de lecteur mappées, Google Drive et OneDrive)
+ Tous les lecteurs USB locaux
+ Dossiers :
+ %USERPROFILE%\$1Desktop
+ %USERPROFILE%\$1Documents
+ %USERPROFILE%\$1Downloads
Ces chemins de lecteur et de dossier préremplissent la boîte de dialogue **Share your local drive and folders (Partager vos lecteurs et dossiers locaux)**. Cette boîte de dialogue s'affiche lorsque les utilisateurs se connectent à WorkSpaces Applications, démarrent une session de streaming et choisissent **Paramètres**, **Ressources locales** **et Lecteurs et dossiers** locaux.
Vous pouvez modifier ou définir vos propres chemins de lecteur et de dossier par défaut en modifiant le registre. Vous pouvez également utiliser le fichier de modèle d'administration fourni dans l'outil de déploiement d'entreprise du client WorkSpaces Applications. Ce modèle vous permet de configurer le client à l'aide d’une stratégie de groupe. Pour plus d’informations, consultez [Installation et configuration du client WorkSpaces d'applications](install-configure-client.md).
Lorsque les utilisateurs accèdent à leurs lecteurs et dossiers locaux partagés au cours d'une session de streaming, les chemins correspondants apparaissent avec des barres obliques inverses remplacées par des traits de soulignement. Ils sont également suivis du nom de l'ordinateur local et d'une lettre de lecteur. Par exemple, pour un utilisateur dont le nom d'utilisateur est janedoe et le nom d'ordinateur ExampleCorp -123456, les chemins par défaut des dossiers Bureau, Documents et Téléchargements apparaissent comme suit :
C\$1Users\$1JaneDoe\$1Desktop (\$1 \$1 -123456) (F:) ExampleCorp
c\$1Users\$1Janedoe\$1Documents (\$1 \$1 -123456) (G:) ExampleCorp
c\$1Users\$1JaneDoe\$1Downloads (\$1 \$1 -123456) (H:) ExampleCorp
# Fournissez aux utilisateurs de vos WorkSpaces applications des conseils sur l'utilisation de la redirection du système de fichiers
Pour aider vos utilisateurs à comprendre comment utiliser la redirection de fichiers au cours de leurs sessions de streaming, vous pouvez leur fournir les informations présentées dans la section [Accès aux fichiers locaux](client-application-windows-file-system-redirection.md).
# Activez la redirection d'imprimante locale pour les utilisateurs de vos WorkSpaces applications
Avec la redirection d'imprimante locale, les utilisateurs de vos WorkSpaces applications peuvent rediriger les tâches d'impression de leur application de streaming vers une imprimante connectée à leur ordinateur local, y compris les imprimantes réseau mappées par les utilisateurs. Il n'est pas nécessaire qu'un pilote d'imprimante soit installé sur l'instance de streaming WorkSpaces Applications pour permettre aux utilisateurs d'imprimer des documents pendant leurs sessions de streaming.
**Note**
L’activation de la redirection d’imprimante locale n’est actuellement pas prise en charge pour les piles basées sur Linux.
**Topics**
+ [Conditions préalables à la redirection d’imprimante locale](local-printer-redirection-prerequisites.md)
+ [Comment activer la redirection d'imprimante locale](how-to-enable-disable-local-printer-redirection.md)
+ [Comment désactiver la redirection d'imprimante locale](disable-local-printer-redirection.md)
# Conditions préalables à la redirection d’imprimante locale
Pour que vos utilisateurs puissent utiliser la redirection d’imprimante locale, vous devez :
+ Utilisez une image qui utilise une version de l'agent WorkSpaces Applications publiée le 30 juillet 2020 ou après cette date. Pour de plus amples informations, veuillez consulter [WorkSpaces Notes de mise à jour des agents d'applications](agent-software-versions.md).
+ Assurez-vous que la version 1.1.179 ou ultérieure du client WorkSpaces Applications est installée sur vos utilisateurs. Pour de plus amples informations, veuillez consulter [WorkSpaces Notes de mise à jour des applications Windows Client](client-release-versions.md).
+ vous assurer que la redirection d’imprimante est activée sur la pile à laquelle vos utilisateurs accèdent pour les sessions de streaming.
# Comment activer la redirection d'imprimante locale
Par défaut, la redirection d'imprimante locale est activée lorsque le client WorkSpaces Applications est installé. Toutefois, si la redirection d'imprimante locale n'est pas activée sur la pile à laquelle vos utilisateurs accèdent pour les sessions de streaming, vous pouvez l'activer dans la console WorkSpaces Applications en effectuant les étapes suivantes.
**Pour activer la redirection d'imprimantes locales à l'aide de la console WorkSpaces Applications**
1. Ouvrez la console WorkSpaces Applications à la [https://console.aws.amazon.com/appstream2/maison](https://console.aws.amazon.com/appstream2/home).
1. Dans le volet de navigation de gauche, choisissez **Stacks (Piles)**.
1. Choisissez la pile pour laquelle vous souhaitez activer la redirection d’imprimante locale.
1. Choisissez l’onglet **Paramètres utilisateur**, puis développez la section **Autorisations relatives au presse-papiers, au transfert de fichiers, aux impressions locales et à l’authentification**.
1. Pour **Imprimer sur l’appareil local**, vérifiez que l’option **Activé** est sélectionnée. Si ce n’est pas le cas, choisissez **Modifier**, puis **Activé**.
1. Choisissez **Mettre à jour**.
Vous pouvez également activer la redirection d'imprimantes locales à l'aide de l'API WorkSpaces Applications, d'un AWS SDK ou du AWS Command Line Interface (AWS CLI).
# Comment désactiver la redirection d'imprimante locale
Pour désactiver la redirection d'imprimante locale, procédez comme suit.
**Pour désactiver la redirection d’imprimante locale**
Vous pouvez désactiver la redirection d’imprimante locale de l’une des manières suivantes :
+ Lors de l’installation du client sur les appareils gérés. Pour de plus amples informations, veuillez consulter [Choisir si la redirection d’imprimante locale doit être désactivée](install-client-configure-settings.md#disable-local-printer-redirection-client).
+ En utilisant la console WorkSpaces Applications pour désactiver cette option sur une pile d' WorkSpaces applications.
+ En utilisant l'API WorkSpaces Applications, un AWS SDK ou le AWS Command Line Interface (AWS CLI) pour désactiver cette option sur une pile d' WorkSpaces applications.