Menggunakan Host Generik dan Klien untuk Http Metadata Exchange

  • Artikel

Jika klien dan host tidak dapat bertukar metadata, maka host generik dan klien dapat diganti dengan host kustom dan klien untuk membantu memecahkan masalah. Jika alamat perangkat atau metadata perangkat tidak muncul di output Klien Debug WSD, maka alamat transportasi yang disediakan atau lingkungan jaringan mungkin menyebabkan kegagalan. Untuk informasi selengkapnya tentang host generik dan klien, lihat Alat Penelusuran Kesalahan.

Jika telah diverifikasi bahwa host generik dan klien dapat menyelesaikan pertukaran metadata WS-Discovery dan HTTP, maka prosedur diagnostik ini dapat dilewati dan pemecahan masalah dapat dilanjutkan dengan mengikuti prosedur dalam Menggunakan Pengelogan WinHTTP untuk Memverifikasi Dapatkan Lalu Lintas.

Jika host atau klien adalah aplikasi yang berjalan pada PC, host atau klien generik harus dijalankan dalam konteks keamanan yang sama dengan host atau klien yang sebenarnya. Misalnya, jika host atau klien aktual berjalan sebagai Administrator, maka host atau klien generik harus berjalan sebagai Administrator. Selain itu, jika host atau klien adalah perangkat mandiri, itu harus sepenuhnya digantikan oleh PC yang menjalankan host generik atau klien dalam konteks keamanan yang menjamin akses jaringan tak terbatas (misalnya, berjalan sebagai Administrator).

Untuk menggunakan host generik dan klien untuk memecahkan masalah pertukaran metadata HTTP

  1. Buka jendela wantian perintah.

  2. Jalankan perintah berikut: WSDDebug_host.exe /mode metadata /start

    Catatan

    Kotak dialog Pemberitahuan Keamanan Windows mungkin muncul. Jika demikian, klik Buka Blokir untuk mengizinkan Host Debug WSD berjalan.

     

    Perintah ini menghasilkan output yang mirip dengan yang berikut ini. Catat ID perangkat.

    WSDAPI Debug Host
Copyright (C) Microsoft Corporation 2007.  All rights reserved.
Device ID is urn:uuid:37f86d35-e6ac-4241-964f-1d9ae46fb366
Host metadata>

  3. Jalankan perintah berikut: WSDDebug_client.exe metadata /mode /hello off /resolve<id>. Ganti <id> dengan ID perangkat yang diidentifikasi di langkah 2.

    Catatan

    Kotak dialog Pemberitahuan Keamanan Windows mungkin muncul. Jika demikian, klik Buka Blokir untuk mengizinkan Klien Debug WSD berjalan.

     

Klien Debug WSD menghasilkan output yang mirip dengan yang berikut ini.

WSDAPI Debug Client
Copyright (C) Microsoft Corporation 2007.  All rights reserved.
Client ID is urn:uuid:0f571af7-6b0e-4daf-8054-f2233ac27910
Hello mode is disabled
Client metadata>
*****************************************************************************
Add at 02/28/07 15:16:51
+ EPR:
  + Address:                 urn:uuid:37f86d35-e6ac-4241-964f-1d9ae46fb366
+ Types:
    (wsdp) https://schemas.xmlsoap.org/ws/2006/02/devprof:Device
+ XAddrs:
  https://[::1]:5357/37f86d35-e6ac-4241-964f-1d9ae46fb366
+ Metadata version:          2
+ Instance ID:               1
+ Probe/Resolve tag:         WSDAPI debug_client
+ Remote transport address:  [::1]:3702
+ Local transport address:   ::1
+ Local interface GUID:      42133cd4-6a70-11db-bbc9-806e6f6e6963
Client metadata>
*****************************************************************************
Getting metadata for host at 02/28/07 15:16:51:
+ Endpoint reference:
  + Address:
    urn:uuid:37f86d35-e6ac-4241-964f-1d9ae46fb366
Using xAddr: https://[::1]:5357/37f86d35-e6ac-4241-964f-1d9ae46fb366
Client metadata>
*****************************************************************************
Metadata for host:
+ Endpoint reference:
  + Address:           urn:uuid:37f86d35-e6ac-4241-964f-1d9ae46fb366
Metadata section:
  + Dialect:
    https://schemas.xmlsoap.org/ws/2006/02/devprof/ThisDevice
  + Friendly name:
    [no lang]: Debugging Host
  + Firmware version:  1.0
  + Serial number:     00000000
Metadata section:
  + Dialect:
    https://schemas.xmlsoap.org/ws/2006/02/devprof/ThisModel
  + Manufacturer:
    [no lang]: Microsoft Corporation
  + Manufacturer URL:  https://www.microsoft.com/
  + Model names:
    [no lang]: Microsoft Debugging Host
  + Model number:      https://www.microsoft.com/
End of metadata
Client metadata>

Klien Debug WSD dapat menghasilkan banyak output di jaringan dengan banyak perangkat DPWS. Output dapat dialihkan ke file untuk analisis yang lebih mudah. Ketik nama> file log tee< di permintaan Klien Debug WSD untuk mengalihkan output ke file. Pengalihan output dapat dihentikan dengan mengetik log tee stop di prompt Klien Debug WSD.

Catat alamat referensi titik akhir (EPR). Alamat EPR ini harus cocok dengan ID perangkat yang diidentifikasi pada langkah 2 di atas. Selain itu, verifikasi bahwa Klien Debug WSD sepenuhnya mencetak metadata untuk perangkat. Metadata perangkat dimulai dengan Metadata for host dan diakhuhi dengan End of metadata.

Jika ID perangkat dan metadata perangkat muncul dengan benar di output Klien Debug WSD, kegagalan aplikasi kemungkinan tidak terkait dengan alamat transportasi yang disediakan, sistem operasi, atau lingkungan jaringan. Ganti host generik dan klien dengan host dan klien kustom, dan lanjutkan pemecahan masalah dengan mengikuti prosedur dalam Menggunakan Pengelogan WinHTTP untuk Memverifikasi Dapatkan Lalu Lintas.

Jika alamat perangkat dan metadata perangkat tidak muncul di output Klien Debug WSD, kegagalan dapat memiliki satu atau beberapa penyebab berikut:

  • Alamat transportasi yang diiklankan oleh host salah atau salah bentuk. Klien Debug WSD mencoba mendapatkan metadata perangkat dari URL yang disediakan dalam elemen XAddrs dari pesan ProbeMatches atau ResolveMatches . URL yang digunakan untuk pertukaran metadata muncul di output Klien Debug WSD, diawali dengan frasa Using xAddr. Contoh berikut menunjukkan XAddrs yang digunakan untuk pertukaran metadata dalam output Klien Debug WSD di atas.

    Using xAddr: https://[::1]:5357/37f86d35-e6ac-4241-964f-1d9ae46fb366

    Jika XAddrs yang disediakan tidak sesuai dengan aturan validasi XAddr, maka Klien Debug WSD tidak bisa mendapatkan metadata perangkat.

  • Aplikasi berjalan dalam konteks keamanan yang salah. Verifikasi bahwa aplikasi menggunakan kredensial yang benar dan bahwa klien dan host memiliki izin yang memadai untuk mengakses jaringan.

  • Konfigurasi firewall salah. Ikuti instruksi dalam Memeriksa Pengaturan Adapter dan Firewall untuk memverifikasi bahwa pengaturan Windows Firewall sudah benar dan tidak ada aturan lain yang menghilangkan paket. Klien dan host juga dapat disalin ke komputer "asli" (satu dengan penginstalan sistem operasi default yang belum pernah bergabung ke domain) untuk mencoba mereproduksi kegagalan.

  • Kebijakan IPSec memblokir aplikasi. Salin klien dan host ke komputer yang tidak tunduk pada kebijakan IPSec dan coba reproduksi kegagalan.

Prosedur Diagnostik WSDAPI

Mulai Menggunakan Pemecahan Masalah WSDAPI