Menginstal aplikasi dengan alat WinAppDeployCmd.exe
Windows Application Deployment (WinAppDeployCmd.exe) adalah alat baris perintah yang dapat digunakan untuk menyebarkan aplikasi Platform Windows Universal (UWP) dari PC Windows 10 ke perangkat Windows 10 apa pun. Anda dapat menggunakan alat ini untuk menyebarkan paket aplikasi saat perangkat Windows 10 terhubung oleh USB atau tersedia di subnet yang sama tanpa memerlukan Microsoft Visual Studio atau solusi untuk aplikasi tersebut. Anda juga dapat menyebarkan aplikasi tanpa pengemasan terlebih dahulu ke PC jarak jauh atau Xbox One. Artikel ini menjelaskan cara menginstal aplikasi UWP menggunakan alat ini.
Anda hanya perlu menginstal Windows 10 SDK untuk menjalankan alat WinAppDeployCmd dari prompt perintah atau file skrip. 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 penginstalan Anda untuk SDK).
Catatan
Di SDK versi 15063 dan yang lebih baru, SDK diinstal berdampingan dalam folder khusus versi. SDK sebelumnya (sebelum dan termasuk 14393) ditulis langsung ke folder induk.
Pertama, sambungkan perangkat Windows 10 Anda ke subnet yang sama atau sambungkan langsung ke komputer Windows 10 Anda dengan koneksi USB. Kemudian gunakan sintaks dan contoh perintah ini nanti dalam 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 yang disimpan oleh aplikasi yang sudah diinstal, gunakan opsi pembaruan alih-alih opsi penginstalan .
Tabel berikut ini menjelaskan perintah untuk WinAppDeployCmd.exe.
| Perintah | Deskripsi |
|---|---|
| perangkat | Tampilkan daftar perangkat jaringan yang tersedia. |
| Instal | Instal paket aplikasi UWP ke perangkat target. |
| pembaruan | 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 pada perangkat. |
| registerfiles | Daftarkan aplikasi file 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. |
| dihapus | Hapus kredensial jaringan yang digunakan target saat menjalankan aplikasi dari berbagi jaringan. |
Tabel berikut ini menjelaskan opsi untuk WinAppDeployCmd.exe.
| Perintah | Deskripsi |
|---|---|
| -h (-bantuan) | Perlihatkan perintah, opsi, dan argumen. |
| -Ip | Alamat IP perangkat target. |
| -g (-guid) | Pengidentifikasi unik perangkat target. |
| -d (-dependensi) | (Opsional) Menentukan jalur dependensi untuk setiap dependensi paket. Jika tidak ada jalur yang ditentukan, alat mencari dependensi di direktori akar 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 dilepas instalannya. (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 autentikasi 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 detik yang digunakan saat menyambungkan ke perangkat. |
| -remotedeploydir | Jalur/nama direktori relatif untuk menyalin file ke pada 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 ini menjelaskan opsi untuk WinAppDeployCmd.exe.
| Argumen | Deskripsi |
|---|---|
| <x> | Waktu habis dalam detik. (Defaultnya adalah 10) |
| <alamat> | Alamat IP atau pengidentifikasi unik perangkat target. |
| <a><b> ... | 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 yang akan dilepas instalannya. |
| <server> | Server pada jaringan file. |
| <username> | Pengguna untuk kredensial dengan akses ke server pada jaringan file. |
| <kata sandi> | Kata sandi untuk kredensial dengan akses ke server pada jaringan file. |
| <remotedeploydir> | Direktori pada perangkat relatif terhadap lokasi penyebaran |
Contoh WinAppDeployCmd.exe
Berikut adalah beberapa contoh cara menyebarkan dari baris perintah menggunakan sintaks untuk WinAppDeployCmd.exe.
Menampilkan perangkat yang tersedia untuk penyebaran. Perintah kehabisan waktu 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 instalasi 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 pada 192.168.0.1.
WinAppDeployCmd registerfiles -remotedeploydir app1_F5 -ip 192.168.0.1
Menggunakan WinAppDeployCmd untuk menyiapkan Jalankan dari penyebaran PC di Xbox One
Jalankan dari PC memungkinkan Anda untuk menyebarkan aplikasi UWP ke Xbox One tanpa menyalin biner, sebaliknya biner dihosting pada berbagi jaringan di jaringan yang sama dengan Xbox. Untuk melakukan ini, Anda memerlukan pengembang membuka kunci 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
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk