

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Kelola Gambar WorkSpaces Aplikasi Amazon Anda
<a name="administer-images"></a>

Gambar yang tersedia tercantum dalam **Image Registry** di konsol WorkSpaces Aplikasi, dan dikategorikan berdasarkan visibilitas sebagai berikut: 
+ **Publik** — Gambar dasar yang dimiliki dan disediakan oleh AWS. Gambar dasar termasuk sistem operasi Windows terbaru dan perangkat lunak agen WorkSpaces Aplikasi. Anda dapat menggunakan gambar dasar ini untuk membuat gambar baru yang menyertakan aplikasi Anda sendiri. Untuk informasi tentang gambar dasar yang dirilis oleh AWS, lihat[WorkSpaces Catatan Rilis Pembaruan Gambar Dasar Aplikasi dan Gambar Terkelola](base-image-version-history.md). 
+ **Private** — Gambar yang Anda buat dan miliki, dan yang belum Anda bagikan dengan AWS akun lain. 
+ **Dibagikan dengan orang lain** — Gambar yang Anda buat dan miliki, dan yang telah Anda bagikan dengan satu atau beberapa AWS akun di AWS Wilayah yang sama. Ketika Anda berbagi gambar dengan AWS akun lain, Anda dapat menentukan apakah gambar dapat digunakan untuk pembuat gambar (untuk membuat gambar baru), untuk armada, atau keduanya.
+ **Dibagikan dengan saya** — Gambar yang dibuat dan dimiliki oleh AWS akun lain di AWS Wilayah yang sama, dan yang dibagikan dengan AWS akun Anda. Bergantung pada izin yang diberikan pemilik saat berbagi gambar dengan akun Anda, Anda dapat menggunakan gambar ini untuk pembuat gambar, untuk armada, atau keduanya.

**Topics**
+ [

# Hapus Gambar Pribadi di WorkSpaces Aplikasi Amazon
](delete-private-image.md)
+ [

# Salin Gambar yang Anda Miliki ke AWS Wilayah Lain di WorkSpaces Aplikasi Amazon
](copy-image-different-region.md)
+ [

# Bagikan Gambar yang Anda Miliki Dengan AWS Akun Lain di WorkSpaces Aplikasi Amazon
](share-image-with-another-account.md)
+ [

# Berhenti Berbagi Gambar yang Anda Miliki di WorkSpaces Aplikasi Amazon
](stop-sharing-image-with-all-accounts.md)
+ [

# Simpan Gambar WorkSpaces Aplikasi Amazon Anda Up-to-Date
](keep-image-updated.md)
+ [

# Pembaruan Windows dan Perangkat Lunak Antivirus di WorkSpaces Aplikasi Amazon
](windows-update-antivirus-software.md)
+ [

# Buat Gambar Baru Secara Terprogram di Aplikasi Amazon WorkSpaces
](create-image-programmatically.md)
+ [

# Kelola Aplikasi Termasuk Lisensi pada Gambar Anda di WorkSpaces Aplikasi Amazon
](license-included-applications.md)
+ [

# Impor Gambar
](import-image.md)
+ [

# Ekspor Gambar
](export-image.md)

# Hapus Gambar Pribadi di WorkSpaces Aplikasi Amazon
<a name="delete-private-image"></a>

Anda dapat menghapus gambar pribadi Anda ketika Anda tidak lagi membutuhkannya. Anda tidak dapat menghapus gambar yang digunakan oleh armada atau dibagikan dengan AWS akun lain. Untuk menghapus gambar yang digunakan oleh armada atau dibagikan, Anda harus terlebih dahulu menghapus gambar dari armada apa pun dan menghapus semua izin berbagi gambar. Setelah Anda menghapus gambar, Anda tidak dapat memulihkannya.

**Untuk menghapus gambar pribadi**

1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.

1. Dalam daftar gambar, pilih gambar pribadi yang ingin Anda hapus.

1. Pilih **Tindakan**, **Hapus**, lalu pilih **Hapus** lagi.

   Gambar dihapus dari registri gambar dan dihapus.

# Salin Gambar yang Anda Miliki ke AWS Wilayah Lain di WorkSpaces Aplikasi Amazon
<a name="copy-image-different-region"></a>

**penting**  
Untuk Wilayah AWS Asia Pasifik (Malaysia), Eropa (Milan), Eropa (Spanyol), dan Israel (Tel Aviv): Penyalinan gambar lintas wilayah hanya didukung untuk gambar WorkSpaces dengan versi agen Aplikasi yang on/after dirilis 02 Oktober 2025, atau gambar menggunakan pembaruan terkelola yang on/after dirilis 05 September 2025. Versi lama tidak memenuhi syarat untuk menyalin antar wilayah. Perbarui gambar Anda untuk memenuhi persyaratan versi minimum ini untuk mengaktifkan fungsionalitas penyalinan lintas wilayah.

Anda dapat menyalin gambar yang Anda miliki ke AWS Wilayah lain. Menggunakan gambar yang sama di berbagai AWS Wilayah dapat membantu menyederhanakan penerapan global aplikasi Anda di Aplikasi. WorkSpaces Dengan menerapkan aplikasi Anda di AWS Wilayah yang secara geografis paling dekat dengan pengguna Anda, Anda dapat membantu memberikan pengalaman yang lebih responsif kepada pengguna Anda.

**Untuk menyalin gambar yang Anda miliki ke AWS Wilayah lain**

1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.

1. Dalam daftar gambar, pilih gambar yang ingin Anda salin ke AWS Wilayah lain.

1. Pilih **Tindakan**, **Salin**. 

1. Dalam kotak dialog **Salin gambar**, di **Wilayah tujuan**, pilih AWS Wilayah yang ingin Anda salin gambarnya.

1. Ketik nama unik dan opsional, deskripsi untuk gambar di **wilayah Tujuan**. 

1. Pilih **Salin Gambar**.

# Bagikan Gambar yang Anda Miliki Dengan AWS Akun Lain di WorkSpaces Aplikasi Amazon
<a name="share-image-with-another-account"></a>

WorkSpaces Gambar aplikasi adalah sumber daya regional, sehingga Anda dapat berbagi gambar yang Anda miliki dengan AWS akun lain dalam AWS Wilayah yang sama. Melakukan hal itu dapat membantu dalam beberapa skenario yang berbeda. Misalnya, jika Anda memisahkan sumber daya pengembangan dan produksi dengan menggunakan AWS akun yang berbeda, Anda dapat membuat gambar dengan menggunakan akun pengembangan Anda. Kemudian Anda dapat berbagi gambar dengan akun produksi Anda. Jika organisasi Anda adalah vendor perangkat lunak independen (ISV), Anda dapat berbagi gambar yang dioptimalkan dengan pelanggan Anda. Gambar yang dioptimalkan yang memiliki aplikasi yang diperlukan sudah diinstal dan dikonfigurasi memungkinkan pelanggan Anda memulai dengan aplikasi Anda dengan cepat, sehingga mereka tidak perlu menginstal dan mengkonfigurasi aplikasi itu sendiri.

Saat Anda berbagi gambar dengan AWS akun lain, Anda menentukan apakah akun tujuan dapat menggunakan gambar dalam armada atau membuat gambar baru dengan membuat pembuat gambar. Anda terus memiliki gambar yang Anda bagikan. Dengan cara ini, Anda dapat menambahkan, mengubah, atau menghapus izin sesuai kebutuhan untuk gambar yang Anda bagikan.

Jika Anda berbagi gambar dengan akun dan memberikan izin armada akun, gambar bersama dapat digunakan untuk membuat atau memperbarui armada di akun tersebut. Jika Anda menghapus izin ini nanti, akun tidak dapat lagi menggunakan gambar. Untuk armada di akun yang menggunakan gambar bersama, kapasitas yang diinginkan diatur ke 0, yang mencegah instance armada baru dibuat. Sesi yang ada berlanjut hingga sesi streaming berakhir. Agar instance armada baru dibuat, armada di akun tersebut harus diperbarui dengan gambar yang valid.

Jika Anda berbagi gambar dengan akun dan memberikan izin pembuat gambar akun, gambar bersama dapat digunakan untuk membuat pembuat gambar dan gambar di akun tersebut. Jika Anda menghapus izin ini nanti, pembuat gambar dan gambar yang dibuat dari gambar Anda tidak akan terpengaruh. 

**penting**  
Setelah membagikan gambar dengan akun, Anda tidak dapat mengontrol pembuat gambar atau gambar di akun yang dibuat dari gambar Anda. Untuk alasan ini, berikan izin pembuat gambar ke akun hanya jika Anda ingin mengaktifkan akun untuk membuat salinan gambar Anda, dan pertahankan akses ke salinan setelah Anda berhenti membagikan gambar Anda.

**Untuk berbagi gambar yang Anda miliki dengan AWS akun lain**

1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.

1. Dalam daftar gambar, pilih gambar yang ingin Anda bagikan.

1. Pilih **Tindakan**, **Bagikan**.

1. Dalam kotak dialog **Bagikan gambar**, pilih **Tambah akun**.

1. Ketik 12 digit ID AWS akun dari akun yang ingin Anda bagikan gambarnya, lalu pilih apakah akun dapat melakukan salah satu atau kedua hal berikut:
   + Gunakan gambar untuk meluncurkan pembuat gambar, jika Anda ingin membuat gambar baru.
   + Gunakan gambar dengan armada.

   Untuk menghapus akun dari daftar akun tempat gambar dibagikan, di baris untuk akun yang ingin Anda hapus, pilih ikon X di sebelah kanan opsi **Gunakan untuk armada**.

1. Untuk berbagi gambar dengan lebih banyak AWS akun, ulangi langkah 6 untuk setiap akun yang ingin Anda bagikan gambarnya. 

1. Pilih **Bagikan Gambar**.

**Untuk menambah atau memperbarui izin berbagi gambar untuk gambar yang Anda miliki**

1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.

1. Dalam daftar gambar, pilih gambar yang ingin Anda ubah izinnya.

1. Di bawah daftar gambar, pilih tab **Izin** untuk gambar yang Anda pilih, lalu pilih **Edit**.

1. Dalam kotak dialog **Edit izin gambar**, pilih atau hapus salah satu atau kedua opsi berbagi gambar berikut sesuai kebutuhan untuk satu atau beberapa AWS akun. Jika Anda menghapus kedua opsi untuk akun, gambar tidak lagi dibagikan dengan akun itu. 
   + Gunakan gambar untuk meluncurkan pembuat gambar, jika Anda ingin membuat gambar baru.
   + Gunakan gambar dengan armada.

   Untuk menghapus akun dari daftar akun tempat gambar dibagikan, di baris untuk akun yang ingin Anda hapus, pilih ikon X di sebelah kanan opsi **Gunakan untuk armada**.

1. Untuk mengedit izin berbagi gambar untuk lebih banyak AWS akun, ulangi langkah 5 untuk setiap akun yang ingin Anda perbarui izinnya. 

1. Pilih **Perbarui izin berbagi gambar**.

# Berhenti Berbagi Gambar yang Anda Miliki di WorkSpaces Aplikasi Amazon
<a name="stop-sharing-image-with-all-accounts"></a>

Ikuti langkah-langkah ini untuk berhenti berbagi gambar yang Anda miliki dengan AWS akun lain.

**Untuk berhenti berbagi gambar yang Anda miliki dengan AWS akun lain**

1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.

1. Dalam daftar gambar, pilih gambar yang ingin Anda ubah izinnya.

1. Di bawah daftar gambar, pilih tab **Izin** untuk gambar yang Anda pilih, lalu pilih **Edit**.

1. Di kotak dialog **Edit izin gambar**, di baris untuk semua AWS akun tempat gambar dibagikan, pilih ikon X di sebelah kanan opsi **Gunakan untuk armada**.

1. Pilih **Perbarui izin berbagi gambar**.

# Simpan Gambar WorkSpaces Aplikasi Amazon Anda Up-to-Date
<a name="keep-image-updated"></a>

Anda dapat menyimpan gambar WorkSpaces Aplikasi Anda up-to-date dengan melakukan salah satu dari berikut ini:
+ [Memperbarui Gambar dengan Menggunakan Pembaruan Gambar WorkSpaces Aplikasi Terkelola](keep-image-updated-managed-image-updates.md)— Metode pembaruan ini menyediakan pembaruan sistem operasi terbaru dan pembaruan driver, dan perangkat lunak agen WorkSpaces Aplikasi terbaru.
+ [Perbarui Perangkat Lunak Agen WorkSpaces Aplikasi dengan Menggunakan Versi Agen WorkSpaces Aplikasi Terkelola](keep-image-updated-manage-image-versions.md)— Metode pembaruan ini menyediakan perangkat lunak agen WorkSpaces Aplikasi terbaru.

# Memperbarui Gambar dengan Menggunakan Pembaruan Gambar WorkSpaces Aplikasi Terkelola
<a name="keep-image-updated-managed-image-updates"></a>

WorkSpaces Aplikasi menyediakan cara otomatis untuk memperbarui gambar Anda dengan pembaruan sistem operasi terbaru, lisensi termasuk pembaruan aplikasi, pembaruan driver, dan perangkat lunak agen WorkSpaces Aplikasi. Dengan pembaruan gambar WorkSpaces Aplikasi terkelola, Anda memilih gambar yang ingin Anda perbarui. WorkSpaces Aplikasi membuat pembuat gambar di AWS akun dan Wilayah yang sama untuk menginstal pembaruan dan membuat gambar baru. Setelah gambar baru dibuat, Anda dapat mengujinya pada armada pra-produksi sebelum memperbarui armada produksi Anda atau berbagi gambar dengan akun lain AWS . 

**catatan**  
Pembaruan Gambar WorkSpaces Aplikasi Terkelola tersedia untuk sistem operasi Microsoft Windows Server, Red Hat Enterprise Linux, dan Rocky Linux.

**catatan**  
Setelah gambar baru Anda dibuat, Anda bertanggung jawab untuk mempertahankan pembaruan untuk sistem operasi. Untuk melakukannya, Anda dapat terus menggunakan pembaruan gambar WorkSpaces Aplikasi terkelola.  
Anda bertanggung jawab untuk menjaga pembaruan untuk driver Amazon EC2 Windows Paravirtual (PV), driver ENA, dan driver. AWS NVMe Untuk informasi selengkapnya tentang cara memperbarui driver, lihat [Mengelola driver perangkat untuk instans EC2 Anda](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-device-drivers.html).  
Anda juga bertanggung jawab untuk memelihara aplikasi Anda dan dependensinya. Untuk menambahkan aplikasi lain, memperbarui aplikasi yang ada, atau mengubah pengaturan gambar, Anda harus memulai dan menyambung kembali ke pembuat gambar yang Anda gunakan untuk membuat gambar. Atau, jika Anda menghapus pembuat gambar itu, luncurkan pembuat gambar baru yang didasarkan pada gambar Anda. Kemudian, buat perubahan Anda dan buat gambar baru.

## Prasyarat
<a name="keep-image-updated-managed-image-updates-prerequisites"></a>

Berikut ini adalah prasyarat dan pertimbangan untuk bekerja dengan pembaruan gambar terkelola.
+ Pastikan kuota akun WorkSpaces Aplikasi Anda (juga disebut sebagai batas) cukup untuk mendukung pembuatan pembuat gambar baru dan gambar baru. Untuk meminta peningkatan kuota, Anda dapat menggunakan konsol Service Quotas di. [https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/) Untuk informasi tentang kuota WorkSpaces Aplikasi default, lihat[Service Quotas WorkSpaces Aplikasi Amazon](limits.md). 
+ Anda harus memiliki gambar yang Anda perbarui. Anda tidak dapat memperbarui gambar yang dibagikan dengan Anda.
+ Saat WorkSpaces Aplikasi membuat pembuat gambar untuk menginstal pembaruan sistem operasi terbaru, pembaruan driver, dan perangkat lunak agen WorkSpaces Aplikasi, dan membuat gambar baru, Anda dikenakan biaya untuk instance pembuat gambar saat memperbarui.
+ Gambar yang didukung harus dibuat dari gambar dasar yang dirilis pada 2017-07-24T 00:00:00 Z atau yang lebih baru.
+ Bahasa Inggris dan Jepang adalah bahasa tampilan yang didukung. Untuk informasi selengkapnya, lihat [Tentukan Bahasa Tampilan Default](configure-default-display-language.md).
+ Gunakan versi terbaru dari SSM Agent. Untuk informasi versi, lihat [WorkSpaces Catatan Rilis Pembaruan Gambar Dasar Aplikasi dan Gambar Terkelola](base-image-version-history.md). Untuk informasi penginstalan, lihat [Menginstal Agen SSM secara manual pada instans EC2 untuk Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html). 

## Cara Memperbarui Gambar dengan Menggunakan WorkSpaces Aplikasi Terkelola Pembaruan Gambar
<a name="keep-image-updated-managed-image-updates-how-to-update-image"></a>

Untuk memperbarui gambar WorkSpaces Aplikasi dengan tambalan terbaru, pembaruan driver, dan perangkat lunak agen WorkSpaces Aplikasi, lakukan langkah-langkah berikut.

1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**. 

1. Dalam daftar gambar, pilih gambar yang ingin Anda perbarui. Verifikasi bahwa status gambar **tersedia**.

1. Pilih **Tindakan**, **Perbarui**.

1. Dalam kotak dialog **Perbarui gambar**, lakukan hal berikut:
   + Untuk **nama gambar baru**, masukkan nama gambar yang unik di dalam AWS akun dan Wilayah. Nama gambar tidak dapat dimulai dengan “Amazon,” “AWS,” atau “AppStream.” 
   + Untuk **nama tampilan gambar baru**, Anda dapat secara opsional memasukkan nama untuk ditampilkan untuk gambar.
   + Untuk **deskripsi gambar baru**, Anda dapat memberikan deskripsi untuk gambar secara opsional.
   + Untuk **Tag**, Anda dapat memilih **Tambah Tag**, dan ketik kunci dan nilai untuk tag. Untuk menambahkan lebih banyak tag, ulangi langkah ini. Untuk informasi selengkapnya, lihat [Menandai Sumber Daya WorkSpaces Aplikasi Amazon Anda](tagging-basic.md).

1. Pilih **Perbarui gambar**.

   Jika gambar Anda saat ini sudah up to date, sebuah pesan akan memberi tahu Anda.

1. Di panel navigasi, pilih **Gambar**, lalu pilih **Image Builder**. 

1. Dalam daftar pembuat gambar, verifikasi bahwa pembuat gambar baru muncul di status **Memperbarui**. Nama pembuat gambar mencakup sufiks 10 digit acak.

   Pembuat gambar adalah ukuran terkecil dalam keluarga instance yang Anda pilih untuk gambar baru di langkah 5. Tidak ada subnet yang ditentukan karena pembuat gambar tidak dilampirkan ke virtual private cloud (VPC) Anda.

1. Pilih **Image Registry** dan verifikasi bahwa gambar baru Anda muncul dalam daftar.

   Saat gambar Anda sedang dibuat, status gambar di registri gambar konsol muncul sebagai **Membuat**.

1. Setelah gambar Anda dibuat, WorkSpaces Aplikasi melakukan proses kualifikasi untuk memverifikasi bahwa gambar berfungsi seperti yang diharapkan. 

   Selama waktu ini, pembuat gambar, yang juga digunakan untuk proses ini, muncul di daftar **Image Builder** dengan status **Kualifikasi Tertunda**. 

1. Setelah proses kualifikasi berhasil diselesaikan, pesan **Sukses** muncul di bagian atas konsol dan status gambar di registri gambar muncul sebagai **Tersedia**.

   Selain itu, pembuat gambar yang dibuat WorkSpaces Aplikasi dihapus secara otomatis.
**catatan**  
Tergantung pada volume pembaruan sistem operasi, mungkin diperlukan beberapa jam untuk pembaruan gambar selesai. **Jika masalah mencegah gambar diperbarui, ikon merah dengan tanda seru muncul di sebelah nama gambar, dan status gambar di registri gambar muncul sebagai Gagal.** Jika ini terjadi, pilih gambar, pilih tab **Pemberitahuan**, dan tinjau notifikasi kesalahan apa pun. Untuk informasi selengkapnya, lihat informasi di [Image Layanan Internal](troubleshooting-notification-codes.md#troubleshooting-notification-codes-image) bagian dokumentasi untuk memecahkan masalah kode notifikasi.  
Jika proses kualifikasi tidak berhasil, pembuat gambar yang dibuat WorkSpaces Aplikasi masih dihapus secara otomatis.

1. Setelah WorkSpaces Aplikasi membuat gambar baru, uji gambar pada armada pra-produksi. Setelah Anda memverifikasi bahwa aplikasi Anda berfungsi seperti yang diharapkan, perbarui armada produksi Anda dengan gambar baru.

# Perbarui Perangkat Lunak Agen WorkSpaces Aplikasi dengan Menggunakan Versi Agen WorkSpaces Aplikasi Terkelola
<a name="keep-image-updated-manage-image-versions"></a>

WorkSpaces Aplikasi menyediakan cara otomatis untuk memperbarui pembuat gambar Anda dengan perangkat lunak agen WorkSpaces Aplikasi yang lebih baru. Melakukan hal itu memungkinkan Anda untuk membuat gambar baru setiap kali versi baru dari agen dirilis. Anda kemudian dapat menguji gambar sebelum memperbarui armada produksi Anda. Untuk informasi selengkapnya tentang cara mengelola perangkat lunak agen WorkSpaces Aplikasi, lihat[Kelola Versi Agen WorkSpaces Aplikasi](base-images-agent.md). 

**catatan**  
Anda bertanggung jawab untuk menginstal dan memelihara pembaruan untuk sistem operasi Windows, aplikasi Anda, dan dependensinya.

Untuk menjaga gambar WorkSpaces Aplikasi Anda diperbarui dengan pembaruan sistem operasi Windows terbaru, lakukan salah satu hal berikut:
+ Instal aplikasi Anda pada gambar dasar terbaru setiap kali gambar baru dirilis.
+ Instal pembaruan untuk sistem operasi Windows, aplikasi Anda, dan dependensinya pada pembuat gambar yang ada.
+ Instal pembaruan untuk sistem operasi Windows, aplikasi Anda, dan dependensinya pada pembuat gambar baru dari gambar yang ada.

Setelah Anda membuat gambar baru dengan sistem operasi Windows terbaru, aplikasi dan dependensinya, dan perangkat lunak agen WorkSpaces Aplikasi, uji gambar pada armada pengembangan. Setelah Anda memverifikasi bahwa aplikasi Anda berfungsi seperti yang diharapkan, perbarui armada produksi Anda dengan gambar baru.

# Pembaruan Windows dan Perangkat Lunak Antivirus di WorkSpaces Aplikasi Amazon
<a name="windows-update-antivirus-software"></a>

WorkSpaces Instans streaming aplikasi tidak persisten. Ketika sesi streaming pengguna berakhir, WorkSpaces Aplikasi menghentikan instans yang digunakan oleh sesi dan, tergantung pada kebijakan penskalaan Anda, menyediakan instans baru untuk menggantinya di armada Anda. Semua instance armada disediakan dari gambar yang sama. Karena gambar tidak dapat diubah setelah dibuat, semua instance armada yang digunakan dalam sesi streaming pengguna hanya memiliki pembaruan Windows dan aplikasi yang diinstal pada gambar yang mendasarinya saat gambar dibuat. Selain itu, karena instance armada yang digunakan untuk sesi streaming berakhir pada akhir sesi, pembaruan apa pun yang dilakukan ke Windows atau aplikasi pada instans selama sesi streaming tidak akan bertahan untuk sesi future oleh pengguna yang sama atau pengguna lain.

**catatan**  
Jika Anda mengaktifkan persistensi pengaturan aplikasi untuk tumpukan Anda, WorkSpaces Aplikasi akan mempertahankan perubahan konfigurasi Windows dan aplikasi yang dibuat oleh pengguna ke sesi future untuk pengguna yang sama jika perubahan konfigurasi tersebut disimpan di profil Windows pengguna. Namun, fitur persistensi pengaturan aplikasi hanya bertahan Windows dan pengaturan konfigurasi aplikasi. Itu tidak bertahan pembaruan perangkat lunak untuk Windows atau aplikasi pada instance streaming.

Untuk alasan ini, WorkSpaces Aplikasi mengambil pendekatan berikut untuk Pembaruan Windows dan perangkat lunak antivirus pada instance WorkSpaces Aplikasi.

## Pembaruan Windows
<a name="windows-update-antivirus-software-wu"></a>

Pembaruan Windows tidak diaktifkan secara default pada gambar dasar WorkSpaces Aplikasi. Jika Anda mengaktifkan Pembaruan Windows pada pembuat gambar dan kemudian mencoba membuat gambar, Asisten Gambar menampilkan peringatan dan menonaktifkan Pembaruan Windows selama proses pembuatan gambar. Untuk memastikan bahwa instans armada Anda memiliki pembaruan Windows terbaru yang diinstal, kami sarankan Anda menginstal pembaruan Windows pada pembuat gambar Anda, membuat gambar baru, dan memperbarui armada Anda dengan gambar baru secara teratur.

## Perangkat Lunak Antivirus
<a name="windows-update-antivirus-software-av"></a>

Jika Anda memilih untuk menginstal perangkat lunak antivirus pada gambar Anda, kami sarankan Anda tidak mengaktifkan pembaruan otomatis untuk perangkat lunak antivirus. Jika tidak, perangkat lunak antivirus dapat mencoba memperbarui dirinya sendiri dengan file definisi terbaru atau pembaruan lainnya selama sesi pengguna. Ini dapat mempengaruhi kinerja. Selain itu, pembaruan apa pun yang dilakukan pada perangkat lunak antivirus tidak akan bertahan di luar sesi pengguna saat ini. Untuk memastikan bahwa instans armada Anda selalu memiliki pembaruan antivirus terbaru, kami sarankan Anda melakukan salah satu hal berikut:
+ Perbarui pembuat gambar Anda dan buat gambar baru secara teratur (misalnya, dengan menggunakan [operasi CLI Asisten Gambar](https://docs.aws.amazon.com/appstream2/latest/developerguide/programmatically-create-image.html)).
+ Gunakan aplikasi antivirus yang mendelegasikan pemindaian atau operasi lain ke server always-up-to-date eksternal.

**catatan**  
Bahkan jika Anda tidak mengaktifkan pembaruan otomatis untuk perangkat lunak antivirus Anda, perangkat lunak antivirus dapat melakukan pemindaian hard drive atau operasi lain yang dapat memengaruhi kinerja instance armada Anda selama sesi pengguna.

Pada WorkSpaces Aplikasi Windows Server 2025/2022/2019/2016 gambar dasar yang dipublikasikan pada atau setelah 10 September 2019, Windows Defender tidak diaktifkan secara default. Pada WorkSpaces Aplikasi Windows Server 2016 dan Windows Server 2019 gambar dasar yang diterbitkan pada 24 Juni 2019, Windows Defender diaktifkan secara default.

**Untuk mengaktifkan Windows Defender secara manual**

Jika Windows Defender tidak diaktifkan pada gambar dasar Anda, Anda dapat mengaktifkannya secara manual. Untuk melakukannya, selesaikan langkah-langkah berikut.

1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Di panel navigasi kiri, pilih **Images**, **Image Builder**. 

1. Pilih pembuat gambar untuk mengaktifkan Windows Defender, verifikasi bahwa itu dalam status **Running**, dan pilih **Connect**. 

1. Masuk ke pembuat gambar dengan akun **Administrator** lokal atau dengan akun domain yang memiliki izin administrator lokal.

1. Buka Editor Registri.

1. Arahkan ke lokasi berikut di registri: **HKLM\$1 SOFTWARE\$1 Policies\$1 Microsoft\$1 Windows Defender\$1**. DisableAntiSpyware 

1. **Untuk mengedit kunci registri ini, klik dua kali, atau klik kanan kunci registri, dan pilih Ubah.**

1. **Dalam kotak dialog **Edit Nilai DWORD (32-bit)**, di **Data nilai**, ubah **1 menjadi 0**.**

1. Pilih **OK**.

1. Tutup Editor Registri.

1. Buka snap-in () **Layanan** Microsoft Management Console (`services.msc`MMC).

1. Dalam daftar layanan, lakukan salah satu hal berikut.

   Jika Anda menggunakan Microsoft Windows Server 2022/2025, lakukan salah satu hal berikut:
   + **Klik kanan **Microsoft Defender Antivirus Service**, dan pilih Mulai.**
   + **Klik dua kali **Microsoft Defender Antivirus Service**, pilih **Mulai** di kotak dialog properti, lalu pilih OK.**

   Jika Anda menggunakan Microsoft Windows Server 2019 atau 2016, lakukan salah satu hal berikut:
   + **Klik kanan **Windows Defender Antivirus Service**, dan pilih Mulai.**
   + **Klik dua kali **Windows Defender Antivirus Service**, pilih **Mulai** di kotak dialog properti, lalu pilih OK.**

1. Tutup snap-in **Layanan**.

# Buat Gambar Baru Secara Terprogram di Aplikasi Amazon WorkSpaces
<a name="create-image-programmatically"></a>

Anda dapat membuat gambar WorkSpaces Aplikasi secara terprogram dengan menghubungkan ke pembuat gambar dan menggunakan operasi antarmuka baris perintah Image Assistant (CLI). Untuk informasi selengkapnya, lihat [Buat Gambar WorkSpaces Aplikasi Amazon Anda Secara Terprogram dengan Menggunakan Operasi CLI Asisten Gambar](programmatically-create-image.md). 

# Kelola Aplikasi Termasuk Lisensi pada Gambar Anda di WorkSpaces Aplikasi Amazon
<a name="license-included-applications"></a>

Anda dapat melakukan streaming aplikasi lisensi Microsoft berikut yang disertakan menggunakan WorkSpaces Aplikasi. Anda dapat menginstal aplikasi ini pada Gambar Windows Anda, menggunakan gambar khusus ini untuk membuat armada, dan kemudian streaming aplikasi ini. Semua aplikasi berikut tersedia dalam arsitektur 32-bit dan 64-bit:
+ Microsoft Office LTSC Professional Plus 2021/2024
+ Microsoft Visio LTSC Professional 2021/2024
+ Microsoft Project Professional 2021/2024
+ Microsoft Office LTSC Standar 2021/2024
+ Microsoft Visio LTSC Standar 2021/2024
+ Standar Proyek Microsoft 2021/2024
**penting**  
Microsoft Office, Visio, dan Project harus mengikuti versi yang sama. Misalnya, Anda tidak dapat mencampur aplikasi 2021 dengan 2024 aplikasi.
Microsoft Office, Visio, dan Project harus mengikuti arsitektur yang sama. Misalnya, Anda tidak dapat mencampur aplikasi 32-bit dengan aplikasi 64-bit.
Standard/Professional versions are supported on Microsoft Windows Server 2019/2022/2025. Microsoft Office, Visio, and Project 2024 Standard/ProfessionalVersi Microsoft Office, Visio, dan Project 2021 didukung di Microsoft Windows Server 2022 dan 2025.
Untuk mengaktifkan fitur ini, Anda harus menggunakan WorkSpaces Applications Image Builder yang menggunakan agen WorkSpaces Aplikasi yang dirilis pada atau setelah 2 Oktober 2025. Untuk informasi selengkapnya, lihat [Kelola Versi Agen WorkSpaces Aplikasi](base-images-agent.md). Atau, gambar Anda harus menggunakan pembaruan gambar WorkSpaces Aplikasi terkelola yang dirilis pada atau setelah 3 Oktober 2025. Untuk informasi selengkapnya, lihat [Simpan Gambar WorkSpaces Aplikasi Amazon Anda Up-to-Date](keep-image-updated.md).
TCP keluar pada port 1688 harus terbuka pada antarmuka jaringan manajemen semua instance streaming. 
Semua pengguna yang streaming melalui armada yang didukung oleh gambar dengan satu atau lebih aplikasi berlisensi dikenakan tagihan untuk aplikasi ini setiap bulan, terlepas dari penggunaannya. Fitur hak aplikasi tidak membatasi akses untuk pengguna tertentu.
Aplikasi yang disertakan lisensi pada Image Builder tidak diaktifkan karena diinstal untuk tujuan administratif. Aktivasi terjadi ketika pengguna melakukan streaming melalui instance armada.

**Topics**
+ [

# Lihat daftar aplikasi yang disertakan lisensi yang diinstal pada gambar Anda
](view-list-image.md)
+ [

# Lihat daftar aplikasi yang disertakan lisensi pada pembuat gambar Anda
](view-list-apps.md)
+ [

# Instal atau hapus instalan aplikasi yang disertakan lisensi
](install-uninstall-apps.md)
+ [

# Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar
](updates-image-builder.md)
+ [

# Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar dengan Powershell
](enable-updates-managed-powershell.md)
+ [

# Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar dengan Pembaruan Gambar Terkelola
](enable-updates-managed.md)

# Lihat daftar aplikasi yang disertakan lisensi yang diinstal pada gambar Anda
<a name="view-list-image"></a>

**Lihat daftar aplikasi yang disertakan lisensi yang diinstal pada gambar Anda**

Untuk melihat daftar aplikasi yang disertakan lisensi yang diinstal pada gambar Anda, ikuti langkah-langkah ini.

1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Pilih **Gambar** di panel navigasi kiri dan tab **Image Registry**.

1. Pilih gambar, dan pilih **Lihat Detail**.

1. Tinjau daftar semua aplikasi yang diinstal di bawah aplikasi yang **disertakan Lisensi**.

# Lihat daftar aplikasi yang disertakan lisensi pada pembuat gambar Anda
<a name="view-list-apps"></a>

**Lihat daftar aplikasi yang disertakan lisensi pada pembuat gambar Anda**

Untuk melihat daftar aplikasi yang disertakan lisensi pada pembuat gambar Anda, ikuti langkah-langkah ini.

1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Pilih **Gambar** di panel navigasi kiri dan tab **Pembuat gambar**.

1. Pilih pembuat gambar, dan pilih **Lihat detail**.

1. Tinjau daftar aplikasi dan statusnya di bawah **aplikasi yang disertakan Lisensi**.

# Instal atau hapus instalan aplikasi yang disertakan lisensi
<a name="install-uninstall-apps"></a>

**Instal atau hapus instalan aplikasi yang disertakan lisensi**

Untuk menginstal atau menghapus satu atau beberapa aplikasi yang disertakan lisensi pada gambar Anda, ikuti langkah-langkah ini.

1. Lengkapi salah satu opsi berikut:
   + Luncurkan Builder gambar dan konfigurasikan aplikasi yang disertakan lisensi. Untuk informasi selengkapnya, lihat [Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming](tutorial-image-builder-create.md).
   + Kelola aplikasi yang disertakan lisensi pada pembuat gambar Anda. Untuk informasi selengkapnya, lihat [Hak Aplikasi Berbasis Atribut Menggunakan Penyedia Identitas SAMP 2.0 Pihak Ketiga](application-entitlements-saml.md).

1. Ketika Anda memiliki gambar yang dibuat dengan satu atau lebih aplikasi termasuk lisensi, Anda dapat menggunakan gambar ini untuk membuat armada. Pengguna yang terhubung ke armada ini dapat mengakses aplikasi ini. 
**penting**  
Semua pengguna yang streaming melalui armada yang didukung oleh gambar dengan satu atau lebih aplikasi berlisensi akan dikenakan tagihan untuk aplikasi ini setiap bulan, terlepas dari penggunaannya. Fitur hak aplikasi tidak membatasi akses untuk pengguna tertentu. 

Jika Anda mengalami kegagalan selama instalasi atau penghapusan instalasi aplikasi yang disertakan dengan lisensi, Anda akan melihat status kegagalan pada halaman detail Pembuat Gambar Anda. Untuk mengatasi masalah ini, sebaiknya sambungkan ke Image Builder Anda dan mengaktifkan pencatatan verbose. Untuk informasi selengkapnya, lihat [Cara mengaktifkan Aplikasi Microsoft 365 untuk pencatatan perusahaan](https://learn.microsoft.com/en-us/troubleshoot/microsoft-365-apps/diagnostic-logs/how-to-enable-office-365-proplus-uls-logging). Jika masalah berlanjut setelah meninjau log dan pemecahan masalah, hubungi untuk bantuan. AWS Dukungan 

# Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar
<a name="updates-image-builder"></a>

**Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar**

Pembaruan untuk semua aplikasi yang disertakan lisensi dinonaktifkan secara default. Anda dapat mengaktifkan pembaruan untuk aplikasi ini pada pembuat gambar dengan gambar yang menyertakan satu atau lebih aplikasi ini. Pembaruan pada instance armada tetap dinonaktifkan untuk mencegah penginstalan selama penyiapan sesi.

Ada tiga opsi untuk mengaktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar.

Untuk mengaktifkan pembaruan untuk lisensi termasuk aplikasi pada pembuat gambar dengan menu aplikasi, ikuti langkah-langkah ini.

1. Buka aplikasi apa pun yang termasuk lisensi.

1. Pilih **File**, **Akun**, **Opsi Pembaruan**, dan **Aktifkan Pembaruan**.

# Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar dengan Powershell
<a name="enable-updates-managed-powershell"></a>

Untuk mengaktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar dengan Powershell, ikuti langkah-langkah ini.
+ Jalankan perintah berikut dengan PowerShell sebagai administrator: 

  `Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration" -Name UpdatesEnabled -Value True `

# Aktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar dengan Pembaruan Gambar Terkelola
<a name="enable-updates-managed"></a>

Untuk mengaktifkan pembaruan untuk aplikasi yang disertakan lisensi pada pembuat gambar dengan Pembaruan Gambar Terkelola, ikuti langkah-langkah ini.
+  Gunakan Pembaruan Gambar Terkelola untuk menerima pembaruan pada aplikasi yang disertakan lisensi Microsoft. Untuk informasi selengkapnya, silakan lihat 

  [Memperbarui Gambar dengan Menggunakan Pembaruan Gambar WorkSpaces Aplikasi Terkelola](keep-image-updated-managed-image-updates.md).

# Impor Gambar
<a name="import-image"></a>

Anda dapat membuat gambar WorkSpaces Aplikasi dengan mengimpor kustomisasi EC2 AMIs Anda. Begini cara kerjanya:

1. Sesuaikan EC2 AMI Anda menggunakan metode apa pun yang disukai termasuk [EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/).

1. Impor AMI Anda yang disesuaikan ke WorkSpaces Aplikasi untuk membuat gambar WorkSpaces Aplikasi

1. Secara opsional, gunakan Image Builder untuk kustomisasi gambar tambahan

Gambar yang dibuat melalui impor AMI adalah dari`type = "custom"`, sedangkan gambar yang disediakan WorkSpaces Aplikasi adalah dari`type = "native"`.

Anda dapat menggunakan jenis instans stream.\$1 untuk gambar dengan. `type = "native"` Untuk menggunakan salah satu jenis instance berikut, Anda harus mengimpor AMI Anda dan membuat gambar dengan`type = "custom"`.
+ GeneralPurpose.\$1
+ MemoryOptimized.\$1
+ ComputeOptimized.\$1
+ Dipercepat. \$1

## Prasyarat untuk impor gambar
<a name="import-image-prerequisites"></a>

Semua prasyarat ini penting untuk eksekusi alur kerja yang sukses. Konfigurasi AMI yang didukung dan persyaratan wajib lainnya tercantum di bawah ini.

### Properti AMI yang Diperlukan
<a name="required-ami-properties"></a>

EBS  
+ Kurang atau sama dengan ukuran 500GB
  + Anda dapat mengimpor AMI dengan < 200 GB, namun, gambar yang diimpor akan menggunakan minimum 200GB.
+ GP2
  + Anda dapat mengimpor AMI dengan tipe volume EBS gp2 atau gp3, namun gambar yang diimpor akan menggunakan gp2.
+ Satu volume per gambar
+ `/dev/sda1`Nama Perangkat Root
+ Tipe Gambar: Mesin
+ Arsitektur: x86\$164
+ Jenis Virtualisasi: HVM
+ Mode Boot: UEFI
+ Dukungan TPM: v2.0. Ini diperlukan, Lihat [https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html\$1 untuk menemukan AMI yang diaktifkan ami-windows-tpm-find TPM](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find).
+ Dukungan ENA: benar
+ Platform: Windows
+ Detail Platform: Windows

### Properti Sistem Operasi
<a name="operating-system-properties"></a>

**Windows Server 2022/2025 Basis Penuh**  
+ Windows Server **Core** tidak didukung
+ Windows dengan SQL Server tidak didukung

Agen  
+ EC2 Luncurkan Versi V2 >= 2.1.1
+ Agen SSM diperlukan

Pengemudi  
+ EC2 Versi Driver ENa>= 2.9.0
+ EC2 NVMe Versi Driver >= 1.6.0

Dukungan Perpustakaan  
+ .NET Framework 4.8 atau lebih
  + Diinstal secara default di Windows Server 2022/2025
+ PowerShell 5.1 atau lebih
  + Diinstal secara default di Windows Server 2022/2025
+ Fitur Windows: Lisensi Layanan Desktop Jarak Jauh dan Host Sesi Layanan Desktop Jarak Jauh tidak boleh diinstal
+ Port: Port 8000, 8300, dan 8443 harus diblokir dan tidak dihuni
+ Mode Boot: UEFI

Jika Anda ingin menggunakan gambar dengan instance grafis seperti Accelerated.G4DN, Accelerated.G5, Accelerated.G6, atau Accelerated.G6E Anda banyak menginstal driver GRID yang tepat pada AMI Anda. Untuk lebih jelasnya, silakan merujuk ke [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html). Namun, jika driver tidak diatur dengan benar, streaming akan berfungsi, kartu grafis mungkin tidak tersedia.

**penting**  
“Id Akun Pemilik” AMI harus berupa id AWS akun Anda. Anda tidak dapat mengimpor EC2 AMI publik.  
Lakukan pembaruan Windows apa pun dan nonaktifkan pembaruan Windows otomatis sebelum mengimpor gambar.  
Impor terenkripsi saat EC2 AMIs ini tidak didukung

### Persyaratan Peran IAM
<a name="iam-role-requirements"></a>

**penting**  
“Buat peran IAM dengan izin berikut untuk digunakan untuk impor gambar:

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Sid": "AllowModifyImageAttributeWithTagCondition",  
            "Effect": "Allow",  
            "Action": "ec2:ModifyImageAttribute",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        }  
    ]  
}
```

Tambahkan hubungan kepercayaan berikut untuk peran IAM ini

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Effect": "Allow",  
            "Principal": {  
                "Service": "appstream.amazonaws.com"  
            },  
            "Action": "sts:AssumeRole"  
        }  
    ]  
}
```

## Untuk mengimpor gambar
<a name="import-image-procedure"></a>

1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Di panel navigasi kiri, pilih **Gambar** dan kemudian pilih **Registri gambar**.

1. Pilih **Impor Gambar**.

1. **ID AMI** - Masukkan ID AMI untuk AMI yang ingin Anda impor ke WorkSpaces Aplikasi. Anda juga dapat mencari AMI Anda menggunakan bidang ini.

1. **Nama gambar** - Masukkan nama unik untuk gambar yang akan dibuat karena operasi impor.

1. **Nama tampilan** *(Opsional)* - Masukkan ke tampilan untuk gambar.

1. **Deskripsi** *(Opsional)* — Masukkan deskripsi untuk gambar.

1. **Peran IAM** - Pilih peran IAM yang telah Anda buat untuk impor gambar. Untuk lebih jelasnya lihat[Persyaratan Peran IAM](#iam-role-requirements).

1. **Agen Kelola WorkSpaces Aplikasi** — Pilih opsi ini jika Anda ingin selalu menggunakan versi agen WorkSpaces Aplikasi terbaru, instans streaming Anda diperbarui secara otomatis dengan fitur terbaru, peningkatan kinerja, dan pembaruan keamanan yang tersedia AWS sejak versi agen baru dirilis.

1. **Validasi runtime** *(Opsional)*: Pilih opsi ini dan layanan akan menyediakan instance dengan gambar yang diimpor dan menjalankan pengujian streaming.
   + 
**catatan**  
Tes streaming ini akan dijalankan di latar belakang, Anda tidak dapat terhubung ke instance ini melalui klien WorkSpaces Aplikasi.
   + Sebaiknya gunakan opsi ini untuk mendapatkan kepercayaan diri yang lebih tinggi bahwa gambar Anda cocok untuk WorkSpaces Aplikasi.
   + Anda akan ditagih untuk harga per jam dari contoh itu.
   + Anda dapat menghindari menjalankan validasi runtime jika Anda mengimpor ulang AMI Anda setelah membuat perubahan kecil yang mungkin tidak memengaruhi pengujian streaming, dan jika validasi runtime berlalu terakhir kali, Anda mengimpor AMI ini.
   + **Pilih jenis instans** *(Opsional)*: Pilih keluarga instans, jenis, dan ukuran yang tepat untuk menjalankan pengujian streaming. Disarankan agar Anda menggunakan contoh yang sama yang Anda rencanakan untuk digunakan untuk pembuatan armada.

1. **Katalog aplikasi dan manifes kinerja peluncuran** *(Opsional)*: Berikan detail untuk membuat katalog aplikasi untuk pengguna akhir Anda dan meningkatkan kinerja peluncuran aplikasi Anda.
   + **Katalog aplikasi**: Untuk membuat katalog aplikasi, tentukan detail tentang aplikasi yang diinstal gambar Anda. Untuk setiap aplikasi yang Anda rencanakan untuk streaming, Anda dapat menentukan nama, nama tampilan, file yang dapat dieksekusi untuk diluncurkan, dan ikon yang akan ditampilkan.
   + **Kinerja peluncuran**: Menambahkan file ke manifes pengoptimalan aplikasi mengurangi waktu yang diperlukan aplikasi untuk diluncurkan untuk pertama kalinya pada instance armada baru. Manifes pengoptimalan adalah file teks yang dibatasi baris per aplikasi.

   Untuk mempelajari lebih lanjut, lihat[Rincian Aplikasi](applications-details.md).

1. **Tag** *(Opsional)* - Pilih **Tambah Tag** dan ketik kunci dan nilai untuk tag. Untuk menambahkan lebih banyak tag, ulangi langkah ini. Untuk informasi selengkapnya, lihat [Menandai Sumber Daya WorkSpaces Aplikasi Amazon Anda](tagging-basic.md).

1. **Impor Gambar** - Tinjau semua informasi yang telah Anda masukkan dan pilih **Impor Gambar**. Layanan akan menjalankan pemeriksaan kompatibilitas untuk memastikan AMI kompatibel dengan WorkSpaces Aplikasi.
   + Jika pemeriksaan statis gagal, Anda akan langsung menerima kesalahan.
   + Jika pemeriksaan statis lulus, permintaan impor Anda akan dikirimkan dan tergantung pada opsi yang telah Anda pilih, dibutuhkan waktu 30-60 menit untuk membuat gambar WorkSpaces Aplikasi baru dengan `type = "custom"`

# Rincian Aplikasi
<a name="applications-details"></a>

Detail aplikasi berisi informasi tentang manifes pra-hangat dan konfigurasi katalog aplikasi.

## PreWarm Manifestasi Aplikasi
<a name="application-prewarm-manifests"></a>

Saat membuat gambar WorkSpaces Aplikasi, Anda dapat menentukan aplikasi yang akan tersedia bagi pengguna Anda. Untuk mempercepat waktu peluncuran aplikasi, Anda dapat menyiapkan PreWarm manifes. Ini pada dasarnya adalah katalog file yang perlu diluncurkan aplikasi Anda saat pengguna meluncurkan aplikasi Anda. Selama penyediaan instance, file-file ini akan disiapkan sebelum koneksi sesi untuk mempercepat waktu peluncuran aplikasi di sesi pengguna.

Manifes prewarm harus dibuat sebelumnya di AMI Anda sebelum diimpor ke lingkungan WorkSpaces Aplikasi. Anda dapat memilih untuk membuat satu file manifes Prewarm umum atau satu per setiap aplikasi. Ini mengubah cara Anda akan mengimpor AMI Anda nanti.

### Manifes Prewarm Umum
<a name="common-prewarm-manifest"></a>

Untuk setiap aplikasi yang ingin Anda prewarm, luncurkan aplikasi dan lakukan interaksi awal apa pun yang mungkin dilakukan pengguna Anda. Kemudian, gunakan perintah berikut yang menargetkan direktori tempat data aplikasi Anda disimpan.

```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```

Ini akan menambahkan file untuk mengoptimalkan setiap aplikasi ke dalam `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` file umum. Tidak ada tindakan tambahan yang diperlukan untuk melakukan pemanasan awal aplikasi. WorkSpaces Aplikasi akan mencari file prewarm di lokasi di atas dan menggunakannya jika ada.

Proses ini bersifat opsional dan seiring bertambahnya ukuran manifes prewarm, waktu penyediaan armada juga akan meningkat. Jadi berhati-hatilah untuk menyeimbangkan optimasi dengan penyediaan armada.

### Manifestasi Khusus Aplikasi
<a name="application-specific-manifests"></a>

Selama impor gambar, Anda mungkin ingin menentukan file manifes aplikasi terpisah per aplikasi untuk memudahkan pelacakan aset prewarm per aplikasi. Untuk melakukan ini, lakukan langkah yang sama seperti di atas, tetapi alih-alih membuat `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` file umum, buat file per aplikasi di AMI Anda.

Untuk setiap aplikasi yang ingin Anda prewarm, luncurkan aplikasi dan lakukan interaksi awal apa pun yang mungkin dilakukan pengguna Anda. Kemudian, gunakan perintah berikut yang menargetkan direktori tempat data aplikasi Anda disimpan.

```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\Path\To\My\<ApplicationName>PreWarm.txt" -encoding UTF8 -append
```

Kami akan menggunakan file prewarm aplikasi ini selama proses impor gambar. Sekali lagi ini sepenuhnya opsional. Anda dapat memilih untuk menggunakan metode ini, metode Common Prewarm Manifest, atau tidak ada manifes Prewarm sama sekali.

## Konfigurasi Katalog Aplikasi
<a name="application-catalog-configs"></a>

`AppCatalogConfig`yang memungkinkan Anda menentukan aplikasi yang ingin Anda daftarkan ke gambar WorkSpaces Aplikasi Anda selama impor AMI. `AppCatalogConfig`Ini adalah daftar JSON objek konfigurasi Aplikasi dari struktur berikut.

```
[  
    {  
        "Name": "Rufus", //Required and must be unique among the list of applications  
        "DisplayName": "Rufus",  
        "AbsoluteAppPath": "Rufus", //Required  
        "AbsoluteIconPath": "Rufus",  
        "AbsoluteManifestPath": "Rufus",  
        "WorkingDirectory": "Rufus",  
        "LaunchParameters": "Rufus"  
    }  

    ...  

    // Up to 50 applications total  
 ]
```

Satu-satunya bidang yang diperlukan per aplikasi adalah `Name` dan`AbsoluteAppPath`. Rincian masing-masing bidang sebagai berikut:

Nama [**Diperlukan**]  
+ Nama yang diberikan untuk aplikasi Anda untuk mengidentifikasinya
+ Antara 1 dan 100 karakter
+ Karakter yang diizinkan regex `^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,99}$`
+ Harus unik dalam suatu AppCatalogConfig

DisplayName  
+ Nama tampilan untuk aplikasi tertentu untuk ditampilkan kepada pengguna
+ Antara 0 dan 100 karakter
+ Karakter yang diizinkan regex `^[a-zA-Z0-9][a-zA-Z0-9_. -]{0,99}$`

AbsoluteAppPath [**Diperlukan**]  
+ Jalur ke executable untuk meluncurkan aplikasi Anda
  + Ini adalah executable yang akan diluncurkan ketika pengguna memilih aplikasi Anda
+ Antara 1 dan 32767 karakter
  + Batas atas panjang karakter ini adalah untuk mendukung jalur file yang diperluas di Windows. Pastikan AMI dan aplikasi Anda dikonfigurasi dengan benar untuk mendukung jalur file Windows yang diperluas jika menggunakan jalur file yang lebih besar dari 260 karakter.
+ Gunakan string jalur file yang lolos seperti
  + `"C:\\Windows\\System32\\notepad.exe"`

AbsoluteManifestPath  
+ Hanya berlaku jika Anda menggunakan [Manifestasi Khusus Aplikasi](#application-specific-manifests)
+ Jalur ke file manifes pemanasan awal untuk aplikasi ini
+ Antara 0 dan 32767 karakter
  + Batas atas panjang karakter ini adalah untuk mendukung jalur file yang diperluas di Windows. Pastikan AMI dan aplikasi Anda dikonfigurasi dengan benar untuk mendukung jalur file Windows yang diperluas jika menggunakan jalur file yang lebih besar dari 260 karakter.
+ Gunakan string jalur file yang lolos seperti
  + `"C:\\Path\\To\\PrewarmManifest.txt"`

AbsoluteIconPath  
+ Jalur ke file ikon pada AMI yang akan digunakan untuk aplikasi.
  + Ikon ini akan ditampilkan kepada pengguna saat streaming ke gambar ini.
  + Jika tidak ada yang disediakan, ikon akan diturunkan dari executable itu sendiri.
  + Berhati-hatilah untuk memilih file ikon dengan transparansi latar belakang yang ditangani dengan tepat untuk pengalaman klien yang baik bagi pengguna Anda
    + Gunakan gambar PNG
+ Antara 1 dan 32767 karakter
  + Batas atas panjang karakter ini adalah untuk mendukung jalur file yang diperluas di Windows. Pastikan AMI dan aplikasi Anda dikonfigurasi dengan benar untuk mendukung jalur file Windows yang diperluas jika menggunakan jalur file yang lebih besar dari 260 karakter.
+ Gunakan string jalur file yang lolos seperti
  + `"C:\\Path\\To\\ApplicationIcon.png"`

WorkingDirectory  
+ Direktori kerja untuk meluncurkan aplikasi Anda di
+ Antara 0 dan 32767 karakter
  + Batas atas panjang karakter ini adalah untuk mendukung jalur file yang diperluas di Windows. Pastikan AMI dan aplikasi Anda dikonfigurasi dengan benar untuk mendukung jalur file Windows yang diperluas jika menggunakan jalur file yang lebih besar dari 260 karakter.
+ Gunakan string jalur file yang lolos seperti
  + `"C:\\Path\\To\\Working\\Directory"`

LaunchParameters  
+ String untuk digunakan sebagai parameter peluncuran untuk executable yang ditentukan dalam `AbsoluteAppPath`
+ Antara 0 dan 1024 karakter
+ Gunakan string yang diloloskan dengan daftar lengkap parameter peluncuran yang diperlukan seperti contoh berikut yang menunjukkan bagaimana Anda dapat menggunakan PowerShell skrip sebagai aplikasi Anda dengan menggunakan PowerShell executable sebagai aplikasi Anda dengan skrip yang disediakan dalam parameter peluncuran
  + AbsoluteAppPath
    + `"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"`
  + LaunchParameters
    + `"-File \"C:\\Path\\To\\App\\Script.ps1\""`

### Sampel AppCatalogConfig
<a name="sample-appcatalogconfig"></a>

Ini adalah contoh telanjang dari Notepad, Google Chrome, dan Mozilla Firefox AppCatalogConfig 

```
[  
    {  
        "Name": "Notepad",  
        "DisplayName": "Notepad",  
        "AbsoluteAppPath": "C:\\Windows\\System32\\notepad.exe"
    },  
    {  
        "Name": "Chrome",  
        "DisplayName": "Chrome",  
        "AbsoluteAppPath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
        "LaunchParameters": "https://www.amazon.com/"  
    },  
    {  
        "Name": "Firefox",  
        "DisplayName": "Firefox",  
        "AbsoluteAppPath": "C:\\Program Files\\Mozilla Firefox\\firefox.exe",
        "LaunchParameters": "https://aws.amazon.com/"  
    }  
 ]
```

# Ekspor Gambar
<a name="export-image"></a>

Anda dapat mengekspor gambar Anda untuk membuat EC2 AMIs. Nanti Anda bisa [Impor Gambar](import-image.md) AMIs kembali untuk membuat gambar WorkSpaces Aplikasi. Ini membantu Anda menggunakan alat kustomisasi AMI Anda sendiri untuk menyesuaikan gambar Anda.

**catatan**  
Selama ekspor komponen berikut akan dihapus dari gambar Anda  
WorkSpaces Agen aplikasi
Lisensi Microsoft termasuk aplikasi, yang ditambahkan menggunakan Image Builder
Hanya gambar Microsoft Windows Server 2022 dan 2025 yang dapat diekspor.

## Persyaratan Peran IAM
<a name="export-image-iam-requirements"></a>

**penting**  
Buat peran IAM dengan izin berikut untuk digunakan untuk impor ekspor:

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Sid": "AllowCopyImage",  
            "Effect": "Allow",  
            "Action": "ec2:CopyImage",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowCreateTags",  
            "Effect": "Allow",  
            "Action": "ec2:CreateTags",  
            "Resource": "*"  
        }  
    ]  
}
```

Tambahkan hubungan kepercayaan berikut untuk peran IAM ini

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Effect": "Allow",  
            "Principal": {  
                "Service": "appstream.amazonaws.com"  
            },  
            "Action": "sts:AssumeRole"  
        }  
    ]  
}
```

## Untuk mengekspor gambar
<a name="export-image-procedure"></a>

1. Buka konsol WorkSpaces Applications di [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Di panel navigasi, pilih **Gambar**, **Registri Gambar**.

1. Dalam daftar gambar, pilih gambar pribadi yang ingin Anda ekspor.

1. Pilih **Tindakan**, **Ekspor**.

1. Di kotak dialog **Ekspor gambar**, ketikkan **nama AMI** yang unik dan opsional **Deskripsi AMI** untuk AMI.

1. **Peran IAM** - Pilih peran IAM yang telah Anda buat untuk ekspor gambar.

1. Anda secara opsional menyalin tag dari Gambar Anda ke AMI dengan mencentang kotak centang **Salin tag di ekspor**.

1. Pilih **Ekspor Gambar**.