本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 為您的使用者控制 WorkSpaces 用戶端體驗
從 2026 年 8 月 25 日開始，Amazon WorkSpaces 推出具有更新界面的新 WorkSpaces Windows 用戶端，旨在更輕鬆地使用，具有簡化的連線流程、easier-to-find的設定和工作階段工具、更有用的錯誤訊息，以及新的工作階段運作狀態功能。
從 5.34 版開始，新的體驗 （在本文件其餘部分中稱為「新」) 將包含在用戶端應用程式安裝程式套件中，並隨目前的體驗一起安裝和執行 （稱為「傳統」)。
根據預設，您在 Amazon WorkSpaces Windows 用戶端上的最終使用者會在選取要連線的 WorkSpace 之後，看到「試用」新體驗的選項。如果他們按一下此選項，他們將看到一個確認對話方塊，說明預期會發生的情況，如果他們繼續，則傳統體驗將會關閉，新的體驗將在幾秒鐘內開啟。同樣地，在新的體驗中，他們將隨時看到「切換回傳統」的選項。雖然我們強烈建議您允許預設行為，但我們會推出用戶端體驗政策功能，以防您需要為最終使用者管理新用戶端體驗的推出。
身為管理員，您可以使用用戶端體驗政策來控制使用者看到的體驗，以及是否可以在兩者之間切換。政策現已推出，因此您可以決定新體驗如何推出給使用者，並在新用戶端啟動之前，將您想要的行為置於適當位置。
本主題說明可用的政策值、如何透過 WorkSpaces API 或 Windows 登錄檔設定政策，以及使用者連線時用戶端如何解析政策。
**注意**
連線到以 PCoIP 為基礎的 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`：使用 Amazon WorkSpaces Windows 用戶端 5.34 版或更新版本的最終使用者將預設為傳統體驗，但可以透過按一下用戶端中的「試用」選項來選擇加入新的體驗。
## 政策值
用戶端體驗政策接受下列值。
| Value | Behavior (行為) | 使用者是否可以切換？ |
| --- | --- | --- |
| `FORCE_CLASSIC` | 使用者一律會看到傳統體驗。 | 否 — 切換選項會隱藏。 |
| `FORCE_UI_2026` | 使用者一律會看到新的體驗。 | 否 — 切換選項會隱藏。 |
| `USER_CHOICE` | 使用者選擇要使用的體驗，並可自由切換。 | 是 — 顯示切換選項。 |
**重要**
如果您有最終使用者需要連線到 PCoIP 型 WorkSpaces 或 WorkSpaces 集區，建議您不要使用 `FORCE_UI_2026`選項，因為新的用戶端體驗不支援這些服務。在此案例中，將 值設定為 `USER_CHOICE` 將允許不在這些服務上的最終使用者選擇加入新的用戶端體驗，而您在 PCoIP 和 WorkSpaces 集區上的使用者仍然可以使用傳統用戶端體驗。
## 政策解析順序
當使用者選取要連線的 WorkSpace 時，用戶端會依下列順序檢查每個來源來解析有效政策。值設定的第一個來源會勝出，並取代所有低優先順序的來源。如果 API 和登錄檔都未設定值，用戶端會套用預設`USER_CHOICE`行為。
1. **集中式政策 (WorkSpaces API)** — 您使用 設定的每個目錄政策`ModifyClientProperties`。
1. **本機機器政策 (HKLM 登錄檔）** — 您透過 GPO 或 SCCM 部署的每個機器政策。
1. **使用者偏好設定** — 使用者上次選擇的體驗 （僅適用於有效政策為 時`USER_CHOICE`，這是未設定政策時的預設值）。
1. **用戶端版本預設** — 用戶端建置中硬式編碼的體驗 （請參閱下表）。
| 用戶端版本 | 預設體驗 | 支援的體驗 |
| --- | --- | --- |
| 5.33 及更早版本 | 傳統 | 僅限傳統 （不支援新體驗） |
| 5.34 及更新版本 | 傳統 | 傳統和新 |
**注意**
用戶端 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 和 SDKs 使用。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 型 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)