Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Penyebaran Aplikasi Windows (WinAppDeployCmd.exe) adalah alat baris perintah yang dapat digunakan untuk menyebarkan aplikasi Universal Windows Platform (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).
Nota
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
Tabel berikut ini menjelaskan perintah untuk WinAppDeployCmd.exe.
| Perintah | Deskripsi |
|---|---|
| Perangkat | Tampilkan daftar perangkat jaringan yang tersedia. |
| pasang | Instal paket aplikasi UWP ke perangkat target. |
| pemutakhiran | Perbarui aplikasi UWP yang sudah diinstal pada perangkat target. |
| daftar | Tampilkan daftar aplikasi UWP yang diinstal pada perangkat target yang ditentukan. |
| hapus instalan | 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 | Mendaftarkan aplikasi file terpisah di direktori penempatan jarak jauh. |
| addcreds | Tambahkan kredensial ke Xbox untuk memungkinkannya mengakses lokasi jaringan untuk pendaftaran aplikasi. |
| getcreds | Saat menjalankan aplikasi dari jaringan berbagi, dapatkan kredensial jaringan untuk penggunaan target. |
| dihapus | Hapus kredensial jaringan yang digunakan target saat menjalankan aplikasi dari berbagi jaringan. |
Tabel berikut ini menjelaskan opsi untuk WinAppDeployCmd.exe.
| Perintah | Deskripsi |
|---|---|
| -h (-help) | Perlihatkan perintah, opsi, dan argumen. |
| -Ip | Alamat IP perangkat target. |
| -g (-guid) | Pengidentifikasi unik perangkat target. |
| -d (-dependency) | (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 berkas untuk paket aplikasi yang akan diinstal, diperbarui, atau dihapus instalasinya. |
| -p (-package) | Nama paket lengkap untuk aplikasi yang akan dicopot pemasangannya. (Anda dapat menggunakan perintah daftar untuk menemukan nama lengkap untuk paket yang sudah diinstal pada perangkat) |
| -PIN | Sebuah 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 yang 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. (Secara default, 10) |
| <alamat> | Alamat IP atau pengidentifikasi unik perangkat target. |
| < ><b> ... | Jalur dependensi untuk setiap dependensi paket aplikasi. |
| <p> | Pin alfanumerik yang dicantumkan dalam pengaturan perangkat untuk membangun koneksi. |
| <jalur> | Jalur direktori sistem. |
| <nama> | Nama paket lengkap untuk paket aplikasi yang akan dilepas instalannya. |
| <peladen> | Server pada jaringan file. |
| <nama pengguna> | Pengguna dengan kredensial untuk akses ke server dalam 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 melakukan deploy melalui 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 pengoperasian aplikasi dari PC ke Xbox One
Menjalankan dari PC memungkinkan Anda untuk menyebarkan aplikasi UWP ke Xbox One tanpa perlu menyalin biner. Sebagai gantinya, biner tersebut dihosting pada berbagi jaringan yang berada di jaringan yang sama dengan Xbox. Untuk melakukan ini, Anda memerlukan Xbox One yang dikembangkan sudah dibuka kuncinya, dan aplikasi UWP dengan file yang belum dikemas 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