Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
CLIOperasi Asisten Gambar untuk Membuat dan Mengelola Gambar Amazon AppStream 2.0 Anda
Bagian ini menjelaskan CLI operasi Asisten Gambar 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\\ Image-Assistant.exe. ConsoleImageBuilder Untuk kenyamanan Anda, file yang dapat dieksekusi ini termasuk dalam variabel WindowsPATH. Ini memungkinkan Anda memanggil CLI operasi Image Assistant tanpa menentukan jalur absolut ke file yang dapat dieksekusi. Untuk memanggil operasi ini, ketik image-assistant.exe perintah.
Pada pembuat gambar Linux, alat asisten gambar terletak di /usr/local/appstream/image-assistant/, dengan tautan simbolis di AppStreamImageAssistant /bin/. AppStreamImageAssistant
Operasi help
Mengambil daftar semua CLI operasi Asisten Gambar. Untuk setiap operasi dalam daftar, deskripsi dan sintaks penggunaan disediakan. Untuk menampilkan bantuan untuk operasi tertentu, ketikkan nama operasi dan tentukan parameter --help. Sebagai contoh:
add-application --help
Sinopsis
help
Keluaran
Mencetak untuk standar daftar operasi yang tersedia dengan deskripsi fungsinya.
Operasi add-application
Menambahkan aplikasi ke daftar aplikasi untuk pengguna AppStream 2.0. 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 putih.
--absolute-app-path(tali)-
Jalur absolut ke file yang dapat dieksekusi, file batch, atau skrip untuk aplikasi. Jalur 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 akan 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 menunjuk 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 akan digunakan, jika tersedia. Jika ikon default tidak tersedia untuk file yang dapat dieksekusi, ikon aplikasi AppStream 2.0 default digunakan.
--working-directory(tali)-
Direktori kerja awal untuk aplikasi saat aplikasi diluncurkan.
--absolute-manifest-path(tali)-
Jalur ke file teks baru yang dibatasi baris. File menentukan jalur absolut file untuk dioptimalkan sebelum instance armada tersedia bagi pengguna untuk streaming. Jalur harus menunjuk ke file teks yang valid.
Keluaran pesan
| Kode keluar | Pesan dicetak ke standar | Deskripsi |
|---|---|---|
| 0 | {"status”: 0, “message”: “Sukses"} | Aplikasi berhasil ditambahkan. |
| 1 | {"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"} | 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”: “File tidak ditemukan (absolute-app-path)"} | File yang ditentukan untuk tidak absolute-app-path dapat ditemukan. |
| 1 | {"status”: 1, “message”: “Ekstensi file yang 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 tidak working-directory dapat ditemukan. |
| 1 | <filename>{"status”: 1, “message”: “Pengoptimalan-manifes tidak ditemukan: “} | File yang ditentukan untuk tidak optimization-manifest dapat ditemukan. |
| 1 | {"status”: 1, “message”: “File tidak ditemukan: <filename>“} | File yang ditentukan dalam manifes pengoptimalan tidak dapat ditemukan. |
| 255 | <error message>{"status”: 255, “pesan”:} | Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Support untuk bantuan. Untuk informasi lebih lanjut, lihat AWS Support Pusat |
Operasi remove-application
Menghapus aplikasi dari daftar aplikasi untuk gambar AppStream 2.0. Aplikasi tidak dihapus atau dimodifikasi, tetapi pengguna tidak akan dapat meluncurkannya dari katalog aplikasi AppStream 2.0.
Sinopsis
remove-application --name <value>
Pilihan
--name(tali)-
Pengidentifikasi unik aplikasi yang akan dihapus.
Keluaran pesan
| Kode keluar | Pesan dicetak ke standar | Deskripsi |
|---|---|---|
| 0 | {"status”: 0, “message”: “Sukses"} | Aplikasi berhasil dihapus. |
| 1 | {"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"} | 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 | <error message>{"status”: 255, “pesan”:} | Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Support untuk bantuan. Untuk informasi lebih lanjut, lihat AWS Support Pusat |
Operasi list-applications
Daftar semua aplikasi yang ditentukan dalam katalog aplikasi.
Sinopsis
list-applications
Keluaran pesan
| Kode keluar | Pesan dicetak ke standar | Deskripsi |
|---|---|---|
| 0 | {"status”: 0, “message”: “Sukses”, “aplikasi”: [{.. app1..}, {.. app2..}]} | Daftar aplikasi dalam katalog aplikasi AppStream 2.0. |
| 255 | <error message>{"status”: 255, “pesan”:} | Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Support untuk bantuan. Untuk informasi lebih lanjut, lihat AWS Support Pusat |
Operasi update-default-profile
Menyalin profil pengguna Windows yang ditentukan ke profil pengguna default Windows. Pengguna baru yang melakukan streaming mewarisi pengaturan yang disimpan di profil yang ditentukan.
catatan
Operasi ini tidak didukung oleh CLI alat asisten gambar Linux.
Sinopsis
update-default-profile [--profile <value>]
Pilihan
--profile(tali)-
Nama pengguna yang profil Windowsnya akan disalin ke profil pengguna default Windows. Gunakan format berikut untuk nama:
“<domain>\<username>”
Jika pembuat gambar Anda tidak bergabung dengan domain Microsoft Active Directory, masukkan titik “.” untuk domain tersebut. Jika Anda tidak menentukan pengguna, akun AppStream 2.0 Template User akan digunakan.
Keluaran pesan
| Kode keluar | Pesan dicetak ke standar | Deskripsi |
|---|---|---|
| 0 | {"status”: 0, “message”: “Sukses"} | Pengaturan pengguna berhasil disalin ke profil Windows default. |
| 1 | {"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"} | 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 ditentukan, tetapi pembuat gambar tidak bergabung ke domain Active Directory. |
| 255 | <error message>{"status”: 255, “pesan”:} | Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Support untuk bantuan. Untuk informasi lebih lanjut, lihat AWS Support Pusat |
Operasi reset-user-profile
Menghapus profil pengguna Windows untuk pengguna yang ditentukan.
catatan
Operasi ini tidak didukung oleh CLI alat asisten gambar Linux.
Sinopsis
reset-user-profile [--profile <value>]
Pilihan
--profile(tali)-
Nama pengguna Windows yang profil Windowsnya akan dihapus. Gunakan format berikut untuk nama:
“<domain>\<username>”
Jika pembuat gambar Anda tidak bergabung dengan domain Microsoft Active Directory, masukkan titik “.” untuk domain tersebut.
Keluaran pesan
| Kode keluar | Pesan dicetak ke standar | Deskripsi |
|---|---|---|
| 0 | {"status”: 0, “message”: “Sukses"} | Pengaturan pengguna yang ditentukan berhasil dihapus. |
| 1 | {"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"} | 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 ditentukan, tetapi pembuat gambar tidak bergabung ke domain Active Directory. |
| 255 | <error message>{"status”: 255, “pesan”:} | Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Support untuk bantuan. Untuk informasi lebih lanjut, lihat AWS Support Pusat |
Operasi create-image
Memulai alur kerja pembuatan gambar, menghasilkan gambar AppStream 2.0 yang dapat digunakan untuk armada AppStream 2.0.
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 dan AWS Wilayah. Panjang maksimum adalah 100 karakter. Karakter yang diizinkan adalah:
a-z, A-Z, 0-9, garis bawah (_), tanda hubung (-), dan periode (.)
Nama gambar tidak dapat dimulai dengan awalan berikut: 'aws', 'appstream', dan 'amazon'. Awalan ini dicadangkan untuk AWS digunakan.
--description(tali)-
Deskripsi untuk ditampilkan untuk gambar. Panjang maksimum adalah 256 karakter.
--display-name(tali)-
Nama yang akan ditampilkan untuk gambar. Panjang maksimum adalah 256 karakter.
--enable-dynamic-app-catalog|--no-enable-dynamic-app-catalog-
Mengaktifkan atau menonaktifkan dukungan untuk kerangka kerja aplikasi dinamis AppStream 2.0. Jika Anda tidak menentukan salah satu parameter, dukungan untuk kerangka kerja aplikasi dinamis tidak diaktifkan.
Kerangka kerja aplikasi dinamis menyediakan operasi dalam instance 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 Agen AppStream 2.0.
--tags(tali)-
Tag untuk mengasosiasikan dengan gambar. Tanda merupakan pasangan nilai kunci. Gunakan format berikut:
--tags “mykey” “myval” “mykey2" “myval2"
Untuk informasi selengkapnya tentang tag, lihat Menandai 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.
Keluaran pesan
| Kode keluar | Pesan dicetak ke standar | Deskripsi |
|---|---|---|
| 0 | {"status”: 0, “message”: “Sukses"} | Alur kerja untuk membuat gambar berhasil dimulai. |
| 1 | {"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"} | Hak istimewa administrator diperlukan untuk menyelesaikan operasi. |
| 1 | {"status”: 1, “message”: “Sebuah gambar dengan nama yang diberikan sudah ada"} | Gambar dengan nama yang ditentukan sudah ada di akun Amazon Web Services. |
| 1 | {"status”: 1, “message”: “Nilai (tag) tidak valid"} | Tag yang ditentukan tidak valid. |
| 255 | <error message>{"status”: 255, “pesan”:} | Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Support untuk bantuan. Untuk informasi lebih lanjut, lihat AWS Support Pusat |
