

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à.

# 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.