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, y compris pour les comptes disposant des autorisations correctes dans Partner Center. Ce correctif a été apporté au back-end des services XBOX ; 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éinitialiser par XUID reste 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 des sandbox de test. Vous pouvez réinitialiser des données telles que les succès, les classements, les statistiques et l’historique de titre. Un compte individuel peut être réinitialisé par son adresse e-mail ou son XUID. Pour réinitialiser par XUID, vous devez d’abord exécuter l’outil XblDevAccount.exe pour vous connecter au compte Partner Center propriétaire du compte à réinitialiser. Pour réinitialiser par l’adresse e-mail du compte de test, vous devez 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 Connected Storage (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 sont mutuellement exclusives. Spécifiez exactement l’une d’entre elles, avec --scid et --sandbox.

​
Réinitialiser 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 concerné. Notez que “Tools Access” n’est pas une autorisation au niveau du compte, c’est une autorisation au niveau du produit. Vous devez donc accorder l’autorisation “Tools Access” pour chacun des produits pour lesquels 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 affecté à un rôle standard (comme Developer), vous devez passer à “Customize permissions”.
  5. Sur la page suivante, accédez au tableau des autorisations “Product-level”, développez l’en-tête de tableau “XBOX Live” et trouvez la colonne “Tools access”.
  6. Cochez explicitement cette case pour les produits ou groupes de produits pour lesquels vous voulez accorder l’autorisation “Tools Access”.
Une fois les autorisations configurées, les données du compte de test peuvent alors être réinitialisées comme suit :

​
Réinitialiser par adresse e-mail

Pour réinitialiser par adresses e-mail de comptes de test, vous devez connaître le mot de passe de chaque compte de test. Utilisez la commande ci-dessous, qui affiche une fenêtre vous permettant de vous connecter en tant qu’utilisateur de test :

​
Réinitialiser par fichier

Pour réinitialiser par fichier, vous pouvez passer l’emplacement d’un fichier délimité de XUID, d’un fichier délimité d’adresses e-mail ou d’un export de comptes Partner Center.
Pour un fichier délimité, l’outil inspecte la première ligne pour décider comment lire le fichier. Si cette ligne contient un caractère @, l’ensemble du fichier est traité comme une liste d’adresses e-mail ; 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 serait analysée comme un compte. Un export de comptes Partner Center est détecté automatiquement, mais uniquement lorsque la ligne d’en-tête d’origine est présente et non modifiée :
Si vous ouvrez l’export dans un tableur et l’enregistrez avec des colonnes réordonnées ou renommées, l’en-tête n’est plus reconnu et le fichier est lu comme un fichier délimité ordinaire.
Connectez-vous avec XblDevAccount.exe avant de réinitialiser à partir d’un export 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 du 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 au lieu d’être traités comme un délimiteur à plusieurs caractères. Le délimiteur est ignoré lorsque le fichier passé à --file est un export 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 de 10 au maximum. Les comptes d’un même lot sont réinitialisés en parallèle, et les lots s’exécutent les uns après les autres. Lorsque vous réinitialisez par adresse e-mail, les comptes sont traités un par un, car chaque compte doit être connecté individuellement. Si la connexion d’un compte de test échoue, l’outil s’arrête immédiatement et les comptes restants de la liste ne sont pas tentés. Chaque compte fait automatiquement l’objet de jusqu’à cinq nouvelles tentatives avant d’être signalé comme échoué, et l’outil attend que le service termine chaque réinitialisation avant de continuer. Un seul compte peut donc prendre jusqu’à environ une minute pour rapporter un résultat final. Laissez l’outil se terminer plutôt que de l’annuler, surtout lorsque vous réinitialisez une longue liste.

​
Sortie

Si la commande réussit ou échoue, vous verrez une sortie semblable à celle indiquée ci-dessous. Success
Error
Une réinitialisation peut également expirer. Une expiration signifie que l’outil a cessé d’attendre un résultat, pas que la réinitialisation a nécessairement échoué. Le travail peut malgré tout 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 depuis un script ou 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 ne vérifie que le code de sortie, ces cas peuvent ressembler à une exécution réussie. Confirmez que la sortie inclut une ligne de résultat pour chaque compte que vous vous attendiez à réinitialiser.

​
Résolution des problèmes

​
Unable to authorize the account with XBOX Live

Ce message accompagne une erreur HTTP 401. Avant août 2026, un problème côté 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 nécessité aucune mise à jour de l’outil ni du GDK. Si vous voyez encore cette erreur, confirmez que le compte connecté dispose de l’autorisation “Tools Access” pour le produit, comme décrit dans Réinitialiser par XUID, et que le SCID et la sandbox correspondent au produit que vous ciblez. Si vous avez récemment modifié des autorisations dans Partner Center, déconnectez-vous puis 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éinitialiser 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’un export 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 e-mail et le mot de passe, et confirmez que le compte appartient à la sandbox que vous avez passée à --sandbox. L’outil s’arrête lorsque cela se produit ; les comptes restants de votre liste ne sont donc pas réinitialisés.
Dernière modification le 28 août 2026

Sujets connexes

Vue d'ensemble de Godot et des moteurs communautairesRépertoire des rubriques NDA : liens actifs vers Microsoft LearnVue d'ensemble de l'accessibilité GDKRessources d'accessibilité pour les développeursInstaller la chaîne d'outils du GDK