Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Instale y configure el cliente de aplicaciones WorkSpaces
Puede hacer que sus usuarios instalen el cliente de WorkSpaces aplicaciones ellos mismos o puede instalar el cliente de WorkSpaces aplicaciones para ellos ejecutando PowerShell scripts de forma remota.
Debe cualificar los dispositivos USB que desea habilitar para que los usuarios utilicen con su sesión de transmisión. Si su dispositivo USB no cumple los requisitos, WorkSpaces las aplicaciones no lo detectarán y no podrán compartirlo con la sesión.
En los temas siguientes se describe cómo instalar y configurar el cliente de WorkSpaces aplicaciones.
**Topics**
+ [Haga que sus usuarios instalen ellos mismos el cliente de WorkSpaces aplicaciones](user-install-client.md)
+ [Tutorial: Instale el cliente de Amazon WorkSpaces Applications y personalice la experiencia del cliente para sus usuarios](install-client-configure-settings.md)
+ [Actualice manualmente la herramienta de implementación empresarial de WorkSpaces aplicaciones, el cliente y el controlador USB](update-enterprise-deployment-tool-client-usb-driver-manually.md)
+ [Cualificación de dispositivos USB para utilizarlos con aplicaciones de streaming](qualify-usb-devices.md)
+ [Configure un método de conexión para los usuarios del cliente de sus WorkSpaces aplicaciones](use-client-start-streaming-session.md)
+ [Permita que los usuarios compartan un dispositivo USB con una sesión de streaming de WorkSpaces aplicaciones](share-usb-devices-with-session.md)
+ [Redireccione una sesión de streaming desde el navegador web al cliente de WorkSpaces aplicaciones](redirect-streaming-session-from-web-to-client.md)
+ [Habilite la redirección del sistema de archivos para los usuarios de sus WorkSpaces aplicaciones](enable-file-system-redirection.md)
+ [Habilite la redirección de impresoras locales para los usuarios de sus aplicaciones WorkSpaces](enable-local-printer-redirection.md)
# Haga que sus usuarios instalen ellos mismos el cliente de WorkSpaces aplicaciones
Para step-by-step obtener instrucciones que puede proporcionar a sus usuarios para ayudarlos a instalar el cliente de WorkSpaces aplicaciones, consulte [Instalación para Windows](client-application-windows-installation-user.md) o[Instalación y configuración para macOS](client-application-mac-installation-user.md).
**importante**
En el caso del cliente de Windows, si su organización ha implementado un software antivirus que impide que los usuarios ejecuten archivos.exe, debe añadir una excepción para que los usuarios puedan ejecutar el programa de instalación del cliente de WorkSpaces aplicaciones .exe. De lo contrario, si los usuarios intentan instalar el cliente, es posible que, o no ocurra nada, o aparezca un error cuando intenten iniciar el programa de instalación.
Una vez que los usuarios instalen el cliente, si planea permitir que usen dispositivos USB durante sus sesiones de streaming de WorkSpaces aplicaciones, deberán cumplirse los siguientes requisitos:
+ Debe calificar los dispositivos USB que se pueden usar con WorkSpaces las aplicaciones. Para obtener más información, consulte [Cualificación de dispositivos USB para utilizarlos con aplicaciones de streaming](qualify-usb-devices.md).
+ Una vez que sus dispositivos cumplan los requisitos, los usuarios deberán compartirlos con WorkSpaces las aplicaciones cada vez que inicien una nueva sesión de streaming. Para obtener directrices que puede proporcionar a los usuarios para completar esta tarea, consulte [Dispositivos USB](client-application-windows-how-to-share-usb-devices-user.md).
# Tutorial: Instale el cliente de Amazon WorkSpaces Applications y personalice la experiencia del cliente para sus usuarios
En las siguientes secciones se describe cómo instalar el cliente de WorkSpaces aplicaciones y cómo personalizar la experiencia del cliente para sus usuarios. Si desea descargar e instalar el cliente para los usuarios, primero debe descargar Enterprise Deployment Tool. A continuación, puede ejecutar PowerShell scripts para instalar el cliente de WorkSpaces aplicaciones y configurar los ajustes del cliente de forma remota.
**nota**
No se admite el uso de la herramienta de implementación empresarial con el cliente WorkSpaces Applications macOS.
**Topics**
+ [Descarga de Enterprise Deployment Tool](#install-client-use-remote-deployment-tool)
+ [WorkSpaces Instale el cliente de aplicaciones y el controlador USB](#run-powershell-script-install-client-usb-driver-silently)
+ [Acceso a WorkSpaces las aplicaciones con el cliente de WorkSpaces aplicaciones](#access-appstream-with-client)
+ [Establezca el valor WorkSpaces de registro StarTurl para los usuarios del cliente de aplicaciones](#set-start-url-registry-value)
+ [Establezca el valor de TrustedDomains registro para habilitar otros dominios para el cliente de aplicaciones WorkSpaces](#set-trusted-domains-registry-value)
+ [Cree AS2 TrustedDomains el registro TXT de DNS para habilitar su dominio para el cliente de WorkSpaces aplicaciones sin cambios en el registro](#create-AS2TrustedDomains-DNS-TXT-record-client)
+ [Deshabilitar la búsqueda de registros TXT de DNS para dominios de confianza](#disable-DNS-TXT-record-lookup-client)
+ [Opción para deshabilitar las actualizaciones automáticas del cliente](#disable-automatic-updates-client)
+ [Elegir si deshabilitar las cargas de registro de diagnóstico bajo demanda](#disable-on-demand-diagnostic-log-uploads)
+ [Elija si desea deshabilitar el modo de aplicación nativa](#disable-native-application-mode-client)
+ [Seleccionar si se desea deshabilitar el redireccionamiento a impresoras locales](#disable-local-printer-redirection-client)
+ [Seleccionar si se desea deshabilitar el redireccionamiento de tarjetas inteligentes](#disable-local-smart-card-support-client)
+ [Configure las opciones de cliente de WorkSpaces aplicaciones adicionales para sus usuarios](#configure-client)
+ [Uso de la política de grupo para personalizar la experiencia del cliente de WorkSpaces las aplicaciones](#configure-client-with-adm-template-group-policy)
## Descarga de Enterprise Deployment Tool
La herramienta de implementación empresarial incluye los archivos de instalación del cliente de WorkSpaces aplicaciones y una plantilla administrativa de políticas de grupo.
1. Para descargar la herramienta de implementación empresarial, en la parte inferior derecha de la página de [WorkSpaces aplicaciones y clientes compatibles](https://clients.amazonappstream.com), seleccione el enlace de la **herramienta de implementación empresarial**. Este enlace abre un archivo .zip que contiene los archivos necesarios para la versión más reciente de la herramienta.
1. Para extraer los archivos necesarios, vaya a la ubicación en la que descargó la herramienta, haga clic con el botón derecho en la carpeta **AmazonAppStreamClientEnterpriseSetup\$1 \$1** y seleccione **Extraer todo**. La carpeta contiene dos programas de instalación y una plantilla administrativa de la política de grupo:
+ WorkSpaces Instalador del cliente de aplicaciones (AmazonAppStreamClientSetup\$1 .msi): instala el WorkSpaces cliente de aplicaciones.
+ WorkSpaces Instalador del controlador USB de aplicaciones (AmazonAppStreamUsbDriverSetup\$1.exe): instala el controlador USB de WorkSpaces aplicaciones necesario para utilizar dispositivos USB con aplicaciones transmitidas a través de las aplicaciones. WorkSpaces
+ WorkSpaces Plantilla administrativa de política de grupo del cliente de aplicaciones (as2\$1client\$1config.adm): permite configurar el cliente de aplicaciones mediante la política de grupo. WorkSpaces
## WorkSpaces Instale el cliente de aplicaciones y el controlador USB
Tras descargar los archivos de instalación del cliente de WorkSpaces aplicaciones, ejecute el siguiente PowerShell script en los ordenadores de los usuarios para instalar el archivo de instalación del cliente de WorkSpaces aplicaciones, AppStreamClient .exe, y el controlador USB de forma silenciosa.
**nota**
Para ejecutar este script, debe haber iniciado sesión en el equipo correspondiente con permisos de administrador. También puede ejecutar el script de forma remota en la cuenta del sistema durante el inicio.
```
Start-Process msiexec.exe -Wait -ArgumentList '/i AmazonAppStreamClientSetup_.msi /quiet'
Start-Process AmazonAppStreamUsbDriverSetup_.exe -Wait -ArgumentList '/quiet'
```
Tras instalar la herramienta de implementación empresarial en el ordenador de un usuario, el cliente de WorkSpaces aplicaciones se instala de la siguiente manera:
1. El archivo de instalación del cliente de WorkSpaces aplicaciones se copia en la siguiente ruta del ordenador del usuario: C:\$1Program Files (x86)\$1 Amazon WorkSpaces Applications Client Installer\$1 AppStreamClient .exe.
1. La primera vez que el usuario inicie sesión en su ordenador después de instalar la herramienta de implementación empresarial, se instalará el cliente de WorkSpaces aplicaciones.
**nota**
Si la herramienta de implementación empresarial detecta que la carpeta WorkSpaces Applications Client ya existe en **%localappdata%**, la herramienta no instala el cliente. **AppStreamClient**
Si un usuario desinstala el cliente de WorkSpaces aplicaciones, el cliente no se volverá a instalar hasta que actualice la herramienta de implementación empresarial de aplicaciones. WorkSpaces
## Acceso a WorkSpaces las aplicaciones con el cliente de WorkSpaces aplicaciones
De forma predeterminada, cuando los usuarios inician el cliente de WorkSpaces aplicaciones, solo pueden conectarse al URLs dominio de WorkSpaces aplicaciones o a los dominios que incluyan un registro TXT de DNS que permita la conexión. Puede permitir que los usuarios del cliente accedan a dominios distintos del dominio de WorkSpaces Aplicaciones mediante una de las siguientes acciones:
+ Establezca el valor del registro `StartURL` para especificar una URL personalizada a la que los usuarios puedan acceder, como la URL del portal de inicio de sesión de su organización.
+ Establezca el valor del registro `TrustedDomains` para especificar dominios de confianza a los que los usuarios puedan acceder.
+ Cree el registro TXT de DNS `AS2TrustedDomains` para especificar dominios de confianza a los que los usuarios puedan acceder. Este método le permite evitar cambios en el registro.
**nota**
La configuración del cliente de la WorkSpaces aplicación y del registro TXT de DNS no impide que los usuarios utilicen otros métodos de conexión para acceder a los dominios o URLs que usted especifique. Por ejemplo, los usuarios pueden acceder a dominios específicos o URLs mediante un navegador web, si tienen acceso de red a los dominios o URLs.
## Establezca el valor WorkSpaces de registro StarTurl para los usuarios del cliente de aplicaciones
Puede usar el valor del `StartUrl` registro para establecer una URL personalizada que se rellene en el cliente de WorkSpaces aplicaciones cuando un usuario inicie el cliente. Puede crear esta clave de registro HKLM al instalar el cliente para que los usuarios no tengan que especificar la URL de inicio la primera vez que lancen el cliente.
Una vez instalado el cliente de WorkSpaces aplicaciones, puede ejecutar el siguiente PowerShell script para crear esta clave de registro o puede usar la plantilla administrativa que se incluye en la herramienta de implementación empresarial del cliente de WorkSpaces aplicaciones para configurar el cliente mediante una política de grupo.
Sustituya el valor `StartUrl` por una dirección URL del proveedor de identidad (IdP). La dirección URL debe utilizar un certificado que sea de confianza para el dispositivo. Esto significa que el certificado que utiliza la página web `StartUrl` debe contener un nombre alternativo del sujeto (SAN) que incluya el nombre de dominio de la dirección URL. Por ejemplo, si `StartUrl` está configurado en https://appstream.example.com, el certificado SSL debe tener una SAN que incluya appstream.example.com.
**nota**
Para ejecutar este script, debe haber iniciado sesión en el equipo correspondiente con permisos de administrador. También puede ejecutar el script de forma remota en la cuenta del sistema durante el inicio.
```
$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
```
## Establezca el valor de TrustedDomains registro para habilitar otros dominios para el cliente de aplicaciones WorkSpaces
Puede configurar el cliente de WorkSpaces aplicaciones para que se conecte a URLs los dominios de confianza que especifique. Por ejemplo, es posible que desee permitir que los usuarios se conecten a cualquier URL del dominio de la organización o a cualquier URL de uno o más dominios del IdP. Cuando especifique la URL, utilice el siguiente formato: \$1. *example*-*idp*. *com*.
Puede especificar una lista de dominios de confianza en formato de valores separados por comas. Añada esta lista como valor de registro a la clave de registro `TrustedDomains` HKLM de WorkSpaces Applications. Le recomendamos que cree esta clave de registro y especifique la lista de dominios de confianza al instalar el cliente de WorkSpaces aplicaciones o, si utiliza Microsoft Active Directory, mediante la política de grupo. De esta forma, los usuarios pueden conectarse a una URL de inicio en cualquier dominio de confianza inmediatamente después de instalar el cliente.
Una vez instalado el cliente de WorkSpaces aplicaciones, puede ejecutar el siguiente PowerShell script para crear esta clave de registro. O bien, puede usar la plantilla administrativa que se incluye en la herramienta de implementación empresarial del cliente de WorkSpaces aplicaciones para configurar el cliente mediante una política de grupo.
Reemplace el valor `TrustedDomains` por una lista separada por comas para uno o varios dominios de su organización o del IdP. El certificado utilizado por la página web del dominio de confianza debe contener un SAN que incluya el dominio de la dirección URL. Por ejemplo, si su dominio de confianza incluye \$1.example.com y los usuarios lo especifican https://appstream.example.com, el certificado SSL debe tener una SAN que incluya appstream.example.com.
**nota**
Para ejecutar este script, debe haber iniciado sesión en el equipo correspondiente con permisos de administrador. También puede ejecutar el script de forma remota en la cuenta del sistema durante el inicio.
```
$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
```
A continuación se presentan los requisitos y consideraciones para dar formato a los nombres de dominio de confianza.
+ Se admiten los siguientes caracteres: a-z, 0-9, -, \$1.
+ DNS trata el carácter \$1 como comodín o como el carácter de asterisco (ASCII 42), en función de dónde aparece en el nombre de dominio. A continuación se indican las restricciones aplicables cuando se utiliza \$1 como comodín en el nombre de un registro DNS:
+ \$1 debe reemplazar la etiqueta situada más a la izquierda de un nombre de dominio. Por ejemplo, \$1.example.com o \$1.prod.example.com. Si incluye \$1 en cualquier otra posición, como prod.\$1.example.com, DNS lo trata como un carácter de asterisco (ASCII 42) y no como un carácter comodín.
+ El \$1 debe sustituir a toda la etiqueta. Por ejemplo, no puede especificar \$1prod.ejemplo.com ni prod\$1.ejemplo.com.
+ \$1 se aplica al nivel de subdominio que incluye el \$1, así como a todos los subdominios de ese subdominio. Por ejemplo, si una entrada se denomina \$1.example.com, el cliente de WorkSpaces aplicaciones permite zenith.example.com, acme.zenith.example.com y pinnacle.acme.zenith.example.com.
## Cree AS2 TrustedDomains el registro TXT de DNS para habilitar su dominio para el cliente de WorkSpaces aplicaciones sin cambios en el registro
Puede permitir que los usuarios se conecten a cualquier dirección URL del dominio de la organización (por ejemplo, \$1.example.com) o a cualquier dirección URL de los dominios de IdP (por ejemplo, \$1.example-idp.com) creando un registro TXT de DNS en ese dominio. Al crear el registro TXT de DNS, los valores de registro `StartURL` o `TrustedDomains` no son necesarios para permitir que un usuario se conecte a una dirección URL.
Puede especificar una lista de subdominios de confianza en un formato separado por comas, con el prefijo `AS2TrustedDomains=`. A continuación, cree un registro TXT de DNS para el dominio apropiado. El registro TXT de DNS `AS2TrustedDomains` solo puede habilitar el mismo dominio o subdominios del dominio en el que se crea el registro TXT de DNS. No puede utilizar el registro TXT de DNS para habilitar otros dominios.
Para obtener más información sobre la configuración del registro DNS, [consulte Habilitar el dominio de la organización para el cliente AppStream 2.0 con un registro TXT de DNS de 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/) y [Crear un registro TXT de AS2 TrustedDomains DNS para redirigir el cliente nativo AppStream 2.0 a un proveedor de identidad externo](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/).
**nota**
Al crear registros TXT de DNS, cualquier usuario puede transmitir desde dominios habilitados que no están incluidos en los valores de registro `StartURL` o `TrustedDomains`. La configuración del cliente de WorkSpaces aplicaciones y del registro DNS TXT no impide que los usuarios utilicen otros métodos de conexión para acceder a los dominios o URLs que usted especifique. Por ejemplo, los usuarios pueden acceder a dominios específicos o URLs mediante un navegador web, si tienen acceso de red a los dominios o URLs.
### Ejemplo de Configuración de Registro TXT de DNS
A continuación se muestra un ejemplo de configuración de registros TXT de DNS. Con la configuración de este ejemplo, los usuarios pueden iniciar el cliente de WorkSpaces aplicaciones y conectarse a appstream.example.com o appstream-dev.example.com. Sin embargo, no pueden conectarse a 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.example.com, appstream-dev.example.com
### Requisitos y consideraciones
Tenga en cuenta los siguientes requisitos y consideraciones para crear un registro TXT de DNS:
+ Debe crear el registro TXT en el dominio de segundo nivel. Por ejemplo, si su dominio es prod.appstream.example.com, debe crear el registro TXT de DNS en example.com.
+ El valor del registro TXT debe comenzar con `AS2TrustedDomains=`
+ Se admiten los siguientes caracteres: a-z, 0-9, -, \$1.
+ DNS trata el carácter \$1 como comodín o como el carácter de asterisco (ASCII 42), en función de dónde aparece en el nombre de dominio. A continuación se indican las restricciones aplicables cuando se utiliza \$1 como comodín en el nombre de un registro DNS:
+ \$1 debe reemplazar la etiqueta situada más a la izquierda de un nombre de dominio. Por ejemplo, \$1.example.com o \$1.prod.example.com. Si incluye \$1 en cualquier otra posición, como prod.\$1.example.com, DNS lo trata como un carácter de asterisco (ASCII 42) y no como un carácter comodín.
+ El \$1 debe sustituir a toda la etiqueta. Por ejemplo, no puede especificar \$1prod.ejemplo.com ni prod\$1.ejemplo.com.
+ \$1 se aplica al nivel de subdominio que incluye el \$1, así como a todos los subdominios de ese subdominio. Por ejemplo, si una entrada se denomina \$1.example.com, el cliente de WorkSpaces aplicaciones permite las conexiones a los siguientes dominios: zenith.example.com, acme.zenith.example.com y pinnacle.acme.zenith.example.com.
## Deshabilitar la búsqueda de registros TXT de DNS para dominios de confianza
De forma predeterminada, cuando los usuarios inician las aplicaciones y especifican una URL que no es un dominio de aplicaciones, el cliente realiza una búsqueda de registros TXT de DNS. WorkSpaces WorkSpaces La búsqueda se realiza en el dominio de segundo nivel de la dirección URL para que el cliente pueda determinar si el dominio está incluido en la lista `AS2TrustedDomains`. Este comportamiento permite a los usuarios conectarse a dominios que no están especificados en las claves de `TrustedDomains` registro `StartURL` o en los dominios de WorkSpaces aplicaciones.
Puede deshabilitar este comportamiento estableciendo el valor de la clave de registro `DnsTxtRecordQueryDisabled` en `true`. Puede crear esta clave de registro al instalar el cliente de WorkSpaces aplicaciones. De esta forma, el cliente se conecta únicamente a URLs las especificadas en las claves de `TrustedDomains` registro `StartURL` o.
Una vez instalado el cliente de WorkSpaces aplicaciones, puede ejecutar el siguiente PowerShell script para crear esta clave de registro. O bien, puede usar la plantilla administrativa que se incluye en la herramienta de implementación empresarial del cliente de WorkSpaces aplicaciones para configurar el cliente mediante una política de grupo.
**nota**
Para ejecutar este script, debe haber iniciado sesión en el equipo correspondiente con permisos de administrador. También puede ejecutar el script de forma remota en la cuenta del sistema durante el inicio.
```
$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
```
## Opción para deshabilitar las actualizaciones automáticas del cliente
De forma predeterminada, cuando hay disponible una nueva versión del cliente de WorkSpaces aplicaciones, el cliente se actualiza automáticamente a la versión más reciente. Para deshabilitar las actualizaciones automáticas, establezca el valor de la clave de registro `AutoUpdateDisabled` en `true`. Puede crear esta clave de registro al instalar el cliente de WorkSpaces aplicaciones. Así, el cliente no se actualiza automáticamente cuando hay disponible una nueva versión.
Una vez instalado el cliente de WorkSpaces aplicaciones, puede ejecutar el siguiente PowerShell script para crear esta clave de registro. O bien, puede usar la plantilla administrativa que se incluye en la herramienta de implementación empresarial del cliente de WorkSpaces aplicaciones para configurar el cliente mediante una política de grupo.
**nota**
Para ejecutar este script, debe haber iniciado sesión en el equipo correspondiente con permisos de administrador. También puede ejecutar el script de forma remota en la cuenta del sistema durante el inicio.
```
$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
```
## Elegir si deshabilitar las cargas de registro de diagnóstico bajo demanda
De forma predeterminada, el cliente de WorkSpaces aplicaciones permite a los usuarios cargar registros de diagnóstico y minidumps a pedido a WorkSpaces Applications ()AWS. Además, si se produce una excepción o el cliente de WorkSpaces aplicaciones deja de responder, se pide a los usuarios que elijan si desean cargar el minidump y los registros asociados. Para obtener más información acerca del registro de diagnóstico bajo demanda, consulte [Cargas de registro de diagnóstico automáticas y bajo demanda](feature-support-diagnostic-log-upload.md).
Para deshabilitar estos comportamientos, establezca el valor de la clave de registro `UserUploadOfClientLogsAllowed` en `false`. Puede crear esta clave de registro HKLM al instalar el cliente de aplicaciones. WorkSpaces
Una vez instalado el cliente de WorkSpaces aplicaciones, puede ejecutar el siguiente PowerShell script para crear esta clave de registro. O bien, puede usar la plantilla administrativa que se incluye en la herramienta de implementación empresarial del cliente de WorkSpaces aplicaciones para configurar el cliente mediante una política de grupo.
**nota**
Para ejecutar este script, debe haber iniciado sesión en el equipo correspondiente con permisos de administrador. También puede ejecutar el script de forma remota en la cuenta del sistema durante el inicio.
```
$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
```
## Elija si desea deshabilitar el modo de aplicación nativa
De forma predeterminada, el cliente de WorkSpaces aplicaciones se puede ejecutar en el modo clásico o en el modo de aplicación nativa. Para deshabilitar el modo de aplicación nativo, establezca el valor de la clave de registro `NativeAppModeDisabled` en `true`. Puede crear esta clave de registro HKLM al instalar el cliente de WorkSpaces aplicaciones. Si el valor se establece en `true`, el cliente solo se ejecuta en modo clásico. Para obtener información sobre el modo de aplicación nativa, consulte [Modo de aplicación nativa](feature-support-native-application-mode.md).
Una vez instalado el cliente de WorkSpaces aplicaciones, puede ejecutar el siguiente PowerShell script para crear esta clave de registro. O bien, puede usar la plantilla administrativa que se incluye en la herramienta de implementación empresarial del cliente de WorkSpaces aplicaciones para configurar el cliente mediante una política de grupo.
**nota**
Para ejecutar este script, debe haber iniciado sesión en el equipo correspondiente con permisos de administrador. También puede ejecutar el script de forma remota en la cuenta del sistema durante el inicio.
```
$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
```
## Seleccionar si se desea deshabilitar el redireccionamiento a impresoras locales
De forma predeterminada, el cliente de WorkSpaces aplicaciones permite a los usuarios redirigir los trabajos de impresión desde sus aplicaciones de streaming a una impresora conectada a su ordenador local. Para deshabilitar el redireccionamiento a impresoras locales, establezca el valor de la clave de registro `PrinterRedirectionDisabled` en `true`. Puede crear esta clave de registro de HKLM al instalar el cliente de WorkSpaces aplicaciones. Si el valor está establecido en `true`, el cliente no redirige los trabajos de impresión desde las aplicaciones de streaming de los usuarios a una impresora que esté conectada a su equipo local.
Tras instalar el cliente de WorkSpaces aplicaciones, puede ejecutar el siguiente PowerShell script para crear esta clave de registro. O bien, puede usar la plantilla administrativa que se incluye en la herramienta de implementación empresarial del cliente de WorkSpaces aplicaciones para configurar el cliente mediante una política de grupo.
**nota**
Para ejecutar este script, debe haber iniciado sesión en el equipo correspondiente con permisos de administrador. También puede ejecutar el script de forma remota en la cuenta del sistema durante el inicio.
```
$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
```
## Seleccionar si se desea deshabilitar el redireccionamiento de tarjetas inteligentes
De forma predeterminada, la redirección de tarjetas inteligentes está habilitada para el cliente de WorkSpaces aplicaciones. Cuando esta función está habilitada, los usuarios pueden utilizar lectores de tarjetas inteligentes conectados a sus ordenadores locales y a sus tarjetas inteligentes durante las sesiones de streaming de WorkSpaces aplicaciones sin necesidad de redireccionamiento USB. Durante WorkSpaces las sesiones de streaming de aplicaciones, los lectores de tarjetas inteligentes y las tarjetas inteligentes de los usuarios permanecen accesibles para su uso con las aplicaciones locales. El cliente redirige las llamadas a la API de la tarjeta inteligente desde las aplicaciones de streaming de los usuarios a su tarjeta inteligente local. Para deshabilitar el redireccionamiento de tarjetas inteligentes, establezca el valor de la clave de registro `SmartCardRedirectionDisabled` en `true`. Puede crear esta clave de registro HKLM al instalar el cliente de WorkSpaces aplicaciones.
Si el valor está establecido en`true`, los usuarios no podrán usar sus lectores de tarjetas inteligentes ni sus tarjetas inteligentes durante una sesión de streaming de WorkSpaces aplicaciones sin una redirección USB. En este caso, los usuarios no pueden iniciar sesión en sus aplicaciones de streaming con una tarjeta inteligente conectada a su equipo local, a menos que [cualifique el dispositivo](qualify-usb-devices.md). Una vez que califique el dispositivo, los usuarios deberán [compartirlo con WorkSpaces las aplicaciones.](client-application-windows-how-to-share-usb-devices-user.md) Cuando la redirección de tarjetas inteligentes está deshabilitada, durante las sesiones de streaming de WorkSpaces aplicaciones de los usuarios, sus lectores de tarjetas inteligentes y sus tarjetas inteligentes no son accesibles para su uso con aplicaciones locales.
Tras instalar el cliente de WorkSpaces aplicaciones, puede ejecutar el siguiente PowerShell script para crear esta clave de registro. O bien, puede usar la plantilla administrativa que se incluye en la herramienta de implementación empresarial del cliente de WorkSpaces aplicaciones para configurar el cliente mediante una política de grupo.
**nota**
Para ejecutar este script, debe haber iniciado sesión en el equipo correspondiente con permisos de administrador. También puede ejecutar el script de forma remota en la cuenta del sistema durante el inicio.
```
$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
```
## Configure las opciones de cliente de WorkSpaces aplicaciones adicionales para sus usuarios
El cliente de WorkSpaces aplicaciones utiliza las claves de registro para configurar los siguientes ajustes adicionales del cliente:
+ WorkSpaces Aceptación del acuerdo de licencia de usuario final (EULA) del cliente de aplicaciones
+ WorkSpaces Se acepta la versión del EULA del cliente de aplicaciones
+ Carga automática del registro de diagnóstico para el cliente de aplicaciones WorkSpaces
+ Actualizaciones automáticas del controlador USB que se utiliza para pasar los controladores USB a las aplicaciones WorkSpaces
+ Habilitar la renderización por hardware en el cliente de WorkSpaces aplicaciones
+ Configurar rutas de carpetas personalizadas para la redirección del sistema de archivos en el cliente de WorkSpaces aplicaciones
+ Abrir la URL del proveedor de identidades (IdP) en el navegador predeterminado del sistema
+ Añadir un indicador para proporcionar información visual en tiempo real sobre la pérdida de datos de streaming
En la siguiente tabla se resumen los valores de registro de las configuraciones de cliente adicionales que puede utilizar para personalizar la experiencia de cliente de WorkSpaces las aplicaciones para sus usuarios.
**nota**
Estos valores distinguen entre mayúsculas y minúsculas.
| Valor | Ruta de registro | Tipo | Description (Descripción) | Datos |
| --- | --- | --- | --- | --- |
| EULAAccepted | HKCU\$1Software\$1Amazon\$1Appstream Client | Cadena | Establezca este valor true para aceptar el EULA del cliente de WorkSpaces aplicaciones en nombre de sus usuarios. | true/false |
| AcceptedEULAVersion | HKCU\$1Software\$1Amazon\$1Appstream Client | Cadena | Versión del CLUF aceptada. Si la versión actual del EULA del cliente de WorkSpaces aplicaciones es diferente de la versión del CLUF que se acepta, se pide a los usuarios que acepten la versión actual del CLUF. | 1.0 |
| DiagnosticInfoCollectionAllowed | HKCU\$1Software\$1Amazon\$1Appstream Client | Cadena | Establezca este valor true para permitir que WorkSpaces las aplicaciones envíen automáticamente los registros de diagnóstico desde el cliente de WorkSpaces WorkSpaces Aplicaciones a Applications ().AWS | true/false |
| USBDriverOptIn | HKCU\$1Software\$1Amazon\$1Appstream Client | Cadena | Establezca este valor true para permitir que WorkSpaces las aplicaciones actualicen automáticamente el controlador USB que se utiliza para pasar los controladores USB a WorkSpaces las aplicaciones. | true/false |
| HardwareRenderingEnabled | HKCU\$1Software\$1Amazon\$1Appstream Client | Cadena | Establezca este valor en true para habilitar la renderización por hardware en el cliente de WorkSpaces aplicaciones. | true/false |
| FileRedirectionCustomDefaultFolders | HKCU\$1Software\$1Amazon\$1Appstream Client | Cadena | Establezca este valor para incluir al menos una ruta de carpeta para el redireccionamiento del sistema de archivos. Separe varias rutas de carpeta con "\$1". De manera predeterminada, se especifican las siguientes rutas de carpeta: %USERPROFILE%\$1Desktop\$1%USERPROFILE%\$1Documents\$1%USERPROFILE%\$1Downloads | Valid folder path |
| OpenIdpUrlInSystemBrowser | HKCU\$1Software\$1Amazon\$1Appstream Client | Cadena | Establezca este valor en true para permitir que el cliente de WorkSpaces aplicaciones abra la URL del IdP en un navegador predeterminado del sistema. Esta característica es compatible en clientes con la versión 1.1.1360 y posteriores. | true/false |
| DataLossIndicator | HKCU\$1Software\$1Amazon\$1Appstream Client | Cadena | Establezca este valor en SHOW\$1ON\$1LOSSY para incluir un indicador de advertencia rojo cuando se produzcan pérdidas de datos de streaming. Establezca este valor en SHOW\$1ON\$1LOSSLESS para incluir un indicador verde en buen estado cuando no se pierdan datos de streaming. | DISABLED/SHOW\$1ON\$1LOSSY/SHOW\$1ON\$1LOSSLESS |
Una vez instalado el cliente de WorkSpaces aplicaciones, puede ejecutar el siguiente PowerShell script para crear estas claves de registro. Si no desea crear todas las claves de registro, modifique los scripts según sea necesario para crear solo las claves de registro que desee. O bien, puede usar la plantilla administrativa que se proporciona en la herramienta de implementación empresarial del cliente de WorkSpaces aplicaciones para configurar el cliente mediante una política de grupo.
**nota**
Debe definir las siguientes entradas para cada usuario.
```
$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
```
## Uso de la política de grupo para personalizar la experiencia del cliente de WorkSpaces las aplicaciones
Puede utilizar la plantilla administrativa que se proporciona en la herramienta de implementación empresarial del cliente de WorkSpaces aplicaciones para configurar el cliente mediante una política de grupo. Para obtener información acerca de cómo cargar las plantillas administrativas en la consola de administración de políticas de grupo, consulte [Recomendaciones para administrar los archivos de plantilla administrativa (.adm) de directiva de grupo](https://support.microsoft.com/en-us/help/816662/recommendations-for-managing-group-policy-administrative-template-adm) en la documentación de Soporte técnico de Microsoft.
# Actualice manualmente la herramienta de implementación empresarial de WorkSpaces aplicaciones, el cliente y el controlador USB
De forma predeterminada, el cliente de WorkSpaces aplicaciones y el controlador USB se actualizan automáticamente cuando se publica una nueva versión del cliente. Sin embargo, si ha utilizado la herramienta de despliegue empresarial para instalar el cliente de WorkSpaces aplicaciones para sus usuarios y ha desactivado las actualizaciones automáticas, debe actualizar la herramienta de despliegue empresarial de WorkSpaces aplicaciones, el cliente y el controlador USB de forma manual. Para ello, lleve a cabo los siguientes pasos para ejecutar los PowerShell comandos necesarios en los ordenadores de los usuarios.
**nota**
Para ejecutar estos comandos, debe haber iniciado sesión en el equipo correspondiente como administrador o puede ejecutar el script de manera remota en la cuenta SYSTEM durante el inicio.
No se admite el uso de la herramienta de implementación empresarial para administrar las WorkSpaces aplicaciones en el cliente macOS.
1. Desinstale la herramienta de implementación empresarial de WorkSpaces aplicaciones de forma silenciosa:
```
Start-Process msiexec.exe -Wait -ArgumentList '/x AmazonAppStreamClientSetup_.msi /quiet'
```
1. Desinstale el controlador USB WorkSpaces de las aplicaciones de forma silenciosa:
```
Start-Process -Wait AmazonAppStreamUsbDriverSetup_.exe -ArgumentList '/uninstall /quiet /norestart'
```
1. Desinstale el cliente de WorkSpaces aplicaciones de forma silenciosa:
```
Start-Process "$env:LocalAppData\AppStreamClient\Update.exe" -ArgumentList '--uninstall'
```
**nota**
Este proceso también elimina las claves de registro que se utilizan para configurar el cliente de WorkSpaces aplicaciones. Tras volver a instalar el cliente de WorkSpaces aplicaciones, debe volver a crear estas claves.
1. Limpie el directorio de instalación de la aplicación:
```
Remove-Item -Path $env:LocalAppData\AppStreamClient -Recurse -Confirm:$false –Force
```
1. Reinicie el equipo:
```
Restart-computer
```
1. Instale la última versión de la herramienta de implementación empresarial de WorkSpaces aplicaciones de forma silenciosa:
```
Start-Process msiexec.exe -Wait -ArgumentList '/i AmazonAppStreamClientSetup_.msi /quiet'
```
1. Instale la última versión del controlador USB de las WorkSpaces aplicaciones de forma silenciosa:
```
Start-Process AmazonAppStreamUsbDriverSetup_.exe -Wait -ArgumentList '/quiet'
```
# Cualificación de dispositivos USB para utilizarlos con aplicaciones de streaming
Existen dos métodos para especificar qué dispositivos USB pueden redirigir los usuarios a sus instancias de streaming de WorkSpaces aplicaciones:
**nota**
Actualmente, la redirección USB solo se admite en las instancias de streaming de WorkSpaces aplicaciones de Windows. No se admite en el cliente para macOS.
+ Puede crear las cadenas de filtro de dispositivos USB en el archivo de configuración guardado en una imagen. Este método solo se puede usar con flotas de funcionamiento continuo y bajo demanda.
+ Puede especificar cadenas de filtros de dispositivos USB al crear la flota, ya sea con la consola AWS de administración o con la `CreateFleet` API. Para obtener información detallada sobre estas cadenas, consulte la sección a continuación. Este método solo se puede usar con flotas elásticas.
Puede crear un archivo en la imagen de la WorkSpaces aplicación que especifique qué dispositivos USB puede poner a disposición un usuario para sus aplicaciones de streaming. Para cualificar los dispositivos USB de los usuarios para que puedan utilizarse con aplicaciones de streaming, siga estos pasos.
**nota**
Por motivos de seguridad, solo cualifique los dispositivos USB de fuentes de confianza aprobadas. Cualificar todos los dispositivos genéricos o clases de dispositivos podría permitir el uso de dispositivos no aprobados con sus aplicaciones de streaming.
1. Si aún no lo ha hecho, instale el cliente de WorkSpaces aplicaciones. Para obtener información, consulte [Instale y configure el cliente de aplicaciones WorkSpaces](install-configure-client.md).
1. Conecte el dispositivo USB que desea cualificar a su equipo.
1. Vaya a **C:\$1Users\$1 < logged-in-user >\$1\$1 LocalAppData\$1** y AppStreamClient haga doble clic en **dcvusblist.exe**.
1. En el cuadro de diálogo **DCV - USB devices (DCV - dispositivos USB)**, se muestra una lista con los dispositivos USB conectados al equipo local. La columna **Filter (Filtro)** muestra la cadena de filtro de cada dispositivo USB. Haga clic con el botón derecho en la entrada de lista de un dispositivo USB que desee habilitar y seleccione **Copy filter string (Copiar cadena de filtro)**.
1. En el escritorio, haga clic en el botón **Inicio** de Windows y busque el Bloc de notas. Haga doble clic en **Notepad (Bloc de notas)** para abrir un nuevo archivo, copie la cadena de filtro y guárdelo. Más adelante, utilizará esta cadena de filtro para cualificar el dispositivo USB.
1. Lance un nuevo constructor de imágenes. Para obtener más información, consulte [Lanzar un generador de imágenes para instalar y configurar aplicaciones de streaming](tutorial-image-builder-create.md).
1. Cuando el generador de imágenes esté en estado En **ejecución**, lleve a cabo los siguientes pasos para crear una URL de transmisión y conectarse al generador de imágenes mediante el cliente de WorkSpaces aplicaciones.
1. Con el constructor de imágenes seleccionado en la lista, seleccione **Actions (Acciones)** y **Create streaming URL (Crear URL de streaming)**.
1. En el cuadro de diálogo **Create streaming URL (Crear URL de streaming)**, elija **Copy link (Copiar enlace)** y copie y pegue la dirección web en un archivo independiente para utilizarla más adelante. Utilizará esta URL para volver a conectarse al constructor de imágenes en el paso 12.
1. Elija **Launch in Client (Lanzar en el cliente)**.
1. Si se abre el cuadro de diálogo **Iniciar aplicación** y le pide que elija la aplicación que desea utilizar al abrir el enlace, elija **Amazon AppStream**, **Abrir enlace**. Para evitar que este cuadro de diálogo se muestre la próxima vez que realice este paso para conectarse al constructor de imágenes, seleccione la casilla de verificación **Remember my choice for amazonappstream links (Recordar mi elección para los enlaces de amazonappstream)**.
1. Si el cliente de WorkSpaces aplicaciones muestra enlaces al Acuerdo con el AWS cliente, las condiciones de AWS servicio y el Aviso de AWS privacidad, así como a avisos de terceros, revise esta información y, a continuación, seleccione **Finalizar.**
1. Si aparece la página de inicio de sesión del cliente, el campo de dirección web se rellena previamente con la URL de streaming. Elija **Conectar**.
1. Si se le solicita, inicie sesión en el constructor de imágenes como administrador.
1. Después de conectarse al constructor de imágenes, si el dispositivo USB necesita que instale los controladores antes de utilizarlo, descargue e instale los controladores en el constructor de imágenes. Por ejemplo, si utiliza el ratón Connexion 3D, deberá descargar e instalar los controladores Connexion que correspondan del constructor de imágenes.
1. En el escritorio del constructor de imágenes, haga clic en el botón **Inicio** de Windows y busque el Bloc de notas. Haga clic con el botón derecho en **Bloc de notas** y seleccione **Ejecutar como administrador**.
1. Elija **Archivo**, **Abrir** y abra el siguiente archivo: `C:\ProgramData\Amazon\Photon\DCV\usb_device_allowlist.txt`. También puede permitir una categoría completa de dispositivos o todos los dispositivos de un fabricante específico mediante las expresiones comodín del archivo `usb_device_allowlist.txt`.
1. Copie la cadena de filtro del equipo local en el generador de imágenes. **La cadena de filtro para un dispositivo USB específico es una cadena separada por comas de los siguientes campos: **Nombre**, **Clase base**, **Protocolo**, ID del **proveedor **SubClass**, ID** **del producto**, **Support Autoshare** y Skip Reset.** Para obtener información detallada sobre estas cadenas, consulte [Trabajo con cadenas de filtro de dispositivos USB](USB-device-filter-strings.md).
1. Desconéctese del generador de imágenes, reinícielo y vuelva a conectarse a él mediante el cliente de aplicaciones. WorkSpaces Para ello, abra el cliente de WorkSpaces aplicaciones y pegue la URL de streaming que creó en el paso 7 en el campo de dirección web de inicio de sesión del cliente y, a continuación, seleccione **Connect**.
1. En el constructor de imágenes, pruebe el dispositivo USB para confirmar que funciona según lo previsto.
1. Antes de que los usuarios puedan usar el dispositivo USB en una sesión de WorkSpaces Aplicaciones, primero deben compartir el dispositivo con su sesión. Para obtener directrices que puede proporcionar a los usuarios para ayudarles a realizar esta tarea, consulte [Dispositivos USB](client-application-windows-how-to-share-usb-devices-user.md).
1. Si el dispositivo USB funciona con el constructor de imágenes tal y como se esperaba, cree una imagen. Para obtener más información, consulte [Tutorial: Crear una imagen de WorkSpaces aplicaciones personalizada mediante la consola de WorkSpaces aplicaciones](tutorial-image-builder.md).
1. Cuando termine de crear la imagen, actualice su flota de WorkSpaces aplicaciones para usar la nueva imagen.
# Trabajo con cadenas de filtro de dispositivos USB
En esta sección se describen las cadenas de filtros que están disponibles para los dispositivos USB aptos para WorkSpaces las sesiones de streaming de aplicaciones. También proporciona asesoramiento para trabajar con estas cadenas. Están disponibles las siguientes cadenas de filtro:
+ `Name`: de forma predeterminada, el valor de esta cadena de filtro es el nombre del dispositivo, pero puede especificar su propio valor.
+ `Base Class,SubClass,Protocol`: el código de clase USB del dispositivo. Para obtener más información, consulte el artículo sobre [códigos de clase definidos](https://www.usb.org/defined-class-codes).
+ `ID Vendor (VID)`: un identificador único asignado por la organización USB al fabricante del dispositivo USB.
+ `ID Product (PID)`: un identificador único asignado por el fabricante al dispositivo USB.
+ `Support Autoshare`— Permite que el cliente de WorkSpaces aplicaciones comparta automáticamente el dispositivo cuando se inicia una sesión de streaming. Establezca este valor en `1` para permitir el uso compartido automático de dispositivos. Establezca este valor en `0` para no permitir el uso compartido automático de dispositivos.
+ `Skip Reset`— De forma predeterminada, cuando WorkSpaces las aplicaciones comparten un dispositivo USB con una sesión de streaming, el dispositivo se restablece para garantizar que funciona correctamente. Sin embargo, algunos dispositivos USB no funcionan correctamente durante la sesión de streaming si se han restablecido. Para evitar que se produzca este problema, defina el valor de esta cadena de filtro `1` para indicar al cliente de WorkSpaces aplicaciones que no reinicie el dispositivo mientras esté compartido con una sesión de streaming. Para asegurarse de que el dispositivo se restablezca mientras se comparte con una sesión de streaming, establezca este valor en `0`. Cuando establezca un valor para `Skip Reset`, asegúrese de establecer el valor `Support Autoshare` en `0` o `1`.
La cadena de filtro que se copia desde el equipo local es específica de un dispositivo USB. En algunos casos, es posible que desee permitir una clase de dispositivos completa en lugar de permitir todos los dispositivos USB posibles. Por ejemplo, es posible que desee permitir a los usuarios utilizar cualquier tipo de tableta de diseño Wacom o cualquier dispositivo de almacenamiento masivo USB. En tales casos, puede indicar caracteres comodín en determinados campos de las cadenas de filtro. Si no conoce el VID y el PID de sus dispositivos USB, puede buscar esta información en la [base de datos de identificadores USB](https://www.the-sz.com/products/usbid/index.php).
En los siguientes ejemplos se muestra cómo configurar cadenas de filtro para el uso compartido de dispositivos USB durante las sesiones de streaming:
+ Permitir automáticamente todos los dispositivos de almacenamiento masivo al iniciar una sesión de streaming: "Mass storage, 8, \$1, \$1, \$1, \$1,1,0"
+ Permitir automáticamente todos los dispositivos Wacom al iniciar una sesión de streaming: "Wacom Tablets, 3, \$1, \$1, 1386, \$1,1,0"
+ Permitir todos los dispositivos que proporcionan una interfaz de audio: "Audio, 1, \$1, \$1, \$1, \$1,1,0"
+ Permitir el dispositivo X pero no restablecerlo mientras el dispositivo se está compartiendo. No compartir el dispositivo automáticamente al iniciar una sesión de streaming: "X, Y, \$1, \$1, 1386, \$1,0,1"
# Configure un método de conexión para los usuarios del cliente de sus WorkSpaces aplicaciones
Tras instalar el cliente de WorkSpaces aplicaciones en los ordenadores locales de los usuarios, estos pueden utilizar el cliente de WorkSpaces aplicaciones para conectarse a una sesión de streaming. Según los requisitos de su organización, puede proporcionar a los usuarios del cliente acceso a WorkSpaces las aplicaciones mediante una de las siguientes acciones: configurar la federación de identidades mediante SAML 2.0, utilizar un grupo de usuarios de WorkSpaces aplicaciones o crear una URL de transmisión.
**Topics**
+ [SAML 2.0](use-client-start-streaming-session-SAML.md)
+ [WorkSpaces Grupo de usuarios de aplicaciones](use-client-start-streaming-session-user-pool.md)
+ [URL de streaming](use-client-start-streaming-session-streaming-URL.md)
+ [Siguientes pasos](use-client-start-streaming-session-next-steps.md)
# SAML 2.0
Si utiliza proveedores de identidad externos para federar a sus usuarios en una pila de WorkSpaces aplicaciones, debe crear un valor de registro para configurar el cliente de WorkSpaces aplicaciones con una URL rellenada previamente cada vez que se inicie el cliente. La dirección URL debe utilizar un certificado que sea de confianza para el dispositivo. El certificado debe contener un nombre alternativo de asunto (SAN) que incluya el nombre de dominio de la dirección URL.
Para obtener más información, consulte lo siguiente:
+ [Configuración de SAML](external-identity-providers-setting-up-saml.md)
+ [Establezca el valor WorkSpaces de registro StarTurl para los usuarios del cliente de aplicaciones](install-client-configure-settings.md#set-start-url-registry-value)
# WorkSpaces Grupo de usuarios de aplicaciones
Cuando crea un nuevo usuario en el grupo de usuarios de WorkSpaces aplicaciones o asigna un usuario del grupo de usuarios a una pila de WorkSpaces WorkSpaces aplicaciones, Applications envía correos electrónicos a los usuarios en su nombre. Los usuarios escriben la URL que se les proporcionó en el correo electrónico de bienvenida, ingresan sus credenciales y, a continuación, eligen **Conectar**.
Para obtener más información, consulte [Grupos de usuarios WorkSpaces de Amazon Applications](user-pool.md).
# URL de streaming
Para crear una URL de streaming, utilice uno de los métodos siguientes:
+ WorkSpaces Consola de aplicaciones
+ La acción [CreateStreamingde la API URL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html)
+ El comando [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html) AWS CLI
Para crear una URL de transmisión mediante la consola de WorkSpaces aplicaciones, complete los pasos del siguiente procedimiento.
**Para crear una URL de streaming mediante la consola de WorkSpaces Aplicaciones**
1. Abre la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. En el panel de navegación, seleccione **Flotas**.
1. En la lista de flotas, elija la flota asociada a la pila para la que desee crear una URL de streaming. Compruebe que el estado de la flota sea **En ejecución**.
1. En el panel de navegación, seleccione **Pilas**. Elija la pila y haga clic en **Acciones** y en **Crear URL de streaming**.
1. En **ID de usuario**, ingrese el ID de usuario.
1. En **Vencimiento de la URL**, elija la hora de vencimiento, lo que determinará durante cuánto tiempo será válida la URL generada. Esta URL es válida durante un máximo de siete días.
1. Elija **Obtener URL**.
1. Copie la URL, guárdela en una ubicación de fácil acceso y, a continuación, facilítesela a sus usuarios.
En la página de inicio de sesión del cliente de WorkSpaces aplicaciones, los usuarios introducen la URL de streaming que creaste como dirección web y, a continuación, eligen **Connect**.
# Siguientes pasos
Tras configurar un método de conexión de cliente, puede proporcionar a sus usuarios las siguientes step-by-step instrucciones para ayudarlos a conectarse a WorkSpaces las aplicaciones e iniciar una sesión de streaming: [Conectarse a WorkSpaces aplicaciones en un cliente de Windows](client-application-windows-start-streaming-session-user.md) o[Conectarse a WorkSpaces las aplicaciones en el cliente macOS](client-application-mac-start-streaming-session-user.md).
# Permita que los usuarios compartan un dispositivo USB con una sesión de streaming de WorkSpaces aplicaciones
Antes de que los usuarios compartan sus dispositivos USB con una sesión de WorkSpaces aplicaciones, los dispositivos USB deben cumplir los requisitos. De lo contrario, cuando los usuarios inicien una sesión de streaming, WorkSpaces las aplicaciones no detectarán su dispositivo USB y no podrán compartirlo con la sesión. Para obtener más información, consulte [Cualificación de dispositivos USB para utilizarlos con aplicaciones de streaming](qualify-usb-devices.md).
**nota**
El cliente macOS no admite compartir un dispositivo USB con una sesión de streaming de WorkSpaces aplicaciones.
# Redireccione una sesión de streaming desde el navegador web al cliente de WorkSpaces aplicaciones
Puede configurar WorkSpaces las aplicaciones para que redirijan una sesión de streaming desde un navegador web al cliente de WorkSpaces aplicaciones. De esta forma, cuando los usuarios inicien sesión en WorkSpaces Applications e inicien una sesión de streaming en su navegador web, su sesión se redirige al cliente de WorkSpaces Applications. Para ello, siga estos pasos.
1. Usa la acción de la `CreateStreamingURL` API de WorkSpaces aplicaciones para generar una URL de streaming.
1. Agregue el siguiente prefijo para el controlador de cliente de WorkSpaces aplicaciones personalizado a la URL de transmisión: **amazonappstream:**
Juntos, el prefijo y la URL de streaming tienen el formato siguiente:
**amazonappstream:***base64encoded(streamingURL)*
**nota**
Cuando codifique la URL, asegúrese de seleccionar UTF-8.
Ejemplo de Powershell para codificar: `[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes("Streaming/IdpURL"))`
1. Cuando se redirige a los usuarios a la URL de transmisión, su navegador detecta que el cliente de WorkSpaces aplicaciones debe abrir el enlace.
1. Se pide a los usuarios que elijan si desean iniciar la sesión de streaming mediante el cliente de WorkSpaces aplicaciones.
1. Después de aparecer el mensaje, puede suceder una de estas dos cosas:
+ Si el cliente de WorkSpaces Aplicaciones está instalado, el usuario puede optar por continuar la sesión de streaming mediante el cliente de WorkSpaces Aplicaciones.
+ Si el cliente de WorkSpaces aplicaciones no está instalado, el comportamiento del navegador varía de la siguiente manera:
+ Chrome: no se muestra ningún mensaje.
+ Firefox: un mensaje indica que el usuario necesita una nueva aplicación para abrir Amazon AppStream.
+ Microsoft Edge: no se muestra ningún mensaje.
+ Internet Explorer: un mensaje notifica al usuario que el cliente de WorkSpaces aplicaciones no está instalado.
En este caso, los usuarios pueden seleccionar el enlace **Descargar el AppStream cliente** para descargar el cliente. Los usuarios pueden descargar el cliente, instalarlo y actualizar el navegador para comenzar la sesión de streaming utilizando el cliente.
## Creación de un acceso directo en el escritorio de Windows con el navegador predeterminado
Para crear un acceso directo en el escritorio de Windows utilizando el navegador predeterminado para iniciar el cliente, utilice el siguiente script de Powershell de ejemplo.
```
$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
```
# Habilite la redirección del sistema de archivos para los usuarios de sus WorkSpaces aplicaciones
WorkSpaces La redirección del sistema de archivos de las aplicaciones permite a los usuarios que tienen el cliente de WorkSpaces aplicaciones instalado acceder a los archivos de su ordenador local desde su sesión de streaming. Al habilitar el redireccionamiento del sistema de archivos, puede especificar la lista de unidades y carpetas locales a las que los usuarios pueden acceder. Cuando los usuarios inician sesión en WorkSpaces Aplicaciones e inician una sesión de streaming, pueden elegir de la lista la unidad o carpeta a la que quieren acceder. A continuación, pueden compartir la unidad o la carpeta con WorkSpaces Aplicaciones. La unidad o carpeta permanece disponible para que puedan acceder durante sus sesiones de streaming. Los usuarios pueden dejar de compartir sus unidades o carpetas locales en cualquier momento.
**nota**
Actualmente no se admite el redireccionamiento del sistema de archivos para instancias de flota basadas en Linux o cuando se utiliza el cliente para macOS.
**Topics**
+ [Requisitos previos para el redireccionamiento del sistema de archivos](file-system-redirection-prerequisites.md)
+ [Cómo habilitar el redireccionamiento del sistema de archivos](how-to-enable-file-system-redirection.md)
+ [Poner las unidades y carpetas predeterminadas a disposición de los usuarios para que las compartan](prepopulate-drives-folders-system-redirection.md)
+ [Proporcione a los usuarios de sus WorkSpaces aplicaciones instrucciones para trabajar con la redirección del sistema de archivos](end-user-guidance-file-system-redirection.md)
# Requisitos previos para el redireccionamiento del sistema de archivos
Para habilitar la redirección de archivos de WorkSpaces aplicaciones:
+ Debe utilizar una imagen que utilice una versión del agente de WorkSpaces aplicaciones publicada a partir del 8 de agosto de 2019. Para obtener más información, consulte [WorkSpaces Notas de lanzamiento de Applications Agent](agent-software-versions.md).
+ Los usuarios deben tener instalada la versión 1.0.480 o posterior del cliente de WorkSpaces aplicaciones. Para obtener más información, consulte [WorkSpaces Aplicaciones: Windows Client: notas de versión](client-release-versions.md).
+ La carga y descarga de archivos deben estar habilitadas en la pila a la que accedan los usuarios para las sesiones de streaming. Consulte el procedimiento siguiente.
# Cómo habilitar el redireccionamiento del sistema de archivos
Siga los siguientes pasos para habilitar tanto la carga como la descarga de archivos en la pila a la que accedan los usuarios para las sesiones de streaming.
1. Abra la consola WorkSpaces de aplicaciones en [https://console.aws.amazon.com/appstream2/casa.](https://console.aws.amazon.com/appstream2/home)
1. En el panel de navegación izquierdo, elija **Pilas**.
1. Elija la pila para la que desea habilitar el redireccionamiento del sistema de archivos.
1. Elija la pestaña **User Settings (Configuración de usuario)** y, a continuación, expanda la sección **Clipboard, file transfer, and local print permissions (Portapapeles, transferencia de archivos y permisos de impresión local)**.
1. En **File transfer (Transferencia de archivos)**, compruebe que está seleccionada la opción **Upload y download (Cargar y descargar)**. De lo contrario, elija **Edit (Editar)** y, a continuación, elija **Upload and download (Carga y descarga)**.
1. Elija **Actualizar**.
# Poner las unidades y carpetas predeterminadas a disposición de los usuarios para que las compartan
De forma predeterminada, al habilitar el direccionamiento de archivos para los usuarios de una pila, las siguientes unidades y carpetas están disponibles para que dichos usuarios las compartan en su sesión de streaming:
+ Unidades:
+ Todos los discos duros locales (unidades físicas, como la unidad C y la unidad D)
+ Todas las unidades virtuales (unidades virtuales y de red, como las letras de unidad mapeadas, Google Drive y OneDrive)
+ Todas las unidades USB locales
+ Carpetas:
+ %USERPROFILE%\$1Desktop
+ %USERPROFILE%\$1Documents
+ %USERPROFILE%\$1Downloads
Estas rutas de unidades y carpetas rellenan previamente el cuadro de diálogo **Share your local drives and folders (Compartir las unidades y carpetas locales)**. Este cuadro de diálogo se muestra cuando los usuarios inician sesión en WorkSpaces las aplicaciones, inician una sesión de streaming y eligen **Configuración**, **Recursos locales** y **Unidades y carpetas locales**.
Puede cambiar o definir sus propias rutas predeterminadas de unidades y carpetas editando el registro. También puede utilizar el archivo de plantilla administrativa que se proporciona en la herramienta de implementación empresarial del cliente de WorkSpaces aplicaciones. Esta plantilla le permite configurar el cliente a través de la política de grupo. Para obtener más información, consulte [Instale y configure el cliente de aplicaciones WorkSpaces](install-configure-client.md).
Cuando los usuarios acceden a sus unidades y carpetas locales compartidas durante una sesión de streaming, las rutas correspondientes aparecen con las barras diagonales invertidas sustituidas por guiones bajos. También presentan un sufijo con el nombre del equipo local y una letra de unidad. Por ejemplo, para un usuario con el nombre de usuario janedoe y el nombre de equipo ExampleCorp -123456, las rutas predeterminadas de las carpetas Escritorio, Documentos y Descargas son las siguientes:
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
# Proporcione a los usuarios de sus WorkSpaces aplicaciones instrucciones para trabajar con la redirección del sistema de archivos
Para ayudar a los usuarios a comprender cómo utilizar el redireccionamiento de archivos durante las sesiones de streaming, puede proporcionarles la información en [Acceso a archivos locales](client-application-windows-file-system-redirection.md).
# Habilite la redirección de impresoras locales para los usuarios de sus aplicaciones WorkSpaces
Con la redirección de impresoras local, los usuarios de sus WorkSpaces aplicaciones pueden redirigir los trabajos de impresión desde su aplicación de streaming a una impresora que esté conectada a su ordenador local, incluida cualquier impresora de red que los usuarios hayan mapeado. No es necesario instalar un controlador de impresora en la instancia de streaming de WorkSpaces Applications para que los usuarios puedan imprimir documentos durante sus sesiones de streaming.
**nota**
Actualmente, las pilas basadas en Linux no admiten el redireccionamiento a impresoras locales.
**Topics**
+ [Requisitos previos para el redireccionamiento a impresoras locales](local-printer-redirection-prerequisites.md)
+ [Cómo habilitar el redireccionamiento a una impresora local](how-to-enable-disable-local-printer-redirection.md)
+ [Cómo deshabilitar el redireccionamiento a una impresora local](disable-local-printer-redirection.md)
# Requisitos previos para el redireccionamiento a impresoras locales
Para garantizar que los usuarios puedan utilizar el redireccionamiento a impresoras locales, debe:
+ Utilice una imagen que utilice una versión del agente de WorkSpaces aplicaciones publicada a partir del 30 de julio de 2020. Para obtener más información, consulte [WorkSpaces Notas de lanzamiento de Applications Agent](agent-software-versions.md).
+ Asegúrese de que sus usuarios tengan instalada la versión 1.1.179 o posterior del cliente de WorkSpaces aplicaciones. Para obtener más información, consulte [WorkSpaces Aplicaciones: Windows Client: notas de versión](client-release-versions.md).
+ Asegúrese de que el redireccionamiento a impresoras esté habilitado en la pila a la que acceden los usuarios para las sesiones de streaming.
# Cómo habilitar el redireccionamiento a una impresora local
De forma predeterminada, la redirección de impresoras locales está habilitada cuando se instala el cliente de WorkSpaces aplicaciones. Sin embargo, si la redirección de impresoras locales no está habilitada en la pila a la que acceden los usuarios para las sesiones de streaming, puede habilitarla en la consola de WorkSpaces aplicaciones siguiendo estos pasos.
**Para habilitar el redireccionamiento de impresoras locales mediante la consola de Aplicaciones WorkSpaces**
1. Abra la consola WorkSpaces de aplicaciones en [https://console.aws.amazon.com/appstream2/casa.](https://console.aws.amazon.com/appstream2/home)
1. En el panel de navegación izquierdo, elija **Pilas**.
1. Elija la pila para la que desea habilitar el redireccionamiento a impresoras locales.
1. Elija la pestaña **Configuración de usuario** y, a continuación, expanda la sección **Portapapeles, transferencia de archivos y permisos de impresión local**.
1. En **Imprimir en un dispositivo local**, compruebe que esté seleccionada la opción **Habilitado**. Si no es así, elija **Editar** y, a continuación, elija **Habilitar**.
1. Elija **Actualizar**.
Como alternativa, puede habilitar la redirección de impresoras locales mediante la API de WorkSpaces aplicaciones, un AWS SDK o el AWS Command Line Interface (AWS CLI).
# Cómo deshabilitar el redireccionamiento a una impresora local
Para deshabilitar el redireccionamiento a una impresora local, siga estos pasos.
**Para deshabilitar el redireccionamiento a impresoras locales**
Para deshabilitar el redireccionamiento a impresoras locales, use cualquiera de las siguientes formas:
+ Durante la instalación del cliente en los dispositivos administrados. Para obtener más información, consulte [Seleccionar si se desea deshabilitar el redireccionamiento a impresoras locales](install-client-configure-settings.md#disable-local-printer-redirection-client).
+ Mediante la consola de WorkSpaces aplicaciones para deshabilitar esta opción en una pila de WorkSpaces aplicaciones.
+ Mediante la API de WorkSpaces aplicaciones, un AWS SDK o el AWS Command Line Interface (AWS CLI) para deshabilitar esta opción en una pila de WorkSpaces aplicaciones.