Windows-Geräteportal für Desktop

Windows Device Portal (WDP) ist ein Geräteverwaltungs- und Debuggingtool, mit dem Sie Geräteeinstellungen konfigurieren und verwalten und Diagnoseinformationen über HTTP in einem Webbrowser anzeigen können. Informationen zu WDP auf anderen Geräten finden Sie unter Windows Übersicht über das Geräteportal.

Sie können den WDP für Folgendes verwenden:

• Verwalten von Geräteeinstellungen (ähnlich der Windows Einstellungs-App)
• Anzeigen und Bearbeiten einer Liste der ausgeführten Prozesse
• Installieren, Löschen, Starten und Beenden von Apps
• WLAN-Profile ändern, Signalstärke anzeigen und ipconfig-Details anzeigen
• Anzeigen von Livediagrammen von CPU, Arbeitsspeicher, E/A, Netzwerk und GPU-Nutzung
• Sammeln von Prozesssicherungen
• ETW-Ablaufverfolgungen sammeln
• Bearbeiten des isolierten Speichers quergeladener Apps

Einrichten Windows Geräteportals auf einem Desktopgerät

Der Entwicklermodus ist vor dem Aktivieren des Geräteportals erforderlich.

Aktivieren Windows Geräteportals

Sie können WDP im Abschnitt "Für Entwickler " der Einstellungen (Einstellungen > system > erweitert) aktivieren.

Sobald WDP aktiviert ist, werden die URIs unten im Abschnitt "Geräteportal" angezeigt. Notieren Sie sich die Portnummer, die am Ende der aufgelisteten URLs angefügt wurde: Diese Zahl wird zufällig generiert, wenn WDP aktiviert ist, sollte aber zwischen Neustarts des Desktops konsistent bleiben.

Diese Links bieten zwei Möglichkeiten zum Herstellen einer Verbindung mit WDP: über das lokale Netzwerk (einschließlich VPN) oder über den lokalen Host.

Deaktivieren Windows Geräteportals

Sie können WDP im Abschnitt "Für Entwickler" von Windows Einstellungen (Einstellungen > system > erweitert) deaktivieren.

Herstellen einer Verbindung mit Windows Geräteportal

Um eine Verbindung über den lokalen Host herzustellen, öffnen Sie ein Browserfenster, und geben Sie eine der hier angezeigten URIs ein (basierend auf dem verwendeten Verbindungstyp).

• Localhost: http://127.0.0.1:<PORT> oder http://localhost:<PORT>
• Lokales Netzwerk: https://<IP address of the desktop>:<PORT>

HTTPS ist für die Authentifizierung und sichere Kommunikation erforderlich.

Wenn Sie WDP in einer geschützten Umgebung verwenden, z. B. in einem Testlabor, in dem Sie jedem in Ihrem lokalen Netzwerk vertrauen, keine persönlichen Informationen auf dem Gerät haben und eindeutige Anforderungen haben, können Sie die Authentifizierungsoption deaktivieren. Dies ermöglicht unverschlüsselte Kommunikation und ermöglicht es jedem mit der IP-Adresse Ihres Computers, eine Verbindung herzustellen und zu steuern.

Windows Geräteportalinhalte

WDP stellt den folgenden Satz von Seiten bereit.

• App-Verwaltung
• Datei-Explorer
• Ausführen von Prozessen
• Performance
• Debug
• ETW (Ereignisablaufverfolgung für Windows)-Protokollierung
• Performanceverfolgung
• Geräte-Manager
• Bluetooth
• Netzwerk
• Absturzdaten
• Features
• Ort
• Scratch

Verwenden Windows Geräteportals zum Testen und Debuggen von MSIX-Apps

Das folgende Video beschreibt, wie MSIX-Apps mithilfe Windows Device Portal remote getestet und gedebuggt werden.

Weitere Windows Geräteportaloptionen

In den folgenden Abschnitten finden Sie Details zu anderen Windows Geräteportaloptionen.

Registrierungsbasierte Konfiguration

Wenn Sie Portnummern für WDP (z. B. 80 und 443) auswählen möchten, können Sie die folgenden Registrierungsschlüssel festlegen:

• Unter HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\Service
  • UseDynamicPorts: Ein erforderlicher DWORD-Wert. Legen Sie dies auf 0 fest, um die von Ihnen ausgewählten Portnummern beizubehalten.
  • HttpPort: Ein erforderlicher DWORD-Wert. Enthält die Portnummer, auf der WDP auf HTTP-Verbindungen lauscht.
  • HttpsPort: Ein erforderlicher DWORD-Wert. Enthält die Portnummer, auf der WDP auf HTTPS-Verbindungen lauscht.

Unter demselben Regkey-Pfad können Sie auch die Authentifizierungsanforderung deaktivieren:

• UseDefaultAuthorizer - 0 für deaktiviert, 1 für aktiviert.
  • Dies steuert sowohl die grundlegende Authentifizierungsanforderung für jede Verbindung als auch die Umleitung von HTTP zu HTTPS.

Befehlszeilenoptionen für Windows Geräteportal

Über eine Administrative Eingabeaufforderung können Sie Teile von WDP aktivieren und konfigurieren. Um den neuesten Satz von Befehlen anzuzeigen, die auf Ihrem Build unterstützt werden, können Sie ausführen webmanagement /?

• sc start webmanagement oder sc stop webmanagement
  • Aktivieren oder Deaktivieren des Diensts. Dies erfordert weiterhin, dass der Entwicklermodus aktiviert ist.
• -Credentials <username> <password>
  • Legen Sie einen Benutzernamen und ein Kennwort für WDP fest. Der Benutzername muss den Standardauthentifizierungsstandards entsprechen. Daher darf kein Doppelpunkt enthalten (:) und sollte aus standardmäßigen ASCII-Zeichen erstellt werden, z. B. [a-zA-Z0-9], da Browser den vollständigen Zeichensatz nicht standardmäßig analysieren.
• -DeleteSSL
  • Dadurch wird der SSL-Zertifikatcache zurückgesetzt, der für HTTPS-Verbindungen verwendet wird. Wenn Tls-Verbindungsfehler auftreten, die nicht umgangen werden können (im Gegensatz zur erwarteten Zertifikatwarnung), kann diese Option das Problem für Sie beheben.
• -SetCert <pfxPath> <pfxPassword>
  • Einzelheiten finden Sie unter Bereitstellung des Windows-Geräteportals mit benutzerdefiniertem SSL-Zertifikat.
  • Auf diese Weise können Sie Ihr eigenes SSL-Zertifikat installieren, um die SSL-Warnseite zu beheben, die in der Regel in WDP zu sehen ist.
• -Debug <various options for authentication, port selection, and tracing level>
  • Führen Sie eine eigenständige Version von WDP mit einer bestimmten Konfiguration und sichtbaren Debugmeldungen aus. Dies ist am nützlichsten für das Erstellen eines verpackten Plug-Ins.
  • Ausführliche Informationen dazu, wie Sie dieses Als System ausführen, um Ihr verpacktes Plug-In vollständig zu testen, finden Sie im MSDN Magazine-Artikel .

Troubleshooting

Nachfolgend finden Sie einige häufige Fehler, die beim Einrichten Windows Geräteportals auftreten können.

WindowsUpdateSearch gibt eine ungültige Anzahl von Updates zurück (0x800f0950)

Dieser Fehler tritt möglicherweise auf, wenn Sie versuchen, die Entwicklerpakete auf einem Vorabbuild von Windows zu installieren. Diese FoD-Pakete (Feature-on-Demand) werden auf Windows Update gehostet. Wenn du sie in Vorabversionsbuilds herunterlädst, musst du dich für das Flighting entscheiden. Wenn deine Installation nicht für das Flighting für die richtige Build-and-Ring-Kombination aktiviert ist, kann die Nutzlast nicht heruntergeladen werden. Überprüfe Folgendes gründlich:

1. Navigieren Sie zu Einstellungen > Update und Sicherheit > Windows-Insider-Programm, und bestätigen Sie, dass der Abschnitt Windows Insider-Konto Ihre korrekten Kontoinformationen enthält. Wenn dieser Abschnitt nicht angezeigt wird, wählen Sie ein Windows Insider-Konto verknüpfen, Ihr E-Mail-Konto hinzufügen und bestätigen, dass er unter der Überschrift Windows Insider-Kontos angezeigt wird (Möglicherweise müssen Sie ein Windows Insider-Konto ein zweites Mal verknüpfen, um ein neu hinzugefügtes Konto zu verknüpfen).

2. Vergewissern Sie sich unter Welche Art von Inhalten möchten Sie erhalten?, dass Aktive Entwicklung von Windows ausgewählt ist.

3. Unter In welchem Tempo möchten Sie neue Builds erhalten? stellen Sie sicher, dass Windows Insider Fast ausgewählt ist.

4. Sie sollten nun in der Lage sein, die FoDs zu installieren. Wenn Sie bestätigt haben, dass Sie sich auf Windows Insider Fast befinden und die FoDs immer noch nicht installieren können, geben Sie Bitte Feedback und fügen Sie die Protokolldateien unter C:\Windows\Logs\CBS an.

[SC] StartService: OpenService FAILED 1060: Der angegebene Dienst ist nicht als installierter Dienst vorhanden.

Möglicherweise wird dieser Fehler angezeigt, wenn die Entwicklerpakete nicht installiert sind. Ohne die Entwicklerpakete gibt es keinen Webdienst für die Webverwaltung. Versuchen Sie erneut, die Entwicklerpakete zu installieren.

CBS kann den Download nicht starten, da sich das System im getakteten Netzwerk befindet (CBS_E_METERED_NETWORK)

Dieser Fehler tritt möglicherweise auf, wenn Sie sich in einer getakteten Internetverbindung befinden. Sie können die Entwicklerpakete nicht über eine getaktete Verbindung herunterladen.

Siehe auch

• Übersicht über das Windows Geräteportal
• Windows Geräteportal–Kern-API-Referenz