Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bundel dan gambar untuk Pools WorkSpaces
*WorkSpace Bundel* adalah kombinasi dari sistem operasi, dan penyimpanan, komputasi, dan sumber daya perangkat lunak. Saat Anda meluncurkan WorkSpace, Anda memilih bundel yang memenuhi kebutuhan Anda. Bundel default yang tersedia untuk WorkSpaces disebut *bundel publik*. Untuk informasi selengkapnya tentang berbagai bundel publik yang tersedia WorkSpaces, lihat [Amazon WorkSpaces Bundles](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles).
Jika Anda telah meluncurkan Windows WorkSpace dan telah menyesuaikannya, Anda dapat membuat gambar khusus dari itu WorkSpace untuk digunakan dengan WorkSpaces Pool. Linux tidak didukung di WorkSpaces Pool.
*Gambar khusus* hanya berisi OS, perangkat lunak, dan pengaturan untuk WorkSpace. *Bundel kustom* adalah kombinasi dari gambar kustom dan perangkat keras dari mana a WorkSpace dapat diluncurkan.
Setelah membuat gambar kustom, Anda dapat membuat bundel kustom yang menggabungkan WorkSpace gambar kustom dan konfigurasi komputasi dan penyimpanan yang mendasari yang Anda pilih. Anda kemudian dapat menentukan bundel kustom ini ketika Anda membuat WorkSpaces Pools baru untuk memastikan bahwa yang baru WorkSpaces di pool memiliki konfigurasi konsisten yang sama (perangkat keras dan perangkat lunak).
Jika Anda perlu melakukan pembaruan perangkat lunak atau menginstal perangkat lunak tambahan pada Anda WorkSpaces, Anda dapat memperbarui bundel kustom Anda dan menggunakannya untuk membangun kembali Anda WorkSpaces.
WorkSpaces Pools mendukung beberapa sistem operasi (OS), protokol streaming, dan bundel yang berbeda. Tabel berikut memberikan informasi tentang lisensi, protokol streaming, dan bundel yang didukung oleh masing-masing OS.
| Sistem Operasi | Lisensi | Protokol streaming | Bundel yang didukung | Kebijakan siklus hidup/tanggal pensiun |
| --- | --- | --- | --- | --- |
| Windows Server 2019 | Termasuk | DCV | Nilai, Standar, Kinerja, Daya, PowerPro | [Januari 9, 2029](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2019) |
| Windows Server 2022 | Termasuk | DCV | Standar, Kinerja, Daya,, PowerPro Grafik.G4DN, .g4dn GraphicsPro | [14 Oktober 2031](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2022) |
**catatan**
Versi sistem operasi yang tidak lagi didukung oleh vendor tidak dijamin berfungsi dan tidak didukung oleh AWS dukungan.
**Topics**
+ [Opsi bundel untuk WorkSpaces Pools](pools-custom-images-bundles.md)
+ [Buat gambar dan bundel khusus untuk WorkSpaces Pools](pools-images-custom-image.md)
+ [Mengelola gambar kustom dan bundel untuk Pools WorkSpaces](pools-images-managing.md)
+ [Gunakan skrip sesi untuk mengelola pengalaman streaming pengguna Anda](pools-images-session-scripts.md)
# Opsi bundel untuk WorkSpaces Pools
Sebelum memilih bundel yang akan digunakan dengan WorkSpaces Pool, pastikan bundel yang ingin Anda pilih kompatibel dengan WorkSpaces 'protokol, sistem operasi, jaringan, dan jenis komputasi Anda. Sebaiknya uji kinerja bundel yang ingin Anda pilih di lingkungan pengujian dengan menjalankan dan menggunakan aplikasi yang mereplikasi tugas harian pengguna Anda. Untuk informasi lebih lanjut tentang protokol, lihat. [Protokol untuk Pribadi WorkSpaces](amazon-workspaces-networking.md#amazon-workspaces-protocols) Untuk informasi selengkapnya tentang jaringan, lihat[Persyaratan jaringan klien untuk WorkSpaces Pribadi](workspaces-network-requirements.md).
Bundel publik berikut dapat digunakan dengan WorkSpaces Pool. Untuk informasi tentang bundel di WorkSpaces, lihat [Amazon WorkSpaces Bundles](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles). Nilai, Standar, Kinerja, Daya, PowerPro
## Bundel nilai
Bundel ini sangat cocok untuk yang berikut:
+ Pengeditan teks dasar dan entri data
+ Penjelajahan web dengan penggunaan ringan
+ Pesan instan
Bundel ini tidak direkomendasikan untuk pengolah kata, konferensi audio dan video, berbagi layar, alat pengembangan perangkat lunak, aplikasi intelijen bisnis, dan aplikasi grafis.
## Bundel standar
Bundel ini sangat cocok untuk yang berikut:
+ Pengeditan teks dasar dan entri data
+ Penjelajahan web
+ Pesan instan
+ Email
Bundel ini tidak direkomendasikan untuk konferensi audio dan video, berbagi layar, pengolah kata, alat pengembangan perangkat lunak, aplikasi intelijen bisnis, dan aplikasi grafis
## Bundel kinerja
Bundel ini sangat cocok untuk yang berikut:
+ Penjelajahan web
+ Pengolah kata
+ Pesan instan
+ Email
+ Spreadsheet
+ Pemrosesan audio
+ Courseware
Bundel ini tidak direkomendasikan untuk konferensi video, berbagi layar, alat pengembangan perangkat lunak, aplikasi intelijen bisnis, dan aplikasi grafis
## Bundel daya
Bundel ini sangat cocok untuk yang berikut:
+ Penjelajahan web
+ Pengolah kata
+ Email
+ Pesan instan
+ Spreadsheet
+ Pemrosesan audio
+ Pengembangan perangkat lunak (Integrated Development Environment (IDE))
+ Masuk ke pemrosesan data tingkat menengah
+ Konferensi audio dan video
Bundel ini tidak direkomendasikan untuk berbagi layar, alat pengembangan perangkat lunak, aplikasi intelijen bisnis, dan aplikasi grafis.
## PowerPro bundel
Bundel ini sangat cocok untuk yang berikut:
+ Penjelajahan web
+ Pengolah kata
+ Email
+ Pesan instan
+ Spreadsheet
+ Pemrosesan audio
+ Pengembangan perangkat lunak (Integrated Development Environment (IDE))
+ Pergudangan data
+ Aplikasi intelijen bisnis
+ Konferensi audio dan video
Bundel ini tidak direkomendasikan untuk pelatihan model pembelajaran mesin, dan aplikasi grafis
## Graphics.g4dn bundel
Bundel ini menawarkan kinerja grafis tingkat tinggi, dan tingkat kinerja CPU dan memori moderat untuk Anda WorkSpaces dan sangat cocok untuk hal-hal berikut:
+ Penjelajahan web
+ Pengolah kata
+ Email
+ Spreadsheet
+ Pesan instan
+ Konferensi audio
+ Pengembangan perangkat lunak (Integrated Development Environment (IDE))
+ Masuk ke pemrosesan data tingkat menengah
+ Pergudangan data
+ Aplikasi intelijen bisnis
+ Desain grafis
+ CAD/CAM (computer-aided design/computerManufaktur dibantu)
Bundel ini tidak direkomendasikan untuk konferensi audio dan video, rendering 3D, desain foto-realistis, dan pelatihan model pembelajaran mesin
## GraphicsPro.g4dn bundel
Bundel ini menawarkan kinerja grafis, kinerja CPU, dan memori tingkat tinggi untuk Anda WorkSpaces dan sangat cocok untuk hal-hal berikut:
+ Penjelajahan web
+ Pengolah kata
+ Email
+ Spreadsheet
+ Pesan instan
+ Konferensi audio
+ Pengembangan perangkat lunak (Integrated Development Environment (IDE))
+ Masuk ke pemrosesan data tingkat menengah
+ Pergudangan data
+ Aplikasi intelijen bisnis
+ Desain grafis
+ CAD/CAM (computer-aided design/computerManufaktur dibantu)
+ Transcoding video
+ Rendering 3D
+ Desain foto-realistis
+ Streaming permainan
+ Pelatihan model ML (machine learning) dan inferensi ML
Bundel ini tidak disarankan untuk konferensi audio dan video.
# Buat gambar dan bundel khusus untuk WorkSpaces Pools
WorkSpaces Pool hanya mendukung gambar dan bundel Windows. Jika Anda telah meluncurkan Windows atau WorkSpace dan telah menyesuaikannya, Anda dapat membuat gambar khusus dan bundel khusus dari itu WorkSpace.
*Gambar khusus* hanya berisi OS, perangkat lunak, dan pengaturan untuk file WorkSpace. *Bundel kustom* adalah kombinasi dari gambar kustom dan perangkat keras dari mana a WorkSpace dapat diluncurkan.
Setelah Anda membuat citra kustom, Anda dapat membangun paket kustom yang menggabungkan citra kustom dan konfigurasi dasar komputasi dan penyimpanan yang Anda pilih. Anda kemudian dapat menentukan bundel kustom ini ketika Anda meluncurkan baru WorkSpaces untuk memastikan bahwa yang baru WorkSpaces memiliki konfigurasi konsisten yang sama (perangkat keras dan perangkat lunak).
Anda dapat menggunakan citra kustom yang sama untuk membuat berbagai paket kustom dengan memilih opsi komputasi dan penyimpanan berbeda untuk setiap paket.
**penting**
Volume penyimpanan bundel khusus tidak boleh lebih kecil dari volume penyimpanan gambar.
Biaya bundel khusus sama dengan bundel publik tempat mereka dibuat. Untuk informasi selengkapnya tentang harga, lihat [ WorkSpaces Harga Amazon](https://aws.amazon.com/workspaces/pricing/).
**Topics**
+ [Persyaratan membuat citra kustom Windows](#pools-windows_custom_image_requirements)
+ [Praktik terbaik](#pools-custom_image_best_practices)
+ [Langkah 1: Jalankan Pemeriksa Gambar](#pools-run_image_checker)
+ [Langkah 2: Buat gambar kustom dan bundel kustom](#pools-create_custom_image_bundle)
+ [Apa yang disertakan dengan gambar WorkSpaces kustom Windows](#pools-image_creation_windows)
## Persyaratan membuat citra kustom Windows
**catatan**
Windows saat ini mendefinisikan 1 GB sebagai 1.073.741.824 byte. Anda harus memastikan bahwa mereka memiliki lebih dari 12.884.901.888 byte (atau 12 GiB) gratis pada drive C dan profil pengguna kurang dari 10.737.418.240 byte (atau 10 GiB) untuk membuat gambar a. WorkSpace
+ Status WorkSpace harus **Tersedia** dan status modifikasinya harus **Tidak Ada**.
+ Semua aplikasi dan profil pengguna pada WorkSpaces gambar harus kompatibel dengan Microsoft Sysprep.
+ Semua aplikasi untuk disertakan dalam gambar harus diinstal pada `C` drive.
+ Semua layanan aplikasi yang berjalan di WorkSpace harus menggunakan akun sistem lokal, bukan kredensyal pengguna domain. Misalnya, Anda tidak dapat memiliki instalasi Microsoft SQL Server Express yang berjalan dengan kredensial pengguna domain.
+ Tidak WorkSpace boleh dienkripsi. Pembuatan gambar dari terenkripsi saat WorkSpace ini tidak didukung.
+ Komponen berikut diperlukan dalam citra. Tanpa komponen ini, WorkSpaces yang Anda luncurkan dari gambar tidak akan berfungsi dengan benar. Untuk informasi selengkapnya, lihat [Komponen konfigurasi dan layanan yang diperlukan untuk WorkSpaces Pribadi](required-service-components.md).
+ Windows PowerShell versi 3.0 atau yang lebih baru
+ Layanan Desktop Jarak Jauh
+ AWS Driver PV
+ Manajemen Jarak Jauh Windows (WinRM)
+ Agen PCo IP Teradici dan driver
+ Agen dan driver STXHD
+ AWS dan WorkSpaces sertifikat
+ Agen Skylight
+ WorkSpaces Pools hanya mendukung bundel maksimum/ukuran volume root image 200 GB. Saat Anda membuat gambar kustom Windows, pastikan itu berada di bawah ukuran volume root 200 GB.
## Praktik terbaik
Sebelum Anda membuat gambar dari a WorkSpace, lakukan hal berikut:
+ Gunakan VPC terpisah yang tidak terhubung ke lingkungan produksi Anda.
+ Terapkan WorkSpace di subnet pribadi dan gunakan instance NAT untuk lalu lintas keluar.
+ Gunakan direktori Simple AD kecil.
+ Gunakan ukuran volume terkecil untuk sumber WorkSpace, dan kemudian sesuaikan ukuran volume sesuai kebutuhan saat membuat bundel khusus.
+ Instal semua pembaruan sistem operasi (kecuali pembaruan fitur/versi Windows) dan semua pembaruan aplikasi di file. WorkSpace
+ Hapus data cache dari WorkSpace yang seharusnya tidak disertakan dalam bundel (misalnya, riwayat browser, file cache, dan cookie browser).
+ Hapus pengaturan konfigurasi dari WorkSpace yang seharusnya tidak disertakan dalam bundel (misalnya, profil email).
+ Beralih ke pengaturan alamat IP dinamik menggunakan DHCP.
+ Pastikan Anda belum melebihi kuota untuk WorkSpace gambar yang diizinkan di Wilayah. Secara default, Anda diizinkan 40 WorkSpace gambar per Wilayah. Jika Anda telah mencapai kuota ini, upaya baru untuk membuat citra akan gagal. Untuk meminta kenaikan kuota, gunakan [formulir WorkSpaces Limits](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=workspaces).
+ Pastikan Anda tidak mencoba membuat gambar dari yang dienkripsi WorkSpace. Pembuatan gambar dari terenkripsi saat WorkSpace ini tidak didukung.
+ Jika Anda menjalankan perangkat lunak antivirus apa pun WorkSpace, nonaktifkan saat Anda mencoba membuat gambar.
+ Jika Anda memiliki firewall diaktifkan pada Anda WorkSpace, pastikan bahwa itu tidak memblokir port yang diperlukan. Untuk informasi selengkapnya, lihat [Alamat IP dan persyaratan port untuk WorkSpaces Pribadi](workspaces-port-requirements.md).
+ Untuk Windows WorkSpaces, jangan mengonfigurasi Objek Kebijakan Grup (GPOs) sebelum pembuatan gambar.
+ Untuk Windows WorkSpaces, jangan menyesuaikan profil pengguna default (`C:\Users\Default`) sebelum membuat gambar. Kami merekomendasikan membuat penyesuaian apa pun ke profil pengguna melalui GPOs, dan menerapkannya setelah pembuatan gambar. GPOs dapat dengan mudah dimodifikasi atau digulung kembali, dan karena itu kurang rentan terhadap kesalahan daripada penyesuaian yang dibuat ke profil pengguna default.
+ Pastikan Anda memperbarui driver ketergantungan jaringan seperti ENA, NVMe, dan driver PV pada Anda WorkSpaces. Anda harus melakukan ini setidaknya sekali setiap 6 bulan. Untuk informasi selengkapnya, lihat [Menginstal atau memutakhirkan driver Elastic Network Adapter (ENA)](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/enhanced-networking-ena.html#ena-adapter-driver-install-upgrade-win), [Driver AWS NVMe untuk instance Windows](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/aws-nvme-drivers.html), dan [Upgrade driver PV pada instans Windows](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Upgrading_PV_drivers.html).
+ Pastikan Anda memperbarui agen EC2 Config, EC2 Launch, dan EC2 Launch V2 ke versi terbaru secara berkala. Anda harus melakukan ini setidaknya sekali setiap 6 bulan. Untuk informasi selengkapnya, lihat [Perbarui EC2 Konfigurasi dan EC2](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/migrating-latest-types.html#upgdate-ec2config-ec2launch) Peluncuran.
## Langkah 1: Jalankan Pemeriksa Gambar
Untuk mengonfirmasi bahwa Windows Anda WorkSpace memenuhi persyaratan untuk pembuatan gambar, kami sarankan menjalankan aplikasi Pemeriksa Gambar. Pemeriksa Gambar melakukan serangkaian pengujian WorkSpace yang ingin Anda gunakan untuk membuat gambar Anda, dan memberikan panduan tentang cara mengatasi masalah apa pun yang ditemukannya. Pemeriksa Gambar hanya tersedia untuk Windows WorkSpaces.
**penting**
WorkSpace Harus lulus semua tes yang dijalankan oleh Pemeriksa Gambar sebelum Anda dapat menggunakannya untuk pembuatan gambar.
Sebelum Anda menjalankan Pemeriksa Gambar, verifikasi bahwa keamanan Windows terbaru dan pembaruan kumulatif diinstal pada Anda. WorkSpace
Untuk mendapatkan Pemeriksa Citra, lakukan salah satu hal berikut:
+ [Reboot Anda WorkSpace](reboot-workspaces.md). Pemeriksa Citra diunduh secara otomatis selama booting ulang dan diinstal di `C:\Program Files\Amazon\ImageChecker.exe`.
+ Unduh Amazon WorkSpaces Image Checker [https://tools.amazonworkspaces.comImageCheckerdari/.zip ](https://tools.amazonworkspaces.com/ImageChecker.zip) dan ekstrak file. `ImageChecker.exe` Salin file ke `C:\Program Files\Amazon\`.
**Untuk Menjalankan Pemeriksa Citra**
1. Buka file `C:\Program Files\Amazon\ImageChecker.exe`.
1. Di kotak dialog **Amazon WorkSpaces Image Checker**, pilih **Jalankan**.
1. Setelah menyelesaikan setiap tes, Anda dapat melihat status tes.
Untuk setiap tes dengan status **GAGAL**, pilih **Info** untuk menampilkan informasi penyelesaian masalah yang menyebabkan kegagalan. Untuk informasi penyelesaian masalah ini, lihat [Tips untuk menyelesaikan masalah yang terdeteksi oleh Pemeriksa Citra](#pools-image_checker_tips).
Jika ada pengujian yang menampilkan status **PERINGATAN**, pilih tombol **Perbaiki Semua Peringatan**.
Alat ini menghasilkan berkas log output dalam direktori yang sama tempat Pemeriksa Citra berada. Secara default, file ini terletak di `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log`. Jangan hapus file log ini. Jika terjadi masalah, berkas log ini dapat membantu dalam pemecahan masalah.
1. Jika berlaku, selesaikan masalah apa pun yang menyebabkan kegagalan pengujian dan peringatan, dan ulangi proses menjalankan Pemeriksa Gambar hingga WorkSpace lulus semua pengujian. Semua kegagalan dan peringatan harus diselesaikan sebelum Anda dapat membuat citra.
1. Setelah WorkSpace melewati semua tes, Anda akan melihat pesan **Validasi Berhasil**. Kini Anda siap membuat paket kustom.
### Tips untuk menyelesaikan masalah yang terdeteksi oleh Pemeriksa Citra
Selain berkonsultasi tips penyelesaian masalah berikut yang terdeteksi oleh Pemeriksa Citra, pastikan meninjau berkas log Pemeriksa Citra di `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log`.
#### PowerShell versi 3.0 atau yang lebih baru harus diinstal
Instal versi terbaru [Microsoft Windows PowerShell](https://docs.microsoft.com/powershell).
**penting**
Kebijakan PowerShell eksekusi untuk a WorkSpace harus disetel untuk mengizinkan **RemoteSigned**skrip. Untuk memeriksa kebijakan eksekusi, jalankan ExecutionPolicy PowerShell perintah **Get-**. Jika kebijakan eksekusi tidak disetel ke **Tidak Dibatasi** atau **RemoteSigned**, jalankan ExecutionPolicy RemoteSigned perintah **Set- ExecutionPolicy —** untuk mengubah nilai kebijakan eksekusi. **RemoteSigned**Pengaturan memungkinkan eksekusi skrip di Amazon WorkSpaces, yang diperlukan untuk membuat gambar.
#### Hanya drive C dan D yang dapat hadir
Hanya `D` drive `C` dan yang dapat hadir pada WorkSpace yang digunakan untuk pencitraan. Hapus semua drive lainnya, termasuk drive virtual.
#### Tidak ada booting ulang tertunda karena Pembaruan Windows dapat dideteksi
+ Proses Create Image tidak dapat berjalan sampai Windows di-boot ulang untuk menyelesaikan penginstalan keamanan atau pembaruan kumulatif. Booting ulang Windows untuk menerapkan pembaruan ini, dan pastikan bahwa tidak ada pembaruan keamanan atau kumulatif Windows lainnya yang perlu diinstal tertunda.
+ Pembuatan gambar tidak didukung pada sistem Windows 10 yang telah ditingkatkan dari satu versi Windows 10 ke versi Windows 10 yang lebih baru ( feature/version upgrade Windows). Namun, pembaruan kumulatif atau keamanan Windows didukung oleh proses pembuatan WorkSpaces gambar.
#### File Sysprep harus ada dan tidak boleh kosong
Jika ada masalah dengan file Sysprep Anda, hubungi [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/) untuk memperbaiki EC2 Config atau Launch Anda. EC2
#### Ukuran profil pengguna harus kurang dari 10 GB
Untuk Windows 7 WorkSpaces, profil pengguna (`D:\Users\username`) harus kurang dari 10 GB total. Hapus file sesuai keperluan untuk mengurangi ukuran profil pengguna.
#### Drive C harus memiliki ruang kosong yang cukup
Untuk Windows 7 WorkSpaces, Anda harus memiliki setidaknya 12 GB ruang kosong pada drive`C`. Hapus file sesuai kebutuhan untuk mengosongkan ruang pada drive `C`. Untuk Windows 10 WorkSpaces, abaikan jika Anda menerima `FAILED` pesan dan ruang disk di atas 2GB.
#### Tidak ada layanan yang dapat berjalan di akun domain
Untuk menjalankan proses Create Image, tidak ada layanan yang WorkSpace dapat berjalan di bawah akun domain. Semua layanan harus berjalan di akun lokal.
**Untuk menjalankan layanan di bawah akun lokal**
1. Buka `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log` dan temukan daftar layanan yang berjalan di bawah akun domain.
1. Di kotak pencarian Windows, masukkan **services.msc** untuk membuka Windows Services Manager.
1. Di **Log On Sebagai**, cari layanan yang berjalan di akun domain. (Layanan yang berjalan sebagai **Sistem Lokal**, **Layanan Lokal**, atau **Layanan Jaringan** tidak mengganggu pembuatan citra.)
1. Pilih layanan yang berjalan di akun domain, dan lalu pilih**Tindakan**, **Properti**.
1. Buka tab **Log On**. Di **Log on sebagai**, pilih **Akun Sistem Lokal**.
1. Pilih **OKE**.
#### WorkSpace Harus dikonfigurasi untuk menggunakan DHCP
Anda harus mengkonfigurasi semua adapter jaringan pada WorkSpace untuk menggunakan DHCP bukan alamat IP statis.
**Untuk mengatur semua adapter jaringan agar menggunakan DHCP**
1. Di kotak pencarian Windows, masukkan **control panel** untuk membuka Panel Kontrol.
1. Pilih **Jaringan dan Internet**.
1. Pilih **Jaringan dan Pusat Berbagi**.
1. Pilih **Mengubah pengaturan adapter**, dan pilih adapter.
1. Pilih **Ubah pengaturan hubungan ini**.
1. **Pada tab **Networking**, pilih **Internet Protocol Version 4 (TCP/IPv4)**, lalu pilih Properties.**
1. Dalam kotak dialog **Internet Protocol Version 4 (TCP/IPv4) Properties**, pilih **Dapatkan alamat IP secara otomatis**.
1. Pilih **OK**.
1. Ulangi proses ini untuk semua adapter jaringan di file WorkSpace.
#### Layanan Desktop Jarak Jauh harus diaktifkan
Proses Pembuatan Citra perlu Layanan Desktop Jarak Jauh yang aktif.
**Untuk mengaktifkan Layanan Desktop Jarak Jauh**
1. Di kotak pencarian Windows, masukkan **services.msc** untuk membuka Windows Services Manager.
1. Di kolom **Nama**, cari **Layanan Desktop Jarak Jauh**.
1. Pilih **Layanan Desktop Jarak Jauh**, lalu pilih**Tindakan**, **Properti**.
1. Pada tab **Umum**, untuk **Tipe Startup**, pilih **Manual** atau **Otomatis**.
1. Pilih **OKE**.
#### Profil pengguna harus ada
WorkSpace Yang Anda gunakan untuk membuat gambar harus memiliki profil pengguna (`D:\Users\username`). Jika pengujian ini gagal, hubungi [Pusat AWS Dukungan](https://console.aws.amazon.com/support/home#/) untuk mendapatkan bantuan.
#### Jalur variabel lingkungan harus dikonfigurasi dengan benar
Jalur variabel lingkungan untuk mesin lokal tidak memiliki entri untuk System32 dan untuk Windows. PowerShell Entri ini diperlukan agar pembuatan citra berjalan.
**Untuk mengonfigurasi jalur variabel lingkungan**
1. Di kotak pencarian Windows, masukkan **environment variables** lalu pilih **Edit variabel lingkungan sistem**.
1. Dalam kotak dialog **Properti Sistem**, pilih tab **Lanjutan**, dan pilih **Variabel Lingkungan**.
1. Di kotak dialog **Variabel lingkungan**, di **Variabel sistem**, pilih **Jalur** lalu pilih **Edit**.
1. Pilih **Baru**, dan tambahkan jalur berikut:
`C:\Windows\System32`
1. Pilih **Baru** kembali, dan tambahkan jalur berikut:
`C:\Windows\System32\WindowsPowerShell\v1.0\`
1. Pilih **OKE**.
1. Mulai ulang WorkSpace.
**Tip**
Urutan item yang muncul di jalur lingkungan variabel adalah hal penting. Untuk menentukan urutan yang benar, Anda mungkin ingin membandingkan jalur variabel lingkungan Anda WorkSpace dengan jalur dari instance Windows yang baru dibuat WorkSpace atau yang baru.
#### Penginstal Modul Windows harus diaktifkan
Proses Pembuatan Citra perlu layanan Penginstal Modul Windows yang aktif.
**Untuk mengaktifkan layanan Penginstal Modul Windows**
1. Di kotak pencarian Windows, masukkan **services.msc** untuk membuka Windows Services Manager.
1. Di kolom **Nama**, cari **Penginstal Modul Windows**.
1. Pilih **Penginstal Modul Windows**, lalu pilih **Tindakan**, **Properti**.
1. Pada tab **Umum**, untuk **Tipe Startup**, pilih **Manual** atau **Otomatis**.
1. Pilih **OKE**.
#### Amazon SSM Agent harus dinonaktifkan
Proses pembuatan citra memerlukan layanan Amazon SSM Agent dinonaktifkan.
**Untuk menonaktifkan layanan Amazon SSM Agent**
1. Di kotak pencarian Windows, masukkan **services.msc** untuk membuka Windows Services Manager.
1. Di kolom **Nama**, cari **Amazon SSM Agent**.
1. Pilih **Amazon SSM Agent**, lalu pilih **Tindakan**, **Properti**.
1. Pada tab **Umum**, untuk **Tipe Startup, **Pilih**Nonaktif**.
1. Pilih **OKE**.
#### SSL3 dan TLS versi 1.2 harus diaktifkan
Untuk mengkonfigurasi SSL/TLS untuk Windows, lihat [Cara Mengaktifkan TLS 1.2](https://docs.microsoft.com/configmgr/core/plan-design/security/enable-tls-1-2) di dokumentasi Microsoft Windows.
#### Hanya satu profil pengguna yang dapat ada di WorkSpace
Hanya ada satu profil WorkSpaces pengguna (`D:\Users\username`) pada WorkSpace yang Anda gunakan untuk membuat gambar. Hapus profil pengguna apa pun yang bukan milik pengguna yang dituju WorkSpace.
Agar pembuatan gambar berfungsi, Anda hanya WorkSpace dapat memiliki tiga profil pengguna di dalamnya:
+ Profil pengguna pengguna yang dituju dari WorkSpace (`D:\Users\username`)
+ Profil pengguna default (juga dikenal sebagai Default Profile)
+ Profil pengguna Administrator
Jika ada profil pengguna tambahan, Anda dapat menghapusnya melalui properti sistem lanjutan di Panel Kontrol Windows.
**Untuk menghapus profil pengguna**
1. Untuk mengakses properti sistem lanjutan, lakukan salah satu hal berikut:
+ Tekan **Kunci Windows\$1Jeda Istirahat**, lalu pilih **Pengaturan sistem lanjutan** dalam panel kiri dari **Panel Kontrol** > **Sistem dan Keamanan** > kotak dialog **Sistem**.
+ Dalam kotak pencarian Windows, masukkan **control panel**. Di Panel Kontrol, pilih **Sistem dan Keamanan**, lalu pilih Sistem, pilih **Pengaturan sistem lanjutan** dalam panel kiri di **Panel Kontrol** > **Sistem dan Keamanan** > kotak dialog **Sistem**.
1. Di kotak dialog **Properti Sistem**, pada tab **Lanjutan**, pilih **Pengaturan** di **Profil Pengguna**.
1. Jika ada profil yang terdaftar selain profil Administrator, Profil Default, dan profil WorkSpaces pengguna yang dituju, pilih profil tambahan itu dan pilih **Hapus**.
1. Saat ditanya keinginan menghapus profil, pilih **Ya**.
1. Jika perlu, ulangi Langkah 3 dan 4 untuk menghapus profil lain yang tidak termasuk dalam WorkSpace.
1. Pilih **OKE** dua kali dan tutup Panel Kontrol.
1. Mulai ulang WorkSpace.
#### Paket AppX tidak bisa berada dalam keadaan bertahap
Satu paket AppX atau lebih berada dalam keadaan bertahap. Hal ini dapat menyebabkan kesalahan Sysprep selama pembuatan citra.
**Untuk menghapus semua paket AppX yang dipaketkan**
1. Dalam kotak pencarian Windows, masukkan **powershell**. Pilih **Jalankan sebagai Administrator**.
1. Saat ditanya "Apakah Anda ingin mengizinkan aplikasi ini melakukan perubahan pada perangkat?", Pilih**Ya**.
1. Di PowerShell jendela Windows, masukkan perintah berikut untuk mencantumkan semua paket AppX bertahap, dan tekan Enter setelah masing-masing.
```
$workSpaceUserName = $env:username
```
```
$allAppxPackages = Get-AppxPackage -AllUsers
```
```
$packages = $allAppxPackages | Where-Object { `
(($_.PackageUserInformation -like "*S-1-5-18*" -and !($_.PackageUserInformation -like "*$workSpaceUserName*")) -and `
($_.PackageUserInformation -like "*Staged*" -or $_.PackageUserInformation -like "*Installed*")) -or `
((!($_.PackageUserInformation -like "*S-1-5-18*") -and $_.PackageUserInformation -like "*$workSpaceUserName*") -and `
$_.PackageUserInformation -like "*Staged*")
}
```
1. Jalankan perintah berikut dengan hak istimewa SYSTEM yang ditinggikan untuk menghapus semua entri penyediaan paket AppX bertahap, dan tekan Enter.
```
$packages | Remove-AppxPackage -ErrorAction SilentlyContinue
```
1. Untuk Menjalankan Pemeriksa Citra Jika ujian ini masih gagal, masukkan perintah berikut untuk menghapus semua paket AppX, dan tekan Enter setelah setiap paket.
```
Get-AppxProvisionedPackage -Online | Remove-AppxProvisionedPackage -Online -ErrorAction SilentlyContinue
```
```
Get-AppxPackage -AllUsers | Remove-AppxPackage -ErrorAction SilentlyContinue
```
#### Windows tidak harus telah ditingkatkan dari versi sebelumnya
Pembuatan gambar tidak didukung pada sistem Windows yang telah ditingkatkan dari satu versi Windows 10 ke versi Windows 10 yang lebih baru ( feature/version upgrade Windows).
Untuk membuat gambar, gunakan WorkSpace yang belum mengalami feature/version upgrade Windows.
#### Jumlah Windows persenjataan ulang tidak boleh 0
Fitur persenjataan ulang memungkinkan Anda memperpanjang masa aktivasi untuk versi percobaan Windows. Proses Pembuatan Citra mengharuskan jumlah persenjataan ulang bernilai selain 0.
**Untuk memeriksa jumlah persenjataan ulang Windows**
1. Pada menu **Mulai** Windows, pilih**Sistem Windows**, lalu pilih **Perintah**.
1. Dalam jendela Perintah, masukkan perintah berikut, kemudian tekan Enter.
`cscript C:\Windows\System32\slmgr.vbs /dlv`
Untuk mengatur ulang jumlah persenjataan ulang ke nilai selain 0, lihat [Instalasi Windows Sysprep (Generalize)](https://docs.microsoft.com/windows-hardware/manufacture/desktop/sysprep--generalize--a-windows-installation) dalam dokumentasi Microsoft Windows.
#### Tips penyelesaian masalah lainnya
Jika Anda WorkSpace lulus semua pengujian yang dijalankan oleh Pemeriksa Gambar, tetapi Anda masih tidak dapat membuat gambar dari WorkSpace, periksa masalah berikut:
+ Pastikan WorkSpace tidak ditetapkan ke pengguna dalam grup **Tamu Domain**. Untuk memeriksa apakah ada akun domain, jalankan PowerShell perintah berikut.
```
Get-WmiObject -Class Win32_Service | Where-Object { $_.StartName -like "*$env:USERDOMAIN*" }
```
+ Beberapa Objek Kebijakan Grup (GPOs) membatasi akses ke cap jempol sertifikat RDP saat diminta oleh layanan EC2 Config atau skrip Peluncuran selama konfigurasi instance Windows. EC2 Sebelum Anda mencoba membuat gambar, pindahkan WorkSpace ke unit organisasi baru (OU) dengan warisan yang diblokir dan tidak GPOs diterapkan.
+ Pastikan bahwa layanan Windows Remote Management (WinRM) dikonfigurasi untuk memulai secara otomatis. Lakukan hal-hal berikut:
1. Di kotak pencarian Windows, masukkan `services.msc` untuk membuka Windows Services Manager.
1. Di kolom **Nama**, cari **Manajemen Jarak Jauh Windows (WS-Management)**.
1. Pilih **Manajemen Jarak Jauh Windows (WS-Management)**, lalu pilih **Tindakan**, **Properti**.
1. Pada tab **Umum**, untuk **Tipe Startup**, pilih **Otomatis**.
1. Pilih **OKE**.
## Langkah 2: Buat gambar kustom dan bundel kustom
Setelah Anda memvalidasi WorkSpace gambar Anda, selesaikan prosedur berikut untuk membuat gambar kustom dan bundel kustom Anda menggunakan WorkSpaces konsol. Untuk membuat gambar secara terprogram, gunakan tindakan CreateWorkspaceImage API. Untuk informasi selengkapnya, lihat [ CreateWorkspaceImage](https://docs.aws.amazon.com/workspaces/latest/api/API_CreateWorkspaceImage.html)di *Referensi Amazon WorkSpaces API*. Untuk membuat paket secara terprogram, gunakan Tindakan API **CreateWorkspaceBundle**. Untuk informasi selengkapnya, lihat [ CreateWorkspaceBundle](https://docs.aws.amazon.com/workspaces/latest/api/API_CreateWorkspaceBundle.html)di *Referensi Amazon WorkSpaces API*.
**Untuk membuat gambar kustom dan bundel kustom menggunakan WorkSpaces konsol**
1. Jika Anda masih terhubung ke WorkSpace, putuskan sambungan dengan memilih **Amazon WorkSpaces** dan **Putuskan sambungan** di aplikasi WorkSpaces klien.
1. Buka WorkSpaces konsol di [https://console.aws.amazon.com/workspaces/v2/home](https://console.aws.amazon.com/workspaces/v2/home).
1. Di panel navigasi, pilih **WorkSpaces**.
1. Pilih WorkSpace untuk membuka halaman detailnya dan pilih **Buat gambar**. Jika status WorkSpace **Dihentikan**, Anda harus memulainya terlebih dahulu (pilih **Tindakan**, **Mulai WorkSpaces**) sebelum Anda dapat memilih **Tindakan**, **Buat Gambar**.
1. Sebuah pesan ditampilkan, meminta Anda untuk reboot (restart) Anda WorkSpace sebelum melanjutkan. Mem-boot ulang WorkSpace pembaruan WorkSpaces perangkat lunak Amazon Anda ke versi terbaru.
Reboot Anda WorkSpace dengan menutup pesan dan mengikuti langkah-langkahnya[Reboot a WorkSpace secara WorkSpaces pribadi](reboot-workspaces.md). Setelah selesai, ulangi [Step 4](create-custom-bundle.md#step_create_image) prosedur ini, tetapi kali ini pilih **Selanjutnya** saat pesan boot ulang muncul. Untuk membuat gambar, status WorkSpace harus **Tersedia** dan status modifikasinya harus **Tidak Ada**.
1. Masukkan nama citra dan deskripsi yang akan membantu Anda mengidentifikasi citra, lalu pilih **Buat Citra**. Saat gambar sedang dibuat, status WorkSpace **ditangguhkan** dan tidak WorkSpace tersedia.
Jangan gunakan karakter khusus tanda hubung (`-`) dalam deskripsi. Ini akan menyebabkan kesalahan.
1. Di panel navigasi, pilih **Citra**. Gambar selesai ketika status WorkSpace perubahan ke **Tersedia** (ini bisa memakan waktu hingga 45 menit).
1. Pilih citra dan pilih **Tindakan**, **Buat Paket**.
1. Masukkan nama paket dan deskripsi, lalu lakukan hal berikut:
+ Untuk **jenis perangkat keras Bundel**, pilih perangkat keras yang akan digunakan saat meluncurkan WorkSpaces dari bundel khusus ini.
+ Kombinasi ukuran default yang tersedia untuk volume root adalah 200 GB per WorkSpace.
1. Untuk mengonfirmasi bahwa paket Anda telah dibuat, pilih **Paket** dan verifikasi bahwa paket terdaftar.
## Apa yang disertakan dengan gambar WorkSpaces kustom Windows
Saat Anda membuat gambar dari Windows WorkSpace, seluruh konten `C` drive disertakan.
+ Kontak
+ Unduh
+ Musik
+ Gambar
+ Game yang disimpan
+ Video
+ Podcast
+ mesin virtual
+ .virtualbox
+ Pelacakan
+ appdata\$1local\$1temp
+ appdata\$1roaming\$1apple computer\$1mobilesync\$1
+ appdata\$1roaming\$1apple computer\$1logs\$1
+ appdata\$1roaming\$1apple computer\$1itunes\$1iphone software updates\$1
+ appdata\$1roaming\$1macromedia\$1flash player\$1macromedia.com\$1support\$1flashplayer\$1sys\$1
+ appdata\$1roaming\$1macromedia\$1flash player\$1\$1sharedobjects\$1
+ appdata\$1roaming\$1adobe\$1flash player\$1assetcache\$1
+ appdata\$1roaming\$1microsoft\$1windows\$1recent\$1
+ appdata\$1roaming\$1microsoft\$1office\$1recent\$1
+ appdata\$1roaming\$1microsoft office\$1live meeting
+ appdata\$1roaming\$1microsoft shared\$1livemeeting shared\$1
+ appdata\$1roaming\$1mozilla\$1firefox\$1crash reports\$1
+ appdata\$1roaming\$1mcafee\$1common framework\$1
+ appdata\$1local\$1microsoft\$1feeds cache
+ appdata\$1local\$1microsoft\$1windows\$1temporary internet files\$1
+ appdata\$1local\$1microsoft\$1windows\$1history\$1
+ appdata\$1local\$1microsoft\$1internet explorer\$1domstore\$1
+ appdata\$1local\$1microsoft\$1internet explorer\$1imagestore\$1
+ appdata\$1locallow\$1microsoft\$1internet explorer\$1iconcache\$1
+ appdata\$1locallow\$1microsoft\$1internet explorer\$1domstore\$1
+ appdata\$1locallow\$1microsoft\$1internet explorer\$1imagestore\$1
+ appdata\$1local\$1microsoft\$1internet explorer\$1recovery\$1
+ appdata\$1local\$1mozilla\$1firefox\$1profiles\$1
# Mengelola gambar kustom dan bundel untuk Pools WorkSpaces
Proses untuk mengelola gambar dan bundel kustom adalah sama antara WorkSpaces Personal dan WorkSpaces Pool. Untuk informasi selengkapnya tentang cara mengelola gambar dan bundel, lihat dokumentasi berikut di bagian WorkSpaces Pribadi dari panduan ini:
**catatan**
Perbedaan utama antara bundel kustom yang dapat Anda gunakan untuk WorkSpaces Personal dan yang dapat Anda gunakan untuk WorkSpaces Pool adalah sistem operasi dan bundel umum dasar yang dapat digunakan. Untuk sistem operasi dan bundel yang didukung di WorkSpaces Pool, lihat[ WorkSpaces Bundel KolamPaket Pelajari tentang bundel WorkSpaces Pools. *WorkSpace Bundel* adalah kombinasi dari sistem operasi, dan penyimpanan, komputasi, dan sumber daya perangkat lunak. Saat Anda meluncurkan WorkSpace, Anda memilih bundel yang memenuhi kebutuhan Anda. Bundel default yang tersedia untuk WorkSpaces disebut *bundel publik*. Untuk informasi selengkapnya tentang berbagai bundel publik yang tersedia WorkSpaces, lihat [Amazon WorkSpaces Bundles](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles). Tabel berikut memberikan informasi tentang lisensi, protokol streaming, dan bundel yang didukung oleh masing-masing OS.
| Sistem Operasi | Lisensi | Protokol streaming | Bundel yang didukung |
| --- | --- | --- | --- |
| Windows Server 2019 | Termasuk | DCV | Nilai, Standar, Kinerja, Daya, PowerPro |
| Windows Server 2022 | Termasuk | DCV | Standar, Kinerja, Daya,, PowerPro Grafik.G4DN, .g4dn GraphicsPro | Versi sistem operasi yang tidak lagi didukung oleh vendor tidak dijamin berfungsi dan tidak didukung oleh AWS dukungan. ](instance-types.md#instance-types.title).
+ [Perbarui bundel khusus untuk WorkSpaces Pribadi](update-custom-bundle.md).
+ [Salin gambar kustom di WorkSpaces Pribadi](copy-custom-image.md).
+ [Bagikan atau batalkan berbagi gambar kustom di WorkSpaces Personal](share-custom-image.md).
+ [Hapus bundel atau gambar khusus di WorkSpaces Pribadi](delete_bundle.md).
# Gunakan skrip sesi untuk mengelola pengalaman streaming pengguna Anda
WorkSpaces Pool menyediakan skrip sesi on-instance. Anda dapat menggunakan skrip ini untuk menjalankan skrip kustom Anda sendiri ketika peristiwa tertentu terjadi dalam sesi streaming pengguna. Misalnya, Anda dapat menggunakan skrip khusus untuk menyiapkan lingkungan WorkSpaces Pools sebelum sesi streaming pengguna dimulai. Anda juga dapat menggunakan skrip khusus untuk membersihkan instance streaming setelah pengguna menyelesaikan sesi streaming mereka.
Skrip sesi ditentukan dalam WorkSpace gambar. Skrip ini dijalankan dalam konteks pengguna atau konteks sistem. Jika skrip sesi Anda menggunakan standar keluar untuk menulis informasi, kesalahan, atau men-debug pesan, skrip ini dapat disimpan secara opsional ke bucket Amazon S3 dalam akun Amazon Web Services Anda.
**Topics**
+ [Jalankan Skrip Sebelum Sesi Streaming Dimulai](#run-scripts-before-streaming-sessions-begin)
+ [Jalankan Skrip Setelah Sesi Streaming Berakhir](#run-scripts-after-streaming-sessions-end)
+ [Buat dan Tentukan Skrip Sesi](#create-specify-session-scripts)
+ [File Konfigurasi Skrip Sesi](#session-script-configuration-file)
+ [Menggunakan PowerShell File Windows](#using-powershell-files-with-session-scripts)
+ [Keluaran Skrip Sesi Pencatatan](#logging-session-output)
+ [Gunakan penyimpanan persisten dengan skrip sesi](#use-storage-connectors-with-session-scripts)
+ [Aktifkan Penyimpanan Bucket Amazon S3 untuk Log Skrip Sesi](#enable-S3-bucket-storage-session-script-logs)
## Jalankan Skrip Sebelum Sesi Streaming Dimulai
Anda dapat mengonfigurasi skrip agar berjalan maksimal 60 detik sebelum aplikasi pengguna diluncurkan dan sesi streaming mereka dimulai. Melakukannya memungkinkan Anda untuk menyesuaikan lingkungan WorkSpaces Pools sebelum pengguna mulai streaming aplikasi mereka. Saat skrip sesi berjalan, spinner pemuatan akan ditampilkan untuk pengguna Anda. Ketika skrip Anda berhasil diselesaikan atau waktu tunggu maksimum berlalu, sesi streaming pengguna Anda akan dimulai. Jika skrip Anda tidak berhasil diselesaikan, pesan kesalahan akan ditampilkan untuk pengguna Anda. Namun, pengguna Anda tidak dicegah menggunakan sesi streaming mereka.
Saat Anda menentukan nama file pada instance Windows, Anda harus menggunakan garis miring terbalik ganda. Contoh:
```
C:\\Scripts\\Myscript.bat
```
Jika Anda tidak menggunakan garis miring terbalik ganda, kesalahan akan ditampilkan untuk memberi tahu Anda bahwa `.json` file tersebut salah diformat.
**catatan**
Ketika skrip Anda berhasil diselesaikan, mereka harus mengembalikan nilai 0. Jika skrip Anda mengembalikan nilai selain 0, WorkSpaces menampilkan pesan kesalahan kepada pengguna.
Saat Anda menjalankan skrip sebelum sesi streaming dimulai, proses berikut terjadi:
1. Pengguna Anda terhubung ke WorkSpace dalam WorkSpaces Pool yang tidak bergabung dengan domain. Mereka terhubung dengan menggunakan SAMP 2.0.
1. Salah satu hal berikut terjadi:
+ Jika persistensi pengaturan aplikasi diaktifkan untuk pengguna Anda, file pengaturan aplikasi Virtual Hard Disk (VHD) yang menyimpan penyesuaian pengguna Anda dan pengaturan Windows diunduh dan dipasang. Login pengguna Windows diperlukan dalam kasus ini.
Untuk informasi tentang persistensi setelan aplikasi, lihat[Aktifkan persistensi pengaturan aplikasi untuk pengguna WorkSpaces Pools Anda](app-settings-persistence.md).
+ Jika persistensi pengaturan aplikasi tidak diaktifkan, pengguna Windows sudah masuk.
1. Skrip sesi Anda dimulai. Jika penyimpanan persisten diaktifkan untuk pengguna Anda, pemasangan konektor penyimpanan juga dimulai. Untuk informasi tentang penyimpanan persisten, lihat[Mengaktifkan dan Mengelola Penyimpanan Persisten untuk Pools WorkSpaces](persistent-storage.md).
**catatan**
Pemasangan konektor penyimpanan tidak perlu diselesaikan agar sesi streaming dimulai. Jika skrip sesi selesai sebelum pemasangan konektor penyimpanan selesai, sesi streaming dimulai.
Untuk informasi tentang memantau status pemasangan konektor penyimpanan, lihat[Gunakan penyimpanan persisten dengan skrip sesi](#use-storage-connectors-with-session-scripts).
1. Skrip sesi Anda selesai atau habis waktu.
1. Sesi streaming pengguna dimulai.
## Jalankan Skrip Setelah Sesi Streaming Berakhir
Anda juga dapat mengonfigurasi skrip agar berjalan setelah sesi streaming pengguna berakhir. Misalnya, Anda dapat menjalankan skrip saat pengguna memilih **Akhir Sesi** dari bilah alat WorkSpaces klien, atau ketika mereka mencapai durasi maksimum yang diizinkan untuk sesi tersebut. Anda juga dapat menggunakan skrip sesi ini untuk membersihkan WorkSpaces lingkungan Anda sebelum instance streaming dihentikan. Misalnya, Anda dapat menggunakan skrip untuk melepaskan kunci file atau mengunggah file log. Saat Anda menjalankan skrip setelah sesi streaming berakhir, proses berikut terjadi:
1. Sesi WorkSpaces streaming pengguna Anda berakhir.
1. Skrip penghentian sesi Anda dimulai.
1. Skrip penghentian sesi selesai atau habis waktu.
1. Terjadi logout pengguna Windows.
1. Salah satu atau kedua hal berikut terjadi secara paralel, jika berlaku:
+ Jika persistensi pengaturan aplikasi diaktifkan untuk pengguna Anda, file VHD pengaturan aplikasi yang menyimpan penyesuaian dan pengaturan Windows pengguna Anda dilepas dan diunggah ke bucket Amazon S3 di akun Anda.
+ Jika penyimpanan persisten diaktifkan untuk pengguna Anda, konektor penyimpanan menyelesaikan sinkronisasi akhir dan dilepas.
1. WorkSpace Itu dihentikan.
## Buat dan Tentukan Skrip Sesi
Selesaikan prosedur berikut untuk membuat dan menentukan skrip sesi untuk Anda WorkSpaces di WorkSpaces Pool.
1. Connect ke Windows WorkSpaces dari mana Anda membuat gambar kustom.
1. Buat direktori `/AWSEUC/SessionScripts` jika belum ada.
1. Buat file konfigurasi `/AWSEUC/SessionScripts/config.json` jika belum ada, menggunakan [template Konfigurasi Skrip Sesi](https://docs.aws.amazon.com/workspaces/latest/adminguide/pools-images-session-scripts.html#session-script-configuration-file).
1. Arahkan ke`C:\AWSEUC\SessionScripts`, dan buka file `config.json` konfigurasi.
Untuk informasi tentang parameter skrip sesi, lihat[File Konfigurasi Skrip Sesi](#session-script-configuration-file).
1. Setelah Anda selesai membuat perubahan, simpan dan tutup `config.json` file.
1. Selesaikan langkah-langkah untuk membuat gambar dari file WorkSpace. Untuk informasi selengkapnya, lihat [Buat gambar dan bundel khusus untuk WorkSpaces Pools](pools-images-custom-image.md).
## File Konfigurasi Skrip Sesi
Untuk menemukan file konfigurasi skrip sesi dalam instance Windows, navigasikan ke`C:\AWSEUC\SessionScripts\config.json`. File diformat sebagai berikut.
**catatan**
File konfigurasi dalam format JSON. Verifikasi bahwa teks apa pun yang Anda ketik dalam file ini dalam format JSON yang valid.
```
{
"SessionStart": {
"executables": [
{
"context": "system",
"filename": "",
"arguments": "",
"s3LogEnabled": true
},
{
"context": "user",
"filename": "",
"arguments": "",
"s3LogEnabled": true
}
],
"waitingTime": 30
},
"SessionTermination": {
"executables": [
{
"context": "system",
"filename": "",
"arguments": "",
"s3LogEnabled": true
},
{
"context": "user",
"filename": "",
"arguments": "",
"s3LogEnabled": true
}
],
"waitingTime": 30
}
}
```
Anda dapat menggunakan parameter berikut dalam file konfigurasi skrip sesi.
**`SessionStart/SessionTermination `**
Skrip sesi untuk dijalankan dalam acara sesi yang sesuai berdasarkan nama objek.
**Tipe**: String
**Wajib**: Tidak
**Nilai yang diizinkan:****SessionStart**, **SessionTermination**
**`WaitingTime`**
Durasi maksimum skrip sesi dalam hitungan detik.
**Tipe**: Integer
**Wajib**: Tidak
**Kendala:** Durasi maksimum adalah 60 detik. Jika skrip sesi tidak selesai dalam durasi ini, skrip tersebut akan dihentikan. Jika Anda memerlukan skrip untuk terus berjalan, luncurkan sebagai proses terpisah.
**`Executables`**
Detail untuk menjalankan skrip sesi.
**Tipe**: String
**Wajib**: Ya
**Kendala:** Jumlah maksimum skrip yang dapat dijalankan per acara sesi adalah 2 (satu untuk konteks pengguna, satu untuk konteks sistem).
**`Context`**
Konteks di mana untuk menjalankan skrip sesi.
**Tipe**: String
**Wajib**: Ya
**Nilai yang diizinkan:****user**, **system**
**`Filename`**
Jalur lengkap ke skrip sesi untuk dijalankan. Jika parameter ini tidak ditentukan, skrip sesi tidak dijalankan.
**Tipe**: String
**Wajib**: Tidak
**Kendala:** Panjang maksimum untuk nama file dan jalur lengkap adalah 1.000 karakter.
**Nilai yang diizinkan:****.bat**,**.exe**, **.sh**
Anda juga dapat menggunakan PowerShell file Windows. Untuk informasi selengkapnya, lihat [Menggunakan PowerShell File Windows](#using-powershell-files-with-session-scripts).
**`Arguments`**
Argumen untuk skrip sesi Anda atau file yang dapat dieksekusi.
**Tipe**: String
**Wajib**: Tidak
**Kendala panjang:** Panjang maksimum adalah 1.000 karakter.
**`S3LogEnabled`**
Ketika nilai untuk parameter ini disetel ke**True**, bucket S3 dibuat dalam akun Amazon Web Services Anda untuk menyimpan log yang dibuat oleh skrip sesi. Secara default, nilai ini diatur ke **True**. Untuk informasi selengkapnya, lihat bagian *Keluaran Skrip Sesi Pencatatan* nanti dalam topik ini.
**Tipe**: Boolean
**Wajib**: Tidak
**Nilai yang diizinkan:****True**, **False**
## Menggunakan PowerShell File Windows
Untuk menggunakan PowerShell file Windows, tentukan jalur lengkap ke PowerShell file dalam `filename` parameter:
```
"filename":
"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
```
Kemudian tentukan skrip sesi Anda di **arguments** parameter:
```
"arguments": "-File \"C:\\path\\to\\session\\script.ps1\"",
```
Terakhir, verifikasi bahwa Kebijakan PowerShell Eksekusi memungkinkan PowerShell file Anda berjalan.
## Keluaran Skrip Sesi Pencatatan
Ketika opsi ini diaktifkan dalam file konfigurasi, WorkSpaces Pool secara otomatis menangkap output dari skrip sesi yang ditulis ke standar keluar. Output ini diunggah ke bucket Amazon S3 di akun Anda. Anda dapat meninjau file log untuk tujuan pemecahan masalah atau debugging.
**catatan**
File log diunggah saat skrip sesi mengembalikan nilai, atau nilai yang ditetapkan **WaitingTime** telah berlalu, mana yang lebih dulu.
## Gunakan penyimpanan persisten dengan skrip sesi
Saat penyimpanan WorkSpaces persisten diaktifkan, penyimpanan mulai dipasang saat skrip mulai sesi berjalan. Jika skrip Anda bergantung pada penyimpanan persisten yang dipasang, Anda dapat menunggu konektor tersedia. WorkSpaces mempertahankan status pemasangan konektor penyimpanan di registri Windows di Windows WorkSpaces, pada tombol berikut:
```
HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\AWSEUC\Storage\\
```
Nilai kunci registri adalah sebagai berikut:
+ Nama pengguna yang disediakan — ID pengguna yang disediakan melalui mode akses. Mode akses dan nilai untuk setiap mode adalah sebagai berikut:
+ User Pool — Alamat email untuk pengguna
+ URL Streaming — UserID
+ SAMP — NameID. Jika nama pengguna menyertakan garis miring (misalnya, SAMAccount Nama pengguna domain), garis miring diganti dengan karakter “-”.
+ Konektor penyimpanan — Konektor untuk opsi penyimpanan persisten yang diaktifkan untuk pengguna. Nilai konektor penyimpanan adalah sebagai berikut:
+ HomeFolder
Setiap kunci registri konektor penyimpanan berisi nilai **MountStatus**DWORD. Tabel berikut mencantumkan nilai yang mungkin untuk **MountStatus**.
**catatan**
Untuk melihat kunci registri ini, Anda harus memiliki Microsoft .NET Framework versi 4.7.2 atau yang lebih baru diinstal pada gambar Anda.
| Nilai | Deskripsi |
| --- | --- |
| 0 | Konektor penyimpanan tidak diaktifkan untuk pengguna ini |
| 1 | Pemasangan konektor penyimpanan sedang berlangsung |
| 2 | Konektor penyimpanan berhasil dipasang |
| 3 | Pemasangan konektor penyimpanan gagal |
| 4 | Pemasangan konektor penyimpanan diaktifkan, tetapi belum dipasang |
## Aktifkan Penyimpanan Bucket Amazon S3 untuk Log Skrip Sesi
Saat Anda mengaktifkan pencatatan Amazon S3 dalam konfigurasi skrip sesi, WorkSpaces Pool menangkap output standar dari skrip sesi Anda. Output diunggah secara berkala ke bucket S3 dalam akun Amazon Web Services Anda. Untuk setiap AWS Wilayah, WorkSpaces Pool membuat bucket di akun Anda yang unik untuk akun Anda dan Wilayah.
Anda tidak perlu melakukan tugas konfigurasi apa pun untuk mengelola bucket S3 ini. Mereka sepenuhnya dikelola oleh WorkSpaces layanan. File log yang disimpan di setiap bucket dienkripsi saat transit menggunakan titik akhir SSL Amazon S3 dan diam menggunakan kunci enkripsi yang dikelola Amazon S3. Ember diberi nama dalam format tertentu sebagai berikut:
```
wspool-logs---random-identifier
```
**``**
Ini adalah kode AWS Wilayah tempat WorkSpaces Pool dibuat dengan penyimpanan bucket Amazon S3 yang diaktifkan untuk log skrip sesi.
**``**
Pengenal akun Amazon Web Services Anda. ID acak memastikan bahwa tidak ada konflik dengan bucket lain di Wilayah itu. Bagian pertama dari nama bucket,`wspool-logs`, tidak berubah di seluruh akun atau Wilayah.
Misalnya, jika Anda menentukan skrip sesi dalam gambar di Wilayah AS Barat (Oregon) (`us-west-2`) pada nomor akun`123456789012`, WorkSpaces Pool akan membuat bucket Amazon S3 dalam akun Anda di Wilayah tersebut dengan nama yang ditampilkan. Hanya administrator dengan izin yang cukup yang dapat menghapus bucket ini.
```
wspool-logs-us-west-2-1234567890123-abcdefg
```
Menonaktifkan skrip sesi tidak menghapus file log yang disimpan di bucket S3. Untuk menghapus file log secara permanen, Anda atau administrator lain dengan izin yang memadai harus melakukannya dengan menggunakan konsol Amazon S3 atau API. WorkSpaces Pools menambahkan kebijakan bucket yang mencegah penghapusan bucket secara tidak sengaja.
Saat skrip sesi diaktifkan, folder unik dibuat untuk setiap sesi streaming yang dimulai.
Jalur untuk folder tempat file log disimpan di bucket S3 di akun Anda menggunakan struktur berikut:
```
//////SessionScriptsLogs/
```
******
Nama bucket S3 tempat skrip sesi disimpan. Format nama dijelaskan sebelumnya di bagian ini.
******
Nama tumpukan sesi berasal.
******
Nama WorkSpaces Pool yang sedang dijalankan skrip sesi.
******
Metode identitas pengguna: `custom` untuk WorkSpaces API atau CLI, `federated` untuk SAMP, dan `userpool` untuk pengguna di kumpulan pengguna.
******
Nama folder khusus pengguna. Nama ini dibuat menggunakan string heksadesimal hash SHA-256 huruf kecil yang dihasilkan dari pengenal pengguna.
******
Pengidentifikasi sesi streaming pengguna. Setiap sesi streaming pengguna menghasilkan ID unik.
******
Peristiwa yang menghasilkan log skrip sesi. Nilai acara adalah: `SessionStart` dan`SessionTermination`.
Struktur folder contoh berikut berlaku untuk sesi streaming yang dimulai dari test-stack dan test-fleet. Sesi ini menggunakan API ID pengguna`testuser@mydomain.com`, dari Akun AWS ID dari`123456789012`, dan grup pengaturan `test-stack` di Wilayah AS Barat (Oregon) (`us-west-2`):
```
wspool-logs-us-west-2-1234567890123-abcdefg/test-stack/test-fleet/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/05yd1391-4805-3da6-f498-76f5x6746016/SessionScriptsLogs/SessionStart/
```
Struktur folder contoh ini berisi satu file log untuk skrip awal sesi konteks pengguna, dan satu file log untuk skrip awal sesi konteks sistem, jika berlaku.