Portail de périphériques Windows pour bureau

Windows Device Portal (WDP) est un outil de gestion et de débogage des appareils qui vous permet de configurer et de gérer les paramètres de l’appareil et d’afficher les informations de diagnostic sur HTTP à partir d’un navigateur web. Pour obtenir des détails sur WDP pour d’autres appareils, consultez la vue d’ensemble de Windows Device Portal.

Vous pouvez utiliser le WDP pour les éléments suivants :

  • Gérer les paramètres de l’appareil (comme dans l’application paramètres de Windows)
  • Afficher et manipuler une liste de processus en cours d’exécution
  • Installer, supprimer, lancer et arrêter des applications
  • Modifier les profils Wi-Fi, afficher la force du signal et afficher les détails ipconfig
  • Afficher les graphiques dynamiques de l’utilisation du processeur, de la mémoire, des E/S, du réseau et du GPU
  • collecter les vidages de processus ;
  • collecter les traces ETW ;
  • manipuler le stockage isolé des applications de version test chargée.

Configurer Windows Portail d’appareil sur un appareil de bureau

Le mode développeur est requis avant d’activer Device Portal.

Note

Pour obtenir des instructions sur l’activation du mode développeur, consultez Paramètres pour les développeurs.

Activer le Portail d’appareil Windows

Vous pouvez activer WDP dans la section Pour les développeurs de Paramètres (Paramètres > Système > Avancé).

Capture d’écran de la fenêtre Paramètres > avancés du système > qui montre la boîte de dialogue Installer Windows package en mode développeur après l’activation du portail d’appareil.

Une fois WDP activé, vous verrez des URI en bas de la section Portail d’appareil. Notez le numéro de port ajouté à la fin des URL répertoriées : ce nombre est généré de manière aléatoire lorsque WDP est activé, mais doit rester cohérent entre les redémarrages du bureau.

Capture d’écran de la fenêtre Paramètres > avancés du système > montrant les paramètres du portail d’appareil disponibles après avoir été activés.

Ces liens offrent deux façons de se connecter à WDP : sur le réseau local (y compris LE VPN) ou via l’hôte local.

Capture d’écran du portail d’appareil Windows

Désactiver le Portail des appareils Windows

Vous pouvez désactiver WDP dans la section For developers of Windows Settings (Settings > System > Advanced).

Se connecter au portail d’appareil Windows

Pour vous connecter via l’hôte local, ouvrez une fenêtre de navigateur et entrez l’une des URI affichées ici (en fonction du type de connexion que vous utilisez).

  • Localhost : http://127.0.0.1:<PORT> ou http://localhost:<PORT>
  • Réseau local : https://<IP address of the desktop>:<PORT>

HTTPS est requis pour l’authentification et la communication sécurisée.

Si vous utilisez WDP dans un environnement protégé, par exemple, dans un laboratoire de test, dans lequel vous faites confiance à tous sur votre réseau local, ne disposez pas d’informations personnelles sur l’appareil et avez des exigences uniques, vous pouvez désactiver l’option d’authentification. Cela permet une communication non chiffrée et permet à toute personne disposant de l’adresse IP de votre ordinateur de se connecter et de la contrôler.

contenu du portail d’appareil Windows

WDP fournit l’ensemble de pages suivant.

  • Gestionnaire d’applications
  • Explorateur de fichiers
  • Processus en cours d’exécution
  • Performance
  • Debug
  • journalisation ETW (traçage d’événements pour Windows)
  • Suivi des performances
  • Gestionnaire de périphériques
  • Bluetooth
  • Networking
  • Données d’incident
  • Features
  • Lieu
  • Scratch

Utilisation de Windows Device Portal pour tester et déboguer des applications MSIX

La vidéo suivante explique comment tester et déboguer des applications MSIX à distance à l’aide de Windows Device Portal.

Autres options de portail d’appareil Windows

Les sections suivantes fournissent des détails sur d’autres options Windows Device Portal.

Configuration basée sur le registre

Si vous souhaitez sélectionner des numéros de port pour WDP (par exemple, 80 et 443), vous pouvez définir les clés régulières suivantes :

  • Sous HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\Service
    • UseDynamicPorts : un DWORD obligatoire. Définissez cette valeur sur 0 pour conserver les numéros de port que vous avez choisis.
    • HttpPort : un DWORD obligatoire. Contient le numéro de port sur lequel WDP écoute les connexions HTTP.
    • HttpsPort : un DWORD obligatoire. Contient le numéro de port sur lequel WDP écoute les connexions HTTPS.

Sous le même chemin de clé de registre, vous pouvez également désactiver l’obligation d’authentification :

  • UseDefaultAuthorizer - 0 pour désactivé, 1 pour activé.
    • Cela contrôle à la fois l’exigence d’authentification de base pour chaque connexion et la redirection de HTTP vers HTTPS.

Options de ligne de commande pour le Portail des appareils Windows

À partir d’une invite de commandes d’administration, vous pouvez activer et configurer des composants de WDP. Pour afficher le dernier ensemble de commandes pris en charge sur votre build, vous pouvez exécuter webmanagement /?

  • sc start webmanagement ou sc stop webmanagement
    • Activez ou désactivez le service. Cela nécessite toujours l’activation du mode développeur.
  • -Credentials <username> <password>
    • Définissez un nom d’utilisateur et un mot de passe pour WDP. Le nom d’utilisateur doit être conforme aux normes d’authentification de base. Par conséquent, il ne peut pas contenir de deux-points (:) et doit être généré à partir de caractères ASCII standard, par exemple [ a-zA-Z0-9], car les navigateurs n’analysent pas le jeu de caractères complets de manière standard.
  • -DeleteSSL
    • Cela réinitialise le cache de certificat SSL utilisé pour les connexions HTTPS. Si vous rencontrez des erreurs de connexion TLS qui ne peuvent pas être ignorées (par opposition à l’avertissement de certificat attendu), cette option peut résoudre le problème pour vous.
  • -SetCert <pfxPath> <pfxPassword>
  • -Debug <various options for authentication, port selection, and tracing level>
    • Exécutez une version autonome de WDP avec une configuration spécifique et des messages de débogage visibles. Cela est le plus utile pour créer un plug-in empaqueté.
    • Consultez l’article de MSDN Magazine pour savoir comment exécuter ce plug-in en tant que System afin de tester entièrement votre plug-in empaqueté.

Résolution des problèmes

Voici quelques erreurs courantes que vous pouvez rencontrer lors de la configuration de Windows Portail d’appareil.

WindowsUpdateSearch retourne un nombre non valide de mises à jour (0x800f0950)

Vous pouvez obtenir cette erreur lors de la tentative d’installation des packages de développeur sur une build de préversion de Windows. Ces packages Feature-on-Demand (FoD) sont hébergés sur Windows Update, et leur téléchargement sur des versions préliminaires nécessite que vous activiez le flighting. Si votre installation ne bénéficie pas de la distribution de version d’évaluation pour la version et la combinaison appropriées, la charge utile ne pourra pas être téléchargée. Vérifiez les éléments suivants :

  1. Accédez à Paramètres > Mise à jour et sécurité > Programme Windows Insider et vérifiez que la section compte Windows Insider contient les informations correctes de votre compte. Si vous ne voyez pas cette section, sélectionnez Lier un compte Insider Windows, ajoutez votre compte de messagerie et confirmez qu'il apparaît sous l'en-tête du compte Insider Windows (vous devrez peut-être sélectionner Lier un compte Insider Windows une deuxième fois pour lier réellement un compte nouvellement ajouté).

  2. Sous Quel type de contenu souhaitez-vous recevoir ?, vérifiez que le développement actif de Windows est sélectionné.

  3. Sous Quel rythme voulez-vous obtenir de nouvelles builds ?, assurez-vous que Windows Insider Fast est sélectionné.

  4. Vous devriez maintenant pouvoir installer les FoDs. Si vous avez confirmé que vous utilisez la version Fast de Windows Insider et que vous ne pouvez toujours pas installer les FoD, envoyez vos commentaires et joignez les fichiers journaux situés dans C:\Windows\Logs\CBS.

[SC] StartService : OpenService FAILED 1060 : le service spécifié n’existe pas en tant que service installé

Vous pouvez obtenir cette erreur si les packages de développement ne sont pas installés. Sans les packages de développement, il n’existe aucun service de gestion web. Réessayez d’installer les packages de développeur.

CbS ne peut pas démarrer le téléchargement, car le système est sur un réseau limité (CBS_E_METERED_NETWORK)

Vous pouvez obtenir cette erreur si vous êtes sur une connexion Internet limitée. Vous ne pourrez pas télécharger les packages de développeur sur une connexion limitée.

Voir aussi

  • Last updated on