Bagikan melalui


Gambaran umum Portal Perangkat Windows

Windows Device Portal (WDP) adalah server web yang disertakan dengan perangkat Windows yang memungkinkan Anda mengonfigurasi dan mengelola pengaturan untuk perangkat melalui jaringan atau koneksi USB (koneksi lokal juga didukung pada perangkat dengan browser web).

WDP juga menyediakan alat diagnostik tingkat lanjut untuk pemecahan masalah dan melihat performa real time perangkat Windows Anda.

Fungsionalitas WDP secara terprogram diekspos melalui kumpulan REST API.

Artikel ini memberikan deskripsi umum tentang Portal Perangkat Windows dan menyertakan tautan ke artikel dengan informasi yang lebih spesifik tentang setiap keluarga perangkat Windows.

Nota

Keluarga perangkat mengidentifikasi API, karakteristik sistem, dan perilaku yang dapat Anda harapkan di seluruh kelas perangkat.

Pengaturan

Setiap keluarga perangkat menyediakan versi WDP, tetapi fitur dan penyiapan bervariasi berdasarkan persyaratan perangkat.

Ini adalah langkah-langkah dasar untuk semua perangkat.

  1. Aktifkan Mode Pengembang (Pengaturan - Sistem> -> Untuk pengembang).

    Cuplikan Layar Pengaturan - Sistem> -> Untuk jendela Pengembang yang memperlihatkan Mode Pengembang diaktifkan.

  2. Aktifkan Portal Perangkat di perangkat Anda (Pengaturan - Sistem> -> Untuk pengembang).

    Cuplikan layar jendela Pengaturan -> Sistem -> Untuk pengembang yang menampilkan pengaturan Device Portal yang tersedia setelah diaktifkan.

  3. Sambungkan perangkat dan PC Anda melalui jaringan lokal atau dengan USB.

  4. Navigasi ke halaman Portal Perangkat di browser Anda. Tabel ini memperlihatkan port dan protokol yang digunakan oleh setiap keluarga perangkat.

Tabel berikut ini menyertakan detail khusus perangkat untuk WDP.

Nota

Windows Mixed Reality berjalan pada desktop reguler, sehingga portalnya sama dengan Desktop.

Keluarga perangkat Aktif secara default? HTTP HTTPS USB Peraturan
Desktop dan IoT Enterprise Aktifkan di dalam Mode Dev 50080* 50043* N/A Portal Perangkat untuk Desktop atau perangkat IoT Enterprise
Xbox Aktifkan di dalam Mode Dev Disabilitas 11443 N/A Portal Perangkat untuk Xbox
HoloLens Ya, dalam Mode Dev 80 (default) 443 (default) http://127.0.0.1:10080 Portal Perangkat untuk HoloLens
IoT Core Ya, dalam Mode Dev 8080 Aktifkan melalui regkey N/A Portal Perangkat untuk IoT Core

* Ini tidak selalu terjadi, karena Portal Perangkat pada desktop mengklaim port dalam rentang sementara (>50.000) untuk mencegah tabrakan dengan klaim port yang ada pada perangkat. Untuk mempelajari selengkapnya, lihat bagian konfigurasi berbasis Registri di Windows Device Portal for Desktop.

Fitur

Toolbar dan navigasi

Toolbar di bagian atas halaman menyediakan akses ke fitur yang umum digunakan.

  • Power: Akses opsi daya.
    • Matikan: Mematikan perangkat.
    • Hidupkan ulang: Daya siklus pada perangkat.
  • Bantuan: Membuka halaman bantuan.

Gunakan tautan di panel navigasi di sepanjang sisi kiri halaman untuk menavigasi ke alat manajemen dan pemantauan yang tersedia untuk perangkat Anda.

Alat yang umum di seluruh keluarga perangkat dijelaskan di sini. Opsi lain mungkin tersedia tergantung pada perangkat. Untuk informasi selengkapnya, lihat halaman tertentu untuk jenis perangkat Anda.

Manajer aplikasi

Manajer Aplikasi menyediakan fungsi penginstalan/penghapusan instalasi dan manajemen untuk paket dan bundel aplikasi di perangkat host.

halaman manajer Aplikasi Portal Perangkat

  • Sebarkan aplikasi: Sebarkan aplikasi paket dari host lokal, jaringan, atau web dan daftarkan file longgar dari berbagi jaringan.
  • Aplikasi terinstal: Gunakan menu dropdown untuk menghapus atau memulai aplikasi yang diinstal pada perangkat.
  • Menjalankan aplikasi: Dapatkan informasi tentang aplikasi yang saat ini berjalan dan tutup seperlunya.

Menginstal aplikasi (sideload)

Anda dapat memuat samping aplikasi selama pengembangan menggunakan Portal Perangkat Windows:

  1. Setelah membuat paket aplikasi, Anda dapat menginstalnya dari jarak jauh ke perangkat Anda. Setelah Anda membuatnya di Visual Studio, folder output dibuat.

    penginstalan aplikasi

  2. Di Portal Perangkat Windows, buka halaman pengelola aplikasi.

  3. Di bagian Sebarkan aplikasi , pilih Penyimpanan Lokal.

  4. Di bawah Pilih paket aplikasi, pilih Cari File dan telusuri paket aplikasi yang ingin Anda unggah.

  5. Di bawah Pilih file sertifikat (.cer) yang digunakan untuk menandatangani paket aplikasi, pilih Pilih File dan telusuri ke sertifikat yang terkait dengan paket aplikasi tersebut.

  6. Centang kotak masing-masing jika Anda ingin menginstal paket opsional atau kerangka kerja bersama dengan penginstalan aplikasi, dan pilih Berikutnya untuk memilihnya.

  7. Pilih Instal untuk memulai penginstalan.

  8. Jika perangkat menjalankan Windows 10 dalam mode S, dan ini adalah pertama kalinya sertifikat yang diberikan telah diinstal pada perangkat, hidupkan ulang perangkat.

Menginstal sertifikat

Atau, Anda dapat menginstal sertifikat melalui Portal Perangkat Windows, dan menginstal aplikasi melalui cara lain:

  1. Di Portal Perangkat Windows, arahkan ke halaman manajer aplikasi.

  2. Di bagian Sebarkan aplikasi , pilih Instal Sertifikat.

  3. Di bawah Pilih file sertifikat (.cer) yang digunakan untuk menandatangani paket aplikasi, pilih Pilih File dan telusuri ke sertifikat yang terkait dengan paket aplikasi yang ingin Anda muat.

  4. Pilih Instal untuk memulai penginstalan.

  5. Jika perangkat menjalankan Windows 10 dalam mode S, dan ini adalah pertama kalinya sertifikat yang diberikan telah diinstal pada perangkat, hidupkan ulang perangkat.

Copot pemasangan aplikasi

  1. Pastikan aplikasi Anda tidak berjalan.
  2. Jika ya, buka Menjalankan aplikasi dan tutup. Jika Anda mencoba menghapus instalasi saat aplikasi berjalan, itu akan menyebabkan masalah saat Anda mencoba menginstal ulang aplikasi.
  3. Pilih aplikasi dari menu dropdown dan klik Hapus.

Menjalankan proses

Halaman ini memperlihatkan detail tentang proses yang saat ini berjalan pada perangkat host. Ini termasuk aplikasi dan proses sistem. Pada beberapa platform (Desktop, IoT, dan HoloLens), Anda dapat mengakhiri proses.

Portal Perangkat halaman Proses yang Sedang Berjalan

Penjelajah file

Halaman ini memungkinkan Anda untuk melihat dan memanipulasi file yang disimpan oleh aplikasi yang diinstal secara langsung. Lihat posting blog Menggunakan App File Explorer untuk mempelajari selengkapnya tentang File explorer dan cara menggunakannya.

halaman penjelajah berkas Portal Perangkat

Kinerja

Halaman Performa memperlihatkan grafik real time info diagnostik sistem seperti penggunaan daya, kecepatan bingkai, dan beban CPU.

Ini adalah metrik yang tersedia:

  • CPU : Persen dari total pemanfaatan CPU yang tersedia
  • Memori: Total, yang digunakan, tersedia, diterapkan, terhalaman, dan tidak terhalaman
  • I/O: Membaca dan menulis kuantitas data
  • Network: Menerima dan mengirim data
  • GPU : Persentase dari total pemanfaatan mesin GPU yang tersedia

halaman Performa Portal Perangkat

Pengelogan Pelacakan Peristiwa untuk Windows (ETW)

Halaman pengelogan ETW mengelola informasi Pelacakan Peristiwa real time untuk Windows (ETW) pada perangkat.

halaman pengelogan ETW Portal Perangkat

Centang Sembunyikan penyedia untuk menampilkan daftar Acara saja.

  • Penyedia terdaftar: Pilih penyedia peristiwa dan tingkat pelacakan. Tingkat pelacakan adalah salah satu nilai ini:

    1. Penghentian atau keluar secara abnormal
    2. Kesalahan parah
    3. Peringatan
    4. Peringatan tidak terkait kesalahan
    5. Jejak terperinci

    Klik atau ketuk Aktifkan untuk mulai melacak. Penyedia ditambahkan ke menu dropdown Penyedia Diaktifkan.

  • Penyedia kustom: Pilih penyedia ETW kustom dan tingkat pelacakan. Identifikasi penyedia dengan GUID-nya. Jangan sertakan tanda kurung dalam GUID.

  • Penyedia yang diaktifkan: Ini mencantumkan penyedia yang diaktifkan. Pilih penyedia dari menu dropdown dan klik atau ketuk Nonaktifkan untuk menghentikan pelacakan. Klik atau ketuk Hentikan semua untuk menangguhkan semua pelacakan.

  • riwayat Penyedia: Ini menunjukkan penyedia ETW yang diaktifkan selama sesi saat ini. Klik atau ketuk Aktifkan untuk mengaktifkan penyedia yang dinonaktifkan. Klik atau ketuk Hapus untuk menghapus riwayat.

  • Filter / Peristiwa: Bagian Peristiwa mencantumkan peristiwa ETW dari penyedia yang dipilih dalam format tabel. Tabel diperbarui secara real time. Gunakan menu Filter untuk menyiapkan filter kustom bagi peristiwa yang akan ditampilkan. Klik tombol Hapus untuk menghapus semua peristiwa ETW dari tabel. Ini tidak menonaktifkan penyedia apa pun. Anda dapat mengklik Simpan ke file untuk mengekspor peristiwa ETW yang saat ini dikumpulkan ke file CSV lokal.

Untuk informasi lebih lanjut tentang penggunaan logging ETW, lihat pada Menggunakan Portal Perangkat untuk melihat log debug tulisan blog.

Pelacakan kinerja

Windows Performance Toolkit menyertakan halaman pelacakan kinerja, yang memungkinkan Anda untuk melihat rekaman Windows Performance Recorder (WPR) dari perangkat host.

halaman pelacakan performa Portal Perangkat

  • Profil yang tersedia: Pilih profil WPR dari menu dropdown, lalu klik atau ketuk Mulai untuk memulai pelacakan.
  • Profil kustom: Klik atau ketuk Telusuri untuk memilih profil WPR dari PC Anda. Klik atau ketuk Unggah dan mulai untuk mulai melacak.

Untuk menghentikan jejak, klik Hentikan. Tetap di halaman ini hingga file pelacakan (. ETL) telah selesai mengunduh.

Ditangkap file ETL dapat dibuka untuk analisis di Windows Performance Analyzer.

Manajer perangkat

Halaman Manajer perangkat menghitung semua periferal yang terpasang pada perangkat Anda. Anda dapat mengklik ikon pengaturan untuk melihat properti masing-masing.

halaman manajer perangkat Portal Perangkat

Jaringan

Halaman Jaringan mengelola koneksi jaringan pada perangkat. Kecuali Anda terhubung ke Portal Perangkat melalui USB, mengubah pengaturan ini kemungkinan akan memutuskan sambungan Anda dari Portal Perangkat.

  • Jaringan yang tersedia: Menampilkan jaringan WiFi yang tersedia untuk perangkat. Mengklik atau mengetuk jaringan akan memungkinkan Anda untuk terhubung ke jaringan tersebut dan menyediakan kode akses jika diperlukan. Portal Perangkat belum mendukung Autentikasi Perusahaan. Anda juga dapat menggunakan dropdown Profil untuk mencoba terhubung ke salah satu profil WiFi yang dikenal perangkat.
  • konfigurasi IP: Menampilkan informasi alamat untuk setiap port jaringan pada perangkat host.

halaman Jaringan Portal Perangkat

Fitur dan catatan layanan

DNS-SD

Portal Perangkat mengiklankan kehadirannya di jaringan lokal menggunakan DNS-SD. Semua instans Portal Perangkat, terlepas dari jenis perangkatnya, beriklan di bawah "WDP._wdp._tcp.local". Catatan TXT untuk instans layanan menyediakan hal berikut:

Kunci Jenis Deskripsi
S Int Port aman untuk Portal Perangkat. Jika 0 (nol), Portal Perangkat tidak mendengarkan koneksi HTTPS.
D string Jenis perangkat. Ini akan dalam format "Windows.*", misalnya, Windows.Xbox atau Windows.Desktop
Sebuah tali Arsitektur perangkat. Ini akan menjadi Arm, x86, atau AMD64.
T daftar string yang dipisahkan oleh karakter null Tag yang diterapkan pengguna untuk perangkat. Lihat TAG REST API untuk cara menggunakannya. Daftar diakhiri dengan dua karakter null.

Menyambungkan pada port HTTPS disarankan, karena tidak semua perangkat mendengarkan port HTTP yang disebutkan dalam rekaman DNS-SD.

Perlindungan dan Pembuatan Skrip CSRF

Untuk melindungi dari serangan CSRF , token unik diperlukan pada semua permintaan non-GET. Token ini, yang berupa header permintaan X-CSRF-Token, berasal dari cookie sesi CSRF-Token. Di antarmuka pengguna web Portal Perangkat, cookie CSRF-Token disalin ke header X-CSRF-Token pada setiap permintaan.

Penting

Perlindungan ini mencegah penggunaan REST API dari klien mandiri (seperti utilitas baris perintah). Ini dapat diselesaikan dengan 3 cara:

  • Gunakan nama pengguna "otomatis". Klien yang menambahkan "otomatis" ke nama pengguna mereka akan melewati perlindungan CSRF. Penting bahwa nama pengguna ini tidak digunakan untuk masuk ke Portal Perangkat melalui browser, karena akan membuka layanan untuk serangan CSRF. Contoh: Jika nama pengguna Portal Perangkat adalah "admin", curl -u auto-admin:password <args> harus digunakan untuk melewati perlindungan CSRF.
  • Terapkan skema cookie-to-header di klien. Ini memerlukan permintaan GET untuk menetapkan cookie sesi, dan kemudian menyertakan baik header maupun cookie pada semua permintaan berikutnya.
  • Nonaktifkan autentikasi dan gunakan HTTP. Perlindungan CSRF hanya berlaku untuk titik akhir HTTPS, sehingga koneksi pada titik akhir HTTP tidak perlu melakukan salah satu hal di atas.

Perlindungan Pembajakan WebSocket Lintas Situs (CSWSH)

Untuk melindungi dari serangan CSWSH, semua klien yang membuka koneksi WebSocket ke Portal Perangkat juga harus menyediakan header Origin yang cocok dengan header Host. Ini membuktikan kepada Portal Perangkat bahwa permintaan berasal dari antarmuka pengguna Portal Perangkat atau aplikasi klien yang valid. Tanpa header Asal, permintaan Anda akan ditolak.

Lihat juga

referensi API inti Portal Perangkat