Windows-apparaatportal voor bureaublad

Windows Device Portal (WDP) is een hulpprogramma voor apparaatbeheer en foutopsporing waarmee u apparaatinstellingen kunt configureren en beheren en diagnostische gegevens kunt weergeven via HTTP vanuit een webbrowser. Zie het overzicht van Windows Device Portal voor WDP-details op andere apparaten.

U kunt de WDP als volgt gebruiken:

• Apparaatinstellingen beheren (vergelijkbaar met de app Windows Instellingen)
• Een lijst met actieve processen bekijken en bewerken
• Apps installeren, verwijderen, starten en beëindigen
• Wijzig Wi-Fi profielen, bekijk signaalsterkte en zie ipconfig-details
• Livegrafieken weergeven van CPU-, geheugen-, I/O-, netwerk- en GPU-gebruik
• Procesdumps verzamelen
• ETW-traceringen verzamelen
• De geïsoleerde opslag van sideloadende apps bewerken

Windows-apparaatportal instellen op een desktopapparaat

De ontwikkelaarsmodus is vereist voordat u de apparaatportal inschakelt.

Windows-apparaatportal inschakelen

U kunt WDP inschakelen in de sectie Voor ontwikkelaars van Instellingen (Instellingen > systeem > geavanceerd).

Zodra WDP is ingeschakeld, ziet u URI's onder aan de sectie Apparaatportal. Noteer het poortnummer dat is toegevoegd aan het einde van de vermelde URL's: dit nummer wordt willekeurig gegenereerd wanneer WDP is ingeschakeld, maar moet consistent blijven tussen het opnieuw opstarten van het bureaublad.

Deze koppelingen bieden twee manieren om verbinding te maken met WDP: via het lokale netwerk (inclusief VPN) of via de lokale host.

Windows-apparaatportal uitschakelen

U kunt WDP uitschakelen in de sectie Voor ontwikkelaars van Windows Settings (Settings > System > Advanced).

Verbinding maken met Windows-apparaatportal

Als u verbinding wilt maken via de lokale host, opent u een browservenster en voert u een van de URI's in die hier worden weergegeven (op basis van het verbindingstype dat u gebruikt).

• Localhost: http://127.0.0.1:<PORT> of http://localhost:<PORT>
• Lokaal netwerk: https://<IP address of the desktop>:<PORT>

HTTPS is vereist voor verificatie en beveiligde communicatie.

Als u WDP gebruikt in een beveiligde omgeving, bijvoorbeeld in een testlab waarin u iedereen in uw lokale netwerk vertrouwt, geen persoonlijke gegevens op het apparaat hebt en unieke vereisten hebt, kunt u de verificatieoptie uitschakelen. Hierdoor is niet-versleutelde communicatie mogelijk en kan iedereen met het IP-adres van uw computer verbinding maken met en beheren.

inhoud van de apparaatportal Windows

WDP biedt de volgende set pagina's.

• Apps-beheer
• Verkenner
• Actieve processen
• Performance
• Debug
• ETW-logboekregistratie (gebeurtenistracering voor Windows)
• Prestatieanalyse
• Apparaatbeheer
• Bluetooth
• Networking
• Crashgegevens
• Features
• Locatie
• Scratch

MsiX-apps testen en fouten opsporen met behulp van Windows Device Portal

In de volgende video wordt beschreven hoe u MSIX-apps op afstand kunt testen en fouten kunt opsporen met behulp van Windows Device Portal.

Meer opties voor Windows apparaatportal

In de volgende secties vindt u meer informatie over andere Windows opties voor de apparaatportal.

Configuratie op basis van register

Als u poortnummers wilt selecteren voor WDP (zoals 80 en 443), kunt u de volgende regkeys instellen:

• Onder HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\Service
  • UseDynamicPorts: Een vereiste DWORD. Stel dit in op 0 om de poortnummers te behouden die u hebt gekozen.
  • HttpPort: Een vereiste DWORD. Bevat het poortnummer waarop WDP luistert naar HTTP-verbindingen.
  • HttpsPort: Een vereiste DWORD. Bevat het poortnummer waarop WDP luistert naar HTTPS-verbindingen.

Onder hetzelfde registersleutelpad kunt u ook de authenticatievereiste uitschakelen:

• UseDefaultAuthorizer - 0 voor uitgeschakeld, 1 voor ingeschakeld.
  • Hiermee bepaalt u zowel de basisverificatievereiste voor elke verbinding als de omleiding van HTTP naar HTTPS.

Opdrachtregelopties voor Windows-apparaatportal

Vanaf een beheeropdrachtprompt kunt u onderdelen van WDP inschakelen en configureren. Als u de meest recente set opdrachten wilt zien die in uw build worden ondersteund, kunt u uitvoeren webmanagement /?

• sc start webmanagement of sc stop webmanagement
  • Schakel de service in of uit. Hiervoor moet de ontwikkelaarsmodus nog steeds worden ingeschakeld.
• -Credentials <username> <password>
  • Stel een gebruikersnaam en wachtwoord in voor WDP. De gebruikersnaam moet voldoen aan de standaardverificatiestandaarden, dus kan geen dubbele punt bevatten (:) en moet worden opgebouwd uit standaard ASCII-tekens, bijvoorbeeld [a-zA-Z0-9] omdat browsers de volledige tekenset niet op een standaard manier parseren.
• -DeleteSSL
  • Hiermee wordt de SSL-certificaatcache die wordt gebruikt voor HTTPS-verbindingen opnieuw ingesteld. Als er TLS-verbindingsfouten optreden die niet kunnen worden overgeslagen (in tegenstelling tot de verwachte certificaatwaarschuwing), kan dit probleem voor u worden opgelost.
• -SetCert <pfxPath> <pfxPassword>
  • Zie Inrichten Windows Device Portal met een aangepast SSL-certificaat voor meer informatie.
  • Hiermee kunt u uw eigen SSL-certificaat installeren om de SSL-waarschuwingspagina te herstellen die doorgaans wordt weergegeven in WDP.
• -Debug <various options for authentication, port selection, and tracing level>
  • Voer een zelfstandige versie van WDP uit met een specifieke configuratie en zichtbare foutopsporingsberichten. Dit is het meest nuttig voor het maken van een verpakte plug-in.
  • Zie het MSDN Magazine-artikel voor meer informatie over hoe u dit kunt uitvoeren als System om uw verpakte invoegtoepassing volledig te testen.

Probleemoplossingsproces

Hieronder vindt u enkele veelvoorkomende fouten die kunnen optreden bij het instellen van Windows Apparaatportal.

WindowsUpdateSearch retourneert een ongeldig aantal updates (0x800f0950)

Deze fout kan optreden wanneer u de ontwikkelaarspakketten probeert te installeren in een pre-release-build van Windows. Deze Feature-on-Demand-pakketten (FoD) zijn beschikbaar via Windows Update, en om ze te downloaden op pre-release-builds moet u deelnemen aan flighting. Als uw installatie niet is aangemeld voor het flightingprogramma voor de juiste build- en ringcombinatie, kan de payload niet worden gedownload. Controleer het volgende:

1. Ga naar Instellingen bijwerken & Beveiligings Windows Insider-programma en controleer of de sectie Windows Insider-account de juiste accountgegevens bevat. Als u deze sectie niet ziet, selecteert u Een Windows Insider-account koppelen, voegt u uw e-mailaccount toe en bevestigt u dat dit wordt weergegeven onder de kop Windows Insider-account (mogelijk moet u een Windows Insider-account een tweede keer koppelen om een nieuw toegevoegd account te koppelen).

2. Controleer onder Welk soort inhoud wilt u ontvangen? of Actieve ontwikkeling van Windows is geselecteerd.

3. Controleer onder Welk tempo wilt u nieuwe builds krijgen?, zorg ervoor dat Windows Insider Fast is geselecteerd.

4. U moet nu de FoD's kunnen installeren. Als u hebt bevestigd dat u op Windows Insider Fast bent en de FoD's nog steeds niet kunt installeren, kunt u feedback geven en de logboekbestanden bijvoegen onder C:\Windows\Logs\CBS.

[SC] StartService: OpenService FAILED 1060: De opgegeven service bestaat niet als een geïnstalleerde service

Deze fout kan optreden als de ontwikkelaarspakketten niet zijn geïnstalleerd. Zonder de ontwikkelaarspakketten is er geen webbeheerservice. Installeer de ontwikkelaarspakketten opnieuw.

CBS kan niet worden gedownload omdat het systeem zich op een netwerk met datalimiet bevindt (CBS_E_METERED_NETWORK)

Deze fout kan optreden als u een internetverbinding met datalimiet gebruikt. U kunt de ontwikkelaarspakketten niet downloaden op een verbinding met datalimiet.

Zie ook

• Overzicht van Windows Device Portal
• Naslaginformatie over de core-API voor Windows Device Portal