Windows-Geräteportal

Mit dem Windows Device Portal (WDP) können Sie Ihr Gerät remote über Ihr lokales Netzwerk konfigurieren und verwalten. Die Hauptfeatures werden auf der Übersichtsseite des Windows-Geräteportals dokumentiert.

Geräteportal home

Wichtig

Maker-Images dürfen nicht für gewerbliche Zwecke verwendet werden. Wenn du ein Gerät vermarkten möchtest, musst du aus Sicherheitsgründen eine benutzerdefinierte FFU-Datei verwenden. Weitere Informationen finden Sie hier.

Warnung

Der Live-Kernel-Debug ist derzeit für ARM-Geräte fehlgeschlagen. Wir arbeiten daran, dieses Problem zu beheben.

Wichtig

Wenn du ein offenes Einzelhandelsgerät für den kommerziellen Einsatz in einer „spezifischen/begrenzten Installation“ (z. B. einer Fabrik oder einem Einzelhandelsgeschäft) konstruierst, bei dem der Endbenutzer die endgültige Konfiguration vornimmt, und du gegenüber deinen Kunden dokumentierst, dass sie sich ein Zertifikat für WDP besorgen und es in beiden Browsern, WDP und dem verbindenden, installieren müssen, und dass die Kennwörter im WDP geändert werden, dann ist der Einsatz des WDP in dieser engen kommerziellen Instanz akzeptabel. Einzelhandelsbilder in diesem Szenario sollten weiterhin IOT_TOOLKIT enthalten, sollten aber das IOT_WEBBEXTN Paket verwenden, um WDP abzurufen.

Freigegebene Dokumentation

WDP ist ein Entwicklertool, das unter allen Windows 10 Geräten geteilt wird. Jedes Produkt verfügt über eigene einzigartige Features, aber die Kernfunktionalität ist identisch. Dokumentation zu den Hauptfeatures finden Sie auf der Übersichtsseite des Windows-Geräteportals. Der Rest der nachstehenden Dokumentation ist IoT-spezifisch.

Einrichtung

Es gibt zwei Möglichkeiten, das Windows-Geräteportal auf dem Laufenden zu halten.

1. Windows 10 IoT-Dashboard

Zuerst möchten Sie das Windows 10 IoT-Dashboard herunterladen, ein Entwicklertool, das das Einrichten neuer Geräte erleichtert. Nachdem Sie das Dashboard verwendet haben, um ein Windows 10 IoT Core Bild auf Ihrem Gerät zu flashen, überprüfen Sie, ob Ihr Gerät unter "Meine Geräte" angezeigt wird.

Verwenden Sie dort die Auslassungspunkte unter "Aktionen", um "In Geräteportal öffnen" auszuwählen. Von dort aus werden Sie zur Seite "Geräteportalauthentifizierung" weitergeleitet, auf der Sie die Anmeldeinformationen erst geändert haben, die Standardanmeldeinformationen sind:

    Username: Administrator
    Password: p@ssw0rd

2. Browser

Wenn Sie Ihr Gerät im Dashboard nicht finden oder das Dashboard überspringen möchten, können Sie das Geräteportal auch öffnen, indem Sie die IP-Adresse Ihres Geräts und :8080 am Ende eingeben. Wenn dies richtig geschehen ist, sollte es wie folgt aussehen:

IoTDashboard-Ansichtsgeräte

IoT-spezifische Features

Geräteeinstellungen

IoT Core fügt ein Kontrollkästchen hinzu, um die Bildschirmtastatur zu aktivieren oder zu deaktivieren.

Hinweis

Dieses Kontrollkästchen weist einen bekannten Fehler auf, bei dem es von aktiviert auf nicht aktiviert "blitzen" wird. Aktualisieren Sie die Seite (F5) nach dem Klicken, um sicherzustellen, dass das Kontrollkästchen Ihren gewünschten Zustand anzeigt.

Apps

Bietet Installations-/Deinstallationsfunktionen für AppX-Pakete und -Bündel auf Ihrem Gerät. App-Liste

IoT Core ist einzigartig darin, dass nur eine Vordergrund-App gleichzeitig ausgeführt werden kann. Die App-Liste wird geändert, um sicherzustellen, dass dies der Fall ist. Unter der Spalte "START " können Sie standardmäßig so viele Hintergrundanwendungen auswählen, aber nur eine Vordergrundanwendung festlegen.

App-Datei-Explorer

Der App-Datei-Explorer zeigt die Verzeichnisse an, auf die Ihre Apps zugreifen können.

  • CameraRoll wird für alle Apps freigegeben.
  • Dokumente werden für alle Apps freigegeben
  • LocalAppData enthält Ordner, die für jede App spezifisch sind. Dieser Ordner ist derselbe Name wie Ihre App, und andere Apps können nicht darauf zugreifen.

Debuggen

Kernelabbilder

Debuggen mit Kernelabbilden

Alle Systemabstürzen werden automatisch protokolliert und können über das Webverwaltungstool angezeigt werden. Anschließend können Sie das Kernelabbild herunterladen und versuchen, herauszufinden, was gerade passiert.

Prozessabbilder

Debuggen mit Prozessabbilden

Dies ähnelt Live-Kernelabbilds, aber für die Benutzermodusprozesse. Durch Klicken auf die Downloadschaltfläche wird ein "Minidump" verursacht, und der gesamte Zustand dieses Prozesses wird heruntergeladen. Dies eignet sich gut für das Debuggen hängender Prozesse.

Kernelabsturzeinstellungen

Kernelabsturzeinstellungen

Bluetooth

Auf dieser Seite werden alle bluetooth-gekoppelten Geräte und alle geräte angezeigt, die auffindbar sind. Um mit einem anderen Bluetooth-Gerät zu koppeln, platzieren Sie das Gerät im Kopplungsmodus, und warten Sie, bis es in der Liste der verfügbaren Geräte angezeigt wird.
Bluetooth-Geräteliste

Klicken Sie auf " Koppeln" , um das Gerät zu koppeln. Wenn das Gerät eine PIN für die Kopplung benötigt, wird ein Meldungsfeld mit der PIN angezeigt. Sobald das Gerät gekoppelt ist, wird es in der Liste der gekoppelten Geräte angezeigt. Sie können das Gerät entkoppeln, indem Sie auf "Entfernen" klicken.

Sobald Sie zur Bluetooth-Seite navigieren, kann Ihr Gerät von anderen Geräten erkannt werden. Sie können es auch von Ihrem PC/Smartphone finden und von dort aus koppeln.

Weitere Informationen zu Bluetooth finden Sie auf der Bluetooth-Seite.

IoT Onboarding

IoT Onboarding bietet Unterstützung für die Konfiguration der Wi-Fi Konnektivitätsoptionen eines IoT-Geräts.

Internetverbindungsfreigabe (Internet Connection Sharing, ICS) Mit der Internetverbindungsfreigabe können Sie den Internetzugriff Ihres Geräts mit anderen Geräten teilen, die mit Ihrem Gerät über die Wi-Fi SoftAP verbunden sind. Um dieses Feature zu verwenden, muss Ihr Windows 10 IoT-Gerät Zugriff auf das Internet haben (z. B. über eine kabelgebundene LAN-Verbindung). Klicken Sie in "Connectivity-Onboarding-SoftAP-Einstellungen>>" auf "Aktivieren", und legen Sie den SSID-Namen und das Kennwort fest. Wählen Sie dann in "Konnektivitäts-Internetverbindungsfreigabe>" für "Access Point Adapter" die Option "Microsoft Wi-Fi Direct Virtual Adapter #2" aus, und wählen Sie für "Freigegebener Netzwerkadapter" Ihren kabelgebundenen Ethernet-Adapter aus. Klicken Sie schließlich auf "Freigegebenen Zugriff starten". Verbinden Sie nach dem Start ein separates Wi-Fi aktiviertes Gerät mit dem SoftAP auf Ihrem Windows 10 IoT-Gerät. Nachdem eine Verbindung hergestellt wurde, kann Ihr separates Wi-Fi aktiviertes Gerät über Ihr Windows 10 IoT-Gerät eine Verbindung mit dem Internet herstellen.

Hinweis

ICS ist deaktiviert, wenn ein Wi-Fi Profil auf dem Gerät vorhanden ist. Beispielsweise wird ICS deaktiviert, wenn Sie eine Verbindung mit einem Wi-Fi Zugriffspunkt herstellen und "Profil erstellen (automatische Erneute Verbindung)" überprüfen.

SoftAP-Einstellungen Mit den SoftAP-Einstellungen können Sie steuern, ob das SoftAP Ihres Geräts aktiviert ist. Es bietet auch eine Möglichkeit zum Konfigurieren der SSID Ihrer SoftAP und des WPA2-PSK-Schlüssels, die erforderlich sind, um das SoftAP von einem anderen Gerät zu verbinden.

AllJoyn Onboarding-Einstellungen Mit den AllJoyn-Onboarding-Einstellungen können Sie steuern, ob die Wi-Fi Verbindung Ihres Geräts über den AllJoyn Onboarding Producer Ihres Geräts konfiguriert werden kann. Wenn ein separates Gerät, auf dem eine AllJoyn Onboarding Consumer-Anwendung ausgeführt wird, eine Verbindung mit Ihrem Windows 10 IoT SoftAP herstellt, kann die AllJoyn Onboarding Consumer-Anwendung verwendet werden, um den Wi-Fi Adapter Ihres IoT-Geräts zu konfigurieren. Wenn dies aktiviert ist, verwendet die AllJoyn Onboarding Producer-App (IoTOnboarding) die ECDHE_NULL-Authentifizierungsmethode.

Hinweis

Um AllJoyn Onboarding mit Windows 10 IoT-Builds 10.0.14393 oder früher zu verwenden, ist ein Update auf das IotOnboarding-Beispiel erforderlich, das hier heruntergeladen werden kann.

Onboarding auf AllJoynOnboarding auf ICS

Hinweis

Access Point Adapter ist der WLAN-Adapter, der als WLAN-Zugriffspunkt fungiert (normalerweise hat er eine IP-Adresse wie 192.168.137.1). Der freigegebene Netzwerkadapter ist der Adapter, der eine Verbindung mit dem Internet herstellt (z. B. Ethernet-Adapter).

Onboarding auf Soft AP

Hinweis

SoftAP SSID wird automatisch durch "AJ_" präfixiert, wenn das AllJoyn-Onboarding aktiviert und mit der MAC-Adresse des Wlan-Adapters postfixiert ist. Die SoftAP-Passphrase muss zwischen 8 und 63 ASCII-Zeichen bestehen.

TPM-Konfiguration

Das Trusted Platform Module (TPM) ist ein kryptografischer Coprocessor, einschließlich Funktionen für die Zufallszahlgenerierung, sichere Generierung von kryptografischen Schlüsseln und Einschränkung ihrer Verwendung. Sie umfasst auch Funktionen wie Remotebestätigung und versiegelte Speicher. Um über das TPM und die Sicherheit auf IoT Core zu erfahren, besuchen Sie die Seite " Sichere Geräte erstellen " und die TPM-Seite.

Wichtig

Limpet.exe verwendet, um Teil von Windows IoT Core zu sein. Ab Oktober 2018 ist es jetzt als Open Source Porject verfügbarhttps://github.com/ms-iot/iot-core-azure-dm-client.

Um tests einfacher zu machen, verfügen wir über eine nicht signierte vorab integrierte Version von Limpet.exe verfügbar und können direkt von WDP heruntergeladen werden. Sie müssen einfach auf die Registerkarte "TPM-Konfiguration" wechseln und auf die Schaltfläche "Neuestes Installieren" klicken.

Hinweis

Diese Version von Limpet.exe sollte nicht mit Ihrem Endprodukt geliefert werden. Stattdessen müssen Sie das Open Source Projekt erstellen, es signieren und mit Ihrem Bild verpacken.

Azure Clients-Konfiguration

IoT-Geräte können über Clouddienste remote verwaltet werden. Azure bietet eine umfangreiche Reihe von Diensten, um solche Szenarien zu aktivieren. Wir haben einen Geräteverwaltungsclient erstellt, der den Azure-Gerätebereitstellungsdienst (DPS) und den IoT Hub Dienst von Azure auf der Windows-Plattform ergänzt und auch mehrere Windows-Verwaltungsfunktionen verfügbar macht.

Die Clients werden als Open-Source-Projekte bereitgestellt. Um die Tests zu vereinfachen, werden wir vorab integrierte Binärdateien bereitstellen. Sie können die Registerkarte "Azure Clients" in WDP verwenden, um diese Test binärdateien zu installieren und auszuführen.

Hinweis

Diese Version der Tools sollte nicht mit Ihrem Endprodukt geliefert werden. Stattdessen müssen Sie das Open Source Projekt erstellen, es signieren und mit Ihrem Bild verpacken.

Wir werden diese Dokumentation aktualisieren, sobald die Open-Source-Projekte für den Verbrauch verfügbar sind.

Remote

Mit dem Windows IoT Remote Server können Benutzer sehen, was ihr Gerät anzeigt, ohne einen physischen Monitor mit der Tastatur zu verbinden.

Zusätzliche Informationen

Ändern des Standardports

  1. Starten Sie PowerShell, und stellen Sie eine Verbindung mit Ihrem Gerät her.
  2. Laden Sie das Tool "TakeRegistryOwnership" herunter, erstellen Sie es, und kopieren Sie sie auf Ihr Gerät.
  3. Übernehmen des Registrierungsschlüssels für den Dienst durch Ausführen
        .\TakeRegistryOwnership.exe MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\webmanagement\service
  1. Legen Sie den gewünschten Port fest, indem Sie die Registrierungseinstellungen ändern
        reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\webmanagement\service /v HttpPort /t REG_DWORD /d <your port number>
  1. Starten Sie den WebManagement-Dienst neu, indem Sie folgendes ausführen oder das Gerät neu starten
        net stop webmanagement ; net start webmanagement

Verwenden von HTTPS

Wenn Sie HTTPS verwenden möchten, übernehmen Sie zuerst den Registrierungsschlüssel wie im vorherigen Abschnitt beschrieben, und legen Sie die HttpsPort- und EncryptionMode-Registrierungsschlüssel wie unten fest, und starten Sie dann den Webdienst neu.

        reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\webmanagement\service /v EncryptionMode /t REG_DWORD /d 0x3 /f
        reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\webmanagement\service /v HttpsPort /t REG_DWORD /d <your port number> /f
        net stop webmanagement ; net start webmanagement

Bereitstellen des Geräteportals mit einem benutzerdefinierten SSL-Zertifikat

Im Windows 10 Creators Update hat das Windows-Geräteportal eine Möglichkeit für Geräteadministratoren hinzugefügt, ein benutzerdefiniertes Zertifikat für die Verwendung in der HTTPS-Kommunikation zu installieren.

Weitere Informationen finden Sie in der Dokumentation unter den Dokumentationen des Windows-Geräteportals.

Absturzabbildeinstellungen zum Erfassen des Speicherabbilds:

Gehen Sie wie folgt vor, um einen Vollständigen Speicherabbild zu erfassen:

  1. Stellen Sie eine Verbindung mit einem IoT-Gerät über WDP her.

  2. Aus Debug - Debugeinstellungen -> Kernelabsturzeinstellungen> -> Absturztyp - Absturzabbildtyp.

  3. Select: Complete memory dump (in use memory). Stellen Sie sicher, dass das Gerät neu gestartet wird, damit die Einstellung wirksam wird.

  4. Stellen Sie sicher, dass HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\CrashControl\CrashDumpEnabled sie auf 0x1 festgelegt ist.

  5. Aktualisieren HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\CrashControl\DumpFileSize Sie 0x0.

  6. Stellen Sie sicher, dass Sie genügend Speicherplatz auf dem Gerät haben, damit dieser Dump generiert werden kann. Sie können die Änderung des DumpFile-Speicherorts von hier aus konfigurieren: HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\CrashControl\DumpFile

Weitere Ressourcen


  1. Übersichtsseite für Windows Device Portal