

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

# Buat Gambar WorkSpaces Aplikasi Amazon Anda Secara Terprogram dengan Menggunakan Operasi CLI Asisten Gambar
<a name="programmatically-create-image"></a>

Anda dapat membuat gambar WorkSpaces Aplikasi Amazon dengan menghubungkan ke pembuat gambar dan menggunakan operasi antarmuka pengguna grafis Asisten Gambar (GUI) atau antarmuka baris perintah (CLI). Operasi CLI Asisten Gambar menyediakan fungsionalitas yang mirip dengan GUI Asisten Gambar. Dengan operasi ini, Anda dapat melakukan hal berikut secara terprogram:
+ Kelola aplikasi yang disertakan dalam gambar.
+ Simpan, perbarui, dan setel ulang pengaturan aplikasi default.
+ Aktifkan atau nonaktifkan kerangka WorkSpaces aplikasi dinamis Aplikasi.
+ Tentukan tag.
+ Buat gambar.

 Anda dapat menggunakan operasi ini untuk mengintegrasikan pembuatan gambar WorkSpaces Aplikasi dengan integrasi berkelanjutan atau proses pengembangan perangkat lunak penyebaran Anda.

Untuk bekerja dengan operasi CLI Asisten Gambar, 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 WorkSpaces Aplikasi yang dirilis pada atau setelah 26 Juli 2019. Jika Anda tidak memiliki pembuat gambar, Anda harus membuatnya. Untuk informasi selengkapnya, lihat [Luncurkan Image Builder untuk Menginstal dan Mengkonfigurasi Aplikasi Streaming](tutorial-image-builder-create.md).

**Topics**
+ [Membuat Aplikasi Default dan Pengaturan Windows dengan operasi CLI Asisten Gambar](create-default-app-windows-settings-image-assistant.md)
+ [Mengoptimalkan Kinerja Peluncuran Aplikasi Anda dengan Operasi CLI Asisten Gambar](optimize-app-launch-performance-image-assistant-cli.md)
+ [Ikhtisar Proses untuk Membuat Gambar Aplikasi Amazon WorkSpaces secara Terprogram](process-overview-creating-image-programmatically-image-assistant-cli.md)
+ [Operasi CLI Asisten Gambar untuk Membuat dan Mengelola Gambar Aplikasi Amazon WorkSpaces Anda](cli-operations-managing-creating-image-image-assistant.md)

# Membuat Aplikasi Default dan Pengaturan Windows dengan operasi CLI Asisten Gambar
<a name="create-default-app-windows-settings-image-assistant"></a>

Anda dapat membuat aplikasi default dan pengaturan Windows sehingga pengguna Anda dapat memulai dengan aplikasi mereka dengan cepat. Saat Anda membuat pengaturan ini, WorkSpaces Aplikasi menggantikan profil pengguna default Windows dengan profil yang Anda konfigurasikan. Profil pengguna default Windows kemudian digunakan untuk membuat pengaturan awal untuk pengguna dalam instance armada. Jika Anda membuat pengaturan ini dengan menggunakan operasi CLI Asisten Gambar, penginstal aplikasi Anda, atau otomatisasi, harus memodifikasi profil pengguna default Windows secara langsung.

Untuk menimpa profil pengguna default Windows dengan pengguna Windows lain, Anda juga dapat menggunakan operasi `update-default-profile` CLI Asisten Gambar.

Untuk informasi selengkapnya tentang mengonfigurasi aplikasi default dan pengaturan Windows, lihat *Membuat Aplikasi Default dan Pengaturan Windows untuk Pengguna WorkSpaces Aplikasi Anda* di[Pengaturan Aplikasi dan Windows Default dan Kinerja Peluncuran Aplikasi di WorkSpaces Aplikasi Amazon](customizing-appstream-images.md).

# Mengoptimalkan Kinerja Peluncuran Aplikasi Anda dengan Operasi CLI Asisten Gambar
<a name="optimize-app-launch-performance-image-assistant-cli"></a>

WorkSpaces Aplikasi 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 diperlukan aplikasi untuk diluncurkan untuk pertama kalinya pada instance armada baru. Namun, ini juga meningkatkan waktu yang diperlukan agar instance armada tersedia bagi pengguna. Manifes pengoptimalan adalah file teks yang dibatasi baris per aplikasi. 

**catatan**  
Jika Anda melakukan onboard manifes pengoptimalan aplikasi dengan menggunakan operasi CLI Asisten Gambar dan GUI Asisten Gambar, 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* di. [Pengaturan Aplikasi dan Windows Default dan Kinerja Peluncuran Aplikasi di WorkSpaces Aplikasi Amazon](customizing-appstream-images.md)

# Ikhtisar Proses untuk Membuat Gambar Aplikasi Amazon WorkSpaces secara Terprogram
<a name="process-overview-creating-image-programmatically-image-assistant-cli"></a>

Anda dapat menggunakan operasi CLI Asisten Gambar dengan otomatisasi instalasi aplikasi Anda untuk membuat alur kerja pembuatan gambar WorkSpaces Aplikasi yang sepenuhnya terprogram. Setelah otomatisasi instalasi aplikasi Anda selesai, tetapi sebelum gambar dibuat, gunakan operasi CLI Asisten Gambar untuk menentukan hal berikut:
+ File yang dapat dieksekusi yang dapat diluncurkan pengguna Anda
+ Manifestasi pengoptimalan untuk aplikasi Anda
+  WorkSpaces Aplikasi lainnya metadata gambar

Ikhtisar tingkat tinggi berikut menjelaskan proses pembuatan gambar Aplikasi secara terprogram. WorkSpaces 

1. 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.

1. Tentukan file dan folder untuk dioptimalkan.

1. Jika berlaku, gunakan operasi `add-application` CLI Asisten Gambar untuk menentukan metadata aplikasi dan manifes pengoptimalan untuk gambar Aplikasi. WorkSpaces 

1. Untuk menentukan aplikasi tambahan untuk gambar WorkSpaces Aplikasi, ulangi langkah 1 hingga 3 untuk setiap aplikasi sesuai kebutuhan.

1. Jika berlaku, gunakan operasi `update-default-profile` CLI Asisten Gambar untuk menimpa profil Windows default dan membuat aplikasi default dan pengaturan Windows untuk pengguna Anda.

1. Gunakan operasi Image Assistant `create-image` CLI untuk membuat gambar.

# Operasi CLI Asisten Gambar untuk Membuat dan Mengelola Gambar Aplikasi Amazon WorkSpaces Anda
<a name="cli-operations-managing-creating-image-image-assistant"></a>

Bagian ini menjelaskan operasi CLI Asisten Gambar yang dapat Anda gunakan untuk membuat dan mengelola gambar WorkSpaces Aplikasi Anda.

Pada pembuat gambar Windows, file yang dapat dieksekusi yang menyertakan antarmuka baris perintah terletak di: C:\$1Program Files\$1 Amazon\$1 Photon\$1\$1 Image-Assistant.exe. ConsoleImageBuilder Untuk kenyamanan Anda, file yang dapat dieksekusi ini disertakan dalam variabel Windows PATH. Ini memungkinkan Anda memanggil operasi CLI Asisten Gambar 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/AppStreamImageAssistant, with a symbolic link at /bin/AppStreamImageAssistant.

## Operasi `help`
<a name="help-operation-image-assistant-cli"></a>

Mengambil daftar semua operasi CLI 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**. Contoh:

```
add-application --help
```

**Sinopsis**

```
help
```

**Keluaran**

Mencetak untuk standar daftar operasi yang tersedia dengan deskripsi fungsinya.

## Operasi `add-application`
<a name="add-application-operation-image-assistant-cli"></a>

Menambahkan aplikasi ke daftar aplikasi untuk pengguna WorkSpaces Aplikasi. Aplikasi dalam daftar ini termasuk dalam katalog aplikasi. Katalog aplikasi ditampilkan kepada pengguna saat mereka masuk ke sesi streaming WorkSpaces Aplikasi.

**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, WorkSpaces Aplikasi 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 WorkSpaces aplikasi Aplikasi 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 |  \$1"status”: 0, “message”: “Sukses"\$1  |  Aplikasi berhasil ditambahkan.  | 
| 1 |  \$1"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"\$1  |  Hak istimewa administrator diperlukan untuk menyelesaikan operasi.  | 
| 1 |  \$1"status”: 1, “message”: “Tidak dapat menambahkan lebih dari 50 aplikasi ke katalog."\$1  |  Aplikasi tidak dapat ditambahkan karena jumlah maksimum aplikasi yang dapat ditambahkan ke katalog WorkSpaces aplikasi Aplikasi adalah 50.  | 
| 1 |  \$1"status”: 1, “message”: “Nama tidak unik"\$1  |  Aplikasi dengan nama itu sudah ada di katalog WorkSpaces aplikasi Aplikasi.  | 
| 1 |  \$1"status”: 1, “message”: “File tidak ditemukan (absolute-app-path)"\$1  |  File yang ditentukan untuk tidak absolute-app-path dapat ditemukan.  | 
| 1 |  \$1"status”: 1, “message”: “Ekstensi file yang tidak didukung"\$1  |  Absolute-app-pathParameter hanya mendukung jenis file berikut: .exe dan .bat.  | 
| 1 |  \$1"status”: 1, “message”: “Direktori tidak ditemukan (direktori kerja)”  |  Direktori yang ditentukan untuk tidak working-directory dapat ditemukan.  | 
| 1 |  <filename>\$1"status”: 1, “message”: “Pengoptimalan-manifes tidak ditemukan: “\$1  |  File yang ditentukan untuk tidak optimization-manifest dapat ditemukan.  | 
| 1 |  \$1"status”: 1, “message”: “File tidak ditemukan: <filename>“\$1  |  File yang ditentukan dalam manifes pengoptimalan tidak dapat ditemukan.  | 
| 255 |  <error message>\$1"status”: 255, “pesan”:\$1  |  Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Dukungan untuk bantuan. Untuk informasi lebih lanjut, lihat [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/).  | 

## Operasi `remove-application`
<a name="remove-application-operation-image-assistant-cli"></a>

Menghapus aplikasi dari daftar aplikasi untuk gambar WorkSpaces Aplikasi. Aplikasi tidak dihapus atau dimodifikasi, tetapi pengguna tidak akan dapat meluncurkannya dari katalog WorkSpaces aplikasi Aplikasi.

**Sinopsis**

```
remove-application
--name <value>
```

**Pilihan**

**`--name`(tali)**  
Pengidentifikasi unik aplikasi yang akan dihapus.

**Keluaran pesan**


| Kode keluar | Pesan dicetak ke standar | Deskripsi | 
| --- | --- | --- | 
| 0 |  \$1"status”: 0, “message”: “Sukses"\$1  |  Aplikasi berhasil dihapus.  | 
| 1 |  \$1"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"\$1  |  Hak istimewa administrator diperlukan untuk menyelesaikan operasi.  | 
| 1 |  \$1"status”: 1, “message”: “Aplikasi tidak ditemukan"\$1  |  Aplikasi yang ditentukan tidak dapat ditemukan di katalog WorkSpaces aplikasi Aplikasi.  | 
| 255 |  <error message>\$1"status”: 255, “pesan”:\$1  |  Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Dukungan untuk bantuan. Untuk informasi lebih lanjut, lihat [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/).  | 

## Operasi `list-applications`
<a name="list-applications-operation-image-assistant-cli"></a>

Daftar semua aplikasi yang ditentukan dalam katalog aplikasi.

**Sinopsis**

```
list-applications
```

**Keluaran pesan**


| Kode keluar | Pesan dicetak ke standar | Deskripsi | 
| --- | --- | --- | 
| 0 |  \$1"status”: 0, “message”: “Sukses”, “aplikasi”: [\$1.. app1..\$1, \$1.. app2..\$1]\$1  |  Daftar aplikasi dalam katalog WorkSpaces aplikasi Aplikasi.  | 
| 255 |  <error message>\$1"status”: 255, “pesan”:\$1  |  Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Dukungan untuk bantuan. Untuk informasi lebih lanjut, lihat [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/).  | 

## Operasi `update-default-profile`
<a name="update-default-profile-image-assistant-cli"></a>

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 alat CLI 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>\$1<username>”  
Jika pembuat gambar Anda tidak bergabung dengan domain Microsoft Active Directory, masukkan titik “.” untuk domain tersebut. Jika Anda tidak menentukan pengguna, akun Pengguna Template WorkSpaces Aplikasi akan digunakan.

**Keluaran pesan**


| Kode keluar | Pesan dicetak ke standar | Deskripsi | 
| --- | --- | --- | 
| 0 |  \$1"status”: 0, “message”: “Sukses"\$1  |  Pengaturan pengguna berhasil disalin ke profil Windows default.  | 
| 1 |  \$1"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"\$1  |  Hak istimewa administrator diperlukan untuk menyelesaikan operasi.  | 
| 1 |  \$1"status”: 1, “message”: “Tidak dapat menyalin berkas atau folder:<path>. <reason>“\$1  |  Pengaturan pengguna tidak dapat disalin karena file atau folder tidak tersedia.  | 
| 1 |  \$1"status”: 1, “message”: “Tidak dapat menyalin pengguna domain saat tidak bergabung ke domain""\$1  |  Pengguna domain Microsoft Active Directory ditentukan, tetapi pembuat gambar tidak bergabung ke domain Active Directory.  | 
| 255 |  <error message>\$1"status”: 255, “pesan”:\$1  |  Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Dukungan untuk bantuan. Untuk informasi lebih lanjut, lihat [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/).  | 

## Operasi `reset-user-profile`
<a name="reset-user-profile-image-assistant-cli"></a>

Menghapus profil pengguna Windows untuk pengguna yang ditentukan.

**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 Windowsnya akan dihapus. Gunakan format berikut untuk nama:  
“<domain>\$1<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 |  \$1"status”: 0, “message”: “Sukses"\$1  |  Pengaturan pengguna yang ditentukan berhasil dihapus.  | 
| 1 |  \$1"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"\$1  |  Hak istimewa administrator diperlukan untuk menyelesaikan operasi.  | 
| 1 |  \$1"status”: 1, “message”: “Tidak dapat menyalin berkas atau folder:<path>. <reason>“\$1  |  Pengaturan pengguna tidak dapat diatur ulang karena file atau folder tidak tersedia.  | 
| 1 |  \$1"status”: 1, “message”: “Tidak dapat menyalin pengguna domain saat tidak bergabung ke domain""\$1  |  Pengguna domain Microsoft Active Directory ditentukan, tetapi pembuat gambar tidak bergabung ke domain Active Directory.  | 
| 255 |  <error message>\$1"status”: 255, “pesan”:\$1  |  Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Dukungan untuk bantuan. Untuk informasi lebih lanjut, lihat [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/).  | 

## Operasi `create-image`
<a name="create-image-operation-image-assistant-cli"></a>

Memulai alur kerja pembuatan gambar, menghasilkan gambar WorkSpaces Aplikasi yang dapat digunakan untuk armada WorkSpaces Aplikasi.

**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 WorkSpaces Aplikasi. 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 (\$1), 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` \$1 `--no-enable-dynamic-app-catalog`**  
Mengaktifkan atau menonaktifkan dukungan untuk kerangka WorkSpaces aplikasi dinamis Aplikasi. Jika Anda tidak menentukan salah satu parameter, dukungan untuk kerangka kerja aplikasi dinamis tidak diaktifkan.  
Kerangka kerja aplikasi dinamis menyediakan operasi dalam instance streaming WorkSpaces Aplikasi 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 WorkSpaces Applications Dynamic Application Framework untuk Membangun Penyedia Aplikasi Dinamis](build-dynamic-app-provider.md).

**`--use-latest-agent-version` \$1 `--no-use-latest-agent-version`**  
Menentukan apakah akan menyematkan gambar ke versi agen WorkSpaces Aplikasi yang saat ini diinstal, atau untuk selalu menggunakan versi agen terbaru. Jika Anda tidak menentukan salah satu parameter, gambar disematkan ke versi agen WorkSpaces Aplikasi yang saat ini diinstal. Untuk informasi selengkapnya, lihat [Kelola Versi Agen WorkSpaces Aplikasi](base-images-agent.md).

**`--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 WorkSpaces Aplikasi Amazon Anda](tagging-basic.md).

**`--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 |  \$1"status”: 0, “message”: “Sukses"\$1  |  Alur kerja untuk membuat gambar berhasil dimulai.  | 
| 1 |  \$1"status”: 1, “message”: “Hak istimewa administrator diperlukan untuk melakukan operasi ini"\$1  |  Hak istimewa administrator diperlukan untuk menyelesaikan operasi.  | 
| 1 |  \$1"status”: 1, “message”: “Sebuah gambar dengan nama yang diberikan sudah ada"\$1  |  Gambar dengan nama yang ditentukan sudah ada di akun Amazon Web Services.  | 
| 1 |  \$1"status”: 1, “message”: “Nilai (tag) tidak valid"\$1  |  Tag yang ditentukan tidak valid.  | 
| 255 |  <error message>\$1"status”: 255, “pesan”:\$1  |  Terjadi kesalahan tak terduga. Coba permintaannya lagi. Jika kesalahan berlanjut, hubungi AWS Dukungan untuk bantuan. Untuk informasi lebih lanjut, lihat [AWS Dukungan Pusat](https://console.aws.amazon.com/support/home#/).  | 