Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Instal dan Konfigurasikan Klien WorkSpaces Aplikasi
Anda dapat meminta pengguna Anda menginstal klien WorkSpaces Aplikasi sendiri, atau Anda dapat menginstal klien WorkSpaces Aplikasi untuk mereka dengan menjalankan PowerShell skrip dari jarak jauh.
Anda harus memenuhi syarat perangkat USB yang ingin Anda aktifkan pengguna Anda untuk digunakan dengan sesi streaming mereka. Jika perangkat USB mereka tidak memenuhi syarat, itu tidak akan terdeteksi oleh WorkSpaces Aplikasi dan tidak dapat dibagikan dengan sesi.
Topik berikut menjelaskan cara menginstal dan mengkonfigurasi klien WorkSpaces Aplikasi.
**Topics**
+ [Mintalah Pengguna Anda Menginstal Klien WorkSpaces Aplikasi Sendiri](user-install-client.md)
+ [Tutorial: Instal Klien WorkSpaces Aplikasi Amazon Dan Sesuaikan Pengalaman Klien untuk Pengguna Anda](install-client-configure-settings.md)
+ [Perbarui WorkSpaces Aplikasi Enterprise Deployment Tool, Client, dan Driver USB Secara Manual](update-enterprise-deployment-tool-client-usb-driver-manually.md)
+ [Memenuhi Syarat Perangkat USB untuk Digunakan dengan Aplikasi Streaming](qualify-usb-devices.md)
+ [Konfigurasikan Metode Koneksi untuk Pengguna Klien WorkSpaces Aplikasi Anda](use-client-start-streaming-session.md)
+ [Memungkinkan Pengguna untuk Berbagi Perangkat USB dengan Sesi Streaming WorkSpaces Aplikasi](share-usb-devices-with-session.md)
+ [Mengalihkan Sesi Streaming dari Browser Web ke Klien WorkSpaces Aplikasi](redirect-streaming-session-from-web-to-client.md)
+ [Aktifkan Pengalihan Sistem File untuk Pengguna WorkSpaces Aplikasi Anda](enable-file-system-redirection.md)
+ [Aktifkan Pengalihan Printer Lokal untuk Pengguna WorkSpaces Aplikasi Anda](enable-local-printer-redirection.md)
# Mintalah Pengguna Anda Menginstal Klien WorkSpaces Aplikasi Sendiri
Untuk step-by-step panduan yang dapat Anda berikan kepada pengguna Anda untuk membantu mereka menginstal klien WorkSpaces Aplikasi, lihat [Pengaturan untuk Windows](client-application-windows-installation-user.md) atau[Penyiapan dan instalasi untuk macOS](client-application-mac-installation-user.md).
**penting**
Untuk klien Windows, jika organisasi Anda telah menerapkan perangkat lunak antivirus yang mencegah pengguna menjalankan file.exe, Anda harus menambahkan pengecualian untuk memungkinkan pengguna menjalankan program .exe instalasi klien WorkSpaces Aplikasi. Jika tidak, ketika pengguna mencoba menginstal klien, tidak ada yang terjadi, atau mereka menerima kesalahan setelah mereka memulai program instalasi.
Setelah pengguna menginstal klien, jika Anda berencana untuk membiarkan pengguna Anda menggunakan perangkat USB selama sesi streaming WorkSpaces Aplikasi mereka, persyaratan berikut harus dipenuhi:
+ Anda harus memenuhi syarat perangkat USB yang dapat digunakan dengan WorkSpaces Aplikasi. Untuk informasi selengkapnya, lihat [Memenuhi Syarat Perangkat USB untuk Digunakan dengan Aplikasi Streaming](qualify-usb-devices.md).
+ Setelah perangkat mereka memenuhi syarat, pengguna Anda harus berbagi perangkat dengan WorkSpaces Aplikasi setiap kali mereka memulai sesi streaming baru. Untuk panduan yang dapat Anda berikan kepada pengguna Anda untuk menyelesaikan tugas ini, lihat[Perangkat USB](client-application-windows-how-to-share-usb-devices-user.md).
# Tutorial: Instal Klien WorkSpaces Aplikasi Amazon Dan Sesuaikan Pengalaman Klien untuk Pengguna Anda
Bagian berikut menjelaskan cara menginstal klien WorkSpaces Aplikasi dan menyesuaikan pengalaman klien untuk pengguna Anda. Jika Anda berencana untuk mengunduh dan menginstal klien untuk pengguna Anda, unduh terlebih dahulu Enterprise Deployment Tool. Anda kemudian dapat menjalankan PowerShell skrip untuk menginstal klien WorkSpaces Aplikasi dan mengkonfigurasi pengaturan klien dari jarak jauh.
**catatan**
Menggunakan Enterprise Deployment Tool dengan klien MacOS WorkSpaces Aplikasi tidak didukung.
**Topics**
+ [Unduh Alat Penyebaran Perusahaan](#install-client-use-remote-deployment-tool)
+ [Instal WorkSpaces Aplikasi Klien dan Driver USB](#run-powershell-script-install-client-usb-driver-silently)
+ [Mengakses WorkSpaces Aplikasi dengan Klien WorkSpaces Aplikasi](#access-appstream-with-client)
+ [Mengatur Nilai WorkSpaces Registri StarTurl untuk Pengguna Klien Aplikasi](#set-start-url-registry-value)
+ [Mengatur Nilai TrustedDomains Registri untuk Mengaktifkan Domain Lain untuk Klien WorkSpaces Aplikasi](#set-trusted-domains-registry-value)
+ [Buat Catatan AS2 TrustedDomains DNS TXT untuk Mengaktifkan Domain Anda untuk Klien WorkSpaces Aplikasi Tanpa Perubahan Registri](#create-AS2TrustedDomains-DNS-TXT-record-client)
+ [Nonaktifkan Pencarian Rekaman DNS TXT untuk Domain Tepercaya](#disable-DNS-TXT-record-lookup-client)
+ [Pilih Apakah akan Menonaktifkan Pembaruan Klien Otomatis](#disable-automatic-updates-client)
+ [Pilih Apakah akan Menonaktifkan Unggahan Log Diagnostik Sesuai Permintaan](#disable-on-demand-diagnostic-log-uploads)
+ [Pilih Apakah akan Menonaktifkan Mode Aplikasi Asli](#disable-native-application-mode-client)
+ [Pilih Apakah akan Menonaktifkan Pengalihan Printer Lokal](#disable-local-printer-redirection-client)
+ [Pilih Apakah akan Menonaktifkan Pengalihan Kartu Cerdas](#disable-local-smart-card-support-client)
+ [Konfigurasikan Pengaturan Klien WorkSpaces Aplikasi Tambahan untuk Pengguna Anda](#configure-client)
+ [Menggunakan Kebijakan Grup untuk Menyesuaikan WorkSpaces Aplikasi Pengalaman Klien](#configure-client-with-adm-template-group-policy)
## Unduh Alat Penyebaran Perusahaan
Enterprise Deployment Tool mencakup file instalasi klien WorkSpaces Aplikasi dan template administratif Kebijakan Grup.
1. Untuk mengunduh Enterprise Deployment Tool, di kanan bawah halaman [klien yang didukung WorkSpaces Applications](https://clients.amazonappstream.com), pilih link **Enterprise Deployment Tool**. Tautan ini membuka file.zip yang berisi file yang diperlukan untuk versi terbaru alat ini.
1. Untuk mengekstrak file yang diperlukan, navigasikan ke lokasi tempat Anda mengunduh alat, klik kanan folder **AmazonAppStreamClient\$1 EnterpriseSetup \$1**, dan pilih **Ekstrak Semua**. Folder berisi dua program instalasi dan template administratif Kebijakan Grup:
+ WorkSpaces Penginstal klien aplikasi (AmazonAppStreamClientSetup\$1 .msi) - Menginstal klien Aplikasi. WorkSpaces
+ WorkSpaces Aplikasi Penginstal driver USB (AmazonAppStreamUsbDriverSetup\$1 .exe) - Menginstal driver USB WorkSpaces Aplikasi yang diperlukan untuk menggunakan perangkat USB dengan aplikasi yang dialirkan melalui Aplikasi. WorkSpaces
+ WorkSpaces Templat administratif Kebijakan Grup klien aplikasi (as2\$1client\$1config.adm) - Memungkinkan Anda mengkonfigurasi klien Aplikasi melalui Kebijakan Grup. WorkSpaces
## Instal WorkSpaces Aplikasi Klien dan Driver USB
Setelah Anda mengunduh file instalasi klien WorkSpaces Aplikasi, jalankan PowerShell skrip berikut di komputer pengguna untuk menginstal file instalasi klien WorkSpaces Aplikasi, AppStreamClient .exe, dan driver USB secara diam-diam.
**catatan**
Untuk menjalankan skrip ini, Anda harus masuk ke komputer yang berlaku dengan izin Administrator. Anda juga dapat menjalankan skrip dari jarak jauh di bawah akun Sistem saat startup.
```
Start-Process msiexec.exe -Wait -ArgumentList '/i AmazonAppStreamClientSetup_.msi /quiet'
Start-Process AmazonAppStreamUsbDriverSetup_.exe -Wait -ArgumentList '/quiet'
```
Setelah Anda menginstal Enterprise Deployment Tool pada komputer pengguna, klien WorkSpaces Applications diinstal sebagai berikut:
1. File instalasi klien WorkSpaces Aplikasi disalin ke jalur berikut di komputer pengguna: C:\$1Program Files (x86)\$1 Amazon WorkSpaces Applications Client Installer\$1 .exe. AppStreamClient
1. Pertama kali pengguna log on ke komputer mereka setelah Enterprise Deployment Tool diinstal, klien WorkSpaces Applications diinstal.
**catatan**
Jika Enterprise Deployment Tool mendeteksi bahwa folder WorkSpaces Applications Client **AppStreamClient**, sudah ada di **%localappdata%**, alat tidak menginstal klien.
Jika pengguna menghapus instalasi klien WorkSpaces Aplikasi, klien tidak diinstal lagi sampai Anda memperbarui WorkSpaces Applications Enterprise Deployment Tool.
## Mengakses WorkSpaces Aplikasi dengan Klien WorkSpaces Aplikasi
Secara default, ketika pengguna meluncurkan klien WorkSpaces Aplikasi, mereka hanya dapat terhubung ke URLs yang menyertakan domain WorkSpaces Aplikasi atau domain yang menyertakan catatan DNS TXT yang memungkinkan koneksi. Anda dapat mengizinkan pengguna klien mengakses domain selain domain WorkSpaces Aplikasi dengan melakukan salah satu hal berikut:
+ Tetapkan nilai `StartURL` registri untuk menentukan URL kustom yang dapat diakses pengguna, seperti URL untuk portal login organisasi Anda.
+ Tetapkan nilai `TrustedDomains` registri untuk menentukan domain tepercaya yang dapat diakses pengguna.
+ Buat data `AS2TrustedDomains` DNS TXT untuk menentukan domain tepercaya yang dapat diakses pengguna. Metode ini memungkinkan Anda menghindari perubahan registri.
**catatan**
Klien WorkSpaces Aplikasi dan konfigurasi catatan DNS TXT tidak mencegah pengguna menggunakan metode koneksi lain untuk mengakses domain atau URLs yang Anda tentukan. Misalnya, pengguna dapat mengakses domain tertentu atau URLs dengan menggunakan browser web, jika mereka memiliki akses jaringan ke domain atau. URLs
## Mengatur Nilai WorkSpaces Registri StarTurl untuk Pengguna Klien Aplikasi
Anda dapat menggunakan nilai `StartUrl` registri untuk menetapkan URL kustom yang diisi di klien WorkSpaces Aplikasi saat pengguna meluncurkan klien. Anda dapat membuat kunci registri HKLM ini saat menginstal klien sehingga pengguna Anda tidak perlu menentukan URL saat mereka meluncurkan klien.
Setelah klien WorkSpaces Aplikasi diinstal, Anda dapat menjalankan PowerShell skrip berikut untuk membuat kunci registri ini, atau Anda dapat menggunakan template administratif yang disertakan dalam WorkSpaces Applications client Enterprise Deployment Tool untuk mengkonfigurasi klien melalui Kebijakan Grup.
Ganti `StartUrl` nilainya dengan URL untuk penyedia identitas Anda (iDP). URL harus menggunakan sertifikat yang dipercaya oleh perangkat. Ini berarti bahwa sertifikat yang digunakan oleh `StartUrl` halaman web harus berisi Nama Alternatif Subjek (SAN) yang menyertakan nama domain URL. Misalnya, jika Anda `StartUrl` disetel ke https://appstream.example.com, sertifikat SSL harus memiliki SAN yang menyertakan appstream.example.com.
**catatan**
Untuk menjalankan skrip ini, Anda harus masuk ke komputer yang berlaku dengan izin Administrator. Anda juga dapat menjalankan skrip dari jarak jauh di bawah akun Sistem saat startup.
```
$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
```
## Mengatur Nilai TrustedDomains Registri untuk Mengaktifkan Domain Lain untuk Klien WorkSpaces Aplikasi
Anda dapat mengonfigurasi klien WorkSpaces Aplikasi untuk terhubung ke URLs domain tepercaya yang Anda tentukan. Misalnya, Anda mungkin ingin mengizinkan pengguna terhubung ke URL apa pun di domain organisasi Anda atau ke URL apa pun di satu atau beberapa domain iDP Anda. Saat Anda menentukan URL, gunakan format berikut: \$1. *example*-*idp*. *com*.
Anda dapat menentukan daftar domain tepercaya dalam format yang dipisahkan koma. Tambahkan daftar ini sebagai nilai registri ke kunci registri WorkSpaces Applications `TrustedDomains` HKLM. Kami menyarankan Anda membuat kunci registri ini dan menentukan daftar domain tepercaya saat Anda menginstal klien WorkSpaces Aplikasi atau, jika Anda menggunakan Microsoft Active Directory, melalui Kebijakan Grup. Dengan begitu, pengguna Anda dapat terhubung ke URL di domain tepercaya apa pun segera setelah klien diinstal.
Setelah klien WorkSpaces Aplikasi diinstal, Anda dapat menjalankan PowerShell skrip berikut untuk membuat kunci registri ini. Atau, Anda dapat menggunakan template administratif yang disertakan dalam WorkSpaces Applications client Enterprise Deployment Tool untuk mengkonfigurasi klien melalui Kebijakan Grup.
Ganti `TrustedDomains` nilai dengan daftar yang dipisahkan koma untuk satu atau beberapa domain organisasi atau idP Anda. Sertifikat yang digunakan oleh halaman web domain tepercaya harus berisi SAN yang menyertakan domain URL. Misalnya, jika domain tepercaya Anda menyertakan \$1.example.com, dan ditentukan pengguna, sertifikat SSL harus memiliki https://appstream.example.com SAN yang menyertakan appstream.example.com.
**catatan**
Untuk menjalankan skrip ini, Anda harus masuk ke komputer yang berlaku dengan izin Administrator. Anda juga dapat menjalankan skrip dari jarak jauh di bawah akun Sistem saat startup.
```
$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
```
Berikut ini adalah persyaratan dan pertimbangan untuk memformat nama domain tepercaya.
+ Karakter berikut didukung: a-z, 0-9, -, \$1
+ DNS memperlakukan karakter \$1 baik sebagai wildcard atau sebagai karakter asterisk (ASCII 42), tergantung di mana ia muncul dalam nama domain. Berikut ini adalah batasan saat menggunakan\$1 sebagai wildcard atas nama catatan DNS:
+ \$1 harus mengganti label paling kiri dalam nama domain. Misalnya, \$1.example.com atau \$1.prod.example.com. Jika Anda menyertakan \$1 di posisi lain, seperti prod.\$1.example.com, DNS memperlakukannya sebagai karakter tanda bintang (ASCII 42), bukan sebagai wildcard.
+ Tanda \$1 harus mengganti seluruh label. Misalnya, Anda tidak dapat menentukan \$1prod.example.com atau prod\$1.example.com.
+ \$1 berlaku untuk tingkat subdomain yang mencakup \$1, dan untuk semua subdomain subdomain tersebut. Misalnya, jika entri diberi nama \$1.example.com, klien WorkSpaces Applications mengizinkan zenith.example.com, acme.zenith.example.com, dan pinnacle.acme.zenith.example.com.
## Buat Catatan AS2 TrustedDomains DNS TXT untuk Mengaktifkan Domain Anda untuk Klien WorkSpaces Aplikasi Tanpa Perubahan Registri
Anda dapat mengaktifkan pengguna untuk terhubung ke URL apa pun di domain organisasi Anda (misalnya, \$1.example.com) atau ke URL apa pun di domain iDP Anda (misalnya, \$1.example-idp.com) dengan membuat catatan DNS TXT di domain tersebut. Saat Anda membuat catatan DNS TXT, nilai `StartURL` atau `TrustedDomains` registri tidak diperlukan untuk memungkinkan pengguna terhubung ke URL.
Anda dapat menentukan daftar subdomain tepercaya dalam format yang dipisahkan koma, diawali dengan. `AS2TrustedDomains=` Kemudian, buat catatan DNS TXT untuk domain yang sesuai. Catatan `AS2TrustedDomains` DNS TXT hanya dapat mengaktifkan domain yang sama, atau subdomain, dari domain tempat catatan DNS TXT dibuat. Anda tidak dapat menggunakan data DNS TXT untuk mengaktifkan domain lain.
Untuk informasi selengkapnya tentang menyiapkan catatan DNS, lihat [Mengaktifkan domain organisasi Anda untuk klien AppStream 2.0 dengan catatan TXT DNS Route 53 dan Membuat catatan AS2](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/) [TrustedDomains DNS TXT untuk mengarahkan klien asli AppStream 2.0 ke penyedia identitas pihak ketiga](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/).
**catatan**
Saat Anda membuat catatan DNS TXT, setiap pengguna dapat melakukan streaming dari domain yang diaktifkan yang tidak termasuk dalam nilai atau registri`StartURL`. `TrustedDomains` Klien WorkSpaces Aplikasi dan konfigurasi catatan DNS TXT tidak mencegah pengguna menggunakan metode koneksi lain untuk mengakses domain atau URLs yang Anda tentukan. Misalnya, pengguna dapat mengakses domain tertentu atau URLs dengan menggunakan browser web, jika mereka memiliki akses jaringan ke domain atau. URLs
### Contoh Konfigurasi Rekaman DNS TXT
Berikut ini adalah contoh konfigurasi catatan DNS TXT. Dengan konfigurasi untuk contoh ini, pengguna dapat meluncurkan klien WorkSpaces Aplikasi dan terhubung ke appstream.example.com atau appstream-dev.example.com. Namun, mereka tidak dapat terhubung ke 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.example.com, appstream-dev.example.com
### Persyaratan dan Pertimbangan
Ingatlah persyaratan dan pertimbangan berikut untuk membuat catatan DNS TXT:
+ Anda harus membuat catatan TXT di domain tingkat kedua. Misalnya, jika domain Anda prod.appstream.example.com, Anda harus membuat catatan DNS TXT di example.com.
+ Nilai catatan TXT harus dimulai dengan `AS2TrustedDomains=`
+ Karakter berikut didukung: a-z, 0-9, -, \$1
+ DNS memperlakukan karakter \$1 baik sebagai wildcard atau sebagai karakter asterisk (ASCII 42), tergantung di mana ia muncul dalam nama domain. Berikut ini adalah batasan saat menggunakan\$1 sebagai wildcard atas nama catatan DNS:
+ \$1 harus mengganti label paling kiri dalam nama domain. Misalnya, \$1.example.com atau \$1.prod.example.com. Jika Anda menyertakan\$1 di posisi lain, seperti prod.\$1.example.com, DNS memperlakukannya sebagai karakter tanda bintang (ASCII 42), bukan sebagai wildcard.
+ Tanda \$1 harus mengganti seluruh label. Misalnya, Anda tidak dapat menentukan \$1prod.example.com atau prod\$1.example.com.
+ \$1 berlaku untuk tingkat subdomain yang mencakup \$1, dan untuk semua subdomain subdomain tersebut. Misalnya, jika entri diberi nama \$1.example.com, klien WorkSpaces Applications mengizinkan koneksi ke domain berikut: zenith.example.com, acme.zenith.example.com, dan pinnacle.acme.zenith.example.com.
## Nonaktifkan Pencarian Rekaman DNS TXT untuk Domain Tepercaya
Secara default, ketika pengguna meluncurkan WorkSpaces Aplikasi dan menentukan URL yang bukan domain WorkSpaces Aplikasi, klien melakukan pencarian catatan DNS TXT. Pencarian dilakukan pada domain tingkat kedua URL sehingga klien dapat menentukan apakah domain tersebut termasuk dalam daftar. `AS2TrustedDomains` Perilaku ini memungkinkan pengguna terhubung ke domain yang tidak ditentukan dalam `StartURL` atau kunci `TrustedDomains` registri, atau domain WorkSpaces Aplikasi.
Anda dapat menonaktifkan perilaku ini dengan menyetel nilai untuk kunci `DnsTxtRecordQueryDisabled` registri`true`. Anda dapat membuat kunci registri ini ketika Anda menginstal klien WorkSpaces Aplikasi. Dengan begitu, klien hanya terhubung ke URLs yang ditentukan oleh `StartURL` atau kunci `TrustedDomains` registri.
Setelah klien WorkSpaces Aplikasi diinstal, Anda dapat menjalankan PowerShell skrip berikut untuk membuat kunci registri ini. Atau, Anda dapat menggunakan template administratif yang disertakan dalam WorkSpaces Applications client Enterprise Deployment Tool untuk mengkonfigurasi klien melalui Kebijakan Grup.
**catatan**
Untuk menjalankan skrip ini, Anda harus masuk ke komputer yang berlaku dengan izin Administrator. Anda juga dapat menjalankan skrip dari jarak jauh di bawah akun Sistem saat startup.
```
$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
```
## Pilih Apakah akan Menonaktifkan Pembaruan Klien Otomatis
Secara default, ketika versi baru klien WorkSpaces Aplikasi tersedia, klien memperbarui secara otomatis ke versi terbaru. Anda dapat menonaktifkan pembaruan otomatis dengan mengatur nilai untuk kunci `AutoUpdateDisabled` registri`true`. Anda dapat membuat kunci registri ini ketika Anda menginstal klien WorkSpaces Aplikasi. Dengan begitu, klien tidak diperbarui secara otomatis setiap kali versi baru tersedia.
Setelah klien WorkSpaces Aplikasi diinstal, Anda dapat menjalankan PowerShell skrip berikut untuk membuat kunci registri ini. Atau, Anda dapat menggunakan template administratif yang disertakan dalam WorkSpaces Applications client Enterprise Deployment Tool untuk mengkonfigurasi klien melalui Kebijakan Grup.
**catatan**
Untuk menjalankan skrip ini, Anda harus masuk ke komputer yang berlaku dengan izin Administrator. Anda juga dapat menjalankan skrip dari jarak jauh di bawah akun Sistem saat startup.
```
$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
```
## Pilih Apakah akan Menonaktifkan Unggahan Log Diagnostik Sesuai Permintaan
Secara default, klien WorkSpaces Aplikasi memungkinkan pengguna untuk mengunggah log diagnostik dan minidumps sesuai permintaan ke WorkSpaces Applications ()AWS. Selain itu, jika terjadi pengecualian atau klien WorkSpaces Aplikasi berhenti merespons, pengguna diminta untuk memilih apakah mereka ingin mengunggah minidump dan log terkait. Untuk informasi selengkapnya tentang pencatatan diagnostik sesuai permintaan, lihat[Unggahan Log Diagnostik Otomatis dan Sesuai Permintaan](feature-support-diagnostic-log-upload.md).
Anda dapat menonaktifkan perilaku ini dengan menyetel nilai untuk kunci `UserUploadOfClientLogsAllowed` registri`false`. Anda dapat membuat kunci registri HKLM ini ketika Anda menginstal klien WorkSpaces Aplikasi.
Setelah klien WorkSpaces Aplikasi diinstal, Anda dapat menjalankan PowerShell skrip berikut untuk membuat kunci registri ini. Atau, Anda dapat menggunakan template administratif yang disertakan dalam WorkSpaces Applications client Enterprise Deployment Tool untuk mengkonfigurasi klien melalui Kebijakan Grup.
**catatan**
Untuk menjalankan skrip ini, Anda harus masuk ke komputer yang berlaku dengan izin Administrator. Anda juga dapat menjalankan skrip dari jarak jauh di bawah akun Sistem saat startup.
```
$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
```
## Pilih Apakah akan Menonaktifkan Mode Aplikasi Asli
Secara default, klien WorkSpaces Aplikasi dapat berjalan dalam mode klasik atau mode aplikasi asli. Anda dapat menonaktifkan mode aplikasi asli dengan mengatur nilai untuk kunci `NativeAppModeDisabled` registri`true`. Anda dapat membuat kunci registri HKLM ini ketika Anda menginstal klien WorkSpaces Aplikasi. Jika nilainya disetel ke`true`, klien berjalan dalam mode klasik saja. Untuk informasi tentang mode aplikasi asli, lihat[Mode Aplikasi Asli](feature-support-native-application-mode.md).
Setelah klien WorkSpaces Aplikasi diinstal, Anda dapat menjalankan PowerShell skrip berikut untuk membuat kunci registri ini. Atau, Anda dapat menggunakan template administratif yang disertakan dalam WorkSpaces Applications client Enterprise Deployment Tool untuk mengkonfigurasi klien melalui Kebijakan Grup.
**catatan**
Untuk menjalankan skrip ini, Anda harus masuk ke komputer yang berlaku dengan izin Administrator. Anda juga dapat menjalankan skrip dari jarak jauh di bawah akun Sistem saat startup.
```
$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
```
## Pilih Apakah akan Menonaktifkan Pengalihan Printer Lokal
Secara default, klien WorkSpaces Aplikasi memungkinkan pengguna untuk mengalihkan pekerjaan cetak dari aplikasi streaming mereka ke printer yang terhubung ke komputer lokal mereka. Anda dapat menonaktifkan pengalihan printer lokal dengan menyetel nilai untuk `true` kunci `PrinterRedirectionDisabled` registri. Anda dapat membuat kunci registri HKLM ini ketika Anda menginstal klien WorkSpaces Aplikasi. Jika nilai disetel ke`true`, klien tidak mengalihkan pekerjaan cetak dari aplikasi streaming pengguna ke printer yang terhubung ke komputer lokal mereka.
Setelah Anda menginstal klien WorkSpaces Aplikasi, Anda dapat menjalankan PowerShell skrip berikut untuk membuat kunci registri ini. Atau, Anda dapat menggunakan template administratif yang disertakan dalam WorkSpaces Applications client Enterprise Deployment Tool untuk mengkonfigurasi klien melalui Kebijakan Grup.
**catatan**
Untuk menjalankan skrip ini, Anda harus masuk ke komputer yang berlaku dengan izin Administrator. Anda juga dapat menjalankan skrip dari jarak jauh di bawah akun Sistem saat startup.
```
$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
```
## Pilih Apakah akan Menonaktifkan Pengalihan Kartu Cerdas
Secara default, pengalihan kartu pintar diaktifkan untuk klien WorkSpaces Aplikasi. Ketika fitur ini diaktifkan, pengguna dapat menggunakan pembaca kartu pintar yang terhubung ke komputer lokal mereka dan kartu pintar mereka selama sesi streaming WorkSpaces Aplikasi tanpa pengalihan USB. Selama sesi streaming WorkSpaces Aplikasi, pembaca kartu pintar dan kartu pintar pengguna tetap dapat diakses untuk digunakan dengan aplikasi lokal. Klien mengalihkan panggilan API kartu pintar dari aplikasi streaming pengguna ke kartu pintar lokal mereka. Anda dapat menonaktifkan pengalihan kartu pintar dengan menyetel nilai untuk `true` kunci `SmartCardRedirectionDisabled` registri. Anda dapat membuat kunci registri HKLM ini ketika Anda menginstal klien WorkSpaces Aplikasi.
Jika nilainya disetel`true`, pengguna Anda tidak dapat menggunakan pembaca kartu pintar dan kartu pintar mereka selama sesi streaming WorkSpaces Aplikasi tanpa pengalihan USB. Dalam hal ini, pengguna tidak dapat masuk ke aplikasi streaming mereka dengan menggunakan kartu pintar yang terhubung ke komputer lokal mereka kecuali Anda [memenuhi syarat perangkat](qualify-usb-devices.md). Setelah Anda memenuhi syarat perangkat, pengguna harus [berbagi perangkat dengan WorkSpaces Aplikasi](client-application-windows-how-to-share-usb-devices-user.md). Ketika pengalihan kartu pintar dinonaktifkan, selama sesi streaming WorkSpaces Aplikasi pengguna, pembaca kartu pintar dan kartu pintar mereka tidak dapat diakses untuk digunakan dengan aplikasi lokal.
Setelah Anda menginstal klien WorkSpaces Aplikasi, Anda dapat menjalankan PowerShell skrip berikut untuk membuat kunci registri ini. Atau, Anda dapat menggunakan template administratif yang disertakan dalam WorkSpaces Applications client Enterprise Deployment Tool untuk mengkonfigurasi klien melalui Kebijakan Grup.
**catatan**
Untuk menjalankan skrip ini, Anda harus masuk ke komputer yang berlaku dengan izin Administrator. Anda juga dapat menjalankan skrip dari jarak jauh di bawah akun Sistem saat startup.
```
$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
```
## Konfigurasikan Pengaturan Klien WorkSpaces Aplikasi Tambahan untuk Pengguna Anda
Klien WorkSpaces Aplikasi menggunakan kunci registri untuk mengkonfigurasi pengaturan klien tambahan berikut:
+ WorkSpaces Penerimaan Perjanjian Lisensi Pengguna Akhir (EULA) klien aplikasi
+ WorkSpaces Aplikasi klien versi EULA diterima
+ Unggahan log diagnostik otomatis untuk klien WorkSpaces Aplikasi
+ Pembaruan otomatis untuk driver USB yang digunakan untuk meneruskan driver USB ke WorkSpaces Aplikasi
+ Mengaktifkan rendering perangkat keras di klien Aplikasi WorkSpaces
+ Mengatur jalur folder khusus untuk pengalihan sistem file di klien WorkSpaces Aplikasi
+ Membuka URL untuk penyedia identitas Anda (iDP) di browser default sistem
+ Menambahkan indikator untuk memberikan umpan balik visual real-time tentang kehilangan data streaming
Tabel berikut merangkum nilai registri untuk pengaturan klien tambahan yang dapat Anda gunakan untuk menyesuaikan pengalaman klien WorkSpaces Aplikasi bagi pengguna Anda.
**catatan**
Nilai-nilai ini peka huruf besar/kecil.
| Nilai | Jalur registri | Tipe | Deskripsi | Data |
| --- | --- | --- | --- | --- |
| EULAAccepted | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Tetapkan nilai ini true untuk menerima EULA klien WorkSpaces Aplikasi atas nama pengguna Anda. | true/false |
| AcceptedEULAVersion | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Versi EULA yang diterima. Jika versi EULA klien WorkSpaces Aplikasi saat ini berbeda dari versi EULA yang diterima, pengguna diminta untuk menerima versi EULA saat ini. | 1.0 |
| DiagnosticInfoCollectionAllowed | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Tetapkan nilai ini true untuk mengaktifkan WorkSpaces Aplikasi untuk secara otomatis mengirim log diagnostik dari klien WorkSpaces Aplikasi ke WorkSpaces Aplikasi (AWS). | true/false |
| USBDriverOptIn | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Tetapkan nilai ini true untuk mengaktifkan WorkSpaces Aplikasi untuk secara otomatis memperbarui driver USB yang digunakan untuk meneruskan driver USB ke WorkSpaces Aplikasi. | true/false |
| HardwareRenderingEnabled | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Tetapkan nilai ini true untuk mengaktifkan rendering perangkat keras di klien WorkSpaces Aplikasi. | true/false |
| FileRedirectionCustomDefaultFolders | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Tetapkan nilai ini untuk menyertakan setidaknya satu jalur folder untuk pengalihan sistem file. Pisahkan beberapa jalur folder dengan menggunakan '\$1'. Secara default, jalur folder berikut ditentukan: %USERPROFILE%\$1 Desktop\$1%UserProfile%\$1 Documents\$1%UserProfile%\$1 Downloads | Valid folder path |
| OpenIdpUrlInSystemBrowser | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Tetapkan nilai ini true untuk mengaktifkan klien WorkSpaces Aplikasi untuk membuka URL iDP di browser default sistem. Fitur ini didukung pada versi klien 1.1.1360 dan yang lebih baru. | true/false |
| DataLossIndicator | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Tetapkan nilai ini ke SHOW\$1ON\$1LOSSY untuk menyertakan indikator peringatan merah ketika ada kehilangan data streaming. Tetapkan nilai ini ke SHOW\$1ON\$1LOSSLESS untuk menyertakan indikator sehat hijau saat tidak ada kehilangan data streaming. | DISABLED/SHOW\$1ON\$1LOSSY/SHOW\$1ON\$1LOSSLESS |
Setelah klien WorkSpaces Aplikasi diinstal, Anda dapat menjalankan PowerShell skrip berikut untuk membuat kunci registri ini. Jika Anda tidak ingin membuat semua kunci registri, ubah skrip sesuai kebutuhan untuk membuat hanya kunci registri yang Anda inginkan. Atau, Anda dapat menggunakan template administratif yang disediakan di WorkSpaces Applications client Enterprise Deployment Tool untuk mengkonfigurasi klien melalui Kebijakan Grup.
**catatan**
Anda harus mengatur entri berikut untuk setiap pengguna.
```
$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
```
## Menggunakan Kebijakan Grup untuk Menyesuaikan WorkSpaces Aplikasi Pengalaman Klien
Anda dapat menggunakan template administratif yang disediakan di WorkSpaces Applications client Enterprise Deployment Tool untuk mengkonfigurasi klien melalui Kebijakan Grup. Untuk mempelajari cara memuat templat administratif ke dalam Konsol Manajemen Kebijakan Grup, lihat [Rekomendasi untuk mengelola file templat administratif Kebijakan Grup (.adm)](https://support.microsoft.com/en-us/help/816662/recommendations-for-managing-group-policy-administrative-template-adm) di dokumentasi Dukungan Microsoft.
# Perbarui WorkSpaces Aplikasi Enterprise Deployment Tool, Client, dan Driver USB Secara Manual
Secara default, klien WorkSpaces Aplikasi dan driver USB diperbarui secara otomatis ketika versi klien baru dirilis. Namun, jika Anda menggunakan Enterprise Deployment Tool untuk menginstal klien WorkSpaces Aplikasi untuk pengguna Anda dan Anda menonaktifkan pembaruan otomatis, Anda harus memperbarui WorkSpaces Applications Enterprise Deployment Tool, klien, dan driver USB secara manual. Untuk melakukannya, lakukan langkah-langkah berikut untuk menjalankan PowerShell perintah yang diperlukan di komputer pengguna.
**catatan**
Untuk menjalankan perintah ini, Anda harus masuk ke komputer yang berlaku sebagai Administrator, atau Anda dapat menjalankan skrip dari jarak jauh di bawah akun SYSTEM saat startup.
Menggunakan Enterprise Deployment Tool untuk mengelola WorkSpaces aplikasi klien macOS tidak didukung.
1. Copot pemasangan WorkSpaces Applications Enterprise Deployment Tool secara diam-diam:
```
Start-Process msiexec.exe -Wait -ArgumentList '/x AmazonAppStreamClientSetup_.msi /quiet'
```
1. Copot pemasangan driver USB WorkSpaces Aplikasi secara diam-diam:
```
Start-Process -Wait AmazonAppStreamUsbDriverSetup_.exe -ArgumentList '/uninstall /quiet /norestart'
```
1. Copot pemasangan klien WorkSpaces Aplikasi secara diam-diam:
```
Start-Process "$env:LocalAppData\AppStreamClient\Update.exe" -ArgumentList '--uninstall'
```
**catatan**
Proses ini juga menghapus kunci registri yang digunakan untuk mengkonfigurasi klien WorkSpaces Aplikasi. Setelah Anda menginstal ulang klien WorkSpaces Aplikasi, Anda harus membuat ulang kunci-kunci ini.
1. Bersihkan direktori instalasi aplikasi:
```
Remove-Item -Path $env:LocalAppData\AppStreamClient -Recurse -Confirm:$false –Force
```
1. Nyalakan kembali komputer:
```
Restart-computer
```
1. Instal versi terbaru WorkSpaces Applications Enterprise Deployment Tool secara diam-diam:
```
Start-Process msiexec.exe -Wait -ArgumentList '/i AmazonAppStreamClientSetup_.msi /quiet'
```
1. Instal versi terbaru driver USB WorkSpaces Aplikasi secara diam-diam:
```
Start-Process AmazonAppStreamUsbDriverSetup_.exe -Wait -ArgumentList '/quiet'
```
# Memenuhi Syarat Perangkat USB untuk Digunakan dengan Aplikasi Streaming
Ada dua metode untuk menentukan perangkat USB mana yang dapat dialihkan pengguna Anda ke instance streaming WorkSpaces Aplikasi mereka:
**catatan**
Pengalihan USB saat ini hanya didukung pada instance streaming WorkSpaces Aplikasi Windows. Itu tidak didukung pada klien macOS.
+ Anda dapat membuat string filter perangkat USB dalam file konfigurasi yang disimpan pada gambar. Metode ini hanya dapat digunakan dengan armada Always-On dan On-Demand.
+ Anda dapat menentukan string filter perangkat USB saat membuat armada, baik dengan AWS Management Console atau dengan `CreateFleet` API. Untuk informasi rinci tentang string ini, lihat bagian di bawah ini. Metode ini hanya dapat digunakan dengan armada elastis.
Anda dapat membuat file pada gambar WorkSpaces Aplikasi Anda yang menentukan perangkat USB mana yang dapat disediakan pengguna untuk aplikasi streaming mereka. Untuk memenuhi syarat perangkat USB pengguna Anda sehingga perangkat dapat digunakan dengan aplikasi streaming, lakukan langkah-langkah ini.
**catatan**
Untuk alasan keamanan, hanya memenuhi syarat perangkat USB dari sumber tepercaya yang disetujui. Memenuhi syarat semua perangkat generik atau kelas perangkat mungkin memungkinkan perangkat yang tidak disetujui untuk digunakan dengan aplikasi streaming Anda.
1. Jika Anda belum melakukannya, instal klien WorkSpaces Aplikasi. Untuk informasi, lihat [Instal dan Konfigurasikan Klien WorkSpaces Aplikasi](install-configure-client.md).
1. Hubungkan perangkat USB yang ingin Anda kualifikasikan ke komputer Anda.
1. Arahkan ke **C:\$1Users\$1 < logged-in-user >\$1AppData\$1 Local\$1 AppStreamClient**, dan klik dua kali **dcvusblist.exe**.
1. Di kotak dialog **DCV - Perangkat USB**, daftar perangkat USB yang terhubung ke komputer lokal Anda ditampilkan. Kolom **Filter** menampilkan string filter untuk setiap perangkat USB. Klik kanan entri daftar untuk perangkat USB yang ingin Anda aktifkan, dan pilih **Salin string filter**.
1. Di desktop Anda, pilih tombol **Start** Windows, dan cari Notepad. Klik dua kali **Notepad** untuk membuka file baru, salin string filter ke file, dan simpan. Nanti, Anda akan menggunakan string filter untuk memenuhi syarat perangkat USB.
1. Luncurkan pembuat gambar baru. Untuk informasi selengkapnya, lihat [Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming](tutorial-image-builder-create.md).
1. Setelah pembuat gambar Anda dalam status **Running**, lakukan langkah-langkah berikut untuk membuat URL streaming dan sambungkan ke pembuat gambar dengan menggunakan klien WorkSpaces Aplikasi.
1. Dengan pembuat gambar Anda dipilih dalam daftar, pilih **Tindakan**, **Buat URL streaming**.
1. Dalam kotak dialog **Buat URL streaming**, pilih **Salin tautan**, dan salin dan tempel alamat web ke file terpisah untuk digunakan nanti. Anda akan menggunakan URL ini untuk menyambung kembali ke pembuat gambar di langkah 12.
1. Pilih **Luncurkan di Klien**.
1. Jika kotak dialog **Luncurkan Aplikasi** terbuka dan meminta Anda untuk memilih aplikasi yang akan digunakan saat membuka tautan, pilih **Amazon AppStream**, **Buka tautan**. Untuk mencegah kotak dialog ini ditampilkan saat berikutnya Anda melakukan langkah ini untuk terhubung ke pembuat gambar, pilih kotak centang **Remember my choice for amazonappstream links**.
1. Jika klien WorkSpaces Aplikasi menampilkan tautan ke Perjanjian AWS Pelanggan, Ketentuan AWS Layanan, dan Pemberitahuan AWS Privasi, dan pemberitahuan pihak ketiga, tinjau informasi ini, lalu pilih **Selesai**.
1. Jika halaman login klien ditampilkan, bidang alamat web diisi sebelumnya dengan URL streaming. Pilih **Hubungkan**.
1. Jika diminta, masuk ke pembuat gambar sebagai Administrator.
1. Setelah Anda terhubung ke pembuat gambar, jika perangkat USB Anda mengharuskan Anda menginstal driver sebelum menggunakannya, unduh dan instal driver pada pembuat gambar. Misalnya, jika Anda menggunakan mouse Connexion 3D, Anda harus mengunduh dan menginstal driver Connexion yang diperlukan pada pembuat gambar.
1. Di desktop pembuat gambar Anda, pilih tombol **Start** Windows, dan cari Notepad. Klik kanan **Notepad**, dan pilih **Jalankan** sebagai Administrator.
1. Pilih **File**, **Buka**, dan buka file berikut:`C:\ProgramData\Amazon\Photon\DCV\usb_device_allowlist.txt`. Anda juga dapat mengizinkan seluruh kategori perangkat atau semua perangkat dari produsen tertentu dengan menggunakan ekspresi wildcard dalam `usb_device_allowlist.txt` file.
1. Salin string filter dari komputer lokal Anda ke pembuat gambar. **String filter untuk perangkat USB tertentu adalah string yang dipisahkan koma dari bidang berikut: **Nama**, **Kelas Dasar**,, **Protokol**, **ID Vendor **SubClass**, ID** **Product**, **Support Autoshare**, dan Lewati Reset.** Untuk informasi rinci tentang string ini, lihat[Bekerja dengan String Filter Perangkat USB](USB-device-filter-strings.md).
1. Putuskan sambungan dari pembuat gambar Anda, mulai ulang, dan sambungkan kembali dengan menggunakan klien WorkSpaces Aplikasi. Untuk melakukannya, buka klien WorkSpaces Aplikasi dan tempel URL streaming yang Anda buat di langkah 7 ke bidang alamat web masuk klien, dan pilih **Connect**.
1. Pada pembuat gambar, uji perangkat USB Anda untuk mengonfirmasi bahwa itu berfungsi seperti yang diharapkan.
1. Sebelum pengguna Anda dapat menggunakan perangkat USB dalam sesi WorkSpaces Aplikasi, mereka harus terlebih dahulu berbagi perangkat dengan sesi mereka. Untuk panduan yang dapat Anda berikan kepada pengguna Anda untuk membantu mereka melakukan tugas ini, lihat[Perangkat USB](client-application-windows-how-to-share-usb-devices-user.md).
1. Jika perangkat USB bekerja dengan pembuat gambar seperti yang diharapkan, buat gambar. Untuk informasi selengkapnya, lihat [Tutorial: Membuat Gambar WorkSpaces Aplikasi Kustom dengan Menggunakan Konsol WorkSpaces Aplikasi](tutorial-image-builder.md).
1. Setelah Anda selesai membuat gambar, perbarui armada WorkSpaces Aplikasi Anda untuk menggunakan gambar baru.
# Bekerja dengan String Filter Perangkat USB
Bagian ini menjelaskan string filter yang tersedia untuk perangkat USB yang memenuhi syarat untuk sesi streaming WorkSpaces Aplikasi. Ini juga memberikan panduan untuk bekerja dengan string ini. String filter berikut tersedia:
+ `Name`— Secara default, nilai untuk string filter ini adalah nama perangkat, tetapi Anda dapat menentukan nilai Anda sendiri.
+ `Base Class,SubClass,Protocol`— Kode kelas USB untuk perangkat. Untuk informasi selengkapnya, lihat [Kode Kelas yang Ditetapkan](https://www.usb.org/defined-class-codes).
+ `ID Vendor (VID)`— Pengidentifikasi unik yang ditugaskan oleh organisasi USB ke produsen perangkat USB.
+ `ID Product (PID)`— Pengidentifikasi unik yang ditetapkan oleh pabrikan ke perangkat USB.
+ `Support Autoshare`— Memungkinkan klien WorkSpaces Aplikasi secara otomatis berbagi perangkat saat sesi streaming dimulai. Tetapkan nilai ini `1` untuk memungkinkan berbagi perangkat otomatis. Tetapkan nilai ini `0` agar tidak mengizinkan berbagi perangkat otomatis.
+ `Skip Reset`— Secara default, ketika perangkat USB dibagikan oleh WorkSpaces Aplikasi dengan sesi streaming, perangkat diatur ulang untuk memastikan bahwa itu berfungsi dengan benar. Namun, beberapa perangkat USB tidak berfungsi dengan benar selama sesi streaming jika disetel ulang. Untuk mencegah masalah ini terjadi, tetapkan nilai untuk string filter ini `1` untuk menginstruksikan klien WorkSpaces Aplikasi agar tidak mengatur ulang perangkat saat dibagikan dengan sesi streaming. Untuk memastikan bahwa perangkat disetel ulang saat dibagikan dengan sesi streaming, setel nilai ini ke`0`. Saat Anda menetapkan nilai untuk`Skip Reset`, pastikan Anda menetapkan nilai `Support Autoshare` untuk `0` atau`1`.
String filter yang disalin dari komputer lokal khusus untuk perangkat USB. Dalam beberapa kasus, Anda mungkin ingin mengizinkan seluruh kelas perangkat alih-alih mengizinkan setiap perangkat USB yang memungkinkan. Misalnya, Anda mungkin ingin mengizinkan pengguna Anda menggunakan segala jenis tablet desain Wacom atau menggunakan perangkat penyimpanan massal USB apa pun. Dalam skenario seperti itu, Anda dapat memberikan karakter wildcard untuk bidang string filter tertentu. Jika Anda tidak mengetahui VID dan PID untuk perangkat USB Anda, Anda dapat mencari informasi ini di [database ID USB](https://www.the-sz.com/products/usbid/index.php).
Contoh berikut menunjukkan cara mengonfigurasi string filter untuk berbagi perangkat USB selama sesi streaming:
+ Izinkan semua perangkat penyimpanan massal secara otomatis saat memulai sesi streaming — “Penyimpanan massal, 8, \$1, \$1, \$1, \$1, \$1,1,0"
+ Izinkan semua perangkat Wacom secara otomatis memulai sesi streaming - “Tablet Wacom, 3, \$1, \$1, 1386, \$1,1,0"
+ Izinkan semua perangkat yang menyediakan antarmuka audio - “Audio, 1, \$1, \$1, \$1, \$1,1,0"
+ Izinkan perangkat X, tetapi jangan mengatur ulang saat perangkat dibagikan. Jangan bagikan perangkat secara otomatis saat memulai sesi streaming — “X, Y, \$1, \$1, \$1, 1386, \$1,0,1"
# Konfigurasikan Metode Koneksi untuk Pengguna Klien WorkSpaces Aplikasi Anda
Setelah Anda menginstal klien WorkSpaces Aplikasi di komputer lokal pengguna Anda, mereka dapat menggunakan klien WorkSpaces Aplikasi untuk terhubung ke sesi streaming. Bergantung pada kebutuhan organisasi Anda, Anda dapat memberi pengguna klien akses ke WorkSpaces Aplikasi dengan melakukan salah satu hal berikut: Menyiapkan federasi identitas menggunakan SAMP 2.0, menggunakan kumpulan pengguna WorkSpaces Aplikasi, atau membuat URL streaming.
**Topics**
+ [SAML 2.0](use-client-start-streaming-session-SAML.md)
+ [WorkSpaces Aplikasi User Pool](use-client-start-streaming-session-user-pool.md)
+ [URL Streaming](use-client-start-streaming-session-streaming-URL.md)
+ [Langkah Berikutnya](use-client-start-streaming-session-next-steps.md)
# SAML 2.0
Jika Anda menggunakan penyedia identitas eksternal untuk menggabungkan pengguna Anda ke tumpukan WorkSpaces Aplikasi, Anda harus membuat nilai registri untuk mengonfigurasi klien WorkSpaces Aplikasi dengan URL yang telah diisi sebelumnya setiap kali klien diluncurkan. URL harus menggunakan sertifikat yang dipercaya oleh perangkat. Sertifikat harus berisi Nama Alternatif Subjek (SAN) yang menyertakan nama domain URL.
Untuk informasi lebih lanjut, lihat:
+ [Menyiapkan SAMP](external-identity-providers-setting-up-saml.md)
+ [Mengatur Nilai WorkSpaces Registri StarTurl untuk Pengguna Klien Aplikasi](install-client-configure-settings.md#set-start-url-registry-value)
# WorkSpaces Aplikasi User Pool
Saat Anda membuat pengguna baru di kumpulan pengguna WorkSpaces Aplikasi, atau menetapkan pengguna kumpulan pengguna ke tumpukan WorkSpaces Aplikasi, WorkSpaces Aplikasi mengirimkan email ke pengguna atas nama Anda. **Pengguna memasukkan URL yang diberikan kepada mereka di email selamat datang, masukkan kredensialnya, lalu pilih Connect.**
Untuk informasi selengkapnya, lihat [Kolam Pengguna WorkSpaces Aplikasi Amazon](user-pool.md).
# URL Streaming
Untuk membuat URL streaming, gunakan salah satu metode berikut:
+ WorkSpaces Aplikasi konsol
+ Tindakan API [CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html)
+ [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html) AWS CLI Perintah
Untuk membuat URL streaming dengan menggunakan konsol WorkSpaces Aplikasi, selesaikan langkah-langkah dalam prosedur berikut.
**Untuk membuat URL streaming dengan menggunakan konsol WorkSpaces Aplikasi**
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2/rumah](https://console.aws.amazon.com/appstream2/home).
1. Di panel navigasi, pilih **Armada.**
1. Dalam daftar armada, pilih armada yang terkait dengan tumpukan tempat Anda ingin membuat URL streaming. Verifikasi bahwa status armada sedang **Berjalan**.
1. Di panel navigasi, pilih **Stacks (Tumpukan)**. Pilih tumpukan, lalu pilih **Tindakan**, **Buat URL streaming**.
1. Di **User id**, masukkan ID pengguna.
1. Untuk **Kedaluwarsa URL**, pilih waktu kedaluwarsa, yang menentukan berapa lama URL yang dihasilkan valid. URL ini berlaku untuk maksimal tujuh hari.
1. Pilih **Dapatkan URL**.
1. Salin URL, simpan ke lokasi yang dapat diakses, lalu berikan kepada pengguna Anda.
Di halaman login klien WorkSpaces Aplikasi, pengguna memasukkan URL streaming yang Anda buat sebagai alamat web, lalu pilih **Connect**.
# Langkah Berikutnya
Setelah mengonfigurasi metode koneksi klien, Anda dapat memberikan step-by-step panduan berikut kepada pengguna untuk membantu mereka terhubung ke WorkSpaces Aplikasi dan memulai sesi streaming: [Connect ke WorkSpaces Aplikasi pada Windows Client](client-application-windows-start-streaming-session-user.md) atau[Connect ke WorkSpaces Aplikasi di klien macOS](client-application-mac-start-streaming-session-user.md).
# Memungkinkan Pengguna untuk Berbagi Perangkat USB dengan Sesi Streaming WorkSpaces Aplikasi
Sebelum pengguna berbagi perangkat USB mereka dengan sesi WorkSpaces Aplikasi, perangkat USB harus memenuhi syarat. Jika tidak, ketika pengguna memulai sesi streaming, perangkat USB mereka tidak terdeteksi oleh WorkSpaces Aplikasi dan tidak dapat dibagikan dengan sesi tersebut. Untuk informasi selengkapnya, lihat [Memenuhi Syarat Perangkat USB untuk Digunakan dengan Aplikasi Streaming](qualify-usb-devices.md).
**catatan**
Berbagi perangkat USB dengan sesi streaming WorkSpaces Aplikasi tidak didukung pada klien macOS.
# Mengalihkan Sesi Streaming dari Browser Web ke Klien WorkSpaces Aplikasi
Anda dapat mengonfigurasi WorkSpaces Aplikasi untuk mengarahkan sesi streaming dari browser web ke klien WorkSpaces Aplikasi. Dengan begitu, ketika pengguna Anda masuk ke WorkSpaces Aplikasi dan memulai sesi streaming di browser web mereka, sesi mereka dialihkan ke klien WorkSpaces Aplikasi. Untuk melakukannya, lakukan langkah-langkah ini.
1. Gunakan tindakan WorkSpaces Applications `CreateStreamingURL` API untuk menghasilkan URL streaming.
1. Tambahkan awalan berikut untuk handler klien WorkSpaces Aplikasi kustom ke URL streaming: **amazonappstream:**
Bersama-sama, awalan dan URL streaming diformat sebagai berikut:
**amazonappstream:***base64encoded(streamingURL)*
**catatan**
Saat menyandikan URL, pastikan pengkodean dalam UTF-8.
Sampel Powershell untuk menyandikan: `[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes("Streaming/IdpURL"))`
1. Ketika pengguna diarahkan ke URL streaming, browser mereka mendeteksi bahwa tautan harus dibuka oleh klien WorkSpaces Aplikasi.
1. Pengguna diminta untuk memilih apakah mereka ingin memulai sesi streaming dengan menggunakan klien WorkSpaces Aplikasi.
1. Setelah prompt, salah satu dari berikut ini terjadi:
+ Jika klien WorkSpaces Aplikasi diinstal, pengguna dapat memilih untuk melanjutkan sesi streaming dengan menggunakan klien WorkSpaces Aplikasi.
+ Jika klien WorkSpaces Aplikasi tidak diinstal, perilaku browser bervariasi sebagai berikut:
+ Chrome - Tidak ada pesan yang ditampilkan.
+ Firefox — Sebuah pesan menyatakan bahwa pengguna memerlukan aplikasi baru untuk membuka Amazon AppStream.
+ Microsoft Edge - Tidak ada pesan yang ditampilkan.
+ Internet Explorer — Sebuah pesan memberi tahu pengguna bahwa klien WorkSpaces Aplikasi tidak diinstal.
Dalam hal ini, pengguna dapat memilih tautan **Unduh AppStream Klien** untuk mengunduh klien. Setelah mereka mengunduh klien, mereka dapat menginstalnya, dan menyegarkan browser mereka untuk memulai sesi streaming dengan menggunakan klien.
## Buat pintasan desktop Windows menggunakan browser default
Untuk membuat pintasan desktop Windows menggunakan browser default untuk meluncurkan klien, gunakan contoh skrip Powershell berikut.
```
$StringToEncode = 'your URL string'
$encodedUrl = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($StringToEncode))
$shortcutContent = "
[{000214A0-0000-0000-C000-000000000046}]
Prop3=19,0
[InternetShortcut]
IDList=
URL=amazonappstream:$encodedUrl
IconIndex=0
HotKey=0
IconFile=$env:USERPROFILE\AppData\Local\AppStreamClient\appstreamclient.exe
"
Set-Content -Path "$env:USERPROFILE\Desktop\AppStream 2.0 Client Launcher.url" -Value $shortcutContent
```
# Aktifkan Pengalihan Sistem File untuk Pengguna WorkSpaces Aplikasi Anda
WorkSpaces Pengalihan sistem file aplikasi memungkinkan pengguna yang memiliki klien WorkSpaces Aplikasi menginstal file akses di komputer lokal mereka dari dalam sesi streaming mereka. Saat Anda mengaktifkan pengalihan sistem file, Anda dapat menentukan daftar drive dan folder lokal yang dapat dipilih pengguna untuk diakses. Saat pengguna masuk ke WorkSpaces Aplikasi dan memulai sesi streaming, mereka dapat memilih drive atau folder yang ingin mereka akses dari daftar. Kemudian mereka dapat berbagi drive atau folder dengan WorkSpaces Aplikasi. Drive atau folder tetap tersedia untuk mereka akses selama sesi streaming mereka. Pengguna dapat berhenti berbagi drive atau folder lokal mereka kapan saja.
**catatan**
Pengalihan sistem file saat ini tidak didukung untuk instance armada berbasis Linux, atau saat menggunakan klien macOS.
**Topics**
+ [Prasyarat untuk Pengalihan Sistem File](file-system-redirection-prerequisites.md)
+ [Cara Mengaktifkan Pengalihan Sistem File](how-to-enable-file-system-redirection.md)
+ [Membuat Default Drive dan Folder Tersedia untuk Pengguna Anda untuk Berbagi](prepopulate-drives-folders-system-redirection.md)
+ [Berikan Panduan kepada Pengguna WorkSpaces Aplikasi Anda untuk Bekerja dengan Pengalihan Sistem File](end-user-guidance-file-system-redirection.md)
# Prasyarat untuk Pengalihan Sistem File
Untuk mengaktifkan pengalihan file WorkSpaces Aplikasi:
+ Anda harus menggunakan gambar yang menggunakan versi agen WorkSpaces Aplikasi yang dirilis pada atau setelah 8 Agustus 2019. Untuk informasi selengkapnya, lihat [WorkSpaces Catatan Rilis Agen Aplikasi](agent-software-versions.md).
+ Pengguna Anda harus memiliki klien WorkSpaces Aplikasi versi 1.0.480 atau yang lebih baru diinstal. Untuk informasi selengkapnya, lihat [WorkSpaces Aplikasi Catatan Rilis Klien Windows](client-release-versions.md).
+ Unggahan dan unduhan file harus diaktifkan pada tumpukan yang diakses pengguna Anda untuk sesi streaming. Lihat prosedur berikut.
# Cara Mengaktifkan Pengalihan Sistem File
Lakukan langkah-langkah berikut untuk mengaktifkan unggahan dan unduhan file di tumpukan yang diakses pengguna Anda untuk sesi streaming.
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2/rumah](https://console.aws.amazon.com/appstream2/home).
1. Di panel navigasi sebelah kiri, pilih **Tumpukan**.
1. Pilih tumpukan yang ingin Anda aktifkan pengalihan sistem file.
1. Pilih tab **Pengaturan Pengguna**, lalu perluas bagian **Clipboard, transfer file, dan izin cetak lokal**.
1. Untuk **transfer File**, verifikasi bahwa **Unggah dan unduh** dipilih. Jika tidak, pilih **Edit**, lalu pilih **Unggah dan unduh**.
1. Pilih **Perbarui**.
# Membuat Default Drive dan Folder Tersedia untuk Pengguna Anda untuk Berbagi
Secara default, saat Anda mengaktifkan arah file untuk pengguna tumpukan, drive dan folder berikut tersedia bagi pengguna tersebut untuk dibagikan dalam sesi streaming mereka:
+ Drive:
+ Semua hard disk lokal (drive fisik, seperti Drive C dan D Drive)
+ Semua drive virtual (drive jaringan dan virtual seperti huruf drive yang dipetakan, Google Drive, dan OneDrive)
+ Semua drive USB lokal
+ Folder:
+ %USERPROFILE%\$1 Desktop
+ %USERPROFILE%\$1 Dokumen
+ %USERPROFILE%\$1 Unduhan
Jalur drive dan folder ini mengisi kotak dialog **Bagikan drive dan folder lokal Anda**. Kotak dialog ini ditampilkan saat pengguna masuk ke WorkSpaces Aplikasi, memulai sesi streaming, dan memilih **Pengaturan**, **Sumber Daya Lokal**, dan **Drive dan Folder Lokal**.
Anda dapat mengubah atau menentukan jalur drive dan folder default Anda sendiri dengan mengedit registri. Anda juga dapat menggunakan file template administratif yang disediakan di WorkSpaces Applications client Enterprise Deployment Tool. Template ini memungkinkan Anda mengkonfigurasi klien dengan menggunakan Kebijakan Grup. Untuk informasi selengkapnya, lihat [Instal dan Konfigurasikan Klien WorkSpaces Aplikasi](install-configure-client.md).
Saat pengguna mengakses drive dan folder lokal bersama mereka selama sesi streaming, jalur yang sesuai muncul dengan garis miring terbalik yang diganti dengan garis bawah. Mereka juga berakhiran dengan nama komputer lokal dan huruf drive. Misalnya, untuk pengguna dengan nama pengguna janedoe dan nama komputer ExampleCorp -123456, jalur folder Desktop, Dokumen, dan Unduhan default muncul sebagai berikut:
C\$1Users\$1Janedoe\$1Desktop (\$1\$1 -123456) (F:) ExampleCorp
C\$1Users\$1Janedoe\$1Documents (\$1\$1 -123456) (G:) ExampleCorp
C\$1Users\$1Janedoe\$1Downloads (\$1\$1 -123456) (H:) ExampleCorp
# Berikan Panduan kepada Pengguna WorkSpaces Aplikasi Anda untuk Bekerja dengan Pengalihan Sistem File
Untuk membantu pengguna Anda memahami cara bekerja dengan pengalihan file selama sesi streaming mereka, Anda dapat memberi mereka informasi di [Akses File Lokal](client-application-windows-file-system-redirection.md) dalamnya.
# Aktifkan Pengalihan Printer Lokal untuk Pengguna WorkSpaces Aplikasi Anda
Dengan pengalihan printer lokal, pengguna WorkSpaces Aplikasi Anda dapat mengalihkan pekerjaan cetak dari aplikasi streaming mereka ke printer yang terhubung ke komputer lokal mereka, termasuk printer jaringan apa pun yang telah dipetakan pengguna. Anda tidak memerlukan driver printer yang diinstal pada instance streaming WorkSpaces Aplikasi untuk memungkinkan pengguna mencetak dokumen selama sesi streaming mereka.
**catatan**
Mengaktifkan pengalihan printer lokal saat ini tidak didukung untuk tumpukan berbasis Linux.
**Topics**
+ [Prasyarat untuk Pengalihan Printer Lokal](local-printer-redirection-prerequisites.md)
+ [Cara Mengaktifkan Pengalihan Printer Lokal](how-to-enable-disable-local-printer-redirection.md)
+ [Cara Menonaktifkan Pengalihan Printer Lokal](disable-local-printer-redirection.md)
# Prasyarat untuk Pengalihan Printer Lokal
Untuk memastikan bahwa pengguna Anda dapat menggunakan pengalihan printer lokal, Anda harus:
+ Gunakan gambar yang menggunakan versi agen WorkSpaces Aplikasi yang dirilis pada atau setelah 30 Juli 2020. Untuk informasi selengkapnya, lihat [WorkSpaces Catatan Rilis Agen Aplikasi](agent-software-versions.md).
+ Pastikan pengguna Anda memiliki klien WorkSpaces Aplikasi versi 1.1.179 atau yang lebih baru diinstal. Untuk informasi selengkapnya, lihat [WorkSpaces Aplikasi Catatan Rilis Klien Windows](client-release-versions.md).
+ Pastikan pengalihan printer diaktifkan pada tumpukan yang diakses pengguna Anda untuk sesi streaming.
# Cara Mengaktifkan Pengalihan Printer Lokal
Secara default, pengalihan printer lokal diaktifkan saat klien WorkSpaces Aplikasi diinstal. Namun, jika pengalihan printer lokal tidak diaktifkan pada tumpukan yang diakses pengguna untuk sesi streaming, Anda dapat mengaktifkannya di konsol WorkSpaces Aplikasi dengan melakukan langkah-langkah berikut.
**Untuk mengaktifkan pengalihan printer lokal dengan menggunakan konsol WorkSpaces Aplikasi**
1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2/rumah](https://console.aws.amazon.com/appstream2/home).
1. Di panel navigasi sebelah kiri, pilih **Tumpukan**.
1. Pilih tumpukan yang ingin Anda aktifkan pengalihan printer lokal.
1. Pilih tab **Pengaturan Pengguna**, lalu perluas **Clipboard, transfer file, cetak ke perangkat lokal, dan bagian izin otentikasi.**
1. Untuk **Mencetak ke perangkat lokal**, verifikasi bahwa **Diaktifkan** dipilih. Jika tidak, pilih **Edit**, lalu pilih **Diaktifkan**.
1. Pilih **Perbarui**.
Atau, Anda dapat mengaktifkan pengalihan printer lokal dengan menggunakan WorkSpaces Applications API, AWS SDK, atau AWS Command Line Interface ()AWS CLI.
# Cara Menonaktifkan Pengalihan Printer Lokal
Untuk menonaktifkan pengalihan printer lokal ikuti langkah-langkah ini.
**Untuk menonaktifkan pengalihan printer lokal**
Anda dapat menonaktifkan pengalihan printer lokal dengan salah satu cara berikut:
+ Selama instalasi klien pada perangkat yang dikelola. Untuk informasi selengkapnya, lihat [Pilih Apakah akan Menonaktifkan Pengalihan Printer Lokal](install-client-configure-settings.md#disable-local-printer-redirection-client).
+ Dengan menggunakan konsol WorkSpaces Aplikasi untuk menonaktifkan opsi ini pada tumpukan WorkSpaces Aplikasi.
+ Dengan menggunakan WorkSpaces Applications API, AWS SDK, atau AWS Command Line Interface (AWS CLI) untuk menonaktifkan opsi ini pada tumpukan WorkSpaces Aplikasi.