Windows Device PortalWindows Device Portal

Le Windows Device Portal (WDP) vous permet de configurer et gérer votre appareil à distance sur votre réseau local.The Windows Device Portal (WDP) lets you configure and manage your device remotely over your local network. Les fonctionnalités principales sont documentées sur le page de vue d’ensemble de Windows Device PortalThe main features are documented on the Windows Device Portal overview page

Accueil du portail de périphérique

Important

N’utilisez pas d’images de fabricant pour la commercialisation.Do not use maker images for commercialization. Si vous commercialisez un appareil, vous devez utiliser un FFU personnalisé pour une sécurité optimale.If you are commercializing a device, you must use a custom FFU for optimal security. Pour en savoir plus, cliquez ici.Learn more here.

Avertissement

Débogage de noyau en direct est actuellement en échec pour les appareils ARM.Live kernel debug is currently failing for ARM devices. Nous nous efforçons de résoudre ce problème.We are working to get this fixed.

Important

Si vous créez un périphérique ouvert de vente au détail pour le déploiement commercial à une « installation spécifique/limité » (autrement dit, magasin d’usine ou de la vente au détail) où l’utilisateur final effectue la configuration finale et vous documenter vos clients qu’ils doivent obtenir une certificat pour WDP et installer sur WDP et navigateurs qui se connecte et le mot de passe sont modifiés sur WDP, puis l’utilisation de WDP dans cette instance commerciale étroite est acceptable.If you are building an open retail device for commercial deployment to a "specific/limited installation" (i.e. factory or retail store) where the end-user does the final configuration and you document your customers that they must obtain a certificate for WDP and install it on both WDP and connecting browsers and passwords are changed on WDP, then using WDP in this narrow commercial instance is acceptable. Images de vente au détail dans ce scénario doivent toujours pas incluent IOT_TOOLKIT, mais devez utiliser le package IOT_WEBBEXTN à extraire dans WDP.Retail images in this scenario should still not include IOT_TOOLKIT, but should use the IOT_WEBBEXTN package to pull in WDP.

Partager cette DocumentationShared Documentation

WDP est un outil de développement partagé entre tous les appareils Windows 10.WDP is a developer tool shared among all Windows 10 devices. Chaque produit possède ses propres fonctionnalités uniques, mais la fonctionnalité principale est le même.Each product has its own unique features, but the core functionality is the same. Documentation pour les principales fonctionnalités se trouvent sur le page de vue d’ensemble de Windows Device Portal.Documentation for the main features are found on the Windows Device Portal overview page. Le reste de la documentation ci-dessous sera IoT spécifique.The rest of the documentation below will be IoT specific.

ConfigurationSet up

Il existe deux façons d’obtenir le Windows Device Portal en cours d’exécution.There are two ways to go get the Windows Device Portal up and running.

1. Tableau de bord Windows 10 IoT1. Windows 10 IoT Dashboard

Tout d’abord, vous souhaitez télécharger le tableau de bord Windows 10 IoT, un outil de développement qui le rend facile à configurer de nouveaux appareils.First, you'll want to download the Windows 10 IoT Dashboard, a developer tool that makes it easy to set up new devices. Une fois que vous avez utilisé le tableau de bord pour flasher une image de Windows 10 IoT standard sur votre appareil, vérifiez que votre appareil s’affiche sous « Mes appareils ».Once you've used the Dashboard to flash a Windows 10 IoT Core image onto your device, check that your device shows up under "My devices".

À partir de là, utilisez le bouton de sélection sous « Actions » pour sélectionner « Ouvrir dans le périphérique portail ».From there, use the ellipses under "Actions" to select "Open in Device Portal". À partir de là, vous êtes dirigé vers la page de l’authentification de portail de l’appareil où, sauf si vous avez modifié les informations d’identification au départ, les informations d’identification par défaut sont :From there, you'll be taken to the Device Portal authentication page where, unless you changed the credentials initially, the default credentials are:

Username: `Administrator`<br/>
Password: `p@ssw0rd`

2. Navigateur2. Browser

Si vous ne pouvez pas retrouver votre appareil dans le tableau de bord ou préférez ignorer à l’aide du tableau de bord, vous pouvez également ouvrir le portail de l’appareil en saisissant l’adresse IP de votre appareil plu :8080 à la fin.If you cannot find your device in the dashboard or prefer to skip using the dashboard, you can also open the Device Portal by entering the IP address of your device plus :8080 onto the end. Lorsque vous avez terminé correctement, il doit ressembler à ceci :When done correctly, it should look something like this:

IoTDashboard afficher les appareils

Fonctionnalités spécifiques de IoTIoT specific features

Paramètres de l’appareilDevice Settings

IoT Core ajoute une case à cocher pour activer ou désactiver le clavier visuelIoT Core adds a checkbox to enable or disable the on-screen keyboard

Notes

Cette case à cocher a un bogue connu où il sera « flash » à partir de vérifié non vérifié.This checkbox has a known bug where it will "flash" from checked to non-checked. Actualisez la page (F5) après avoir cliqué sur pour vous assurer que la case à cocher affiche votre état souhaité.Please refresh the page (F5) after clicking to ensure that the checkbox is showing your desired state.

ApplicationsApps

Fournit les installer ou désinstaller des fonctionnalités pour les packages AppX et des offres groupées sur votre appareil.Provides install/uninstall functionality for AppX packages and bundles on your device. Liste d’applicationsApp list

IoT Core est unique car elle permet uniquement d’une application de premier plan exécuter en même temps.IoT Core is unique in that it only allows one foreground app to run at one time. La liste des applications est modifiée pour vous assurer que c’est le cas.The app list is modified to ensure that this is the case. Sous le démarrage colonne, vous pouvez sélectionner autant d’applications en arrière-plan à démarrer par défaut, mais ne peut définir une application de premier plan.Under the STARTUP column, you can select as many background applications to start by default, but can only set one foreground application.

Explorateur de fichiers de l’applicationApp File Explorer

L’Explorateur de fichiers d’application montre les répertoires que vos applications peuvent accéder.The app file explorer shows the directories that your apps can access.

  • CameraRoll est partagé entre toutes les applicationsCameraRoll is shared among all apps
  • Documents est partagé entre toutes les applicationsDocuments is shared among all apps
  • LocalAppData contient des dossiers spécifiques à chaque application.LocalAppData contains folders specific to each app. Ce dossier sera le même nom que votre application et d’autres applications ne peuvent pas y accéder.This folder will be the same name as your app and other apps cannot access it.

DébogageDebugging

Vidages du noyauKernel dumps

Débogage avec des dumps de noyau

Les blocages du système seront automatiquement consignées et peuvent être consultées via l’outil de gestion web.Any system crashes will automatically be logged and available to view through the web management tool. Vous pouvez télécharger l’image du noyau, puis essaient de deviner ce qui se passait.You can then download the kernel dump and try to figure out what's going on.

Vidages de processusProcess dumps

Débogage avec les vidages de processus

Cela est similaire aux vidages sur le noyau en direct, mais pour les processus en mode utilisateur.This is similar to Live kernel dumps, but for the user mode processes. En cliquant sur le télécharger bouton provoque un minidump' ', et l’état complet de ce processus sera téléchargé.Clicking the download button will cause a 'minidump', and the entire state of that process will be downloaded. Voici les avantages pour le débogage des processus de blocage.This is good for debugging hanging processes.

Paramètres de noyau sur incidentKernel crash settings

Paramètres de noyau sur incident

BluetoothBluetooth

Cette page affiche tous les périphériques bluetooth associé et tous les appareils qui peuvent être découverts.This page shows you all the bluetooth paired devices and all the devices which are discoverable. Pour coupler avec un autre périphérique Bluetooth, placez l’appareil dans le mode d’association et attendre qu’il apparaisse dans la liste de périphériques disponibles.To pair with another Bluetooth device, put the device in pairing mode and wait for it to appear in the available devices list.
Liste des appareils Bluetooth

Cliquez sur lien de la paire pour coupler l’appareil.Click on Pair link to pair the device. Si l’appareil nécessite un code confidentiel pour l’appairage, il s’affiche une boîte de message affichant le code confidentiel.If the device requires a PIN for pairing, it will pop-up a message box displaying the PIN. Une fois que l’appareil est associé, il s’affichera dans la liste d’appareils appariés.Once the device is paired, it will show up in the Paired devices list. Vous pouvez annuler-paire l’appareil en cliquant sur supprimer.You can un-pair the device by clicking on Remove.

Une fois que vous accédez à la page de Bluetooth, votre appareil sera détectable par d’autres appareils.Once you navigate to the Bluetooth page, your device will be discoverable by other devices. Vous pouvez également retrouver à partir de votre PC ou par téléphone et l’associer à partir de là.You can also find it from your PC/Phone and pair it from there.

Vous trouverez plus d’informations sur bluetooth sur le bluetooth page.More information on bluetooth can be found on the bluetooth page.

Intégration d’IoTIoT Onboarding

IoT Onboarding prend en charge pour la configuration des options de connectivité Wi-Fi d’un appareil IoT.IoT Onboarding provides support for configuring an IoT device's Wi-Fi connectivity options.

Partage de connexion Internet (ICS) le partage de connexion Internet vous permet de partager l’accès à Internet de votre appareil avec d’autres périphériques connectés à votre appareil via le Wi-Fi SoftAP.Internet Connection Sharing (ICS) Internet Connection Sharing allows you to share the Internet access of your device with other devices connected to your device over the Wi-Fi SoftAP. Pour utiliser cette fonctionnalité, vos appareils Windows 10 IoT doit avoir accès à internet (par exemple, via une connexion de réseau local câblée).To use this feature, your Windows 10 IoT Device needs to have access to the internet (e.g. through a wired LAN connection). Dans « connectivité -> d’intégration ->, cliquez sur paramètres de le SoftAP « activer » et définissez le nom SSID et le mot de passe.In 'Connectivity->Onboarding->SoftAP settings' click 'enable' and set SSID name and password. Dans « Connectivité -> Partage de connexion Internet » pour adaptateur de point d’accès, sélectionnez « Microsoft Wi-FI Direct virtuel carte #2 » et « adaptateur de réseau partagé » puis votre carte ethernet câblé.Then in 'Connectivity->Internet connection sharing' for 'access point adapter' select "Microsoft Wi-FI Direct Virtual Adapter #2" and for 'shared network adapter' select your wired ethernet adapter. Enfin, cliquez sur « Démarrer d’accès partagé ».Finally, click 'start shared access.' Une fois démarré, se connecter un appareil compatible Wi-Fi distinct à la SoftAP sur votre appareil Windows 10 IoT.Once started, connect a separate Wi-Fi enabled device to the SoftAP on your Windows 10 IoT device. Après l’établie d’une connexion de votre appareil compatible Wi-Fi distinct sera en mesure de se connecter à internet via votre appareil Windows 10 IoT.After a connection is established your separate Wi-Fi enabled device will be able to connect to the internet through your Windows 10 IoT device.

Notes

Partage de connexion Internet est désactivé lorsqu’un profil Wi-Fi existe sur l’appareil.ICS is disabled when a Wi-Fi profile exists on the device. Par exemple, ICS sera désactivé si vous vous connectez à un point d’accès Wi-Fi et consultez « Créer un profil (ré-connexion automatique) ».For example, ICS will be disabled if you connect to a Wi-Fi access point and check “Create profile (auto re-connect)”.

Paramètres de SoftAP le SoftAP paramètres vous permettent de contrôler les SoftAP de votre appareil est activé ou non.SoftAP Settings The SoftAP Settings allow you to control whether or not your device's SoftAP is enabled. Il fournit également un moyen pour la configuration de votre SoftAP SSID et la WPA2-PSK de clés qui sont nécessaire pour connecter le SoftAP à partir d’un autre appareil.It also provides a means for configuring your SoftAP's SSID and the WPA2-PSK key which are necessary to connect the SoftAP from another device.

Paramètres d’intégration de AllJoyn le AllJoyn d’intégration paramètres permettent de contrôler s’il faut ou non connexion de Wi-Fi de votre appareil peut configurés par le biais AllJoyn d’intégration producteur de votre appareil.AllJoyn Onboarding Settings The AllJoyn Onboarding Settings allow you to control whether or not your device's Wi-Fi connection can configured through your device's AllJoyn Onboarding Producer. Quand un appareil distinct exécutant un consommateur de l’intégration AllJoyn application se connecte à votre SoftAP de IoT Windows 10, l’application du consommateur de l’intégration de AllJoyn peut servir pour configurer l’adaptateur Wi-Fi de votre appareil IoT.When a separate device running an AllJoyn Onboarding Consumer application connects to your Windows 10 IoT SoftAP, the AllJoyn Onboarding Consumer application can be used to configure your IoT device's Wi-Fi adapter. Lorsque l’option est activée, l’application de producteur d’intégration de AllJoyn (IoTOnboarding) utilise la méthode d’authentification ECDHE_NULL.When enabled, the AllJoyn Onboarding Producer app (IoTOnboarding) uses the ECDHE_NULL authentication method.

Notes

Pour utiliser AllJoyn l’intégration avec Windows 10 IoT génère 10.0.14393 ou précédemment nécessite une mise à jour le IotOnboarding exemple qui peut être téléchargé ici.To use AllJoyn Onboarding with Windows 10 IoT builds 10.0.14393 or earlier requires an update to the IotOnboarding sample which may be downloaded here.

L’intégration sur AllJoyn l’intégration sur le partage de connexion InternetOnboarding onto AllJoyn Onboarding onto ICS

Notes

Adaptateur de point d’accès est la carte de Wi-Fi qui agissent comme un point d’accès Wi-Fi (elle a généralement une adresse IP comme 192.168.137.1).Access point adapter is the WiFi adapter that act as a WiFi access point (it usually has an IP address like 192.168.137.1). Carte de réseau partagé est la carte qui se connecte à Internet (par exemple : Carte Ethernet).Shared network adapter is the adapter that connects to Internet (e.g.: Ethernet adapter).

Intégrer sur le point d’accès de manière réversible

Notes

SoftAP SSID sera automatiquement précédé « AJ_ », si l’intégration AllJoyn est activée et avoir le suffixe avec l’adresse MAC de l’adaptateur Wi-Fi.SoftAP SSID will be automatically prefixed by "AJ_" if AllJoyn onboarding is enabled and postfixed with the MAC address of the Wifi adapter. La phrase secrète SoftAP doit comprendre entre 8 et 63 caractères ASCII.The SoftAP passphrase must be between 8 and 63 ASCII characters.

Configuration du module de plateforme sécuriséeTPM configuration

Le Module de plateforme sécurisée (TPM) est un coprocesseur chiffrement, y compris les fonctionnalités de génération de nombres aléatoires, la génération de clés de chiffrement sécurisée et la limitation de leur utilisation.The Trusted Platform Module (TPM) is a cryptographic coprocessor including capabilities for random number generation, secure generation of cryptographic keys and limitation of their use. Il inclut également des fonctionnalités telles que l’attestation distante et stockage sealed.It also includes capabilities such as remote attestation and sealed storage. Pour en savoir plus sur le module de plateforme sécurisée et la sécurité sur IoT Core, visitez le création de sécuriser les appareils page et le TPM page.To learn about the TPM and security on IoT Core, visit the Building secure devices page and the TPM page.

Important

Limpet.exe utilisé pour faire partie de Windows IoT Core.Limpet.exe used to be part of Windows IoT Core. À compter d’octobre 2018, il est désormais disponible en tant qu’un porject open source à https://github.com/ms-iot/azure-dm-client .Starting with October 2018, it is now available as an open source porject at https://github.com/ms-iot/azure-dm-client.

Pour faciliter le test, nous ont une version prédéfinie non signé de Limpet.exe disponible et peut être téléchargées directement à partir de WDP.To make testing easier, we have a non-signed pre-built version of Limpet.exe available and can be downloaded right from WDP. Vous devez simplement l’onglet « Configuration du module de plateforme sécurisée » et cliquez sur le bouton Installer plus récente.You just need to go the 'TPM Configuration' tab and click the 'Install Latest' button.

Notes

Cette version de Limpet.exe ne doit pas être fournie avec votre produit final.This version of Limpet.exe should not be shipped with your final product. Au lieu de cela, vous devez générer le projet open source, signez-le et empaqueter avec votre image.Instead, you need to build the open source project, sign it, and package it with your image.

Configuration de Clients AzureAzure Clients configuration

Appareils IoT peuvent être gérés à distance via les services de cloud.IoT devices can be remotely managed through cloud services. Azure fournit un ensemble très complet de services pour permettre de tels scénarios.Azure provides a very rich set of services to enable such scenarios. Nous avons créé un client de gestion de périphérique qui complète le service Device Provisioning Service (DPS d’Azure) et IoT Hub d’Azure sur la plateforme Windows et qui expose également plusieurs fonctionnalités de facilité de gestion de Windows.We have created a device management client that complements Azure's Device Provisioning Service (DPS) and Azure's IoT Hub service on the Windows platform and which also exposes several Windows manageability features.

Les clients seront fournies sous les projets open source.The clients will be provided as open source projects. Pour faciliter les tests, nous vous fournirons des fichiers binaires prédéfinis.To make testing them easier, we will be providing pre-built binaries. Vous pouvez utiliser l’onglet « Clients Azure » dans WDP pour installer et exécuter les fichiers binaires de test.You can use the 'Azure Clients' tab in WDP to install and run those test binaries.

Notes

Cette version des outils ne doit pas être fournie avec votre produit final.This version of the tools should not be shipped with your final product. Au lieu de cela, vous devez générer le projet open source, signez-le et empaqueter avec votre image.Instead, you need to build the open source project, sign it, and package it with your image.

Nous mettrons à jour de cette documentation une fois que les projets open source sont disponibles pour la consommation.We will update this documentation once the open source projects are available for consumption.

RemoteRemote

Le serveur à distance de Windows IoT permet aux utilisateurs de voir ce que leur appareil est affichant sans connexion d’un moniteur physique à l’aide du clavier.The Windows IoT Remote Server allows users to see what their device is displaying without connecting a physical monitor to the keyboard.

Informations supplémentairesAdditional Information

Modification du port par défautChanging the default port

  1. Lancez powershell et se connecter à votre appareil.Launch powershell and connect to your device.

  2. Télécharger TakeRegistryOwnership outil, générez-le et copiez-le sur votre appareil.Download TakeRegistryOwnership tool, build it, and copy it to your device.

  3. Prendre possession de la clé de Registre pour le service en exécutantTake ownership of the registry key for the service by running

     .\TakeRegistryOwnership.exe MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\webmanagement\service
    
  4. Définir le port souhaité en modifiant les paramètres du RegistreSet the desired port by modifying the registry settings

     reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\webmanagement\service /v HttpPort /t REG_DWORD /d <your port number>
    
  5. Redémarrez le service de gestion Web en exécutant suivant ou en redémarrant l’appareilRestart the WebManagement service by running following or by restarting the device

     net stop webmanagement ; net start webmanagement
    

À l’aide de HTTPSUsing HTTPS

Si vous souhaitez utiliser le protocole HTTPS, prendre tout d’abord la possession de la clé de Registre comme décrit dans la section précédente et définissez les clés de Registre HttpsPort et EncryptionMode comme indiqué ci-dessous et redémarrez le service de gestion WebIf you want to use HTTPS, first take the ownership of the registry key as described in previous section and set the HttpsPort and EncryptionMode registry keys as below and then restart the webmanagement service

    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

Portail des appareils de mise en service avec un certificat SSL personnaliséProvisoning Device Portal with a custom SSL certificate

Dans Windows 10 Creators Update, le Windows Device Portal ajouté un moyen pour les administrateurs de l’appareil installer un certificat personnalisé pour une utilisation dans les communications HTTPS.In the Windows 10 Creators Update, the Windows Device Portal added a way for device administrators to install a custom certificate for use in HTTPS communication.

Pour en savoir plus, lire la documentation de la documentation Windows Device Portal.To learn more, read the documentation under the Windows Device Portal docs.

Bloquer les paramètres de vidage pour capturer l’image mémoire :Crash Dump Settings for Capturing Memory Dump:

Pour capturer une image mémoire complète, procédez comme suit :To capture a Full Memory Dump, do the following:

  1. Se connecter à un appareil IoT via WDP.Connect to a IoT device through WDP.

  2. À partir de débogage -> Débogage -> Paramètres de paramètres de noyau sur incident -> type de vidage sur incident.From Debug -> Debug settings -> Kernel crash settings -> Crash dump type.

  3. Sélectionnez : Image mémoire complète (dans la mémoire de l’utilisation).Select: Complete memory dump (in use memory). Assurez-vous que l’appareil est redémarré pour que le paramètre prenne effet.Make sure the device is rebooted for the setting to take effect.

  4. Vérifiez que HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\CrashControl\CrashDumpEnabled est définie sur 0 x 1.Verify that HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\CrashControl\CrashDumpEnabled is set to 0x1.

  5. Mise à jour HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\CrashControl\DumpFileSize à 0 x 0.Update HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\CrashControl\DumpFileSize to 0x0.

  6. Assurez-vous que vous avez suffisamment d’espace sur l’appareil pour cette image doit être généré.Make sure you have enough space on the device for this Dump to be generated. Vous pouvez configurer la modification de l’emplacement du fichier de vidage à partir d’ici : HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\CrashControl\DumpFileYou can configure the changing the DumpFile location from here: HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\CrashControl\DumpFile

Ressources complémentairesAdditional Resources


  1. Page de vue d’ensemble de Windows Device PortalWindows Device Portal overview page