Skip to main content
En août 2026, nous avons corrigé un problème qui provoquait des erreurs d’autorisation (HTTP 401) lors de la réinitialisation des données de joueur par XUID, même pour les comptes qui disposaient des autorisations Partner Center appropriées. Ce correctif a été apporté du côté des services XBOX (back end), il s’applique donc automatiquement. Vous n’avez pas besoin d’installer une nouvelle version du GDK, du package d’outils des services XBOX ni de l’outil lui-même. Si vous avez déjà rencontré cette erreur et l’avez contournée, ou si l’on vous a indiqué que vos autorisations Partner Center étaient mal configurées, vous pouvez réessayer l’outil en suivant les étapes ci-dessous. L’autorisation “Tools Access” décrite dans Réinitialisation par XUID demeure requise.
L’outil de réinitialisation des données de joueur peut être utilisé pour réinitialiser les données d’un joueur ou d’un groupe de joueurs dans les bacs à sable de test. Vous pouvez réinitialiser des données telles que les succès, les classements, les statistiques et l’historique des titres. Un compte individuel peut être réinitialisé à partir de son adresse courriel ou de son XUID. Pour réinitialiser par XUID, vous devez d’abord exécuter l’outil XblDevAccount.exe afin de vous connecter au compte Partner Center propriétaire du compte à réinitialiser. Pour réinitialiser à partir de l’adresse courriel du compte de test, vous devrez connaître le mot de passe du compte de test. L’outil ne réinitialise pas le stockage connecté d’un joueur (sauvegardes de jeu). Pour gérer le stockage connecté, voir Outil de stockage connecté (XblConnectedStorage.exe). Cet outil en ligne de commande fait partie du GDK et, séparément, du package d’outils des services XBOX. Pour savoir comment obtenir l’outil XblPlayerDataReset.exe, voir Outils de développement pour les services XBOX. Les options --xuid, --user et --file s’excluent mutuellement. Spécifiez exactement l’une d’entre elles, ainsi que --scid et --sandbox.

​
Réinitialisation par XUID

Pour utiliser l’outil de réinitialisation des données de joueur afin de réinitialiser un utilisateur par son XUID, le compte de développeur utilisé pour la connexion (avec XblDevAccount.exe) doit disposer de l’autorisation appropriée pour le produit en question. Notez que “Tools Access” n’est pas une autorisation au niveau du compte, mais une autorisation au niveau du produit. Vous devez donc accorder l’autorisation “Tools Access” pour chaque produit pour lequel vous voulez réinitialiser les données de joueur.
  1. Connectez-vous à Partner Center avec un compte de développeur disposant de privilèges d’administration.
  2. Accédez aux paramètres du compte => page Utilisateurs.
  3. Cliquez sur l’utilisateur ou le groupe qui a besoin de l’autorisation “Tools Access”.
  4. Si l’utilisateur ou le groupe est actuellement assigné à un rôle standard (comme Developer), vous devez passer à “Customize permissions”.
  5. Sur la page suivante, allez au tableau des autorisations “Product-level”, développez l’en-tête de tableau “XBOX Live” et repérez la colonne “Tools access”.
  6. Cochez explicitement cette case pour les produits ou groupes de produits auxquels vous voulez accorder l’autorisation “Tools Access”.
Une fois les autorisations configurées, les données du compte de test peuvent être réinitialisées comme suit :

​
Réinitialisation par adresse courriel

Pour réinitialiser à partir des adresses courriel des comptes de test, vous devrez connaître le mot de passe de chaque compte de test. Utilisez la commande ci-dessous, qui fera apparaître une fenêtre vous permettant de vous connecter en tant qu’utilisateur de test :

​
Réinitialisation par fichier

Pour réinitialiser par fichier, vous pouvez passer l’emplacement d’un fichier délimité de XUID, d’un fichier délimité de courriels ou d’une exportation de comptes Partner Center.
Pour un fichier délimité, l’outil inspecte la première ligne pour déterminer comment lire le fichier. Si cette ligne contient un caractère @, l’ensemble du fichier est traité comme une liste d’adresses courriel; sinon, il est traité comme une liste de XUID. N’incluez pas de ligne d’en-tête dans un fichier délimité, car elle est analysée comme un compte. Une exportation de comptes Partner Center est détectée automatiquement, mais uniquement si la ligne d’en-tête d’origine est présente et non modifiée :
Si vous ouvrez l’exportation dans un tableur et que vous l’enregistrez avec des colonnes réordonnées ou renommées, l’en-tête n’est plus reconnu et le fichier est alors lu comme un fichier délimité ordinaire.
Connectez-vous avec XblDevAccount.exe avant de lancer une réinitialisation à partir d’une exportation de comptes Partner Center. Lorsqu’un compte Partner Center est connecté, l’outil lit la colonne Xuid et réinitialise les comptes sans autre invite. Lorsqu’aucun compte n’est connecté, il se rabat sur la colonne Email et vous demande le mot de passe de chaque compte figurant dans le fichier.

​
Option de délimiteur

Vous pouvez éventuellement définir un délimiteur personnalisé pour les options --xuid et --user, ainsi que pour les fichiers délimités passés à --file. Le délimiteur par défaut est la virgule (,).
Seul le premier caractère de la valeur est utilisé. Si vous passez une valeur de plus d’un caractère, les caractères restants sont ignorés plutôt que traités comme un délimiteur à plusieurs caractères. Le délimiteur est ignoré lorsque le fichier passé à --file est une exportation de comptes Partner Center, car ce format est toujours séparé par des virgules.

​
Traitement des comptes

La façon dont les comptes sont traités dépend de l’option que vous utilisez. Lorsque vous réinitialisez par XUID, ou à partir d’un fichier qui se résout en XUID, les comptes sont traités par lots d’au plus 10. Les comptes d’un lot sont réinitialisés en parallèle, et les lots s’exécutent l’un après l’autre. Lorsque vous réinitialisez par adresse courriel, les comptes sont traités un à la fois, car chaque compte doit être connecté individuellement. Si un compte de test échoue à se connecter, l’outil s’arrête immédiatement et les comptes restants de la liste ne sont pas traités. Chaque compte fait automatiquement l’objet d’un maximum de cinq nouvelles tentatives avant d’être signalé comme ayant échoué, et l’outil attend que le service termine chaque réinitialisation avant de passer au suivant. Un seul compte peut donc prendre jusqu’à environ une minute avant de rapporter un résultat final. Laissez l’outil terminer plutôt que de l’annuler, surtout lorsque vous réinitialisez une longue liste.

​
Sortie

Que la commande réussisse ou échoue, vous verrez une sortie semblable à ce qui suit. Success
Error
Une réinitialisation peut également expirer. Une expiration signifie que l’outil a cessé d’attendre un résultat, et non que la réinitialisation a définitivement échoué. Le travail peut quand même se terminer dans le service.

​
Codes de sortie

L’outil renvoie 0 en cas de réussite et -1 en cas d’échec. Lorsque vous appelez l’outil à partir d’un script ou d’une passe de test automatisée, vérifiez le code de sortie plutôt que de vous fier au texte de la console.
L’outil renvoie également 0 dans deux cas où rien n’est réinitialisé : lorsqu’aucune des options --xuid, --user ou --file n’est spécifiée, et lorsque le fichier passé à --file ne peut pas être lu. Si votre automatisation vérifie uniquement le code de sortie, ces cas peuvent ressembler à une exécution réussie. Confirmez que la sortie comprend une ligne de résultat pour chaque compte que vous vous attendiez à réinitialiser.

​
Dépannage

​
Unable to authorize the account with XBOX Live

Ce message accompagne une erreur HTTP 401. Avant août 2026, un problème du côté du service provoquait cette erreur pour tous les développeurs effectuant une réinitialisation par XUID, y compris les développeurs dont les autorisations Partner Center étaient correctement configurées. Ce problème a été corrigé, et le correctif n’a pas nécessité de mise à jour de l’outil ni du GDK. Si vous voyez toujours cette erreur, confirmez que le compte connecté dispose de l’autorisation “Tools Access” pour le produit, comme décrit dans Réinitialisation par XUID, et que le SCID et le bac à sable correspondent au produit ciblé. Si vous avez récemment modifié des autorisations dans Partner Center, déconnectez-vous et reconnectez-vous avec XblDevAccount.exe afin qu’un nouveau jeton soit émis.

​
Your account doesn’t have access to perform the operation

Ce message accompagne une erreur HTTP 403. Accordez l’autorisation “Tools Access” pour le produit, comme décrit dans Réinitialisation par XUID.

​
Resetting by XUID requires a signed in Partner Center account

Exécutez XblDevAccount.exe signin avant de réinitialiser par XUID, ou avant de réinitialiser à partir d’une exportation de comptes Partner Center.

​
Failed to log in to test account

L’outil n’a pas pu se connecter au compte de test. Vérifiez l’adresse courriel et le mot de passe, et confirmez que le compte appartient au bac à sable que vous avez passé à --sandbox. L’outil s’arrête lorsque cela se produit, de sorte que les comptes restants de votre liste ne sont pas réinitialisés.
Dernière modification le 28 août 2026

Sujets connexes

Aperçu de Godot et des moteurs communautairesRépertoire des rubriques NDA : liens actifs vers Microsoft LearnRessources d'accessibilité pour les développeursInstaller la chaîne d'outils du GDKGlossaire des termes et acronymes du GDK