​

Guide FAQ et dépannage de XBOX PC Remote Tools

​

Questions fréquentes

​

Quelle est la différence entre les types d’appareil Fully Managed et Lightweight?

​

Où trouver le numéro de version de l’application?

​

Quels sont les problèmes connus, les dépendances et les limitations?

​

Problèmes connus

1. La configuration de PowerShell/DSC peut échouer, et XBOX PC Toolbox peut se fermer de façon inattendue pendant la configuration.
   • Solution de contournement : voir Le provisionnement PowerShell et DSC échoue pendant la configuration.
2. Appareils cibles joints à un domaine : seule l’authentification par mot de passe est prise en charge pour les connexions OpenSSH en mode Fully Managed (l’authentification par clé est préférable, mais n’est pas disponible). Le provisionnement Lightweight constitue une alternative pour les appareils joints à un domaine.
   • Remarque : ce problème concerne les appareils Windows Professionnel joints à un domaine utilisant le mode Fully Managed. L’équipe travaille avec les équipes OpenSSH et Microsoft Entra ID sur de futures améliorations.
3. Erreurs de commandes WinGet (par exemple, winget search échoue)
   • Solution de contournement : redémarrez l’appareil cible. L’équipe produit examine ce problème.
4. Performances du débogueur Visual Studio : XBOX PC Remote Debugger n’est pas encore optimisé en matière de performances. Attendez-vous à des temps de débogage plus longs qu’en débogage local. Une version future améliorera les performances du débogueur.
5. XBOX PC Remote Debugger peut cesser de répondre après plusieurs itérations de débogage. Redémarrez votre appareil cible après environ 50 itérations.
   • Solution de contournement : redémarrez votre appareil cible, puis la session de débogage.

​

Dépendances et limitations

• Les deux appareils ont besoin d’un accès à Internet pendant la configuration.
• Les appareils doivent se trouver sur le même réseau local et pouvoir s’envoyer des pings.
• L’application XBOX PC Toolbox est uniquement disponible dans le bac à sable RETAIL. Assurez-vous que les appareils sont en mode RETAIL pour la télécharger depuis le Microsoft Store.
• Appareils pris en charge : Windows 10 ou Windows 11, éditions Famille ou Professionnel.
• Un accès physique aux deux appareils est requis pendant la configuration.
• Un accès administrateur est requis sur les deux appareils pour la configuration.
• Les appareils cibles joints à Microsoft Entra ID sont pris en charge uniquement par le provisionnement Lightweight. Le mode Fully Managed n’est pas disponible pour les appareils joints à Entra. L’application le détecte automatiquement et désactive l’option Fully Managed pendant la configuration.

​

Le désappairage depuis mon PC de développement déconnecte-t-il complètement l’appareil?

​

Comment trouver les informations de connexion de l’appareil?

# Open a PowerShell 7 terminal
$env:ComputerName  # Device name
$env:Username      # Username  
ipconfig           # IP address

​

Comment vérifier les modifications de configuration sur les appareils?

# Open a PowerShell 7 terminal on the DevPC
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\devPC.dsc.yaml"

# Network (usable on either device)  
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\network.dsc.yaml"

# Open a PowerShell 7 terminal on TargetDevice
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\targetDevice.dsc.yaml"

​

Comment vérifier et changer le bac à sable?

​

Comment sélectionner une carte réseau spécifique pour la configuration du canal sécurisé?

​

Comment signaler un problème?

• La version du système d’exploitation (build de Windows 10/11)
• La version de PowerShell ($PSVersionTable) pour les problèmes liés à XBOX Device Management PowerShell Module
• 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, XBOX Device Management PowerShell Module, wdRemote ou wdEndpoint)
• La version de préversion

​

Quelle est la différence entre XBOX Device Management PowerShell Module (XDM) et wdRemote/wdEndpoint ?

• XDM : configure des canaux de communication sécurisés.
• wdRemote/wdEndpoint : déploie et lance des jeux par ces canaux.

​

Ai-je besoin à la fois de XDM et de wdRemote/wdEndpoint ?

​

Pourquoi exécuter wdEndpoint en tant qu’administrateur la première fois?

​

Puis-je déployer plusieurs jeux sur le même appareil cible?

​

Que se passe-t-il si la connexion réseau est interrompue pendant le déploiement?

​

Toutes les communications sont-elles chiffrées?

​

Quel outil utiliser pour chaque tâche?

• XBOX PC Toolbox : utilisez-le pour provisionner et acquérir des appareils à distance, configurer des canaux sécurisés, installer des dépendances et configurer des appareils.
• Tester la connectivité : utilisez XBOX PC Toolbox avant de déployer des jeux.
• Sessions à distance : utilisez les sessions à distance compatibles XDM et la communication à distance PowerShell pour exécuter des commandes sur l’appareil cible.
• wdRemote/wdEndpoint : utilisez ces outils pour déployer, tester et arrêter des jeux.

​

Puis-je utiliser ces outils avec n’importe quel jeu Windows?

​

Quels ports réseau ces outils utilisent-ils?

• XDM : SSH (port 22)
• wdEndpoint : HTTPS (port 4275)

​

Guide de dépannage

​

L’appairage échoue dans un environnement réseau d’entreprise

• Vérifiez que les deux appareils sont visibles l’un pour l’autre sur le réseau. Les pare-feu d’entreprise ou la segmentation du réseau peuvent bloquer la communication entre appareils.
• Assurez-vous que les ports suivants sont ouverts entre les appareils : port 22 (OpenSSH) et port 4275 (outils Remote Iteration).
• Déconnectez-vous de tout VPN avant de tenter l’appairage ou la connexion.
• Si votre organisation exige l’inscription des appareils, vérifiez que votre appareil est inscrit conformément à vos stratégies informatiques.

​

Erreur lors de l’installation des outils requis

• Solution de contournement : supprimez les répertoires des modules dans %onedrive%/Documents/PowerShell/Modules/ et réessayez.
• Cause : OneDrive peut interférer avec l’installation des modules PowerShell.

​

Le provisionnement PowerShell et DSC échoue pendant la configuration

• Ouvrez un terminal avec élévation de privilèges et exécutez :

winget uninstall Microsoft.PowerShell
winget uninstall Microsoft.DSC
winget install Microsoft.PowerShell --installer-type wix
winget install Microsoft.DSC --installer-type zip

• Si la configuration se bloque pendant l’installation de DSC après ces étapes, redémarrez XBOX PC Toolbox et réessayez.

​

Erreur OpenSSH : kex_exchange_identification: read: Connection reset

• Redémarrez l’appareil cible.
• Assurez-vous que l’appareil utilise un profil de réseau privé; sinon, le pare-feu risque de bloquer la connexion.
• Vérifiez que le fichier known_hosts de votre appareil local n’est pas endommagé.

​

L’installation de Microsoft PowerShell 7.5 par winget échoue (0x8A150049)

• Solution de contournement : désinstallez PowerShell 7.6 (inclus avec Visual Studio 2026). La version plus récente provoque des conflits d’installation.

​

L’exécution de winget par SSH échoue après l’appairage

• Solution de contournement : exécutez Repair-WinGetPackageManager sur l’appareil cible, ou redémarrez l’appareil cible.
• Cause : ce problème se produit sur les connexions SSH.

​

Le déploiement de jeux échoue sur les appareils portables

• Solution de contournement : ajustez les paramètres d’alimentation de l’appareil cible pour l’empêcher de se mettre en veille pendant le déploiement. Assurez-vous que le délai de mise en veille de l’appareil est défini sur une durée plus longue ou désactivé pendant le déploiement.
• Cause : XBOX PC Toolbox ne gère plus les paramètres d’alimentation des appareils par DSC. Sur les appareils portables dont le délai de mise en veille est court, l’appareil se met en veille en plein déploiement, ce qui fait échouer wdRemote.

​

L’appairage indique une réussite sur l’appareil cible distant, mais la connexion SSH échoue sur le PC de développement

Get-Service sshd

Restart-Service sshd

ssh -o IdentitiesOnly=yes -i "$env:USERPROFILE\.ssh\XboxPCDeviceManagerKey" -o PreferredAuthentications=publickey user@target-ip "echo SUCCESS"

• Si cette commande réussit, ssh-agent met en cache des clés incorrectes. Suivez les étapes ci-dessous pour corriger le problème.
• Si cette commande échoue, le problème se situe du côté de l’appareil cible distant. Pour approfondir le diagnostic, voir Comment collecter les journaux OpenSSH.

# Clear all cached keys
ssh-add -D

# Restart the agent service
Restart-Service ssh-agent

# Re-add only the correct key
ssh-add "$env:USERPROFILE\.ssh\XboxPCDeviceManagerKey"

# Verify only your key is loaded
ssh-add -l

# Test the connection
ssh -o PreferredAuthentications=publickey user@target-ip "echo SUCCESS"

​

Comment collecter les journaux OpenSSH

1. Ouvrez le Bloc-notes en tant qu’administrateur.
2. Ouvrez le fichier C:\ProgramData\ssh\sshd_config.

3. Recherchez la section qui commence par # Logging et remplacez :
   # Logging
   #SyslogFacility AUTH
   #LogLevel INFO
   
   par :
   # Logging
   SyslogFacility LOCAL0
   LogLevel Debug3
   
4. Ouvrez un terminal PowerShell en tant qu’administrateur et redémarrez le service SSH :
   net stop sshd
   net start sshd
   
5. Reproduisez le problème dans l’application XBOX PC Toolbox.
6. Collectez les journaux dans C:\ProgramData\ssh\logs. Compressez le dossier dans un fichier .zip à partager avec l’équipe de développement.
7. Après avoir collecté les journaux, annulez les modifications effectuées à l’étape 3 (rajoutez # au début de chaque ligne) et redémarrez de nouveau le service SSH en suivant l’étape 4.

​

Voir aussi

• Utilisation de XBOX PC Remote Tools
• Guide de démarrage rapide de XBOX PC Remote Tools
• Vue d’ensemble de XBOX PC Remote Tools