Instal aplikasi dengan alat WinAppDeployCmd.exe

Windows Application Deployment (WinAppDeployCmd.exe) adalah alat baris perintah yang dapat digunakan untuk menyebarkan aplikasi Universal Windows Platform (UWP) dari PC Windows 10 ke perangkat Windows 10 mana pun. Anda dapat menggunakan alat ini untuk menyebarkan paket aplikasi saat perangkat Windows 10 terhubung melalui USB atau tersedia di subnet yang sama tanpa memerlukan Visual Studio Microsoft atau solusi untuk aplikasi tersebut. Anda juga dapat menyebarkan aplikasi tanpa mengemas terlebih dahulu ke PC jarak jauh atau Xbox One. Artikel ini menjelaskan cara menginstal aplikasi UWP menggunakan alat ini.

Anda hanya perlu sdk Windows 10 diinstal untuk menjalankan alat WinAppDeployCmd dari command prompt atau file script. Saat Anda menginstal aplikasi dengan WinAppDeployCmd.exe, ini menggunakan file .appx/.msix atau AppxManifest(untuk file longgar) untuk memuat aplikasi Anda ke perangkat Windows 10. Perintah ini tidak menginstal sertifikat yang diperlukan untuk aplikasi Anda. Untuk menjalankan aplikasi, perangkat Windows 10 harus dalam mode pengembang atau sudah menginstal sertifikat.

Untuk menyebarkan ke perangkat seluler, Anda harus terlebih dahulu membuat paket. Untuk informasi selengkapnya, lihat di sini.

Alat WinAppDeployCmd.exe terletak di sini di PC Windows 10 Anda: C:\Program Files (x86)\Windows Kits\10\bin\<SDK Version>\x86\WinAppDeployCmd.exe (berdasarkan jalur instalasi Anda untuk SDK).

Catatan

Di versi 15063 dan sdk yang lebih baru, SDK diinstal berdampingan dalam folder khusus versi. SDK sebelumnya (sebelum dan termasuk 14393) ditulis langsung ke folder induk.

Pertama, hubungkan perangkat Windows 10 Anda ke subnet yang sama atau hubungkan langsung ke mesin Windows 10 Anda dengan koneksi USB. Kemudian gunakan sintaks berikut dan contoh perintah ini nanti di artikel ini untuk menyebarkan aplikasi UWP Anda:

Sintaks dan opsi WinAppDeployCmd

Ini adalah sintaks umum yang digunakan untuk WinAppDeployCmd.exe:

WinAppDeployCmd command -option <argument>

Berikut adalah beberapa contoh sintaks tambahan untuk menggunakan berbagai perintah:

WinAppDeployCmd devices
WinAppDeployCmd devices <x>
WinAppDeployCmd install -file <path> -ip <address>
WinAppDeployCmd install -file <path> -guid <address> -pin <p>
WinAppDeployCmd install -file <path> -ip <address> -dependency <a> <b> 
WinAppDeployCmd install -file <path> -guid <address> -dependency <a> <b>
WinAppDeployCmd uninstall -file <path>
WinAppDeployCmd uninstall -package <name>
WinAppDeployCmd update -file <path>
WinAppDeployCmd list -ip <address>
WinAppDeployCmd list -guid <address>
WinAppDeployCmd deployfiles -file <path> -remotedeploydir <remoterelativepath> -ip <address>
WinAppDeployCmd registerfiles -remotedeploydir <remoterelativepath> -ip <address>
WinAppDeployCmd addcreds -credserver <server> -credusername <username> -credpassword <password> -ip <address>
WinAppDeployCmd getcreds -credserver <server> -ip <address>
WinAppDeployCmd deletecreds -credserver <server> -ip <address>

Anda dapat menginstal atau menghapus instalan aplikasi di perangkat target, atau Anda dapat memperbarui aplikasi yang sudah diinstal. Untuk menyimpan data atau pengaturan oleh aplikasi yang sudah diinstal, gunakan opsi pembaruan alih-alih opsi penginstalan .

Tabel berikut menjelaskan perintah untuk WinAppDeployCmd.exe.

Perintah Deskripsi
devices Tampilkan daftar perangkat jaringan yang tersedia.
Instal Instal paket aplikasi UWP ke perangkat target.
update Perbarui aplikasi UWP yang sudah diinstal pada perangkat target.
list Tampilkan daftar aplikasi UWP yang diinstal pada perangkat target yang ditentukan.
uninstall Hapus instalan paket aplikasi yang ditentukan dari perangkat target.
deployfiles Salin aplikasi file longgar di jalur target ke jalur relatif jarak jauh di perangkat.
registerfiles Daftarkan aplikasi file yang longgar di direktori penyebaran jarak jauh.
addcreds Tambahkan kredensial ke Xbox untuk memungkinkannya mengakses lokasi jaringan untuk pendaftaran aplikasi.
getcreds Dapatkan kredensial jaringan untuk penggunaan target saat menjalankan aplikasi dari berbagi jaringan.
deletecreds Hapus kredensial jaringan yang digunakan target saat menjalankan aplikasi dari berbagi jaringan.

Tabel berikut menjelaskan opsi untuk WinAppDeployCmd.exe.

Perintah Deskripsi
-h (-bantuan) Tampilkan perintah, opsi, dan argumen.
-ip Alamat IP perangkat target.
-g (-membimbing) Pengidentifikasi unik dari perangkat target.
-d (-ketergantungan) (Opsional) Menentukan jalur dependensi untuk masing-masing dependensi paket. Jika tidak ada jalur yang ditentukan, alat mencari dependensi di direktori root untuk paket aplikasi dan direktori SDK.
-f (-file) Jalur file untuk paket aplikasi untuk menginstal, memperbarui, atau menghapus instalasi.
-p (-paket) Nama paket lengkap untuk paket aplikasi untuk dihapus. (Anda dapat menggunakan perintah daftar untuk menemukan nama lengkap untuk paket yang sudah diinstal pada perangkat)
-pin Pin jika diperlukan untuk membuat koneksi dengan perangkat target. (Anda akan diminta untuk mencoba kembali dengan opsi -pin jika otentikasi diperlukan)
-credserver Nama server kredensial jaringan untuk digunakan oleh target.
-credusername Nama pengguna kredensial jaringan untuk digunakan oleh target.
-credpassword Kata sandi kredensial jaringan untuk digunakan oleh target.
-connecttimeout Batas waktu dalam hitungan detik digunakan saat menghubungkan ke perangkat.
-remotedeploydir Jalur/nama direktori relatif untuk menyalin file ke perangkat jarak jauh; Ini akan menjadi folder penyebaran jarak jauh yang terkenal dan ditentukan secara otomatis.
-deleteextrafile Beralih untuk menunjukkan apakah file yang ada di direktori jarak jauh harus dibersihkan agar sesuai dengan direktori sumber.

Tabel berikut menjelaskan opsi untuk WinAppDeployCmd.exe.

Argumen Deskripsi
<x> Waktu habis dalam detik. (Default adalah 10)
<alamat> Alamat IP atau pengenal unik perangkat target.
<ab><> ... Jalur dependensi untuk setiap dependensi paket aplikasi.
<p> Pin alfa-numerik yang ditampilkan dalam pengaturan perangkat untuk membuat koneksi.
<jalan> Jalur sistem file.
<Nama> Nama paket lengkap untuk paket aplikasi untuk menghapus instalasi.
<peladen> Server pada jaringan file.
<nama pengguna> Pengguna untuk kredensial dengan akses ke server di jaringan file.
<kata sandi> Kata sandi untuk kredensial dengan akses ke server di jaringan file.
<remotedeploydir> Direktori pada perangkat relatif terhadap lokasi penyebaran

WinAppDeployCmd.exe contoh

Berikut adalah beberapa contoh cara menyebarkan dari baris perintah menggunakan sintaks untuk WinAppDeployCmd.exe.

Memperlihatkan perangkat yang tersedia untuk penyebaran. Perintah kali keluar dalam 3 detik.

WinAppDeployCmd devices 3

Menginstal aplikasi dari paket MyApp.appx yang ada di direktori Unduhan PC Anda ke perangkat Windows 10 dengan alamat IP 192.168.0.1 dengan PIN A1B2C3 untuk membuat koneksi dengan perangkat

WinAppDeployCmd install -file "Downloads\MyApp.appx" -ip 192.168.0.1 -pin A1B2C3

Menghapus paket yang ditentukan (berdasarkan nama lengkapnya) dari perangkat Windows dengan alamat IP 192.168.0.1. Anda dapat menggunakan perintah daftar untuk melihat nama lengkap paket apa pun yang diinstal pada perangkat.

WinAppDeployCmd uninstall -package Company.MyApp_1.0.0.1_x64__qwertyuiop -ip 192.168.0.1

Memperbarui aplikasi yang sudah diinstal pada perangkat Windows 10 dengan alamat IP 192.168.0.1 menggunakan paket aplikasi yang ditentukan.

WinAppDeployCmd update -file "Downloads\MyApp.appx" -ip 192.168.0.1

Menyebarkan file aplikasi ke PC atau Xbox dengan alamat IP 192.168.0.1 di folder yang sama dengan AppxManifest ke direktori app1_F5 di bawah jalur penyebaran perangkat.

WinAppDeployCmd deployfiles -file "C:\apps\App1\AppxManifest.xml" -remotedeploydir app1_F5 -ip 192.168.0.1

Mendaftarkan aplikasi di direktori app1_F5 di bawah jalur penyebaran PC atau Xbox di 192.168.0.1.

WinAppDeployCmd registerfiles -remotedeploydir app1_F5 -ip 192.168.0.1

Menggunakan WinAppDeployCmd untuk mengatur Run from PC deployment di Xbox One

Run from PC memungkinkan Anda untuk menyebarkan aplikasi UWP ke Xbox One tanpa menyalin binari, sebagai gantinya binari di-host pada berbagi jaringan pada jaringan yang sama dengan Xbox. Untuk melakukan ini, Anda memerlukan pengembang yang tidak terkunci Xbox One, dan aplikasi UWP file longgar pada drive jaringan yang dapat diakses Xbox.

Jalankan ini untuk mendaftarkan aplikasi:

WinAppDeployCmd registerfiles -ip <Xbox One IP> -remotedeploydir <location of app> -username <user for network> -password <password for user>

ex. WinAppDeployCmd register files -ip 192.168.0.1 -remotedeploydir \\driveA\myAppLocation -username admin -password A1B2C3