本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 控制用户的 WorkSpaces 客户体验
从2026年8月25日起，亚马逊 WorkSpaces 将推出一款新的 WorkSpaces Windows客户端，该客户端具有更新的界面，旨在更易于使用，具有简化的连接流程，更易于查找的设置和会话工具，更有用的错误消息以及新的会话健康功能。
新体验（在本文档的其余部分中称为 “新体验”）将从版本 5.34 开始包含在客户端应用程序安装程序包中，并将与当前体验（称为 “经典”）一起安装和运行。
默认情况下，您在亚马逊 WorkSpaces Windows 客户端上的最终用户在选择要连接的后将看到 “试用” 新体验的 WorkSpace 选项。如果他们点击此选项，他们将看到一个确认对话框，说明预期的内容，如果他们继续，经典体验将关闭，新体验将在几秒钟内打开。同样，在新体验中，他们将随时看到 “切换回经典版” 的选项。虽然我们强烈建议您允许默认行为，但我们正在推出 “客户体验政策” 功能，以防您需要为最终用户管理新客户体验的推出。
作为管理员，使用客户体验政策，您可以控制用户看到的体验以及他们是否可以在两者之间切换。该政策现已推出，因此您可以决定如何向用户推出新体验，并在新客户启动之前将想要的行为付诸实践。
本主题说明了可用的策略值、如何通过 WorkSpaces API 或 Windows 注册表设置策略，以及用户连接时客户端如何解析策略。
**注意**
连接 PCoIP-based WorkSpaces 和连接 WorkSpaces 矿池需要经典体验，并将根据各自的终止支持通知（[PCoIP ](workspaces-pcoip-end-of-support.md) 和[WorkSpaces 矿池](wsp-pools-end-of-support.md)）继续提供支持。
## 客户体验政策的运作方式
客户体验政策决定了用户在连接时看到的客户体验 WorkSpace，以及他们是否可以选择切换体验。
您可以将策略设置为两个级别：
+ **[选项 1：通过 WorkSpaces API 按目录划](#client-experience-policy-api)**分 — 适用于连接到该目录中 WorkSpaces 注册的所有用户。使用 `ModifyClientProperties` API 操作进行此设置。对于大多数管理员来说，这是推荐的方法，因为它不需要管理客户端计算机。
+ **[选项 2：每台计算机，通过 Windows 注册表 ](#client-experience-policy-registry) ** — 适用于特定 Windows 计算机上的所有用户。使用组策略 (GPO) 或 SCCM 等配置管理工具进行部署。当您集中管理客户端设备并需要计算机级控制时，请使用此方法。
如果您不采取任何措施，则该政策默认为`USER_CHOICE`：使用亚马逊 WorkSpaces Windows 客户端 5.34 或更高版本的最终用户将默认为经典体验，但可以通过点击客户端中的 “试用” 选项自行选择加入新体验。
## 政策价值
客户体验政策接受以下价值观。
| 值 | 行为 | 用户可以切换吗？ |
| --- | --- | --- |
| `FORCE_CLASSIC` | 用户总能看到经典体验。 | 否 — 切换选项处于隐藏状态。 |
| `FORCE_UI_2026` | 用户总能看到新的体验。 | 否 — 切换选项处于隐藏状态。 |
| `USER_CHOICE` | 用户可以选择使用哪种体验，并可以自由切换。 | 是 — 切换选项可见。 |
**重要**
如果您的最终用户需要连接 PCoIP-based WorkSpaces 或连接 WorkSpaces 矿池，我们建议不要使用该`FORCE_UI_2026`选项，因为新的客户体验不支持这些服务。在这种情况下，将该值设置为`USER_CHOICE`将允许未使用这些服务的最终用户选择加入新的客户体验，而您在 PCoIP 和 P WorkSpaces ools 上的用户仍然能够使用经典客户体验。
## 政策解决顺序
当用户选择 WorkSpace 要连接时，客户端通过按以下顺序检查每个源来解析有效策略。第一个设置了值的来源获胜并取代所有优先级较低的来源。如果 API 和注册表均未设置值，则客户端将应用默认`USER_CHOICE`行为。
1. **集中式策略 (WorkSpaces API) ** — 您设置的`ModifyClientProperties`每目录策略。
1. **本地计算机策略（HKLM 注册表）**— 您通过 GPO 或 SCCM 部署的每台计算机策略。
1. **用户首选项 ** — 用户上次选择的体验（仅在有效策略为时适用`USER_CHOICE`，这是未设置政策时的默认设置）。
1. **客户端版本默认 ** — 在客户端版本中硬编码的体验（参见下表）。
| 客户端版本 | 默认体验 | 支持的体验 |
| --- | --- | --- |
| 5.33 及更早版本 | Classic | 仅限经典版（不支持新体验） |
| 5.34 及更高版本 | Classic | 经典与新款 |
**注意**
客户端版本 5.33 及更早版本不支持新体验，因此会忽略该政策。使用这些版本的用户总能看到经典体验。
## 政策何时生效
客户端在会话前阶段应用策略，即在用户选择 WorkSpace 要连接之后，但在登录之前。切换体验需要重新启动客户端。如果已解决的体验与当前运行的体验不同，则客户端将提示用户重新启动客户端，以继续连接到他们选择的客户端 WorkSpace。在活动会话期间不评估该策略。如果您在用户连接时更改策略，则该更改将在用户下次启动客户端或注销并重新登录时生效。
## 选项 1：通过 WorkSpaces API 设置政策
使用 [`ModifyClientProperties`](https://docs.aws.amazon.com/workspaces/latest/api/API_ModifyClientProperties.html) API 操作为目录设置策略。该`ClientExperiencePolicy`字段是[`ClientProperties`](https://docs.aws.amazon.com/workspaces/latest/api/API_ClientProperties.html)对象的一部分。
**注意**
启动时，此设置仅可通过 AWS CLI 和 SDK 使用。 WorkSpaces计划在将来的更新中提供控制台支持。
### AWS CLI 示例
以下命令将目录的策略设置为`USER_CHOICE`，允许用户选择自己的体验：
```
aws workspaces modify-client-properties \
--resource-id d-1234567890 \
--client-properties ClientExperiencePolicy=USER_CHOICE
```
要强制目录中的所有用户使用新体验，请执行以下操作：
```
aws workspaces modify-client-properties \
--resource-id d-1234567890 \
--client-properties ClientExperiencePolicy=FORCE_UI_2026
```
### 查看当前政策
使用 `DescribeClientProperties` API 操作查看当前为目录设置的策略：
```
aws workspaces describe-client-properties \
--resource-ids d-1234567890
```
如果已设置政策，则响应中包含该`ClientExperiencePolicy`字段。如果从未为该目录设置任何策略，则会省略该字段，客户端将退回到计算机级注册表策略（如果已设置）或默认`USER_CHOICE`行为。
```
{
"ClientPropertiesList": [
{
"ResourceId": "d-1234567890",
"ClientProperties": {
"ReconnectEnabled": "ENABLED",
"LogUploadEnabled": "ENABLED",
"ClientExperiencePolicy": "USER_CHOICE"
}
}
]
}
```
**注意**
设置该`ClientExperiencePolicy`值后无法将其清除。要恢复默认行为，请将该值设置为`USER_CHOICE`。
如果您提交了无法识别的值，则 API 会返回。`InvalidParameterValuesException`
## 选项 2：通过 Windows 注册表设置策略
如果您集中管理客户端计算机，则可以使用以下注册表值设置每台计算机的策略。通过组策略或配置管理工具进行部署。
```
Path: HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\Amazon WorkSpaces Client
Name: ClientExperiencePolicy
Type: REG_SZ
Value: FORCE_CLASSIC | FORCE_UI_2026 | USER_CHOICE
```
此注册表路径与其他 WorkSpaces 客户端计算机设置（例如`clientUpgradeDisabled`和）一致`WSUseDualStackIPv6`。
要通过提升的命令提示符设置值，请使用以下命令。这个例子强制带来了新的体验：
```
reg add "HKLM\SOFTWARE\Amazon\Amazon WorkSpaces Client" /v ClientExperiencePolicy /t REG_SZ /d FORCE_UI_2026 /f
```
要删除该值，请执行以下操作：
```
reg delete "HKLM\SOFTWARE\Amazon\Amazon WorkSpaces Client" /v ClientExperiencePolicy /f
```
仅当没有为用户连接的目录设置每个目录 API 策略时，注册表策略才适用。每个目录的 API 策略始终优先于计算机级注册表策略。
**重要**
一旦通过 API 设置了每个目录的策略，就无法将其删除，并且始终优先于注册表策略，包括将其设置为`USER_CHOICE`时。如果您依赖计算机级注册表策略，请避免为这些目录设置每个目录的策略。
## 您的用户将体验到什么
+ **当您设置`USER_CHOICE`（或不采取任何操作，因为`USER_CHOICE`这是默认设置）时：**用户会在客户端中看到一个允许他们在经典体验和新体验之间切换的链接。切换会提示他们在新选择的体验开始之前（几秒钟内）重新启动客户端。
+ **当您设置`FORCE_CLASSIC`或时`FORCE_UI_2026`：**用户会看到您选择的体验，切换选项处于隐藏状态。如果用户使用不同的强制策略切换到目录 WorkSpace 中的，则客户端会提示他们重启您通过客户体验政策设置的体验。
## 规划您的部署
在采用新体验时，我们建议采用以下方法：
1. **评估您的最终用户的需求。**如果您的终端用户需要连接到 PCoIP-based WorkSpaces 我们的 WorkSpaces 矿池，请考虑如何将其纳入您的总体策略。
1. **决定你的默认姿势。**选择是让用户选择加入 (`USER_CHOICE`)、对新体验进行标准化 (`FORCE_UI_2026`)，还是在过渡期间保留经典体验 (`FORCE_CLASSIC`)。
1. **确保客户是最新的。**仅客户端版本 5.34 及更高版本遵守该政策。在依赖该政策之前，请确认您的用户使用的是支持的版本。
1. **与您的用户沟通。**告知用户新体验何时可用以及他们是否可以切换。
1. **进行任何必要的调整。**新体验推出后，进行更详细的评估，获取最终用户的反馈，并在需要时实施任何姿势变更。
## 相关主题
+ [修改客户机属性 ](https://docs.aws.amazon.com/workspaces/latest/api/API_ModifyClientProperties.html)
+ [描述客户机属性 ](https://docs.aws.amazon.com/workspaces/latest/api/API_DescribeClientProperties.html)
+ [ClientProperties 数据类型 ](https://docs.aws.amazon.com/workspaces/latest/api/API_ClientProperties.html)