Utilisation de XBOX PC Remote Tools
L’application XBOX PC Toolbox est en préversion. Téléchargez-la depuis le Microsoft Store sur Windows.
Configurer votre appareil de développement
- Sur votre appareil, téléchargez et installez XBOX PC Toolbox depuis le Microsoft Store sur Windows.
- Ouvrez l’application. Sélectionnez Set as development device, puis Continue.
-
Sélectionnez Install Tools pour ajouter les composants requis pour votre environnement.
En sélectionnant Install Tools, vous acceptez les conditions du contrat. Pour consulter les conditions, sélectionnez le lien sur l’écran d’installation.
- Après l’installation, sélectionnez la carte réseau à utiliser pour le canal sécurisé. Si votre système ne comporte qu’une seule carte, elle est sélectionnée automatiquement.
- Ajoutez une phrase secrète robuste pour protéger votre clé SSH. Conservez la phrase secrète en lieu sûr.
- Sélectionnez Confirm pour démarrer le processus de configuration de l’appareil.
- Une fois la configuration terminée, l’écran de l’espace de travail des appareils s’affiche.
Configurer votre appareil cible distant
Suivez les mêmes étapes que pour l’appareil de développement, avec les différences suivantes :- À l’étape 2, sélectionnez Set as a remote target device au lieu de l’appareil de développement.
-
Sélectionnez un type d’appareil :
- Fully Managed : active l’itération à distance et les fonctionnalités de gestion d’appareil par SSH.
- Lightweight : active les scénarios d’itération à distance (déploiement, lancement et arrêt) par HTTPS/TLS, sans nécessiter de configuration SSH.
- À l’étape 5, vous n’avez pas besoin de créer des clés SSH ni d’ajouter une phrase secrète sur l’appareil cible distant.
Gérer les modules complémentaires des appareils
Les modules complémentaires sont des composants facultatifs qui permettent des workflows de développement qui ne sont pas forcément nécessaires pour tous les projets. Une fois votre appareil configuré dans XBOX PC Toolbox, ces modules complémentaires deviennent disponibles. Activez le module complémentaire Windows Graphics Tools si vous déboguez ou profilez des graphismes DirectX ou l’API D3D. Windows Graphics Tools active la couche de débogage D3D et la validation basée sur le GPU sur votre appareil. Une fois ce module activé, vous pouvez utiliser des outils comme PIX pour effectuer des captures GPU, et toutes les erreurs de validation de l’API D3D sont signalées. Vous pouvez aussi activer ce module complémentaire par les Paramètres Windows en gérant les fonctionnalités facultatives. Toutefois, Toolbox fournit ce module complémentaire pour simplifier la configuration de votre appareil sans avoir à quitter l’application. Vous pouvez activer ou désactiver des modules complémentaires dans l’espace de travail des modules complémentaires en sélectionnant une seule option. Vous pouvez appliquer des modules complémentaires à votre PC de développement et à vos appareils Windows distants.Si vous rencontrez des difficultés pour désactiver un module complémentaire, assurez-vous que votre appareil Windows est à jour et redémarrez-le. Si le problème persiste, signalez-le par le Hub de commentaires.
Appairer vos appareils
-
Sur l’appareil cible distant : dans l’espace de travail, sélectionnez Pair device pour démarrer l’appairage.
-
Sur l’appareil cible distant : sélectionnez Start Pairing. L’application génère un code PIN et affiche les détails de connexion. Notez ces détails pour la configuration et le test de la connexion.
Vous disposez de deux minutes pour saisir le code PIN sur le PC de développement avant son expiration. - Sur l’appareil de développement : sur l’écran Device Workspace, sélectionnez Pair device.
- Sur l’écran Select device type, sélectionnez Fully Managed ou Lightweight pour l’appareil cible distant.
-
Sur l’écran Pair a new device, saisissez l’adresse IP ou le nom de l’appareil, le code PIN, le nom d’utilisateur et un surnom. Sélectionnez ensuite Pair device.
-
Sur l’appareil cible distant : lorsque l’appairage réussit, sélectionnez Return Home pour revenir à l’espace de travail. L’appareil est prêt pour des opérations sécurisées Fully Managed ou Lightweight.
-
Sur l’appareil de développement : pour finaliser la configuration des appareils Fully Managed, acceptez l’empreinte SSH. L’application ouvre un terminal et vous demande si vous voulez continuer. Tapez
yeset appuyez sur Entrée.Après la connexion, tapezexitet appuyez sur Entrée pour fermer la fenêtre. La fermeture à l’aide du bouton X peut entraîner des problèmes connus. - Sur l’appareil de développement : une fois le test de connexion terminé, un écran de réussite confirme que vos appareils sont appairés de façon sécurisée. Sélectionnez Return home pour revenir au Device Workspace et afficher vos appareils cibles distants appairés.
Désappairer des appareils
Pour gérer un appareil appairé, sélectionnez l’icône d’engrenage sur la carte de l’appareil dans l’espace de travail. À partir de là, vous pouvez :- Unpair device : supprimer l’appareil appairé de votre espace de travail.
- Rename device : modifier le nom d’affichage de l’appareil appairé.
- Edit connection settings : mettre à jour l’adresse IP ou d’autres détails de connexion de l’appareil appairé.
Désappairez depuis l’appareil cible distant. Lorsque vous désappairez depuis l’appareil cible distant, les clés SSH sont supprimées sur les deux appareils, ce qui garantit une déconnexion propre. Si vous désappairez depuis le PC de développement, l’appareil est supprimé uniquement de l’espace de travail local.
Utiliser Microsoft.XboxPC.DeviceManager (XDM)
Microsoft.XboxPC.DeviceManager (XDM) est un module PowerShell installé pendant la configuration. Il établit une communication sécurisée et chiffrée entre les PC de développement et les appareils distants. XDM gère l’acquisition des appareils, la configuration d’OpenSSH et la confiance, et il permet l’exécution de commandes à distance avec gestion de l’état des appareils.
Démarrer une session interactive
Sur votre PC de développement, accédez à l’espace de travail des appareils dans XBOX PC Toolbox. Recherchez la carte de l’appareil auquel vous voulez vous connecter et sélectionnez Connect. Cette action démarre une session interactive avec l’appareil distant par la communication à distance PowerShell dans un terminal de ligne de commande. Les commandes que vous exécutez ici s’exécutent sur l’appareil distant.
Provisionner les outils d’itération à distance
Utilisez les outils en ligne de commande wdRemote et wdEndpoint pour transférer des fichiers, déployer et gérer des jeux, et exécuter des outils sur des appareils Windows distants une fois que vous avez établi une connexion sécurisée à l’aide de XBOX PC Toolbox. Ces deux outils sont des exécutables autonomes installés lors de l’appairage.- wdRemote.exe : s’exécute sur le PC de développement et envoie des commandes.
- wdEndpoint.exe : s’exécute sur l’appareil cible distant et exécute les commandes.
Utiliser wdRemote
Ouvrez un terminal de ligne de commande sur votre PC de développement pour exécuter des commandeswdRemote.
Déployer un jeu
Lorsque vous spécifiez des chemins pour des machines distantes, utilisez des chemins relatifs au répertoire gameroot. Le répertoire racine du jeu estC:\%ProgramData%\Microsoft GDK\wdEndpoint\gameroot sur l’appareil cible distant.
Syntaxe :
Lancer un jeu
Syntaxe :Arrêter un jeu
Syntaxe :Envoyer des commentaires
Dans la barre de titre de XBOX PC Toolbox, sélectionnez Send Feedback. Sélectionnez ensuite Report a Problem.
- La version du système d’exploitation (build de Windows 10/11)
- La version de PowerShell (
$PSVersionTable) pour les problèmes liés àMicrosoft.XboxPC.DeviceManager - La configuration réseau (Wi-Fi/Ethernet, réseau d’entreprise/domestique)
- Les messages d’erreur (texte exact)
- Les étapes de reproduction
- L’outil que vous avez utilisé (XBOX PC Toolbox,
Microsoft.XboxPC.DeviceManager, wdRemote ou wdEndpoint) - La version de préversion que vous utilisez