> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Outil de réinitialisation des données de joueur (XblPlayerDataReset.exe) > Outil en ligne de commande XblPlayerDataReset.exe qui réinitialise les succès, les classements, les statistiques et l'historique de titre d'un joueur ou d'un groupe dans les bacs à sable (sandbox) des services XBOX. 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](#reset-by-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)](/tools/tools-services/live-connected-storage-tool). 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](/tools/tools-services/live-tools). 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](https://partner.microsoft.com/dashboard/account/usermanagement). 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 : ```cmd theme={null} XblPlayerDataReset.exe --scid --sandbox --xuid ``` ## 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 : ```cmd theme={null} XblPlayerDataReset.exe --scid --sandbox --user ``` ## 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](/services/xbox-services/develop/test-accounts/live-exporting-test-accounts). ```cmd theme={null} XblPlayerDataReset.exe --scid --sandbox --file ``` 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 : ```text theme={null} Xuid,Email,Gamertag,IsDeleted,AccountId,Etag,Subscriptions,Keywords ``` 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 (,). ```cmd theme={null} XblPlayerDataReset.exe --scid --sandbox --xuid --delimiter * XblPlayerDataReset.exe --scid --sandbox --user --delimiter $ XblPlayerDataReset.exe --scid --sandbox --file --delimiter % ``` 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*** ```cmd theme={null} Resetting player data for SCID in sandbox Using Dev account contoso@contoso.com from WindowsDevCenter Processing batch of 2 account(s). Resetting player 2814000000000001 result: Succeeded Resetting player 2814000000000002 result: Succeeded Player data has been reset successfully. ``` ***Error*** ```cmd theme={null} Resetting player data for SCID in sandbox Using Dev account contoso@contoso.com from WindowsDevCenter Processing batch of 1 account(s). Resetting player 2814000000000001 result: CompletedError. Will retry. Retrying 1 accounts. 4 more attempt(s). Failed to reset 1 account(s): 2814000000000001 An error occurred while resetting player data: ``` 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. ```cmd theme={null} Player data reset has timed out: ``` ## 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 ```cmd theme={null} Unable to authorize the account with XBOX Live and scid : and sandbox : , please contact your administrator. ``` 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](#reset-by-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 ```cmd theme={null} Your account doesn't have access to perform the operation, please contact your administrator. ``` Ce message accompagne une erreur HTTP 403. Accordez l'autorisation "Tools Access" pour le produit, comme décrit dans [Réinitialiser par XUID](#reset-by-xuid). ### Resetting by XUID requires a signed in Partner Center account ```cmd theme={null} Resetting by XUID requires a signed in Partner Center account. Please use "XblDevAccount.exe signin" to log in. ``` 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 ```cmd theme={null} 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. ## Related topics - [Vue d'ensemble de Godot et des moteurs communautaires](/fr/paths/community-engines/overview.md) - [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md) - [Vue d'ensemble de l'accessibilité GDK](/fr/build/game-principles/accessibility/accessibility-overview.md) - [Ressources d'accessibilité pour les développeurs](/fr/build/game-principles/accessibility/accessibility-resources.md) - [Installer la chaîne d'outils du GDK](/fr/home/setup-install/download-install.md)