Windows-Geräteportal für Desktop

Das Windows-Geräteportal (WDP) ist ein Tool zum Verwalten und Debuggen von Geräten, mit dem Sie Geräteeinstellungen konfigurieren und verwalten sowie Diagnoseinformationen über HTTP in einem Webbrowser anzeigen können. WDP-Details zu anderen Geräten finden Sie unter Übersicht über das Windows-Geräteportal.

Sie können das WDP für folgende Aufgaben verwenden:

• Verwalten von Geräteeinstellungen (ähnlich der Windows-Einstellungen-App)
• Anzeigen und Bearbeiten einer Liste laufender Prozesse
• Installieren, Löschen, Starten und Beenden von Apps
• Ändern von WLAN-Profilen und Anzeigen der Signalstärke und der ipconfig-Details
• Anzeigen von Live-Diagrammen zur Auslastung von CPU, Arbeitsspeicher, E/A, Netzwerk und GPU
• Sammeln von Prozesssicherungen
• Sammeln von ETW-Ablaufverfolgungen
• Bearbeiten des isolierten Speichers quergeladener Apps

Einrichten des Windows-Geräteportals auf einem Desktop-Gerät

Aktivieren des Entwicklermodus

Ab Windows 10, Version 1607, sind einige der neueren Funktionen für den Desktop nur verfügbar, wenn der Entwicklermodus aktiviert ist. Informationen zum Aktivieren des Entwicklermodus findest du unter Aktivieren Ihres Geräts für die Entwicklung.

Wichtig

In manchen Fällen wird der Entwicklermodus aufgrund von Problemen mit dem Netzwerk oder der Kompatibilität nicht ordnungsgemäß installiert. Lies den entsprechenden Abschnitt von „Aktivieren Sie Ihr Gerät für die Entwicklung”, um Hilfe bei der Behebung dieser Probleme zu erhalten.

Aktivieren des Windows-Geräteportals

Sie können WDP im Abschnitt Für Entwickler von Einstellungen („Einstellungen“ –> „Datenschutz und Sicherheit“ –> „Für Entwickler“) aktivieren. Wenn du es aktivierst, musst du auch einen entsprechenden Benutzernamen und ein Kennwort erstellen. Verwenden Sie nicht Ihr Microsoft-Konto oder andere Windows-Anmeldeinformationen.

Sobald das WDP aktiviert ist, werden unten im Abschnitt Links angezeigt. Beachten Sie die Portnummer am Ende der aufgeführten URLs: Diese Nummer wird zufällig generiert, wenn das WDP aktiviert ist, sollte aber zwischen den Neustarts des Desktops konsistent bleiben.

Diese Links bieten zwei Möglichkeiten, sich mit dem WDP zu verbinden: über das lokale Netzwerk (einschließlich VPN) oder über den lokalen Host. Sobald Sie eine Verbindung hergestellt haben, sollte es ungefähr so aussehen:

Deaktivieren des Windows-Geräteportals

Sie können das WDP im Bereich Für Entwickler unter Windows-Einstellungen deaktivieren.

Herstellen einer Verbindung mit dem Windows-Geräteportal

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

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

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

Sie können die Authentifizierungsoption deaktivieren, wenn Sie das WDP in einer geschützten Umgebung verwenden, z. B. in einem Testlabor, in dem Sie allen Benutzern im lokalen Netzwerk vertrauen, keine persönlichen Informationen auf dem Gerät gespeichert haben und eindeutige Anforderungen bestehen. Dies ermöglicht eine unverschlüsselte Kommunikation, und jeder, der die IP-Adresse deines Computers kennt, kann sich verbinden und ihn steuern.

Inhalt des Windows-Geräteportals

WDP stellt die folgenden Seiten bereit.

• App-Manager
• Xbox Live
• Datei-Explorer
• Ausgeführte Prozesse
• Leistung
• Debuggen
• ETW-Protokollierung (Event Tracing for Windows, Ereignisablaufverfolgung für Windows)
• Leistungsüberwachung
• Geräte-Manager
• Bluetooth
• Netzwerk
• Absturzdaten
• Features
• Mixed Reality
• Streaming Install-Debugger
• Position
• Entwurf

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

Im folgenden Video wird beschrieben, wie Sie MSIX-Apps mithilfe des Windows-Geräteportals remote testen und debuggen.

Weitere Optionen des Windows-Geräteportals

Die folgenden Abschnitte enthalten Details zu anderen Optionen im Windows-Geräteportal.

Registrierungsbasierte Konfiguration

Wenn Sie Portnummern für WDP auswählen möchten (z. B. 80 und 443), 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 den Wert auf 0 fest, um die von Ihnen ausgewählten Portnummern beizubehalten.
  • HttpPort: Ein erforderlicher DWORD-Wert. Enthält die Portnummer, die das WDP auf HTTP-Verbindungen überwacht.
  • HttpsPort: Ein erforderlicher DWORD-Wert. Enthält die Portnummer, die das WDP auf HTTPS-Verbindungen überwacht.

Unter dem gleichen regkey-Pfad kannst du 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 Weiterleitung von HTTP nach HTTPS.

Befehlszeilenoptionen für das Windows-Geräteportal

Über eine administrative Eingabeaufforderung können Sie Teile des WDPs aktivieren und konfigurieren. Um den neuesten Satz von Befehlen zu sehen, die von deinem Build unterstützt werden, kannst du webmanagement /? ausführen.

• sc start webmanagement oder sc stop webmanagement
  • Schalte den Dienst ein oder aus. Dazu muss ebenfalls der Entwicklermodus aktiviert sein.
• -Credentials <username> <password>
  • Legen Sie einen Benutzernamen und ein Kennwort für das WDP fest. Der Benutzername muss den Basic-Auth-Standards entsprechen, darf also keinen Doppelpunkt (:) enthalten und sollte aus Standard-ASCII-Zeichen wie z. B. [a-z, A-Z, 0-9] aufgebaut sein, da Browser standardmäßig nicht den gesamten Zeichensatz verarbeiten.
• -DeleteSSL
  • Dadurch wird der für HTTPS-Verbindungen verwendete SSL-Zertifikat-Cache zurückgesetzt. Wenn du auf TLS-Verbindungsfehler stößt, die nicht umgangen werden können (im Gegensatz zur erwarteten Zertifikatswarnung), kann diese Option das Problem für dich beheben.
• -SetCert <pfxPath> <pfxPassword>
  • Weitere Informationen finden Sie unter Bereitstellen eines Windows-Geräteportals mit einem benutzerdefinierten SSL-Zertifikat.
  • Auf diese Weise können Sie Ihr eigenes SSL-Zertifikat installieren, um die SSL-Warnseite zu reparieren, die normalerweise im WDP angezeigt wird.
• -Debug <various options for authentication, port selection, and tracing level>
  • Führen Sie eine eigenständige Version des WDPs mit einer bestimmten Konfiguration und sichtbaren Debugmeldungen aus. Dies ist besonders nützlich für die Erstellung eines gepackten Plugins.
  • Lies den Artikel im MSDN Magazine mit Details darüber, wie du es als „System” ausführen kannst, um dein gepacktes Plugin vollständig zu testen.

Problembehandlung

Im folgenden finden Sie einige häufige Fehler, die beim Einrichten des Windows-Geräteportals auftreten können.

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

Dieser Fehler kann auftreten, wenn du versuchst, die Entwicklerpakete in einem Vorabversionsbuild 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 vergewissern Sie sich, dass der Windows-Insider-Konto-Abschnitt die richtigen Kontoinformationen enthält. Wenn dieser Abschnitt nicht angezeigt wird, wähle Windows-Insider-Konto verknüpfen aus, füge dein E-Mail-Konto hinzu und bestätige, dass es in der Windows-Insider-Konto-Überschrift angezeigt wird (möglicherweise musst du Windows-Insider-Konto verknüpfen ein zweites Mal auswählen, um tatsächlich ein neu hinzugefügtes Konto zu verknüpfen).

2. Stelle unter Welche Inhalte möchten Sie erhalten? sicher, dass Aktive Entwicklung von Windows ausgewählt ist.

3. Stelle unter In welchem Intervall möchten Sie neue Builds erhalten? sicher, dass Windows-Insider: schnell ausgewählt ist.

4. Du solltest jetzt FoDs installieren können. Wenn du dich vergewissert hast, dass du mit „Windows-Insider: schnell“ arbeitest und die FoDs weiterhin nicht installieren kannst, gib bitte Feedback, und füge die Protokolldateien unter C:\Windows\Logs\CBS an.

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

Dieser Fehler wird möglicherweise angezeigt, wenn die Entwicklerpakete nicht installiert sind. Ohne die Entwicklerpakete gibt es keinen Webverwaltungsdienst. Versuche erneut, die Entwicklerpakete zu installieren.

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

Dieser Fehler wird möglicherweise angezeigt, wenn du über eine getaktete Internetverbindung verfügst. Du kannst die Entwicklerpakete nicht über eine getaktete Verbindung herunterladen.

Weitere Informationen

• Übersicht über das Windows-Geräteportal
• Referenz zur Kern-API des Windows-Geräteportals