Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Buat Gambar AppStream 2.0 Anda secara Pemrograman dengan Menggunakan Operasi Image Assistant CLI
Anda dapat membuat gambar Amazon AppStream 2.0 dengan menghubungkan ke pembuat gambar dan menggunakan antarmuka pengguna grafis Image Assistant (GUI) atau operasi antarmuka baris perintah (CLI). Operasi Image Assistant CLI menyediakan fungsionalitas yang mirip dengan Image Assistant GUI. Dengan operasi ini, Anda dapat melakukan hal berikut:
Kelola aplikasi yang disertakan dalam gambar.
Simpan, perbarui, dan setel ulang pengaturan aplikasi default.
Mengaktifkan atau menonaktifkan kerangka aplikasi dinamis AppStream 2.0.
Menentukan tag.
Membuat citra.
Anda dapat menggunakan operasi ini untuk mengintegrasikan pembuatan gambar AppStream 2.0 dengan integrasi berkelanjutan atau proses pengembangan perangkat lunak penyebaran Anda.
Untuk bekerja dengan operasi Image Assistant CLI, gunakan shell baris perintah pilihan Anda pada pembuat gambar. Misalnya, Anda dapat menggunakan prompt perintah Windows atau PowerShell.
catatan
Pembuat gambar harus menggunakan versi agen AppStream 2.0 yang dirilis pada atau setelah 26 Juli 2019. Jika Anda tidak memiliki image builder, Anda harus membuatnya. Untuk informasi selengkapnya, lihat Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming.
Daftar Isi
- Membuat Aplikasi Default dan Pengaturan Windows dengan operasi Image Assistant CLI
- Mengoptimalkan Kinerja Peluncuran Aplikasi Anda dengan Operasi Image Assistant CLI
- Ikhtisar Proses untuk Membuat Gambar AppStream 2.0 Secara Pemrograman
- Image Assistant Operasi CLI untuk Membuat dan Mengelola Gambar AppStream 2.0 Anda
Membuat Aplikasi Default dan Pengaturan Windows dengan operasi Image Assistant CLI
Anda dapat membuat aplikasi default dan pengaturan Windows sehingga pengguna Anda dapat memulai dengan aplikasi mereka dengan cepat. Saat Anda membuat pengaturan ini, AppStream 2.0 menggantikan profil pengguna default Windows dengan profil yang Anda konfigurasikan. Profil pengguna default Windows kemudian digunakan untuk membuat pengaturan awal bagi pengguna dalam instance armada. Jika Anda membuat pengaturan ini dengan menggunakan operasi Image Assistant CLI, penginstal aplikasi Anda, atau otomatisasi, harus mengubah profil pengguna default Windows secara langsung.
Untuk menimpa profil pengguna default Windows dengan profil pengguna Windows lain, Anda juga dapat menggunakan operasi Image Assistantupdate-default-profile CLI.
Untuk informasi selengkapnya tentang mengkonfigurasi aplikasi default dan pengaturan Windows, lihat Membuat Aplikasi Default dan Pengaturan Windows untuk Pengguna AppStream 2.0 Anda diPengaturan Aplikasi dan Windows Default dan Kinerja Peluncuran Aplikasi.
Mengoptimalkan Kinerja Peluncuran Aplikasi Anda dengan Operasi Image Assistant CLI
AppStream 2.0 memungkinkan Anda mengoptimalkan kinerja peluncuran aplikasi Anda untuk sesi streaming pengguna Anda. Ketika Anda melakukannya dengan menggunakan operasi Image Assistant CLI, Anda dapat menentukan file yang akan dioptimalkan untuk peluncuran aplikasi Anda. Menambahkan file ke manifes pengoptimalan aplikasi mengurangi waktu yang dibutuhkan aplikasi untuk diluncurkan untuk pertama kalinya pada instance armada baru. Namun, ini juga meningkatkan waktu yang diperlukan agar instance armada tersedia bagi pengguna. Manifes optimasi adalah file teks line-delimited yang per aplikasi.
catatan
Jika Anda melakukan pengoptimalan aplikasi onboard bermanifestasi dengan menggunakan operasi Image Assistant CLI dan Image Assistant GUI, manifes akan digabungkan.
Berikut ini adalah contoh file manifes pengoptimalan aplikasi:
C:\Program Files (x86)\Notepad++\autoCompletion C:\Program Files (x86)\Notepad++\localization C:\Program Files (x86)\Notepad++\plugins C:\Program Files (x86)\Notepad++\themes C:\Program Files (x86)\Notepad++\updater C:\Program Files (x86)\Notepad++\userDefineLangs C:\Program Files (x86)\Notepad++\change.log C:\Program Files (x86)\Notepad++\config.xml C:\Program Files (x86)\Notepad++\contextMenu.xml C:\Program Files (x86)\Notepad++\doLocalConf.xml C:\Program Files (x86)\Notepad++\functionList.xml C:\Program Files (x86)\Notepad++\langs.model.xml C:\Program Files (x86)\Notepad++\license.txt C:\Program Files (x86)\Notepad++\notepad++.exe C:\Program Files (x86)\Notepad++\readme.txt C:\Program Files (x86)\Notepad++\SciLexer.dll C:\Program Files (x86)\Notepad++\shortcuts.xml C:\Program Files (x86)\Notepad++\stylers.model.xml
Untuk informasi selengkapnya tentang mengoptimalkan kinerja peluncuran aplikasi Anda, lihat Mengoptimalkan Kinerja Peluncuran Aplikasi Anda diPengaturan Aplikasi dan Windows Default dan Kinerja Peluncuran Aplikasi.
Ikhtisar Proses untuk Membuat Gambar AppStream 2.0 Secara Pemrograman
Anda dapat menggunakan operasi Image Assistant CLI dengan otomatisasi instalasi aplikasi Anda untuk membuat alur kerja pembuatan gambar AppStream 2.0 yang sepenuhnya terprogram. Setelah otomatisasi instalasi aplikasi selesai, tetapi sebelum gambar dibuat, gunakan operasi Image Assistant CLI untuk menentukan yang berikut:
File yang dapat dieksekusi yang dapat diluncurkan pengguna Anda
Manifestasi optimasi untuk aplikasi Anda
Metadata citra AppStream 2.0 lainnya
Gambaran umum tingkat tinggi berikut menjelaskan proses untuk membuat gambar AppStream 2.0 secara terprogram.
Gunakan otomatisasi instalasi aplikasi Anda untuk menginstal aplikasi yang diperlukan pada pembuat gambar Anda. Instalasi ini dapat mencakup aplikasi yang akan diluncurkan pengguna Anda, dependensi apa pun, dan aplikasi latar belakang.
Tentukan file dan folder yang akan dioptimalkan.
Jika berlaku, gunakan operasi Image Assistant
add-applicationCLI untuk menentukan metadata aplikasi dan manifes pengoptimalan untuk image AppStream 2.0.Untuk menentukan aplikasi tambahan untuk gambar AppStream 2.0, ulangi langkah 1 hingga 3 untuk setiap aplikasi sesuai kebutuhan.
-
Jika berlaku, gunakan operasi Image Assistant
update-default-profileCLI untuk menimpa profil Windows default dan membuat pengaturan aplikasi dan Windows default untuk pengguna Anda. Gunakan operasi Image Assistant
create-imageCLI untuk membuat gambar.
Image Assistant Operasi CLI untuk Membuat dan Mengelola Gambar AppStream 2.0 Anda
Bagian ini menjelaskan operasi Image Assistant CLI yang dapat Anda gunakan untuk membuat dan mengelola gambar AppStream 2.0 Anda.
Pada pembuat gambar Windows, file yang dapat dieksekusi yang menyertakan antarmuka baris perintah terletak di: C:\Program Files\ Amazon\ Photon\ConsoleImageBuilder\ Image-Assistant.exe. Untuk kenyamanan Anda, file yang dapat dieksekusi ini disertakan dalam variabel Windows PATH. Ini memungkinkan Anda memanggil operasi Image Assistant CLI tanpa menentukan path absolut ke file yang dapat dieksekusi. Untuk memanggil operasi ini, ketikimage-assistant.exe perintah.
Pada pembuat gambar Linux, alat asisten gambar terletak di /usr/local/appstream/image-assistant/AppStreamImageAssistant, dengan tautan simbolis di /bin/AppStreamImageAssistant.
Operasi help
Mengambil daftar dari semua operasi Image Assistant CLI. Untuk setiap operasi dalam daftar, deskripsi dan sintaks penggunaan disediakan. Untuk menampilkan bantuan untuk operasi tertentu, ketik nama operasi dan tentukan parameter --help. Misalnya:
add-application --help
Sinopsis
help
Keluaran
Mencetak ke standar keluar daftar operasi yang tersedia dengan deskripsi fungsi mereka.
Operasi add-application
Menambahkan aplikasi ke daftar aplikasi untuk AppStream 2.0 pengguna. Aplikasi dalam daftar ini termasuk dalam katalog aplikasi. Katalog aplikasi ditampilkan kepada pengguna saat mereka masuk ke sesi streaming AppStream 2.0.
catatan
Jika Anda perlu membuat perubahan pada konfigurasi aplikasi, hapus aplikasi dan tambahkan aplikasi dengan pengaturan yang diperbarui.
Sinopsis
add-application --name <value> --absolute-app-path <value> [--display-name <value>] [--absolute-icon-path <value>] [--working-directory <value>] [--launch-parameters <""-escaped value>] [--absolute-manifest-path <value>]
Pilihan
--name(tali)-
Nama unik untuk aplikasi. Panjang maksimum adalah 256 karakter. Anda dapat menambahkan hingga 50 aplikasi. Anda tidak dapat menggunakan karakter spasi.
--absolute-app-path(tali)-
Jalur absolut ke file executable, file batch, atau script untuk aplikasi. Path harus menunjuk ke file yang valid.
--display-name(tali)-
Nama yang akan ditampilkan untuk aplikasi dalam katalog aplikasi. Jika Anda tidak menentukan nama tampilan, AppStream 2.0 membuat nama yang berasal dari nama file yang dapat dieksekusi. Nama dibuat tanpa ekstensi file dan dengan garis bawah di tempat spasi. Panjang maksimum adalah 256 karakter.
--absolute-icon-path(tali)-
Jalur absolut ke ikon untuk aplikasi. Jalur harus mengarah ke file ikon yang valid yang merupakan salah satu dari jenis berikut: .jpg, .png, atau.bmp. Dimensi maksimumnya adalah: 256 px x 256 px. Jika Anda tidak menentukan jalur, ikon default untuk file yang dapat dieksekusi digunakan, jika tersedia. Jika ikon default tidak tersedia untuk file yang dapat dieksekusi, ikon aplikasi default AppStream 2.0 digunakan.
--working-directory(tali)-
Direktori kerja awal untuk aplikasi saat aplikasi diluncurkan.
--absolute-manifest-path(tali)-
Path ke file teks line-delimited baru. File menentukan jalur absolut dari file yang akan dioptimalkan sebelum instance armada tersedia bagi pengguna untuk streaming. Jalur harus menunjuk ke file teks yang valid.
Output pesan
| Kode Keluar | Pesan dicetak ke standar keluar | Deskripsi |
|---|---|---|
| 0 | {"status”: 0, “message”: “Sukses"} | Aplikasi berhasil ditambahkan. |
| 1 | {"status”: 1, “message”: “Hak administrator diperlukan untuk menjalankan operasi ini"} | Diperlukan hak istimewa administrator diperlukan untuk menyelesaikan operasi. |
| 1 | {"status”: 1, “message”: “Tidak dapat menambahkan lebih dari 50 aplikasi ke katalog."} | Aplikasi tidak dapat ditambahkan karena jumlah maksimum aplikasi yang dapat ditambahkan ke katalog aplikasi AppStream 2.0 adalah 50. |
| 1 | {"status”: 1, “message”: “Nama tidak unik"} | Aplikasi dengan nama itu sudah ada di katalog aplikasi AppStream 2.0. |
| 1 | {"status”: 1, “message”: “Berkas tidak ditemukan (absolute-app-path)"} | File yang ditentukan untuk tidakabsolute-app-path dapat ditemukan. |
| 1 | {"status”: 1, “message”: “Ekstensi berkas tidak didukung"} | Absolute-app-pathParameter hanya mendukung jenis file berikut: .exe dan .bat. |
| 1 | {"status”: 1, “message”: “Direktori tidak ditemukan (direktori kerja)” | Direktori yang ditentukan untuk tidakworking-directory dapat ditemukan. |
| 1 | {"status”: 1, “message”: “Manifes optimasi tidak ditemukan: <filename>“} | File yang ditentukan untuk tidakoptimization-manifest dapat ditemukan. |
| 1 | {"status”: 1, “message”: “Berkas tidak ditemukan: <filename>“} | File yang ditentukan dalam manifes pengoptimalan tidak dapat ditemukan. |
| 255 | {"status”: 255, “pesan”:<error message>} | Terjadi eror yang tidak terduga terjadi kesalahan yang tidak terduga terjadi Coba permintaan lagi. Jika kesalahan tetap ada, kontakAWS Support untuk bantuan. Untuk informasi selengkapnya, lihat AWS SupportPusat |
Operasi remove-application
Menghapus aplikasi dari daftar aplikasi untuk gambar AppStream 2.0. Aplikasi ini tidak dihapus atau dimodifikasi, tetapi pengguna tidak akan dapat meluncurkannya dari katalog aplikasi AppStream 2.0.
Sinopsis
remove-application --name <value>
Pilihan
--name(tali)-
Pengenal unik aplikasi yang akan dihapus.
Output pesan
| Kode Keluar | Pesan dicetak ke standar keluar | Deskripsi |
|---|---|---|
| 0 | {"status”: 0, “message”: “Sukses"} | Aplikasi berhasil dihapus. |
| 1 | {"status”: 1, “message”: “Hak administrator diperlukan untuk menjalankan operasi ini"} | Diperlukan hak istimewa administrator diperlukan untuk menyelesaikan operasi. |
| 1 | {"status”: 1, “message”: “Aplikasi tidak ditemukan"} | Aplikasi yang ditentukan tidak dapat ditemukan di katalog aplikasi AppStream 2.0. |
| 255 | {"status”: 255, “pesan”:<error message>} | Terjadi eror yang tidak terduga terjadi kesalahan yang tidak terduga terjadi Coba permintaan lagi. Jika kesalahan tetap ada, kontakAWS Support untuk bantuan. Untuk informasi selengkapnya, lihat AWS SupportPusat |
Operasi list-applications
Daftar semua aplikasi yang ditentukan dalam katalog aplikasi.
Sinopsis
list-applications
Output pesan
| Kode Keluar | Pesan dicetak ke standar keluar | Deskripsi |
|---|---|---|
| 0 | {"status”: 0, “message”: “Success”, “applications”: [{.. app1..}, {.. app2..}]} | Daftar aplikasi dalam katalog aplikasi AppStream 2.0. |
| 255 | {"status”: 255, “pesan”:<error message>} | Terjadi eror yang tidak terduga terjadi kesalahan yang tidak terduga terjadi Coba permintaan lagi. Jika kesalahan tetap ada, kontakAWS Support untuk bantuan. Untuk informasi selengkapnya, lihat AWS SupportPusat |
Operasi update-default-profile
Menyalin profil pengguna Windows yang ditentukan ke profil pengguna default Windows. Pengguna baru yang streaming mewarisi pengaturan yang disimpan di profil yang ditentukan.
catatan
Operasi ini tidak didukung oleh alat CLI asisten gambar Linux.
Sinopsis
update-default-profile [--profile <value>]
Pilihan
--profile(tali)-
Nama pengguna yang profil Windows-nya akan disalin ke profil pengguna default Windows. Gunakan format berikut untuk nama:
“<domain>\<username>”
Jika pembuat gambar Anda tidak bergabung ke domain Microsoft Active Directory, masukkan periode “.” untuk domain. Jika Anda tidak menentukan pengguna, akun Pengguna Templat AppStream 2.0 digunakan.
Output pesan
| Kode Keluar | Pesan dicetak ke standar keluar | Deskripsi |
|---|---|---|
| 0 | {"status”: 0, “message”: “Sukses"} | Pengaturan pengguna berhasil disalin ke profil Windows default. |
| 1 | {"status”: 1, “message”: “Hak administrator diperlukan untuk menjalankan operasi ini"} | Diperlukan hak istimewa administrator diperlukan untuk menyelesaikan operasi. |
| 1 | {"status”: 1, “message”: “Tidak dapat menyalin berkas atau folder:<path>. <reason>“} | Pengaturan pengguna tidak dapat disalin karena file atau folder tidak tersedia. |
| 1 | {"status”: 1, “message”: “Tidak dapat menyalin pengguna domain ketika tidak bergabung ke domain""} | Pengguna domain Microsoft Active Directory telah ditentukan, tetapi pembuat gambar tidak bergabung ke domain Active Directory. |
| 255 | {"status”: 255, “pesan”:<error message>} | Terjadi eror yang tidak terduga terjadi kesalahan yang tidak terduga terjadi Coba permintaan lagi. Jika kesalahan tetap ada, kontakAWS Support untuk bantuan. Untuk informasi selengkapnya, lihat AWS SupportPusat |
Operasi reset-user-profile
Menghapus profil pengguna Windows untuk pengguna tertentu.
catatan
Operasi ini tidak didukung oleh alat CLI asisten gambar Linux.
Sinopsis
reset-user-profile [--profile <value>]
Pilihan
--profile(tali)-
Nama pengguna Windows yang profil Windows-nya akan dihapus. Gunakan format berikut untuk nama:
“<domain>\<username>”
Jika pembuat gambar Anda tidak bergabung ke domain Microsoft Active Directory, masukkan periode “.” untuk domain.
Output pesan
| Kode Keluar | Pesan dicetak ke standar keluar | Deskripsi |
|---|---|---|
| 0 | {"status”: 0, “message”: “Sukses"} | Pengaturan pengguna yang ditentukan berhasil dihapus. |
| 1 | {"status”: 1, “message”: “Hak administrator diperlukan untuk menjalankan operasi ini"} | Diperlukan hak istimewa administrator diperlukan untuk menyelesaikan operasi. |
| 1 | {"status”: 1, “message”: “Tidak dapat menyalin berkas atau folder:<path>. <reason>“} | Pengaturan pengguna tidak dapat diatur ulang karena file atau folder tidak tersedia. |
| 1 | {"status”: 1, “message”: “Tidak dapat menyalin pengguna domain ketika tidak bergabung ke domain""} | Pengguna domain Microsoft Active Directory telah ditentukan, tetapi pembuat gambar tidak bergabung ke domain Active Directory. |
| 255 | {"status”: 255, “pesan”:<error message>} | Terjadi eror yang tidak terduga terjadi kesalahan yang tidak terduga terjadi Coba permintaan lagi. Jika kesalahan tetap ada, kontakAWS Support untuk bantuan. Untuk informasi selengkapnya, lihat AWS SupportPusat |
Operasi create-image
Mulai alur kerja pembuatan gambar, menghasilkan gambar AppStream 2.0 yang dapat digunakan untuk AppStream 2.0 armada.
Sinopsis
create-image --name <value> [--description <value>] [--display-name <value>] [--enable-dynamic-app-catalog] | [--no-enable-dynamic-app-catalog] [--use-latest-agent-version] | [--no-use-latest-agent-version] [--tags <value>] [--dry-run]
Pilihan
--name(tali)-
Nama untuk gambar AppStream 2.0. Nama harus unik dalam akun Amazon Web Services danAWS Wilayah. Panjang maksimum adalah 100 karakter. Karakter yang diizinkan adalah:
(.), 0-9, garis bawah (.), tanda hubung (-), dan titik (.), dan garis (.)
Nama gambar tidak dapat dimulai dengan salah satu awalan berikut: 'aws', 'appstream', dan 'amazon'. Awalan ini dicadangkan untukAWS digunakan.
--description(tali)-
Deskripsi yang ditampilkan untuk gambar. Panjang maksimum adalah 256 karakter.
--display-name(tali)-
Nama yang ditampilkan untuk gambar. Panjang maksimum adalah 256 karakter.
--enable-dynamic-app-catalog|--no-enable-dynamic-app-catalog-
Mengaktifkan atau menonaktifkan dukungan untuk kerangka aplikasi dinamis AppStream 2.0. Jika Anda tidak menentukan salah satu parameter, dukungan untuk framework aplikasi dinamis tidak diaktifkan.
Framework aplikasi dinamis menyediakan operasi dalam instans streaming AppStream 2.0 yang dapat Anda gunakan untuk membangun penyedia aplikasi dinamis. Penyedia aplikasi dinamis dapat menggunakan operasi ini untuk memodifikasi katalog aplikasi yang dapat diakses pengguna Anda secara real time. Untuk informasi selengkapnya, lihat Menggunakan AppStream 2.0 Dynamic Application Framework untuk Membangun Penyedia Aplikasi Dinamis.
--use-latest-agent-version|--no-use-latest-agent-version-
Menentukan apakah akan menyematkan gambar ke versi agen AppStream 2.0 yang saat ini diinstal, atau untuk selalu menggunakan versi agen terbaru. Jika Anda tidak menentukan salah satu parameter, gambar disematkan ke versi agen AppStream 2.0 yang saat ini diinstal. Untuk informasi selengkapnya, lihat Kelola Versi AppStream 2.0 Agen.
--tags(tali)-
Tag untuk mengasosiasikan dengan citra. Tanda merupakan pasangan nilai kunci. Gunakan format berikut:
-tag “mykey” “myval” “mykey2" “myval2"
Untuk informasi selengkapnya tentang tanda, lihat Penambahan Tanda Sumber Daya Amazon AppStream 2.0 Anda.
--dry-run(tali)-
Melakukan validasi tanpa membuat gambar. Gunakan perintah ini untuk mengidentifikasi apakah gambar Anda memiliki masalah sebelum Anda membuatnya.
Output pesan
| Kode Keluar | Pesan dicetak ke standar keluar | Deskripsi |
|---|---|---|
| 0 | {"status”: 0, “message”: “Sukses"} | Alur kerja untuk membuat gambar dimulai dengan sukses. |
| 1 | {"status”: 1, “message”: “Hak administrator diperlukan untuk menjalankan operasi ini"} | Diperlukan hak istimewa administrator diperlukan untuk menyelesaikan operasi. |
| 1 | {"status”: 1, “message”: “Gambar dengan nama yang diberikan sudah ada"} | Gambar dengan nama yang ditentukan sudah ada di akun Amazon Web Services. |
| 1 | {"status”: 1, “message”: “Nilai tidak valid (tag)"} | Tag yang ditentukan tidak valid. |
| 255 | {"status”: 255, “pesan”:<error message>} | Terjadi eror yang tidak terduga terjadi kesalahan yang tidak terduga terjadi Coba permintaan lagi. Jika kesalahan tetap ada, kontakAWS Support untuk bantuan. Untuk informasi selengkapnya, lihat AWS SupportPusat |
