

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# WorkSpaces Installa e configura il client delle applicazioni
<a name="install-configure-client"></a>

È possibile fare in modo che gli utenti installino il client WorkSpaces Applicazioni da soli oppure è possibile installare il client WorkSpaces Applicazioni per loro eseguendo PowerShell gli script in remoto.

Devi qualificare i dispositivi USB che vuoi abilitare per gli utenti che li usano con la sessione di streaming. Se il loro dispositivo USB non è qualificato, non verrà rilevato dalle WorkSpaces Applicazioni e non potrà essere condiviso con la sessione.

I seguenti argomenti descrivono come installare e configurare il client WorkSpaces Applications.

**Topics**
+ [Chiedi agli utenti di installare autonomamente il client WorkSpaces delle applicazioni](user-install-client.md)
+ [Tutorial: installa il client Amazon WorkSpaces Applications e personalizza l'esperienza del cliente per i tuoi utenti](install-client-configure-settings.md)
+ [Aggiorna manualmente l' WorkSpaces Applications Enterprise Deployment Tool, il client e il driver USB](update-enterprise-deployment-tool-client-usb-driver-manually.md)
+ [Qualificare i dispositivi USB affinché possano essere utilizzati con le applicazioni in streaming](qualify-usb-devices.md)
+ [Configura un metodo di connessione per gli utenti del client WorkSpaces delle applicazioni](use-client-start-streaming-session.md)
+ [Consenti agli utenti di condividere un dispositivo USB con una sessione di streaming di WorkSpaces applicazioni](share-usb-devices-with-session.md)
+ [Reindirizza una sessione di streaming dal browser Web al client delle applicazioni WorkSpaces](redirect-streaming-session-from-web-to-client.md)
+ [Abilita il reindirizzamento del file system per gli utenti delle applicazioni WorkSpaces](enable-file-system-redirection.md)
+ [Abilita il reindirizzamento della stampante locale per gli utenti delle applicazioni WorkSpaces](enable-local-printer-redirection.md)

# Chiedi agli utenti di installare autonomamente il client WorkSpaces delle applicazioni
<a name="user-install-client"></a>

Per step-by-step informazioni che puoi fornire agli utenti per aiutarli a installare il client WorkSpaces Applications, consulta [Configurazione per Windows](client-application-windows-installation-user.md) o[Configurazione e installazione per macOS](client-application-mac-installation-user.md). 

**Importante**  
Per il client Windows, se l'organizzazione ha distribuito un software antivirus che impedisce agli utenti di eseguire file con estensione exe, è necessario aggiungere un'eccezione per consentire agli utenti di eseguire il programma di installazione del client WorkSpaces Applications (.exe). In caso contrario, quando gli utenti cercano di installare il client, non accade nulla oppure viene visualizzato un errore dopo l'avvio del programma di installazione. 

Dopo che gli utenti hanno installato il client, se si prevede di consentire agli utenti di utilizzare dispositivi USB durante le sessioni di streaming WorkSpaces delle applicazioni, è necessario soddisfare i seguenti requisiti: 
+ È necessario qualificare i dispositivi USB che possono essere utilizzati con WorkSpaces le applicazioni. Per ulteriori informazioni, consulta [Qualificare i dispositivi USB affinché possano essere utilizzati con le applicazioni in streaming](qualify-usb-devices.md).
+ Una volta qualificati i dispositivi, gli utenti devono condividerli con WorkSpaces le Applicazioni ogni volta che iniziano una nuova sessione di streaming. Per informazioni aggiuntive che puoi offrire agli utenti per completare questa attività, consulta [Dispositivi USB](client-application-windows-how-to-share-usb-devices-user.md).

# Tutorial: installa il client Amazon WorkSpaces Applications e personalizza l'esperienza del cliente per i tuoi utenti
<a name="install-client-configure-settings"></a>

Le seguenti sezioni descrivono come installare il client WorkSpaces Applications e personalizzare l'esperienza del client per gli utenti. Se si prevede di scaricare e installare il client per conto degli utenti, è necessario innanzitutto scaricare l'Enterprise Deployment Tool. È quindi possibile eseguire PowerShell script per installare il client WorkSpaces Applicazioni e configurare le impostazioni del client in remoto.

**Nota**  
L'utilizzo dell'Enterprise Deployment Tool con il client MacOS WorkSpaces Applications non è supportato. 

**Topics**
+ [Scaricare Enterprise Deployment Tool](#install-client-use-remote-deployment-tool)
+ [WorkSpaces Installa il client delle applicazioni e il driver USB](#run-powershell-script-install-client-usb-driver-silently)
+ [Accesso alle WorkSpaces applicazioni con l'Applications WorkSpaces Client](#access-appstream-with-client)
+ [Imposta il valore del registro StartUrl per gli utenti del client WorkSpaces Applications](#set-start-url-registry-value)
+ [Imposta il valore del TrustedDomains Registro di sistema per abilitare altri domini per il client Applications WorkSpaces](#set-trusted-domains-registry-value)
+ [Crea AS2 TrustedDomains il record DNS TXT per abilitare il tuo dominio per il client WorkSpaces Applications senza modifiche al registro](#create-AS2TrustedDomains-DNS-TXT-record-client)
+ [Disattivare la ricerca di record TXT DNS per domini attendibili](#disable-DNS-TXT-record-lookup-client)
+ [Scegliere se disabilitare gli aggiornamenti automatici del client](#disable-automatic-updates-client)
+ [Scegliere se disabilitare i caricamenti dei log di diagnostica on demand](#disable-on-demand-diagnostic-log-uploads)
+ [Scegliere se disabilitare la modalità di applicazione nativa](#disable-native-application-mode-client)
+ [Scegliere se disabilitare il reindirizzamento della stampante locale](#disable-local-printer-redirection-client)
+ [Scegliere se disabilitare il reindirizzamento delle smart card](#disable-local-smart-card-support-client)
+ [Configura impostazioni aggiuntive del client WorkSpaces Applications per i tuoi utenti](#configure-client)
+ [Utilizzo di Group Policy per personalizzare l'esperienza del client di WorkSpaces Applications](#configure-client-with-adm-template-group-policy)

## Scaricare Enterprise Deployment Tool
<a name="install-client-use-remote-deployment-tool"></a>

L'Enterprise Deployment Tool include i file di installazione del client WorkSpaces Applications e un modello amministrativo di Group Policy.

1. Per scaricare l'Enterprise Deployment Tool, nella parte inferiore destra della pagina [WorkSpaces Applicazioni supportate dai client](https://clients.amazonappstream.com), seleziona il link **Enterprise Deployment Tool**. Questo link apre un file.zip che contiene i file necessari per la versione più recente dello strumento.

1. Per estrarre i file richiesti, accedi alla posizione in cui hai scaricato lo strumento, fai clic con il pulsante destro del mouse sulla <version>cartella **AmazonAppStreamClientEnterpriseSetup\$1 \$1** e scegli **Estrai tutto**. La cartella contiene due programmi di installazione e un modello amministrativo di policy di gruppo:
   + WorkSpaces Applications client installer (AmazonAppStreamClientSetup\$1 <version>.msi): installa il client Applications. WorkSpaces 
   + WorkSpaces Programma di installazione del driver USB delle applicazioni (AmazonAppStreamUsbDriverSetup\$1 <version>.exe): installa il driver USB WorkSpaces delle applicazioni necessario per utilizzare i dispositivi USB con le applicazioni trasmesse tramite Applicazioni. WorkSpaces 
   + WorkSpaces Modello amministrativo Applications Client Group Policy (as2\$1client\$1config.adm): consente di configurare il client Applications tramite Group Policy. WorkSpaces 

## WorkSpaces Installa il client delle applicazioni e il driver USB
<a name="run-powershell-script-install-client-usb-driver-silently"></a>

Dopo aver scaricato i file di installazione del client WorkSpaces Applicazioni, esegui PowerShell lo script seguente sui computer degli utenti per installare automaticamente il file di installazione del client WorkSpaces Applicazioni, AppStreamClient .exe, e il driver USB. 

**Nota**  
Per eseguire questo script, è necessario essere collegati al computer applicabile con le autorizzazioni di Amministratore. È inoltre possibile eseguire lo script da remoto con l'account System (Sistema) all'avvio.

```
Start-Process msiexec.exe -Wait -ArgumentList  '/i AmazonAppStreamClientSetup_<version>.msi /quiet'

Start-Process AmazonAppStreamUsbDriverSetup_<version>.exe -Wait -ArgumentList  '/quiet'
```

Dopo aver installato Enterprise Deployment Tool sul computer di un utente, il client WorkSpaces Applications viene installato come segue:

1. Il file di installazione del client WorkSpaces Applications viene copiato nel seguente percorso sul computer dell'utente: C:\$1Program Files (x86)\$1 Amazon WorkSpaces Applications Client Installer\$1 .exe. AppStreamClient

1. La prima volta che l'utente accede al proprio computer dopo l'installazione di Enterprise Deployment Tool, viene installato il WorkSpaces client Applications.
**Nota**  
Se l'Enterprise Deployment Tool rileva che la cartella WorkSpaces Applications Client esiste già in **%localappdata%**, lo strumento non installa il client. **AppStreamClient**

Se un utente disinstalla il client WorkSpaces Applications, il client non viene installato nuovamente finché non si aggiorna l'Applications Enterprise Deployment Tool. WorkSpaces 

## Accesso alle WorkSpaces applicazioni con l'Applications WorkSpaces Client
<a name="access-appstream-with-client"></a>

Per impostazione predefinita, quando gli utenti avviano il client WorkSpaces Applicazioni, possono connettersi solo a quelli URLs che includono il dominio o i domini WorkSpaces delle Applicazioni che includono un record DNS TXT che abilita la connessione. Puoi consentire agli utenti client di accedere a domini diversi dal dominio WorkSpaces Applicazioni effettuando una delle seguenti operazioni: 
+ Imposta il valore del registro `StartURL` per specificare un URL personalizzato a cui gli utenti possono accedere, ad esempio l'URL per il portale di accesso dell'organizzazione. 
+ Imposta il valore del registro `TrustedDomains` per specificare i domini attendibili a cui gli utenti possono accedere. 
+ Crea il record TXT DNS `AS2TrustedDomains` per specificare i domini attendibili a cui gli utenti possono accedere. Questo metodo consente di evitare modifiche al registro.

**Nota**  
Il client WorkSpaces delle applicazioni e la configurazione dei record DNS TXT non impediscono agli utenti di utilizzare altri metodi di connessione per accedere ai domini o URLs quelli specificati dall'utente. Ad esempio, gli utenti possono accedere a domini specifici o URLs utilizzare un browser Web, se dispongono dell'accesso di rete ai domini o. URLs

## Imposta il valore del registro StartUrl per gli utenti del client WorkSpaces Applications
<a name="set-start-url-registry-value"></a>

È possibile utilizzare il valore del `StartUrl` registro per impostare un URL personalizzato che viene compilato nel client WorkSpaces Applications quando un utente avvia il client. Puoi creare questa chiave di registro HKLM durante l'installazione del client in modo che gli utenti non debbano specificare l'URL quando avviano il client.

Dopo aver installato il client WorkSpaces Applications, è possibile eseguire lo PowerShell script seguente per creare questa chiave di registro oppure utilizzare il modello amministrativo incluso nell'Enterprise Deployment Tool del client WorkSpaces Applications per configurare il client tramite Group Policy.

Sostituire il valore `StartUrl` con un URL del provider di identità (IdP) L'URL deve utilizzare un certificato ritenuto affidabile dal dispositivo. Ciò significa che il certificato utilizzato dalla pagina Web `StartUrl` deve contenere un Subject Alternative Name (SAN) che includa il nome di dominio dell'URL. Ad esempio, se `StartUrl` è impostato su https://appstream.example.com, il certificato SSL deve avere una SAN che includa appstream.example.com.

**Nota**  
Per eseguire questo script, è necessario essere collegati al computer applicabile con le autorizzazioni di Amministratore. È inoltre possibile eseguire lo script da remoto con l'account System (Sistema) all'avvio. 

```
$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
```

## Imposta il valore del TrustedDomains Registro di sistema per abilitare altri domini per il client Applications WorkSpaces
<a name="set-trusted-domains-registry-value"></a>

È possibile configurare il client WorkSpaces Applications a cui connettersi URLs nei domini affidabili specificati dall'utente. Ad esempio, puoi consentire agli utenti di connettersi a qualsiasi URL nel dominio dell'organizzazione o a qualsiasi URL in uno o più domini IDP. Quando specificate l'URL, utilizzate il seguente formato: \$1. *example*-*idp*. *com*. 

Puoi specificare un elenco di domini attendibili in un formato con valori separati da virgole. Aggiungere questo elenco come valore di registro alla chiave di registro `TrustedDomains` HKLM di WorkSpaces Applications. Si consiglia di creare questa chiave di registro e specificare l'elenco dei domini affidabili quando si installa il client WorkSpaces Applications o, se si utilizza Microsoft Active Directory, tramite Criteri di gruppo. In questo modo, gli utenti possono connettersi a un URL in qualsiasi dominio attendibile immediatamente dopo l'installazione del client.

Dopo aver installato il client WorkSpaces Applications, è possibile eseguire lo PowerShell script seguente per creare questa chiave di registro. In alternativa, è possibile utilizzare il modello amministrativo incluso nell'Enterprise Deployment Tool del client WorkSpaces Applications per configurare il client tramite Group Policy.

Sostituisci il valore `TrustedDomains` con un elenco di valori separati da virgole per uno o più domini aziendali o IDP. Il certificato utilizzato dalla pagina Web del dominio attendibile deve contenere un SAN che includa il dominio dell'URL. Ad esempio, se il dominio affidabile include \$1.example.com e gli utenti lo https://appstream.example.com specificano, il certificato SSL deve disporre di una SAN che includa appstream.example.com.

**Nota**  
Per eseguire questo script, è necessario essere collegati al computer applicabile con le autorizzazioni di Amministratore. È inoltre possibile eseguire lo script da remoto con l'account System (Sistema) all'avvio. 

```
$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
```

Di seguito sono riportati i requisiti e le considerazioni per la formattazione dei nomi di dominio attendibili.
+ Sono supportati i seguenti caratteri: a-z, 0-9, -, \$1
+ DNS considera il carattere \$1 sia come un carattere jolly che come il carattere asterisco (ASCII 42), a seconda della posizione all'interno del nome di dominio. Di seguito sono riportate le limitazioni quando si utilizza \$1 come carattere jolly nel nome di un record DNS:
  + \$1 deve sostituire l'etichetta più a sinistra in un nome di dominio. Ad esempio, \$1.esempio.com o \$1.prod.esempio.com. Se includi \$1 in qualsiasi altra posizione, come prod.\$1.esempio.com, DNS lo considera un carattere asterisco (ASCII 42), non un carattere jolly.
  + L'\$1 deve sostituire l'intera etichetta. Ad esempio, non puoi specificare \$1prod.esempio.com o prod\$1.esempio.com.
  + \$1 si applica al livello di sottodominio che include \$1 e a tutti i sottodomini di tale sottodominio. Ad esempio, se una voce è denominata \$1.example.com, il client Applications consente zenith.example.com, acme.zenith.example.com e pinnacle.acme.zenith.example.com. WorkSpaces 

## Crea AS2 TrustedDomains il record DNS TXT per abilitare il tuo dominio per il client WorkSpaces Applications senza modifiche al registro
<a name="create-AS2TrustedDomains-DNS-TXT-record-client"></a>

Puoi consentire agli utenti di connettersi a qualsiasi URL nel dominio dell'organizzazione (ad esempio, \$1.esempio.com) o a qualsiasi URL nei domini IDP (ad esempio, \$1.esempio-idp.com) creando un record TXT DNS in tale dominio. Quando crei il record TXT DNS, i valori del registro `StartURL` o `TrustedDomains` non sono necessari per consentire a un utente di connettersi a un URL. 

Puoi specificare un elenco di sottodomini attendibili in un formato separato da virgole, preceduto da `AS2TrustedDomains=`. Quindi, crea un record TXT DNS per il dominio appropriato. Il record TXT DNS `AS2TrustedDomains` può abilitare solo lo stesso dominio o i sottodomini del dominio in cui viene creato il record TXT DNS. Non è possibile utilizzare il record TXT DNS per abilitare altri domini. 

Per ulteriori informazioni sulla configurazione del record DNS, consulta [Abilitare il dominio organizzativo per il client AppStream 2.0 con un record TXT DNS Route 53 e Creazione di un AS2 TrustedDomains record DNS TXT](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/) [per reindirizzare il client nativo AppStream 2.0 a](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/) un provider di identità di terze parti.

**Nota**  
Quando crei record TXT DNS, tutti gli utenti possono eseguire lo streaming da domini abilitati che non sono inclusi nei valori `StartURL` o `TrustedDomains` del registro. Il client WorkSpaces Applications e la configurazione del record DNS TXT non impediscono agli utenti di utilizzare altri metodi di connessione per accedere ai domini o quelli specificati dall'utente. URLs Ad esempio, gli utenti possono accedere a domini specifici o URLs utilizzare un browser Web, se dispongono dell'accesso di rete ai domini o. URLs

### Esempio di configurazione di record TXT DNS
<a name="configuration-example-AS2TrustedDomains-DNS-TXT-record-client"></a>

Di seguito è riportato un esempio di configurazione di record TXT DNS. Con la configurazione di questo esempio, gli utenti possono avviare il client WorkSpaces Applicazioni e connettersi a appstream.example.com o appstream-dev.example.com. Tuttavia, non possono connettersi 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.esempio.com, appstream-dev.esempio.com

### Requisiti e considerazioni
<a name="requirements-AS2TrustedDomains-DNS-TXT-record-client"></a>

Tieni presente i requisiti e le considerazioni riportate di seguito per la creazione di un record TXT DNS:
+ È necessario creare il record TXT nel dominio di secondo livello. Ad esempio, se il dominio è prod.appstream.esempio.com, è necessario creare il record TXT DNS in example.com.
+ Il valore del record TXT deve iniziare con `AS2TrustedDomains=`
+ Sono supportati i seguenti caratteri: a-z, 0-9, -, \$1
+ DNS considera il carattere \$1 sia come un carattere jolly che come il carattere asterisco (ASCII 42), a seconda della posizione all'interno del nome di dominio. Di seguito sono riportate le limitazioni quando si utilizza \$1 come carattere jolly nel nome di un record DNS:
  + \$1 deve sostituire l'etichetta più a sinistra in un nome di dominio. Ad esempio, \$1.esempio.com o \$1.prod.esempio.com. Se includi \$1 in qualsiasi altra posizione, come prod.\$1.esempio.com, DNS lo considera un carattere asterisco (ASCII 42), non un carattere jolly.
  + L'\$1 deve sostituire l'intera etichetta. Ad esempio, non puoi specificare \$1prod.esempio.com o prod\$1.esempio.com.
  + \$1 si applica al livello di sottodominio che include \$1 e a tutti i sottodomini di tale sottodominio. Ad esempio, se una voce è denominata \$1.example.com, il client Applications consente le connessioni ai seguenti domini: zenith.example.com, acme.zenith.example.com e pinnacle.acme.zenith.example.com. WorkSpaces 

## Disattivare la ricerca di record TXT DNS per domini attendibili
<a name="disable-DNS-TXT-record-lookup-client"></a>

Per impostazione predefinita, quando gli utenti avviano le Applicazioni e specificano un URL che non è WorkSpaces un dominio Applicazioni, il client esegue una ricerca nei record DNS TXT. WorkSpaces La ricerca viene eseguita nel dominio di secondo livello dell'URL in modo che il client possa determinare se il dominio è incluso nell'elenco `AS2TrustedDomains`. Questo comportamento consente agli utenti di connettersi a domini non specificati nelle chiavi di `TrustedDomains` registro `StartURL` o nei domini delle applicazioni. WorkSpaces 

È possibile disattivare questo comportamento impostando il valore per la chiave `DnsTxtRecordQueryDisabled` del registro su `true`. È possibile creare questa chiave di registro quando si installa il client WorkSpaces Applications. In questo modo, il client si connette solo a URLs quelle specificate dalle chiavi di `TrustedDomains` registro `StartURL` o.

Dopo aver installato il client WorkSpaces Applications, è possibile eseguire lo PowerShell script seguente per creare questa chiave di registro. In alternativa, è possibile utilizzare il modello amministrativo incluso nell'Enterprise Deployment Tool del client WorkSpaces Applications per configurare il client tramite Group Policy.

**Nota**  
Per eseguire questo script, è necessario essere collegati al computer applicabile con le autorizzazioni di Amministratore. È inoltre possibile eseguire lo script da remoto con l'account System (Sistema) all'avvio.

```
$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
```

## Scegliere se disabilitare gli aggiornamenti automatici del client
<a name="disable-automatic-updates-client"></a>

Per impostazione predefinita, quando è disponibile una nuova versione del client WorkSpaces Applications, il client si aggiorna automaticamente alla versione più recente. Puoi disabilitare gli aggiornamenti automatici impostando il valore per la chiave `AutoUpdateDisabled` del registro su `true`. È possibile creare questa chiave di registro quando si installa il client WorkSpaces Applications. In questo modo, il client non viene aggiornato automaticamente ogni volta che è disponibile una nuova versione. 

Dopo aver installato il client WorkSpaces Applications, è possibile eseguire lo PowerShell script seguente per creare questa chiave di registro. In alternativa, è possibile utilizzare il modello amministrativo incluso nell'Enterprise Deployment Tool del client WorkSpaces Applications per configurare il client tramite Group Policy.

**Nota**  
Per eseguire questo script, è necessario essere collegati al computer applicabile con le autorizzazioni di Amministratore. È inoltre possibile eseguire lo script da remoto con l'account System (Sistema) all'avvio. 

```
$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
```

## Scegliere se disabilitare i caricamenti dei log di diagnostica on demand
<a name="disable-on-demand-diagnostic-log-uploads"></a>

Per impostazione predefinita, il client WorkSpaces Applications consente agli utenti di caricare registri di diagnostica e minidump su richiesta in Applications (). WorkSpaces AWS Inoltre, se si verifica un'eccezione o il client WorkSpaces Applications smette di rispondere, agli utenti viene richiesto di scegliere se caricare il minidump e i log associati. Per ulteriori informazioni sulla registrazione della diagnostica on demand, consulta [Caricamenti automatici e on demand dei log di diagnostica](feature-support-diagnostic-log-upload.md).

Puoi disattivare questi comportamenti impostando il valore per la chiave `UserUploadOfClientLogsAllowed` del registro su `false`. È possibile creare questa chiave di registro HKLM quando si installa il client Applications. WorkSpaces 

Dopo aver installato il client WorkSpaces Applications, è possibile eseguire lo PowerShell script seguente per creare questa chiave di registro. In alternativa, è possibile utilizzare il modello amministrativo incluso nell'Enterprise Deployment Tool del client WorkSpaces Applications per configurare il client tramite Group Policy.

**Nota**  
Per eseguire questo script, è necessario essere collegati al computer applicabile con le autorizzazioni di Amministratore. È inoltre possibile eseguire lo script da remoto con l'account System (Sistema) all'avvio. 

```
$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
```

## Scegliere se disabilitare la modalità di applicazione nativa
<a name="disable-native-application-mode-client"></a>

Per impostazione predefinita, il client WorkSpaces Applications può essere eseguito in modalità classica o in modalità applicazione nativa. Puoi disabilitare la modalità di applicazione nativa impostando il valore della chiave `NativeAppModeDisabled` del registro su `true`. È possibile creare questa chiave di registro HKLM quando si installa il client WorkSpaces Applications. Se il valore è impostato su `true`, il client viene eseguito solo in modalità classica. Per informazioni sulla modalità di applicazione nativa, consulta [Modalità di applicazione nativa](feature-support-native-application-mode.md).

Dopo aver installato il client WorkSpaces Applications, è possibile eseguire lo PowerShell script seguente per creare questa chiave di registro. In alternativa, è possibile utilizzare il modello amministrativo incluso nell'Enterprise Deployment Tool del client WorkSpaces Applications per configurare il client tramite Group Policy.

**Nota**  
Per eseguire questo script, è necessario essere collegati al computer applicabile con le autorizzazioni di Amministratore. È inoltre possibile eseguire lo script da remoto con l'account System (Sistema) all'avvio. 

```
$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
```

## Scegliere se disabilitare il reindirizzamento della stampante locale
<a name="disable-local-printer-redirection-client"></a>

Per impostazione predefinita, il client WorkSpaces Applications consente agli utenti di reindirizzare i lavori di stampa dalle applicazioni di streaming a una stampante collegata al computer locale. Puoi disabilitare il reindirizzamento della stampante locale impostando il valore della chiave `PrinterRedirectionDisabled` del registro su `true`. È possibile creare questa chiave di registro HKLM quando si installa il WorkSpaces client Applications. Se il valore è impostato su `true`, il client non reindirizza i lavori di stampa dalle applicazioni di streaming degli utenti a una stampante collegata al computer locale.

Dopo aver installato il client WorkSpaces Applications, è possibile eseguire lo PowerShell script seguente per creare questa chiave di registro. In alternativa, è possibile utilizzare il modello amministrativo incluso nell'Enterprise Deployment Tool del client WorkSpaces Applications per configurare il client tramite Group Policy.

**Nota**  
Per eseguire questo script, è necessario essere collegati al computer applicabile con le autorizzazioni di Amministratore. È inoltre possibile eseguire lo script da remoto con l'account System (Sistema) all'avvio. 

```
$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
```

## Scegliere se disabilitare il reindirizzamento delle smart card
<a name="disable-local-smart-card-support-client"></a>

Per impostazione predefinita, il reindirizzamento tramite smart card è abilitato per il client WorkSpaces Applications. Quando questa funzionalità è abilitata, gli utenti possono utilizzare lettori di smart card collegati ai computer locali e alle relative smart card durante le sessioni di streaming WorkSpaces delle Applicazioni senza reindirizzamento USB. Durante WorkSpaces le sessioni di streaming delle Applicazioni, i lettori di smart card e le smart card degli utenti rimangono accessibili per l'uso con le applicazioni locali. Il client reindirizza le chiamate API delle smart card dalle applicazioni di streaming degli utenti alla smart card locale. Puoi disabilitare il reindirizzamento delle smart card impostando il valore della chiave `SmartCardRedirectionDisabled` del registro su `true`. È possibile creare questa chiave di registro HKLM quando si installa il WorkSpaces client Applications.

Se il valore è impostato su`true`, gli utenti non possono utilizzare i lettori di smart card e le smart card durante una sessione di streaming WorkSpaces delle Applicazioni senza reindirizzamento USB. In questo caso, gli utenti non possono accedere alle proprie applicazioni di streaming utilizzando una smart card collegata al computer locale, a meno che il [dispositivo non sia qualificato](qualify-usb-devices.md). Dopo aver qualificato il dispositivo, gli utenti devono [condividerlo con WorkSpaces le Applicazioni](client-application-windows-how-to-share-usb-devices-user.md). Quando il reindirizzamento delle smart card è disabilitato, durante le sessioni di streaming WorkSpaces delle Applicazioni degli utenti, i lettori di smart card e le smart card non sono accessibili per l'uso con le applicazioni locali. 

Dopo aver installato il client WorkSpaces Applications, è possibile eseguire lo PowerShell script seguente per creare questa chiave di registro. In alternativa, è possibile utilizzare il modello amministrativo incluso nell'Enterprise Deployment Tool del client WorkSpaces Applications per configurare il client tramite Group Policy. 

**Nota**  
Per eseguire questo script, è necessario essere collegati al computer applicabile con le autorizzazioni di Amministratore. È inoltre possibile eseguire lo script da remoto con l'account System (Sistema) all'avvio. 

```
$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
```

## Configura impostazioni aggiuntive del client WorkSpaces Applications per i tuoi utenti
<a name="configure-client"></a>

Il client WorkSpaces Applications utilizza le chiavi di registro per configurare le seguenti impostazioni client aggiuntive:
+ WorkSpaces Accettazione del contratto di licenza con l'utente finale (EULA) del client Applications
+ WorkSpaces Versione EULA del client Applications accettata
+ Caricamenti automatici dei registri di diagnostica per il client Applications WorkSpaces 
+ Aggiornamenti automatici per il driver USB utilizzato per passare i driver USB alle applicazioni WorkSpaces 
+ Abilitazione del rendering hardware nel client WorkSpaces Applications
+ Impostazione di percorsi di cartelle personalizzati per il reindirizzamento del file system nel client WorkSpaces Applicazioni
+ Apertura dell'URL per il tuo provider di identità (IdP) nel browser predefinito del sistema
+ Aggiunta di un indicatore per fornire un feedback visivo in tempo reale sulla perdita di dati in streaming

La tabella seguente riassume i valori di registro per le impostazioni client aggiuntive che è possibile utilizzare per personalizzare l'esperienza del client WorkSpaces Applications per gli utenti. 

**Nota**  
Questi valori fanno distinzione tra maiuscole e minuscole.


| Valore | Percorso Registro di sistema | Tipo | Description | Dati | 
| --- | --- | --- | --- | --- | 
| EULAAccepted | HKCU\$1Software\$1Amazon\$1Appstream Client | Stringa | Imposta questo valore su per true accettare l'EULA del client WorkSpaces Applications per conto dei tuoi utenti. | true/false | 
| AcceptedEULAVersion | HKCU\$1Software\$1Amazon\$1Appstream Client | Stringa | La versione di EULA che viene accettata. Se la versione corrente dell'EULA del client WorkSpaces Applications è diversa dalla versione dell'EULA accettata, agli utenti viene richiesto di accettare la versione corrente dell'EULA. | 1.0 | 
| DiagnosticInfoCollectionAllowed | HKCU\$1Software\$1Amazon\$1Appstream Client | Stringa | Imposta questo valore su per consentire true  alle WorkSpaces Applicazioni di inviare automaticamente i registri di diagnostica dal client WorkSpaces Applicazioni alle Applicazioni (). WorkSpaces AWS | true/false | 
| USBDriverOptIn | HKCU\$1Software\$1Amazon\$1Appstream Client | Stringa | Imposta questo valore per consentire true alle WorkSpaces Applicazioni di aggiornare automaticamente il driver USB utilizzato per passare i driver USB alle WorkSpaces Applicazioni. | true/false | 
| HardwareRenderingEnabled | HKCU\$1Software\$1Amazon\$1Appstream Client | Stringa | Imposta questo valore true per abilitare il rendering hardware nel client WorkSpaces Applicazioni. | true/false | 
| FileRedirectionCustomDefaultFolders | HKCU\$1Software\$1Amazon\$1Appstream Client | Stringa | Impostare questo valore per includere almeno un percorso di cartella per il reindirizzamento del file system. Separare più percorsi di cartella utilizzando '\$1'. Per impostazione predefinita, vengono specificati i seguenti percorsi di cartella: %USERPROFILE%\$1Desktop\$1%USERPROFILE%\$1Documents\$1%USERPROFILE%\$1Downloads | Valid folder path | 
| OpenIdpUrlInSystemBrowser | HKCU\$1Software\$1Amazon\$1Appstream Client | Stringa | Imposta questo valore per consentire true al client WorkSpaces Applications di aprire l'URL IdP in un browser predefinito del sistema. Questa funzionalità è supportata nella versione client 1.1.1360 e successive. | true/false | 
| DataLossIndicator | HKCU\$1Software\$1Amazon\$1Appstream Client | Stringa | Imposta questo valore su SHOW\$1ON\$1LOSSY per includere un indicatore di avviso rosso in caso di perdita di dati in streaming. Imposta questo valore su SHOW\$1ON\$1LOSSLESS per includere un indicatore verde integro quando non si verifica alcuna perdita di dati in streaming. | DISABLED/SHOW\$1ON\$1LOSSY/SHOW\$1ON\$1LOSSLESS | 

Dopo aver installato il client WorkSpaces Applications, è possibile eseguire PowerShell lo script seguente per creare queste chiavi di registro. Se non si desidera creare tutte le chiavi di registro, modificare lo script in base alle esigenze per creare solo le chiavi di registro desiderate. In alternativa, è possibile utilizzare il modello amministrativo fornito nell'Enterprise Deployment Tool del client WorkSpaces Applications per configurare il client tramite Group Policy.

**Nota**  
È necessario impostare le seguenti voci per ogni utente.

```
$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
```

## Utilizzo di Group Policy per personalizzare l'esperienza del client di WorkSpaces Applications
<a name="configure-client-with-adm-template-group-policy"></a>

È possibile utilizzare il modello amministrativo fornito nell'Enterprise Deployment Tool del client WorkSpaces Applications per configurare il client tramite Group Policy. Per ulteriori informazioni su come caricare i modelli amministrativi nella console di gestione delle policy di gruppo, consultare [Consigli per la gestione dei file di modelli amministrativi (adm) di criteri di gruppo](https://support.microsoft.com/en-us/help/816662/recommendations-for-managing-group-policy-administrative-template-adm) nella documentazione di supporto Microsoft.

# Aggiorna manualmente l' WorkSpaces Applications Enterprise Deployment Tool, il client e il driver USB
<a name="update-enterprise-deployment-tool-client-usb-driver-manually"></a>

Per impostazione predefinita, il client WorkSpaces Applications e il driver USB vengono aggiornati automaticamente quando viene rilasciata una nuova versione del client. Tuttavia, se hai utilizzato Enterprise Deployment Tool per installare il client WorkSpaces Applications per i tuoi utenti e hai disabilitato gli aggiornamenti automatici, devi aggiornare manualmente l' WorkSpaces Applications Enterprise Deployment Tool, il client e il driver USB. A tale scopo, effettuate le seguenti operazioni per eseguire i PowerShell comandi richiesti sui computer degli utenti. 

**Nota**  
Per eseguire questi comandi, occorre aver eseguito l'accesso al computer applicabile come Amministratore oppure è possibile eseguire lo script in remoto con l'account SYSTEM all'avvio.  
L'utilizzo dell'Enterprise Deployment Tool per gestire il client macOS WorkSpaces delle applicazioni non è supportato. 

1. Disinstalla silenziosamente l' WorkSpaces Applications Enterprise Deployment Tool:

   ```
   Start-Process msiexec.exe -Wait -ArgumentList '/x AmazonAppStreamClientSetup_<existing_version>.msi /quiet'
   ```

1. Disinstalla silenziosamente il driver USB WorkSpaces delle applicazioni:

   ```
   Start-Process -Wait AmazonAppStreamUsbDriverSetup_<existing_version>.exe -ArgumentList '/uninstall /quiet /norestart'
   ```

1. Disinstalla silenziosamente il client WorkSpaces delle applicazioni:

   ```
   Start-Process "$env:LocalAppData\AppStreamClient\Update.exe" -ArgumentList '--uninstall'
   ```
**Nota**  
Questo processo rimuove anche le chiavi di registro utilizzate per configurare il client WorkSpaces Applications. Dopo aver reinstallato il client WorkSpaces Applications, è necessario ricreare queste chiavi.

1. Pulire la directory di installazione dell'applicazione:

   ```
   Remove-Item -Path $env:LocalAppData\AppStreamClient -Recurse -Confirm:$false –Force 
   ```

1. Riavviare il computer:

   ```
   Restart-computer
   ```

1. Installa silenziosamente la versione più recente di WorkSpaces Applications Enterprise Deployment Tool:

   ```
   Start-Process msiexec.exe -Wait -ArgumentList '/i AmazonAppStreamClientSetup_<new_version>.msi /quiet'
   ```

1. Installa silenziosamente la versione più recente del driver USB WorkSpaces delle applicazioni:

   ```
   Start-Process AmazonAppStreamUsbDriverSetup_<new_version>.exe -Wait -ArgumentList '/quiet'
   ```

# Qualificare i dispositivi USB affinché possano essere utilizzati con le applicazioni in streaming
<a name="qualify-usb-devices"></a>

Esistono due metodi per specificare quali dispositivi USB gli utenti possono reindirizzare nelle istanze di streaming delle WorkSpaces applicazioni:

**Nota**  
Il reindirizzamento USB è attualmente supportato solo sulle istanze di streaming delle applicazioni Windows WorkSpaces . Non è supportata sul client macOS. 
+ Puoi creare le stringhe di filtro del dispositivo USB all'interno del file di configurazione salvato su un'immagine. Questo metodo può essere utilizzato solo con parchi istanze sempre attivi e on demand.
+ È possibile specificare le stringhe di filtro dei dispositivi USB quando si crea la flotta, con la console di AWS gestione o con l'`CreateFleet`API. Per informazioni dettagliate su queste stringhe, consulta la sezione successiva. Questo metodo può essere utilizzato solo con parchi istanze elastici.

È possibile creare un file sull'immagine WorkSpaces delle applicazioni che specifica quali dispositivi USB un utente può rendere disponibili per le proprie applicazioni di streaming. Per qualificare i dispositivi USB degli utenti in modo che possano essere utilizzati con le applicazioni in streaming, esegui questi passaggi. 

**Nota**  
Per motivi di sicurezza, qualifica solo i dispositivi USB provenienti da origini affidabili approvate. La qualificazione di tutti i dispositivi o delle classi di dispositivi generici potrebbe consentire l'utilizzo di dispositivi non approvati con le applicazioni di streaming.

1. Se non l'hai già fatto, installa il client WorkSpaces Applicazioni. Per informazioni, consulta [WorkSpaces Installa e configura il client delle applicazioni](install-configure-client.md).

1. Collega il dispositivo USB desideri qualificare al computer.

1. Accedere a **C:\$1Users\$1 < logged-in-user >\$1AppData\$1 Local\$1 AppStreamClient** e fare doppio clic su **dcvusblist.exe**.

1. Nella finestra di dialogo **DCV - USB devices (Dispositivi DCV – USB)** viene visualizzato l'elenco dei dispositivi USB collegati al computer locale. La colonna **Filter (Filtra)** mostra la stringa di filtro per ogni dispositivo USB. Fare clic con il pulsante destro del mouse sulla voce elenco per un dispositivo USB che si desidera abilitare e scegliere **Copy filter string (Copia stringa di filtro)**. 

1. Sul desktop, scegliere il pulsante **Start** di Windows e cercare Notepad. Fare doppio clic su **Notepad** per aprire un nuovo file, copiare la stringa di filtro sul file e salvarlo. In seguito, sarà possibile utilizzare la stringa di filtro per qualificare il dispositivo USB.

1. Avviare un nuovo Image Builder. Per ulteriori informazioni, consulta [Avvio di uno sviluppatore di immagini per installare e configurare applicazioni per lo streaming](tutorial-image-builder-create.md).

1. Una volta che il generatore di immagini è in **esecuzione**, esegui i seguenti passaggi per creare un URL di streaming e connetterti al generatore di immagini utilizzando il WorkSpaces client Applications.

   1. Con l'Image Builder selezionato nell'elenco, scegliere **Actions (Azioni)**, **Create streaming URL (Crea URL di streaming)**.

   1. Nella finestra di dialogo **Create streaming URL (Crea URL di streaming)** scegliere **Copy link (Copia collegamento)** e copiare e incollare l'indirizzo Web in un file separato per un uso successivo. Si utilizzerà questo URL per riconnettersi all'Image Builder nella fase 12.

   1. Scegliere **Launch in Client (Avvia nel client)**.

   1. Se la finestra di dialogo **Avvia applicazione** si apre e ti chiede di scegliere l'applicazione da utilizzare all'apertura del link, scegli **Amazon AppStream**, **Apri** link. Per evitare che questa finestra di dialogo venga visualizzata la prossima volta che di esegue questa fase per la connessione a un Image Builder, selezionare la casella di controllo **Remember my choice for amazonappstream links (Ricorda la mia scelta per i collegamenti amazonappstream)** .

   1. **Se il client WorkSpaces Applicazioni mostra collegamenti al Contratto con il AWS cliente, ai Termini di AWS servizio e all' AWS Informativa sulla privacy e avvisi di terze parti, rivedi queste informazioni e quindi scegli Fine.** 

   1. Se viene visualizzata la pagina di accesso client, il campo dell'indirizzo Web viene precompilato con l'URL di streaming. Scegli **Connetti**. 

   1. Se richiesto, accedere all'Image Builder come Amministratore. 

1. Dopo aver effettuato la connessione all'Image Builder, se il dispositivo USB richiede di installare i driver prima dell'utilizzo, scaricare e installare i driver nell'Image Builder. Ad esempio, se si utilizza il mouse Connexion 3D, è necessario scaricare e installare i driver Connexion richiesti sull'Image Builder. 

1. Sul desktop dell'Image Builder, scegliere il pulsante **Start** di Windows e cercare Notepad. Fare clic con il pulsante destro del mouse su **Notepad** e scegliere **Run as Administrator (Esegui come amministratore)**.

1. Scegliere **File**, **Open (Apri)** e aprire il file seguente: `C:\ProgramData\Amazon\Photon\DCV\usb_device_allowlist.txt`. È anche possibile autorizzare un'intera categoria di dispositivi o tutti i dispositivi di un produttore specifico utilizzando le espressioni carattere jolly nel file `usb_device_allowlist.txt`. 

1. Copiare la stringa di filtro dal computer locale all'Image Builder. **La stringa di filtro per uno specifico dispositivo USB è una stringa separata da virgole dei seguenti campi: **Name**, **Base Class**, **Protocol**, **ID Vendor **SubClass**, ID** **Product,** **Support Autoshare** e Skip Reset.** Per informazioni dettagliate su queste stringhe, consulta [Utilizzare le stringhe di filtro per i dispositivi USB](USB-device-filter-strings.md).

1. Disconnettiti dal tuo generatore di immagini, riavvialo e riconnettiti utilizzando il client Applicazioni. WorkSpaces A tale scopo, apri il client WorkSpaces Applicazioni e incolla l'URL di streaming creato nel passaggio 7 nel campo dell'indirizzo web di accesso del client, quindi scegli **Connect**.

1. Nell'Image Builder, testare il dispositivo USB per confermare che funzioni come previsto.

1. Prima che gli utenti possano utilizzare il dispositivo USB in una sessione di WorkSpaces Applicazioni, devono prima condividere il dispositivo con la loro sessione. Per le linee guida che puoi fornire agli utenti per aiutarli a svolgere questa attività, consulta [Dispositivi USB](client-application-windows-how-to-share-usb-devices-user.md).

1. Se il dispositivo USB funziona con l'Image Builder come previsto, creare un'immagine. Per ulteriori informazioni, consulta [Tutorial: creazione di un'immagine personalizzata WorkSpaces delle applicazioni utilizzando la console WorkSpaces delle applicazioni](tutorial-image-builder.md).

1. Dopo aver completato la creazione dell'immagine, aggiorna il parco WorkSpaces applicazioni per utilizzare la nuova immagine.

# Utilizzare le stringhe di filtro per i dispositivi USB
<a name="USB-device-filter-strings"></a>

Questa sezione descrive le stringhe di filtro disponibili per i dispositivi USB idonei per le sessioni di streaming WorkSpaces delle applicazioni. Fornisce anche le indicazioni per utilizzare queste stringhe. Sono disponibili le seguenti stringhe di filtro:
+ `Name`: per impostazione predefinita, il valore di questa stringa di filtro è il nome del dispositivo, ma puoi specificare un valore personalizzato.
+ `Base Class,SubClass,Protocol`: il codice di classe USB per il dispositivo. Per ulteriori informazioni, consulta [Codici di classe definiti](https://www.usb.org/defined-class-codes).
+ `ID Vendor (VID)`: un identificatore univoco assegnato dall'organizzazione USB al produttore del dispositivo USB.
+ `ID Product (PID)`: un identificatore univoco assegnato dal produttore al dispositivo USB. 
+ `Support Autoshare`— Consente al client WorkSpaces Applications di condividere automaticamente il dispositivo all'avvio di una sessione di streaming. Impostare questo valore su `1` per consentire la condivisione automatica del dispositivo. Impostare questo valore su `0` per non consentire la condivisione automatica del dispositivo.
+ `Skip Reset`— Per impostazione predefinita, quando un dispositivo USB viene condiviso dalle WorkSpaces Applicazioni con una sessione di streaming, il dispositivo viene ripristinato per garantire che funzioni correttamente. Tuttavia, alcuni dispositivi USB non funzionano correttamente durante la sessione di streaming se vengono reimpostati. Per evitare che questo problema si verifichi, imposta il valore di questa stringa di filtro in modo `1` da indicare al client WorkSpaces Applications di non reimpostare il dispositivo mentre è condiviso con una sessione di streaming. Per assicurarsi che il dispositivo venga reimpostato mentre è condiviso con una sessione di streaming, impostare questo valore su `0`. Quando si imposta un valore per `Skip Reset`, assicurarsi di impostare il valore `Support Autoshare` su `0` o `1`.

 La stringa di filtro copiata dal computer locale è specifica di un dispositivo USB. In alcuni casi, è possibile consentire un'intera classe di dispositivi invece di autorizzare ogni possibile dispositivo USB. Ad esempio, è possibile consentire agli utenti di utilizzare qualsiasi tipo di tablet di progettazione Wacom o utilizzare qualsiasi dispositivo di storage di massa USB. In tali scenari, è possibile fornire caratteri jolly per campi stringa di filtro specifici. Se non si conosce il VID e il PID per i dispositivi USB, è possibile cercare queste informazioni nel [database di ID USB](https://www.the-sz.com/products/usbid/index.php). 

Negli esempi seguenti viene illustrato come configurare le stringhe di filtro per la condivisione dei dispositivi USB durante le sessioni di streaming:
+ Autorizza automaticamente tutti i dispositivi di archiviazione di massa all'avvio di una sessione di streaming: "Mass storage, 8, \$1, \$1, \$1, \$1,1,0"
+ Autorizza automaticamente tutti i dispositivi Wacom all'avvio di una sessione di streaming: "Wacom tablets, 3, \$1, \$1, 1386, \$1,1,0"
+ Autorizza tutti i dispositivi che forniscono un'interfaccia audio: "Audio, 1, \$1, \$1, \$1, \$1,1,0"
+ Autorizza il dispositivo X ma non reimpostarlo mentre è condiviso. Non condividere automaticamente il dispositivo all'avvio di una sessione di streaming: "X, Y, \$1, \$1, 1386, \$1,0,1" 

# Configura un metodo di connessione per gli utenti del client WorkSpaces delle applicazioni
<a name="use-client-start-streaming-session"></a>

Dopo aver installato il client WorkSpaces Applicazioni sui computer locali degli utenti, questi possono utilizzare il client WorkSpaces Applicazioni per connettersi a una sessione di streaming. A seconda dei requisiti organizzativi, puoi fornire agli utenti client l'accesso alle WorkSpaces applicazioni effettuando una delle seguenti operazioni: configurazione della federazione delle identità tramite SAML 2.0, utilizzo di un pool di utenti WorkSpaces delle applicazioni o creazione di un URL di streaming.

**Topics**
+ [SAML 2.0](use-client-start-streaming-session-SAML.md)
+ [WorkSpaces Pool di utenti delle applicazioni](use-client-start-streaming-session-user-pool.md)
+ [URL di streaming](use-client-start-streaming-session-streaming-URL.md)
+ [Fasi successive](use-client-start-streaming-session-next-steps.md)

# SAML 2.0
<a name="use-client-start-streaming-session-SAML"></a>

Se utilizzi provider di identità esterni per federare gli utenti in uno stack di WorkSpaces applicazioni, devi creare un valore di registro per configurare il client WorkSpaces Applications con un URL precompilato ogni volta che il client viene avviato. L'URL deve utilizzare un certificato ritenuto affidabile dal dispositivo. Il certificato contiene un Subject Alternative Name (SAN) che include l'URL per il nome di dominio.

Per ulteriori informazioni, consulta:
+ [Configurazione del linguaggio SAML](external-identity-providers-setting-up-saml.md)
+ [Imposta il valore del registro StartUrl per gli utenti del client WorkSpaces Applications](install-client-configure-settings.md#set-start-url-registry-value)

# WorkSpaces Pool di utenti delle applicazioni
<a name="use-client-start-streaming-session-user-pool"></a>

Quando si crea un nuovo utente nel pool di utenti delle WorkSpaces Applicazioni o si assegna un utente del pool di utenti a uno stack di WorkSpaces WorkSpaces applicazioni, Applications invia e-mail agli utenti per conto dell'utente. Gli utenti immettono l'URL fornito nell'e-mail di benvenuto, immettono le proprie credenziali e quindi scelgono **Connetti**.

Per ulteriori informazioni, consulta [Pool di utenti di Amazon WorkSpaces Applications](user-pool.md).

# URL di streaming
<a name="use-client-start-streaming-session-streaming-URL"></a>

Per creare un URL di streaming, utilizza uno dei seguenti metodi:
+ WorkSpaces Console delle applicazioni
+ L'azione [CreateStreamingdell'API URL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html) 
+ Il comando [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html) AWS CLI .

Per creare un URL di streaming utilizzando la console WorkSpaces Applicazioni, completare i passaggi indicati nella procedura seguente.

**Per creare un URL di streaming utilizzando la console WorkSpaces Applicazioni**

1. Apri la console WorkSpaces Applicazioni a [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).

1. Nel riquadro di navigazione, selezionare **Fleets (Parchi istanze)**.

1. Nell'elenco dei parchi istanze, scegliere il parco istanze associato allo stack per il quale si desidera creare un URL di streaming. Verificare che lo stato del parco istanze sia **Running (In esecuzione)**.

1. Nel riquadro di navigazione selezionare **Stacks (Stack)**. Seleziona lo stack, quindi scegli **Operazioni**, **Crea URL di streaming**.

1. In **ID utente**, inserisci l'ID utente.

1. Per **Scadenza URL** scegli un'ora di scadenza che determina per quanto tempo è valido l'URL generato. Questo URL è valido per un massimo di sette giorni.

1. Scegli **Ottieni URL**.

1. Copia l'URL, salvalo in una posizione accessibile e forniscilo agli utenti.

   Nella pagina di accesso del client WorkSpaces Applicazioni, gli utenti inseriscono l'URL di streaming che hanno creato come indirizzo Web, quindi scelgono **Connect**. 

# Fasi successive
<a name="use-client-start-streaming-session-next-steps"></a>

Dopo aver configurato un metodo di connessione client, puoi fornire agli utenti le seguenti step-by-step indicazioni per aiutarli a connettersi alle WorkSpaces applicazioni e avviare una sessione di streaming: [Connect alle WorkSpaces applicazioni su Windows Client](client-application-windows-start-streaming-session-user.md) oppure[Connect alle WorkSpaces applicazioni sul client macOS](client-application-mac-start-streaming-session-user.md).

# Consenti agli utenti di condividere un dispositivo USB con una sessione di streaming di WorkSpaces applicazioni
<a name="share-usb-devices-with-session"></a>

Prima che gli utenti condividano i propri dispositivi USB con una sessione di WorkSpaces applicazioni, i dispositivi USB devono essere qualificati. Altrimenti, quando gli utenti avviano una sessione di streaming, il loro dispositivo USB non viene rilevato dalle WorkSpaces applicazioni e non può essere condiviso con la sessione. Per ulteriori informazioni, consulta [Qualificare i dispositivi USB affinché possano essere utilizzati con le applicazioni in streaming](qualify-usb-devices.md). 

**Nota**  
La condivisione di un dispositivo USB con una sessione di streaming di WorkSpaces Applicazioni non è supportata sul client macOS. 

# Reindirizza una sessione di streaming dal browser Web al client delle applicazioni WorkSpaces
<a name="redirect-streaming-session-from-web-to-client"></a>

È possibile configurare WorkSpaces le applicazioni per reindirizzare una sessione di streaming da un browser Web al client WorkSpaces Applicazioni. In questo modo, quando gli utenti accedono alle WorkSpaces Applicazioni e avviano una sessione di streaming nel loro browser web, la loro sessione viene reindirizzata al client WorkSpaces Applicazioni. A tale scopo, procedi nel modo seguente:

1.  WorkSpaces Utilizzate l'azione Applications `CreateStreamingURL` API per generare un URL di streaming.

1. Aggiungi il seguente prefisso per il gestore client WorkSpaces Applications personalizzato all'URL di streaming: **amazonappstream:**

   Insieme, il prefisso e l'URL di streaming sono formattati come segue:

   **amazonappstream:***base64encoded(streamingURL)*
**Nota**  
Quando codificate l'URL, assicuratevi che la codifica sia in UTF-8.   
Esempio di Powershell da codificare: `[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes("Streaming/IdpURL"))`

1. Quando gli utenti vengono reindirizzati all'URL di streaming, il browser rileva che il collegamento deve essere aperto dal client Applicazioni. WorkSpaces 

1. Agli utenti viene richiesto di scegliere se avviare la sessione di streaming utilizzando il WorkSpaces client Applicazioni. 

1. Dopo il prompt, si verifica uno dei seguenti eventi:
   + Se il client WorkSpaces Applicazioni è installato, l'utente può scegliere di continuare la sessione di streaming utilizzando il client WorkSpaces Applicazioni. 
   + Se il client WorkSpaces Applicazioni non è installato, il comportamento del browser varia come segue:
     + Chrome: non viene visualizzato alcun messaggio.
     + Firefox: un messaggio indica che l'utente ha bisogno di una nuova app per aprire Amazon AppStream.
     + Microsoft Edge: non viene visualizzato alcun messaggio.
     + Internet Explorer: un messaggio notifica all'utente che il client WorkSpaces Applicazioni non è installato.

       In questo caso, gli utenti possono selezionare il collegamento **Download AppStream Client** per scaricare il client. Gli utenti possono scaricare il client, installare e aggiornare il proprio browser per avviare la sessione di streaming utilizzando il client.

## Crea un collegamento sul desktop di Windows utilizzando il browser predefinito
<a name="desktop-shortcut"></a>

Per creare un collegamento sul desktop di Windows utilizzando il browser predefinito per avviare il client, usa lo script Powershell di esempio seguente.

```
$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
```

# Abilita il reindirizzamento del file system per gli utenti delle applicazioni WorkSpaces
<a name="enable-file-system-redirection"></a>

WorkSpaces Il reindirizzamento del file system delle applicazioni consente agli utenti che hanno installato il client WorkSpaces Applications di accedere ai file sul proprio computer locale dall'interno della sessione di streaming. Quando si abilita il reindirizzamento del file system, è possibile specificare l'elenco di unità e cartelle locali a cui gli utenti possono scegliere di accedere. Quando gli utenti accedono alle WorkSpaces Applicazioni e avviano una sessione di streaming, possono scegliere l'unità o la cartella a cui desiderano accedere dall'elenco. Quindi possono condividere l'unità o la cartella con WorkSpaces Applications. L'unità o la cartella rimangono disponibili per l'accesso durante le sessioni di streaming. Gli utenti possono interrompere la condivisione delle unità o cartelle locali in qualsiasi momento.

**Nota**  
Il reindirizzamento del file system non è attualmente supportato per le istanze fleet basate su Linux o quando si utilizza il client macOS.

**Topics**
+ [Prerequisiti per il reindirizzamento del file system](file-system-redirection-prerequisites.md)
+ [Come abilitare il reindirizzamento del file system](how-to-enable-file-system-redirection.md)
+ [Rendere unità e cartelle predefinite disponibili per la condivisione](prepopulate-drives-folders-system-redirection.md)
+ [Fornite agli utenti delle vostre applicazioni indicazioni su come utilizzare il reindirizzamento dei file system WorkSpaces](end-user-guidance-file-system-redirection.md)

# Prerequisiti per il reindirizzamento del file system
<a name="file-system-redirection-prerequisites"></a>

Per abilitare il reindirizzamento dei file delle applicazioni: WorkSpaces 
+ È necessario utilizzare un'immagine che utilizzi una versione dell'agente WorkSpaces Applications rilasciata a partire dall'8 agosto 2019. Per ulteriori informazioni, consulta [WorkSpaces Note sulla versione di Applications Agent](agent-software-versions.md).
+ Gli utenti devono avere installato la versione 1.0.480 o successiva del client WorkSpaces Applications. Per ulteriori informazioni, consulta [WorkSpaces Applicazioni: Windows Client, Note di rilascio](client-release-versions.md).
+ Il caricamento e il download dei file devono essere abilitati sullo stack a cui gli utenti accedono per le sessioni di streaming. Segui la procedura descritta di seguito.

# Come abilitare il reindirizzamento del file system
<a name="how-to-enable-file-system-redirection"></a>

Eseguire la procedura seguente per abilitare sia il caricamento che il download dei file sullo stack a cui gli utenti accedono per le sessioni di streaming. 

1. [Apri la console WorkSpaces Applicazioni a casahttps://console.aws.amazon.com/appstream2/.](https://console.aws.amazon.com/appstream2/home)

1. Nel riquadro di navigazione a sinistra, selezionare **Stacks (Stack)**.

1. Scegliere lo stack per il quale si desidera abilitare il reindirizzamento del file system.

1. Scegliere la scheda **User Settings (Impostazioni utente)**, quindi espandere la sezione **Clipboard, file transfer, and local print permissions (Appunti, trasferimento file e autorizzazioni di stampa locale)**.

1. Verifica che sia selezionato **Carica e scarica** per **Trasferimento file**. In caso contrario, scegli **Modifica**, quindi scegli **Carica e scarica**.

1. Scegliere **Aggiorna**.

# Rendere unità e cartelle predefinite disponibili per la condivisione
<a name="prepopulate-drives-folders-system-redirection"></a>

Per impostazione predefinita, quando si abilita l'indirizzamento dei file per gli utenti di uno stack, le seguenti unità e cartelle sono disponibili per tali utenti per la condivisione all'interno della sessione di streaming:
+ Unità:
  + Tutti i dischi rigidi locali (unità fisiche, ad esempio unità C e unità D)
  + Tutte le unità virtuali (unità di rete e virtuali come le lettere di unità mappate, Google Drive e OneDrive)
  + Tutte le unità USB locali
+ Cartelle:
  + %USERPROFILE%\$1Desktop
  + %USERPROFILE%\$1Documents
  + %USERPROFILE%\$1Downloads

Questi percorsi di unità e cartelle precompilano la finestra di dialogo **Share your local drives and folders (Condividi le unità e le cartelle locali)**. Questa finestra di dialogo viene visualizzata quando gli utenti accedono alle WorkSpaces Applicazioni, avviano una sessione di streaming e scelgono **Impostazioni**, **Risorse locali** **e Unità e cartelle** locali. 

È possibile modificare o definire propri percorsi predefiniti di unità e cartelle modificando il registro. È inoltre possibile utilizzare il file modello amministrativo fornito nell'Enterprise Deployment Tool del client WorkSpaces Applications. Questo modello consente di configurare il client utilizzando la policy di gruppo. Per ulteriori informazioni, consulta [WorkSpaces Installa e configura il client delle applicazioni](install-configure-client.md).

Quando gli utenti accedono alle unità e cartelle locali condivise durante una sessione di streaming, i percorsi corrispondenti vengono visualizzati con barre rovesciate sostituite da caratteri di sottolineatura. Hanno inoltre un suffisso con il nome del computer locale e una lettera di unità. Ad esempio, per un utente con il nome utente janedoe e il nome computer ExampleCorp -123456, i percorsi predefiniti delle cartelle Desktop, Documents e Downloads sono i seguenti:

C\$1Users\$1janedoe\$1desktop (\$1\$1 -123456) (F:) ExampleCorp

C\$1Users\$1Janedoe\$1documenti (\$1\$1 ExampleCorp -123456) (G:)

C\$1Users\$1Janedoe\$1downloads (\$1\$1 ExampleCorp -123456) (H:)

# Fornite agli utenti delle vostre applicazioni indicazioni su come utilizzare il reindirizzamento dei file system WorkSpaces
<a name="end-user-guidance-file-system-redirection"></a>

Per aiutare gli utenti a comprendere come utilizzare il reindirizzamento dei file durante le sessioni di streaming, puoi fornire le informazioni riportate in [Accesso ai file locali](client-application-windows-file-system-redirection.md). 

# Abilita il reindirizzamento della stampante locale per gli utenti delle applicazioni WorkSpaces
<a name="enable-local-printer-redirection"></a>

Con il reindirizzamento della stampante locale, gli utenti WorkSpaces delle applicazioni possono reindirizzare i lavori di stampa dalla propria applicazione di streaming a una stampante collegata al computer locale, comprese le stampanti di rete mappate dagli utenti. Non è necessario installare un driver di stampa sull'istanza di streaming delle WorkSpaces applicazioni per consentire agli utenti di stampare documenti durante le sessioni di streaming. 

**Nota**  
L'abilitazione del reindirizzamento della stampante locale non è attualmente supportata per gli stack basati su Linux.

**Topics**
+ [Prerequisiti per il reindirizzamento della stampante locale](local-printer-redirection-prerequisites.md)
+ [Come abilitare il reindirizzamento della stampante locale](how-to-enable-disable-local-printer-redirection.md)
+ [Come disabilitare il reindirizzamento della stampante locale](disable-local-printer-redirection.md)

# Prerequisiti per il reindirizzamento della stampante locale
<a name="local-printer-redirection-prerequisites"></a>

Per garantire che gli utenti possano utilizzare il reindirizzamento della stampante locale, è necessario:
+ Utilizza un'immagine che utilizzi una versione dell'agente WorkSpaces Applications rilasciata a partire dal 30 luglio 2020. Per ulteriori informazioni, consulta [WorkSpaces Note sulla versione di Applications Agent](agent-software-versions.md).
+ Assicurati che negli utenti sia installata la versione 1.1.179 o successiva del client WorkSpaces Applications. Per ulteriori informazioni, consulta [WorkSpaces Applicazioni: Windows Client, Note di rilascio](client-release-versions.md).
+ Assicurati che il reindirizzamento della stampante sia abilitato nello stack a cui gli utenti accedono per le sessioni di streaming.

# Come abilitare il reindirizzamento della stampante locale
<a name="how-to-enable-disable-local-printer-redirection"></a>

Per impostazione predefinita, il reindirizzamento della stampante locale è abilitato quando è installato il client WorkSpaces Applicazioni. Tuttavia, se il reindirizzamento della stampante locale non è abilitato nello stack a cui gli utenti accedono per le sessioni di streaming, puoi abilitarlo nella console WorkSpaces Applicazioni eseguendo i seguenti passaggi. 

**Per abilitare il reindirizzamento della stampante locale utilizzando la console Applicazioni WorkSpaces**

1. Apri la console WorkSpaces delle applicazioni a [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).

1. Nel riquadro di navigazione a sinistra, selezionare **Stacks (Stack)**.

1. Scegli lo stack per il quale desideri abilitare il reindirizzamento della stampante locale.

1. Scegli la scheda **Impostazioni utente**, quindi espandi la sezione **Appunti, trasferimento file, stampa su dispositivo te locale e autorizzazioni di autenticazione**.

1. Per **Stampa su dispositivo locale**, verifica che sia selezionata l'opzione **Abilitata**. In caso contrario, scegli **Modifica**, quindi scegli **Abilitata**.

1. Scegliere **Aggiorna**.

In alternativa, puoi abilitare il reindirizzamento della stampante locale utilizzando l'API WorkSpaces Applications, un AWS SDK o AWS Command Line Interface ()AWS CLI.

# Come disabilitare il reindirizzamento della stampante locale
<a name="disable-local-printer-redirection"></a>

Per disabilitare il reindirizzamento della stampante locale, segui questi passaggi.

**Per disabilitare il reindirizzamento della stampante locale**

Puoi disabilitare il reindirizzamento della stampante locale in uno dei seguenti modi:
+ Durante l'installazione del client sui dispositivi gestiti. Per ulteriori informazioni, consulta [Scegliere se disabilitare il reindirizzamento della stampante locale](install-client-configure-settings.md#disable-local-printer-redirection-client).
+ Utilizzando la console WorkSpaces Applicazioni per disabilitare questa opzione in uno stack di WorkSpaces applicazioni.
+ Utilizzando l'API WorkSpaces Applications, un AWS SDK o il AWS Command Line Interface (AWS CLI) per disabilitare questa opzione in uno stack di WorkSpaces applicazioni.