As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Controle a experiência WorkSpaces do cliente para seus usuários
A partir de 25 de agosto de 2026, a Amazon WorkSpaces apresentará um novo cliente WorkSpaces Windows com uma interface atualizada, projetada para ser mais fácil de usar, com um fluxo de conexão simplificado, configurações e ferramentas de sessão mais fáceis de encontrar, mensagens de erro mais úteis e um novo recurso de integridade da sessão.
A nova experiência (chamada de “nova” no restante deste documento) será incluída no pacote do instalador do aplicativo cliente a partir da versão 5.34 e será instalada e executada junto com a experiência atual (chamada de “clássica”).
Por padrão, seus usuários finais no cliente Amazon WorkSpaces Windows verão a opção de “experimentar” a nova experiência depois de selecionarem um WorkSpace para se conectar. Se clicarem nessa opção, verão uma caixa de diálogo de confirmação explicando o que esperar e, se continuarem, a experiência clássica será fechada e a nova experiência será aberta em alguns segundos. Da mesma forma, na nova experiência, eles verão a opção de “Voltar ao clássico” a qualquer momento. Embora seja altamente recomendável que você permita o comportamento padrão, estamos introduzindo um recurso de Política de Experiência do Cliente caso você precise gerenciar a implantação da nova experiência do cliente para seus usuários finais.
Como administrador, usando a Política de Experiência do Cliente, você pode controlar a experiência que seus usuários veem e se eles podem alternar entre as duas. A política está disponível agora, para que você possa decidir como a nova experiência será implementada para seus usuários e implementar o comportamento desejado antes do lançamento do novo cliente.
Este tópico explica os valores da política disponíveis, como definir a política por meio da WorkSpaces API ou do registro do Windows e como o cliente resolve a política quando um usuário se conecta.
**nota**
A experiência clássica é necessária para se conectar a PCoIP-based WorkSpaces e aos WorkSpaces Pools e continuará a receber suporte de acordo com seus respectivos avisos de fim de suporte ([PCoIP ](workspaces-pcoip-end-of-support.md) e [ WorkSpaces Pools). ](wsp-pools-end-of-support.md)
## Como funciona a Política de Experiência do Cliente
A Política de Experiência do Cliente determina qual experiência de cliente um usuário vê quando se conecta a um WorkSpace e se a opção de alternar experiências está disponível para ele.
Você pode definir a política em dois níveis:
+ **[Opção 1: Por diretório, por meio da WorkSpaces API ](#client-experience-policy-api) ** — Aplica-se a todos os usuários que se conectam aos WorkSpaces registrados nesse diretório. Defina isso usando a operação `ModifyClientProperties` da API. Esse é o método recomendado para a maioria dos administradores porque não exige o gerenciamento da máquina cliente.
+ **[Opção 2: Por máquina, por meio do registro do Windows ](#client-experience-policy-registry) ** — Aplica-se a todos os usuários em uma máquina Windows específica. Implemente isso usando a Política de Grupo (GPO) ou uma ferramenta de gerenciamento de configuração, como o SCCM. Use esse método quando você gerencia dispositivos cliente centralmente e deseja controle no nível da máquina.
Se você não tomar nenhuma ação, a política padrão é`USER_CHOICE`: seus usuários finais que usam o cliente Amazon WorkSpaces Windows versão 5.34 ou superior usarão como padrão a experiência clássica, mas poderão optar pela nova experiência clicando na opção “Testar” no cliente.
## Valores da política
A Política de Experiência do Cliente aceita os seguintes valores.
| Valor | Comportamento | O usuário pode mudar? |
| --- | --- | --- |
| `FORCE_CLASSIC` | Os usuários sempre veem a experiência clássica. | Não — a opção de troca está oculta. |
| `FORCE_UI_2026` | Os usuários sempre veem a nova experiência. | Não — a opção de troca está oculta. |
| `USER_CHOICE` | Os usuários escolhem qual experiência usar e podem alternar livremente. | Sim — a opção de troca está visível. |
**Importante**
Se você tiver usuários finais que precisem se conectar a PCoIP-based WorkSpaces ou a WorkSpaces pools, recomendamos não usar a `FORCE_UI_2026` opção, pois a nova experiência do cliente não oferece suporte a esses serviços. Nesse cenário, definir o valor como `USER_CHOICE` permitirá que seus usuários finais que não estão nesses serviços optem pela nova experiência do cliente, enquanto seus usuários de PCoIP e WorkSpaces Pools ainda poderão usar a experiência clássica do cliente.
## Ordem de resolução de políticas
Quando um usuário WorkSpace seleciona um para se conectar, o cliente resolve a política efetiva verificando cada fonte na seguinte ordem. A primeira fonte que tem um conjunto de valores vence e substitui todas as fontes de menor prioridade. Se nem a API nem o registro tiverem um valor definido, o cliente aplicará o `USER_CHOICE` comportamento padrão.
1. **Política centralizada (WorkSpaces API) ** — a política por diretório com `ModifyClientProperties` a qual você define.
1. **Política de máquina local (registro HKLM) ** — a política por máquina que você implanta por meio de GPO ou SCCM.
1. **Preferência do usuário ** — a experiência que o usuário escolheu pela última vez (só se aplica quando a política efetiva é`USER_CHOICE`, que é a padrão quando nenhuma política foi definida).
1. **Versão padrão do cliente ** — a experiência codificada na compilação do cliente (consulte a tabela a seguir).
| Versão do cliente | Experiência padrão | Experiências suportadas |
| --- | --- | --- |
| 5.33 e anteriores | Clássica | Somente clássico (nova experiência não suportada) |
| 5.34 e posteriores | Clássica | Clássico e novo |
**nota**
As versões 5.33 e anteriores do cliente não oferecem suporte à nova experiência e ignoram a política. Os usuários dessas versões sempre veem a experiência clássica.
## Quando a política entra em vigor
O cliente aplica a política na fase de pré-sessão — depois que um usuário WorkSpace seleciona um para se conectar, mas antes de entrar. A troca de experiências exige a reinicialização do cliente. Se a experiência resolvida for diferente da que está sendo executada atualmente, o cliente solicitará que o usuário reinicie o cliente para continuar se conectando ao selecionado WorkSpace. A política não é avaliada durante uma sessão ativa. Se você alterar uma política enquanto um usuário estiver conectado, a alteração entrará em vigor na próxima vez que o usuário iniciar o cliente ou sair e entrar novamente.
## Opção 1: definir a política por meio da WorkSpaces API
Use a operação [`ModifyClientProperties`](https://docs.aws.amazon.com/workspaces/latest/api/API_ModifyClientProperties.html) da API para definir a política para um diretório. O `ClientExperiencePolicy` campo faz parte do [`ClientProperties`](https://docs.aws.amazon.com/workspaces/latest/api/API_ClientProperties.html) objeto.
**nota**
No lançamento, essa configuração está disponível somente por meio dos SDKs AWS CLI e. WorkSpaceso suporte do console está planejado para uma atualização futura.
### AWS CLI exemplo
O comando a seguir define a política de um diretório como`USER_CHOICE`, permitindo que os usuários escolham sua experiência:
```
aws workspaces modify-client-properties \
--resource-id d-1234567890 \
--client-properties ClientExperiencePolicy=USER_CHOICE
```
Para forçar todos os usuários em um diretório a adotarem a nova experiência:
```
aws workspaces modify-client-properties \
--resource-id d-1234567890 \
--client-properties ClientExperiencePolicy=FORCE_UI_2026
```
### Veja a política atual
Use a operação `DescribeClientProperties` da API para visualizar a política atualmente definida para um diretório:
```
aws workspaces describe-client-properties \
--resource-ids d-1234567890
```
A resposta inclui o `ClientExperiencePolicy` campo se uma política tiver sido definida. Se nenhuma política tiver sido definida para o diretório, o campo será omitido e o cliente retornará à política de registro no nível da máquina (se definida) ou ao comportamento padrão. `USER_CHOICE`
```
{
"ClientPropertiesList": [
{
"ResourceId": "d-1234567890",
"ClientProperties": {
"ReconnectEnabled": "ENABLED",
"LogUploadEnabled": "ENABLED",
"ClientExperiencePolicy": "USER_CHOICE"
}
}
]
}
```
**Observações**
Você não pode limpar o `ClientExperiencePolicy` valor depois de defini-lo. Para restaurar o comportamento padrão, defina o valor como`USER_CHOICE`.
Se você enviar um valor não reconhecido, a API retornará um`InvalidParameterValuesException`.
## Opção 2: definir a política por meio do registro do Windows
Se você gerencia centralmente as máquinas clientes, pode definir uma política por máquina usando o seguinte valor de registro. Implante-o por meio da Política de Grupo ou de uma ferramenta de gerenciamento de configuração.
```
Path: HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\Amazon WorkSpaces Client
Name: ClientExperiencePolicy
Type: REG_SZ
Value: FORCE_CLASSIC | FORCE_UI_2026 | USER_CHOICE
```
Esse caminho de registro é consistente com outras configurações da máquina WorkSpaces cliente, como `clientUpgradeDisabled` `WSUseDualStackIPv6` e.
Para definir o valor em um prompt de comando elevado, use o comando a seguir. Esse exemplo força a nova experiência:
```
reg add "HKLM\SOFTWARE\Amazon\Amazon WorkSpaces Client" /v ClientExperiencePolicy /t REG_SZ /d FORCE_UI_2026 /f
```
Para remover o valor:
```
reg delete "HKLM\SOFTWARE\Amazon\Amazon WorkSpaces Client" /v ClientExperiencePolicy /f
```
A política de registro se aplica somente quando nenhuma política de API por diretório é definida para o diretório ao qual o usuário se conecta. Uma política de API por diretório sempre tem precedência sobre a política de registro no nível da máquina.
**Importante**
Depois que uma política por diretório é definida por meio da API, ela não pode ser removida e sempre tem precedência sobre a política de registro, inclusive quando está definida como. `USER_CHOICE` Se você confiar em políticas de registro em nível de máquina, evite definir a política por diretório para esses diretórios.
## O que seus usuários experimentarão
+ **Quando você define `USER_CHOICE` (ou não realiza nenhuma ação, já que `USER_CHOICE` é o padrão): ** os usuários veem um link no cliente que permite alternar entre a experiência clássica e a nova. A troca solicita que eles reiniciem o cliente antes que a experiência recém-escolhida seja aberta (em alguns segundos).
+ **Quando você define `FORCE_CLASSIC` ou`FORCE_UI_2026`: ** Os usuários veem a experiência que você selecionou e a opção de alternar fica oculta. Se um usuário mudar para um WorkSpace em um diretório com uma política forçada diferente, o cliente solicitará que ele reinicie a experiência que você definiu por meio da Política de Experiência do Cliente.
## Planeje seu lançamento
Recomendamos a seguinte abordagem ao adotar a nova experiência:
1. **Avalie as necessidades de seus usuários finais. ** Se você tem usuários finais que precisam se conectar aos PCoIP-based WorkSpaces nossos WorkSpaces pools, considere como incorporar isso à sua estratégia geral.
1. **Decida sua postura padrão. ** Escolha se deseja permitir que os usuários optem por participar (`USER_CHOICE`), padronizar a nova experiência (`FORCE_UI_2026`) ou manter a experiência clássica durante a transição (`FORCE_CLASSIC`).
1. **Certifique-se de que os clientes estejam atualizados. ** A política é respeitada somente pelas versões 5.34 e posteriores do cliente. Confirme se seus usuários estão usando uma versão compatível antes de confiar na política.
1. **Comunique-se com seus usuários. ** Informe aos usuários quando a nova experiência estará disponível e se eles poderão mudar.
1. **Faça os ajustes necessários. ** Quando a nova experiência estiver disponível, faça uma avaliação mais detalhada, obtenha feedback dos usuários finais e implemente qualquer mudança de postura, se necessário.
## Tópicos relacionados
+ [Modificar propriedades do cliente ](https://docs.aws.amazon.com/workspaces/latest/api/API_ModifyClientProperties.html)
+ [Descreva as propriedades do cliente ](https://docs.aws.amazon.com/workspaces/latest/api/API_DescribeClientProperties.html)
+ [ClientProperties tipo de dados](https://docs.aws.amazon.com/workspaces/latest/api/API_ClientProperties.html)