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 Windows Geräteportals dokumentiert.

Device Portal 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

Das Live-Kernel-Debug ist derzeit für ARM-Geräte fehlschlägt. 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 nicht IOT_TOOLKIT enthalten, sondern das IOT_WEBBEXTN Paket zum Abrufen in WDP verwenden.

Freigegebene Dokumentation

WDP ist ein Entwicklertool, das unter allen Windows 10 Geräten gemeinsam genutzt wird. Jedes Produkt verfügt über eigene einzigartige Features, aber die Kernfunktionen sind identisch. Dokumentation für die Hauptfeatures finden Sie auf der Übersichtsseite Windows Geräteportals. Der Rest der nachstehenden Dokumentation ist IoT-spezifischer.

Einrichten

Es gibt zwei Möglichkeiten zum Abrufen des Windows Geräteportals.

1. Windows 10 IoT-Dashboard

Zunächst möchten Sie das Windows 10 IoT-Dashboard herunterladen, ein Entwicklertool, das es einfach macht, neue Geräte einzurichten. Nachdem Sie das Dashboard zum Blitzen eines Windows 10 IoT Core Bilds auf Ihrem Gerät verwendet haben, ü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 zunächst 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 plus :8080 am Ende eingeben. Bei richtiger Arbeit sollte es wie folgt aussehen:

IoTDashboard View Devices

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 er auf nicht überprüfte Kontrollkästchen "blitzt". Aktualisieren Sie die Seite (F5), nachdem Sie auf das Kontrollkästchen geklickt haben, um sicherzustellen, dass das Kontrollkästchen Ihren gewünschten Zustand anzeigt.

Apps

Bietet Installations-/Deinstallationsfunktionen für AppX-Pakete und Bundles auf Ihrem Gerät. App list

IoT Core ist eindeutig, 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 der gleiche Name wie Ihre App und andere Apps können nicht darauf zugreifen.

Debuggen

Kernelabbildbilder

Debugging with kernel dumps

Alle Systemabstürzen werden automatisch protokolliert und verfügbar, um das Webverwaltungstool anzuzeigen. Sie können dann das Kernelabbild herunterladen und versuchen, herauszufinden, was gerade passiert.

Prozessabbildbilder

Debugging with process dumps

Dies ist ähnlich wie Live-Kernelabbilds, aber für die Benutzermodusprozesse. Durch Klicken auf die Schaltfläche " Download " wird ein "Minidump" verursacht, und der gesamte Zustand dieses Prozesses wird heruntergeladen. Dies ist gut für das Debuggen hängender Prozesse.

Kernel-Absturzeinstellungen

Kernel crash settings

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, legen Sie das Gerät im Kopplungsmodus fest, und warten Sie darauf, dass es in der Liste der verfügbaren Geräte angezeigt wird.
Bluetooth device list

Klicken Sie auf den Link "Paar", um das Gerät zu koppeln. Wenn das Gerät eine PIN für die Kopplung benötigt, wird ein Meldungsfeld angezeigt, das die PIN anzeigt. Sobald das Gerät gekoppelt ist, wird sie 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, wird Ihr Gerät von anderen Geräten erkannt. Sie können es auch aus Ihrem PC/Telefon finden und sie von dort aus koppeln.

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

IoT Onboarding

IoT Onboarding unterstützt die Konfiguration der Wi-Fi Konnektivitätsoptionen eines IoT-Geräts.

Internetverbindungsfreigabe (ICS) Mit der Internetverbindungsfreigabe können Sie den Internetzugriff Ihres Geräts mit anderen Geräten teilen, die mit Ihrem Gerät verbunden sind, über die Wi-Fi SoftAP. 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 "freigegebene Netzwerkadapter" Ihren kabelgebundenen Ethernetadapter aus. Klicken Sie schließlich auf "freigegebenen Zugriff starten". Verbinden Sie einmal ein separates Wi-Fi aktiviertes Gerät mit dem SoftAP auf Ihrem Windows 10 IoT-Gerät. Nachdem eine Verbindung eingerichtet 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 (automatisches Erneutes Verbinden)" überprüfen.

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

AllJoyn Onboarding Einstellungen Das AllJoyn Onboarding Einstellungen ermöglicht Es Ihnen, zu steuern, ob die Wi-Fi Verbindung Ihres Geräts über den AllJoyn Onboarding-Produzenten Ihres Geräts konfiguriert werden kann. Wenn ein separates Gerät, das eine AllJoyn Onboarding Consumer-Anwendung ausführt, 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. Bei der Aktivierung 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, erfordert ein Update für das IotOnboarding-Beispiel, das hier heruntergeladen werden kann.

Onboarding onto AllJoynOnboarding onto ICS

Hinweis

Access Point Adapter ist der Wlan-Adapter, der als WLAN-Zugriffspunkt fungiert (es verfügt in der Regel über eine IP-Adresse wie 192.168.137.1). Freigegebener Netzwerkadapter ist der Adapter, der eine Verbindung mit Internet herstellt (z. B. Ethernet-Adapter).

Onboard onto Soft AP

Hinweis

SoftAP SSID wird automatisch durch "AJ_" präfixiert, wenn das AllJoyn-Onboarding aktiviert und mit der MAC-Adresse des Wlan-Adapters behoben wird. 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 Windows IoT Core zu sein. Ab Oktober 2018 ist es jetzt als Open Source Porject verfügbarhttps://github.com/ms-iot/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 Device Portal 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 Windows Geräteportals.

Absturzabbild Einstellungen zum Erfassen des Speicherabbilds:

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

  1. Verbinden zu einem IoT-Gerät über WDP.

  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

Zusätzliche Ressourcen


  1. Übersichtsseite Windows Geräteportal