Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengontrol pengalaman WorkSpaces klien untuk pengguna Anda
Mulai 25 Agustus 2026, Amazon WorkSpaces memperkenalkan klien WorkSpaces Windows baru dengan antarmuka yang diperbarui, dirancang agar lebih mudah digunakan, dengan aliran koneksi yang disederhanakan, pengaturan dan alat sesi yang lebih mudah ditemukan, pesan kesalahan yang lebih bermanfaat, dan fitur Kesehatan Sesi baru.
Pengalaman baru (disebut sebagai “baru” di sisa dokumen ini) akan disertakan dalam paket penginstal aplikasi klien mulai dari versi 5.34, dan akan menginstal dan berjalan bersama pengalaman saat ini (disebut sebagai “klasik”).
Secara default, pengguna akhir Anda di klien Amazon WorkSpaces Windows akan melihat opsi untuk “Coba” pengalaman baru setelah mereka memilih WorkSpace untuk terhubung. Jika mereka mengklik opsi ini, mereka akan melihat dialog konfirmasi yang menjelaskan apa yang diharapkan, dan jika mereka melanjutkan, pengalaman klasik akan ditutup, dan pengalaman baru akan terbuka dalam beberapa detik. Demikian juga, dalam pengalaman baru, mereka akan melihat opsi untuk “Beralih kembali ke klasik” kapan saja. Meskipun kami sangat menyarankan Anda untuk mengizinkan perilaku default, kami memperkenalkan fitur Kebijakan Pengalaman Klien jika Anda perlu mengelola peluncuran pengalaman klien baru untuk pengguna akhir Anda.
Sebagai administrator, menggunakan Kebijakan Pengalaman Klien, Anda dapat mengontrol pengalaman mana yang dilihat pengguna Anda, dan apakah mereka dapat beralih di antara keduanya. Kebijakan ini tersedia sekarang — sehingga Anda dapat memutuskan bagaimana pengalaman baru diluncurkan kepada pengguna Anda dan menerapkan perilaku yang Anda inginkan sebelum klien baru diluncurkan.
Topik ini menjelaskan nilai kebijakan yang tersedia, cara mengatur kebijakan melalui WorkSpaces API atau melalui registri Windows, dan bagaimana klien menyelesaikan kebijakan saat pengguna terhubung.
**catatan**
Pengalaman klasik diperlukan untuk terhubung ke PCoIP-based WorkSpaces dan ke WorkSpaces Pools, dan akan terus didukung sesuai dengan pemberitahuan akhir dukungan masing-masing ([PCoIP ](workspaces-pcoip-end-of-support.md) dan [ WorkSpaces Pools](wsp-pools-end-of-support.md)).
## Cara kerja Kebijakan Pengalaman Klien
Kebijakan Pengalaman Klien menentukan pengalaman klien mana yang dilihat pengguna saat mereka terhubung ke WorkSpace, dan apakah opsi untuk beralih pengalaman tersedia bagi mereka.
Anda dapat mengatur kebijakan di dua tingkat:
+ **[Opsi 1: Per direktori, melalui WorkSpaces API ](#client-experience-policy-api) ** - Berlaku untuk semua pengguna yang terhubung ke WorkSpaces terdaftar di direktori itu. Atur ini menggunakan operasi `ModifyClientProperties` API. Ini adalah metode yang direkomendasikan untuk sebagian besar administrator karena tidak memerlukan pengelolaan mesin klien.
+ **[Opsi 2: Per mesin, melalui registri Windows ](#client-experience-policy-registry) ** - Berlaku untuk semua pengguna pada mesin Windows tertentu. Terapkan ini menggunakan Group Policy (GPO) atau alat manajemen konfigurasi seperti SCCM. Gunakan metode ini saat Anda mengelola perangkat klien secara terpusat dan menginginkan kontrol tingkat mesin.
Jika Anda tidak mengambil tindakan, kebijakan default adalah`USER_CHOICE`: pengguna akhir Anda yang menggunakan klien Amazon WorkSpaces Windows versi 5.34 atau lebih tinggi akan default ke pengalaman klasik tetapi dapat memilih sendiri pengalaman baru, dengan mengklik opsi “Coba” di klien.
## Nilai-nilai kebijakan
Kebijakan Pengalaman Klien menerima nilai-nilai berikut.
| Nilai | Perilaku | Bisakah pengguna beralih? |
| --- | --- | --- |
| `FORCE_CLASSIC` | Pengguna selalu melihat pengalaman klasik. | Tidak - opsi sakelar disembunyikan. |
| `FORCE_UI_2026` | Pengguna selalu melihat pengalaman baru. | Tidak - opsi sakelar disembunyikan. |
| `USER_CHOICE` | Pengguna memilih pengalaman mana yang akan digunakan dan dapat beralih dengan bebas. | Ya - opsi sakelar terlihat. |
**penting**
Jika Anda memiliki pengguna akhir yang perlu terhubung ke PCoIP-based WorkSpaces atau ke WorkSpaces Pools, sebaiknya jangan gunakan `FORCE_UI_2026` opsi ini, karena pengalaman klien baru tidak mendukung layanan ini. Dalam skenario ini, menyetel nilai ke `USER_CHOICE` akan memungkinkan pengguna akhir Anda yang tidak menggunakan layanan ini untuk memilih pengalaman klien baru, sementara pengguna Anda di PCoIP dan WorkSpaces Pools masih akan memiliki kemampuan untuk menggunakan pengalaman klien klasik.
## Urutan resolusi kebijakan
Ketika pengguna memilih a WorkSpace untuk terhubung, klien menyelesaikan kebijakan efektif dengan memeriksa setiap sumber dalam urutan berikut. Sumber pertama yang memiliki set nilai menang dan menggantikan semua sumber prioritas rendah. Jika API maupun registri tidak memiliki set nilai, klien menerapkan `USER_CHOICE` perilaku default.
1. **Kebijakan terpusat (WorkSpaces API) ** — kebijakan per direktori yang Anda tetapkan. `ModifyClientProperties`
1. **Kebijakan mesin lokal (registri HKLM) ** — kebijakan per-mesin yang Anda terapkan melalui GPO atau SCCM.
1. **Preferensi pengguna ** — pengalaman yang terakhir dipilih pengguna (hanya berlaku jika kebijakan efektif berlaku`USER_CHOICE`, yang merupakan default jika tidak ada kebijakan yang ditetapkan).
1. **Versi klien default ** — pengalaman hardcode dalam build klien (lihat tabel berikut).
| Versi klien | Pengalaman default | Pengalaman yang didukung |
| --- | --- | --- |
| 5.33 dan sebelumnya | Klasik | Klasik saja (Pengalaman baru tidak didukung) |
| 5.34 dan yang lebih baru | Klasik | Klasik dan baru |
**catatan**
Versi klien 5.33 dan yang lebih lama tidak mendukung pengalaman baru dan mengabaikan kebijakan. Pengguna pada versi tersebut selalu melihat pengalaman klasik.
## Ketika kebijakan tersebut berlaku
Klien menerapkan kebijakan pada fase pra-sesi — setelah pengguna memilih WorkSpace untuk terhubung, tetapi sebelum mereka masuk. Pengalaman pengalihan memerlukan restart klien. Jika pengalaman yang diselesaikan berbeda dari yang sedang berjalan, klien akan meminta pengguna untuk memulai ulang klien untuk melanjutkan menghubungkan ke yang mereka pilih WorkSpace. Kebijakan tidak dievaluasi selama sesi aktif. Jika Anda mengubah kebijakan saat pengguna terhubung, perubahan akan berlaku saat berikutnya pengguna memulai klien atau keluar dan masuk kembali.
## Opsi 1: Tetapkan kebijakan melalui WorkSpaces API
Gunakan operasi [`ModifyClientProperties`](https://docs.aws.amazon.com/workspaces/latest/api/API_ModifyClientProperties.html) API untuk menyetel kebijakan untuk direktori. `ClientExperiencePolicy`Bidang adalah bagian dari [`ClientProperties`](https://docs.aws.amazon.com/workspaces/latest/api/API_ClientProperties.html) objek.
**catatan**
Saat peluncuran, pengaturan ini hanya tersedia melalui SDK AWS CLI dan. WorkSpacesdukungan konsol direncanakan untuk pembaruan di masa mendatang.
### AWS CLI contoh
Perintah berikut menetapkan kebijakan untuk direktori ke`USER_CHOICE`, memungkinkan pengguna memilih pengalaman mereka:
```
aws workspaces modify-client-properties \
--resource-id d-1234567890 \
--client-properties ClientExperiencePolicy=USER_CHOICE
```
Untuk memaksa semua pengguna dalam direktori ke pengalaman baru:
```
aws workspaces modify-client-properties \
--resource-id d-1234567890 \
--client-properties ClientExperiencePolicy=FORCE_UI_2026
```
### Lihat kebijakan saat ini
Gunakan operasi `DescribeClientProperties` API untuk melihat kebijakan yang saat ini ditetapkan untuk direktori:
```
aws workspaces describe-client-properties \
--resource-ids d-1234567890
```
Tanggapan mencakup `ClientExperiencePolicy` bidang jika kebijakan telah ditetapkan. Jika tidak ada kebijakan yang ditetapkan untuk direktori, bidang tersebut dihilangkan dan klien kembali ke kebijakan registri tingkat mesin (jika disetel) atau perilaku default. `USER_CHOICE`
```
{
"ClientPropertiesList": [
{
"ResourceId": "d-1234567890",
"ClientProperties": {
"ReconnectEnabled": "ENABLED",
"LogUploadEnabled": "ENABLED",
"ClientExperiencePolicy": "USER_CHOICE"
}
}
]
}
```
**Catatan**
Anda tidak dapat menghapus `ClientExperiencePolicy` nilai setelah Anda mengaturnya. Untuk mengembalikan perilaku default, atur nilainya ke`USER_CHOICE`.
Jika Anda mengirimkan nilai yang tidak dikenali, API mengembalikan. `InvalidParameterValuesException`
## Opsi 2: Tetapkan kebijakan melalui registri Windows
Jika Anda mengelola mesin klien secara terpusat, Anda dapat menetapkan kebijakan per mesin menggunakan nilai registri berikut. Terapkan melalui Kebijakan Grup atau alat manajemen konfigurasi.
```
Path: HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\Amazon WorkSpaces Client
Name: ClientExperiencePolicy
Type: REG_SZ
Value: FORCE_CLASSIC | FORCE_UI_2026 | USER_CHOICE
```
Jalur registri ini konsisten dengan pengaturan mesin WorkSpaces klien lainnya, seperti `clientUpgradeDisabled` dan`WSUseDualStackIPv6`.
Untuk mengatur nilai dari prompt perintah yang ditinggikan, gunakan perintah berikut. Contoh ini memaksa pengalaman baru:
```
reg add "HKLM\SOFTWARE\Amazon\Amazon WorkSpaces Client" /v ClientExperiencePolicy /t REG_SZ /d FORCE_UI_2026 /f
```
Untuk menghapus nilai:
```
reg delete "HKLM\SOFTWARE\Amazon\Amazon WorkSpaces Client" /v ClientExperiencePolicy /f
```
Kebijakan registri hanya berlaku jika tidak ada kebijakan API per direktori yang ditetapkan untuk direktori yang terhubung pengguna. Kebijakan API per direktori selalu diutamakan daripada kebijakan registri tingkat mesin.
**penting**
Setelah kebijakan per direktori ditetapkan melalui API, kebijakan tersebut tidak dapat dihapus dan selalu diutamakan daripada kebijakan registri — termasuk saat disetel ke. `USER_CHOICE` Jika Anda mengandalkan kebijakan registri tingkat mesin, hindari menyetel kebijakan per direktori untuk direktori tersebut.
## Apa yang akan dialami pengguna Anda
+ **Saat Anda mengatur `USER_CHOICE` (atau tidak mengambil tindakan, karena `USER_CHOICE` merupakan default): ** Pengguna melihat tautan di klien yang memungkinkan mereka beralih antara pengalaman klasik dan baru. Beralih meminta mereka untuk me-restart klien sebelum pengalaman yang baru dipilih terbuka (dalam beberapa detik).
+ **Saat Anda mengatur `FORCE_CLASSIC` atau`FORCE_UI_2026`: ** Pengguna melihat pengalaman yang Anda pilih, dan opsi sakelar disembunyikan. Jika pengguna beralih ke direktori dengan kebijakan paksa yang berbeda, klien meminta mereka untuk memulai ulang ke pengalaman yang telah Anda tetapkan melalui Kebijakan Pengalaman Klien. WorkSpace
## Rencanakan peluncuran Anda
Kami merekomendasikan pendekatan berikut saat mengadopsi pengalaman baru:
1. **Evaluasi kebutuhan pengguna akhir Anda. ** Jika Anda memiliki pengguna akhir yang perlu terhubung ke PCoIP-based WorkSpaces atau Pool, WorkSpaces pertimbangkan cara memasukkannya ke dalam strategi keseluruhan Anda.
1. **Tentukan postur default Anda. ** Pilih apakah akan mengizinkan pengguna memilih (`USER_CHOICE`), menstandarisasi pengalaman baru (`FORCE_UI_2026`), atau mempertahankan pengalaman klasik selama transisi (`FORCE_CLASSIC`).
1. **Pastikan klien terkini. ** Kebijakan ini hanya dihormati oleh klien versi 5.34 dan yang lebih baru. Konfirmasikan pengguna Anda menggunakan versi yang didukung sebelum mengandalkan kebijakan.
1. **Berkomunikasi dengan pengguna Anda. ** Beri tahu pengguna kapan pengalaman baru akan tersedia dan apakah mereka dapat beralih.
1. **Lakukan penyesuaian yang diperlukan. ** Setelah pengalaman baru tersedia, lakukan evaluasi yang lebih rinci, dapatkan umpan balik dari pengguna akhir Anda, dan terapkan perubahan postur jika diperlukan.
## Topik terkait
+ [Ubah properti klien ](https://docs.aws.amazon.com/workspaces/latest/api/API_ModifyClientProperties.html)
+ [Jelaskan properti klien ](https://docs.aws.amazon.com/workspaces/latest/api/API_DescribeClientProperties.html)
+ [ClientProperties tipe data ](https://docs.aws.amazon.com/workspaces/latest/api/API_ClientProperties.html)