> ## 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 XBOX Connected Storage (XblConnectedStorage.exe)

> Outil en ligne de commande XblConnectedStorage.exe qui télécharge les sauvegardes de jeu XBOX depuis n'importe quel sandbox, y compris RETAIL, pour aider à déboguer des problèmes de sauvegarde difficiles à reproduire.

L'outil XBOX Connected Storage permet de télécharger des sauvegardes de jeu. Il peut télécharger les sauvegardes de
n'importe quel sandbox, y compris RETAIL. C'est utile pour déboguer des problèmes difficiles à reproduire.

Cet outil en ligne de commande fait partie du Microsoft Game Development Kit (GDK) et de `XboxLiveTools.zip` ; voir
[Outils de développement pour les services XBOX](/fr/tools/tools-services/live-tools). Il est également disponible dans le GDK à partir de
la version 2104.

XblConnectedStorage.exe permet de télécharger les données de stockage connecté d'un utilisateur. L'outil
[XBOX services Developer Account (XblDevAccount.exe)](/fr/tools/tools-services/live-dev-account-tool) est nécessaire
pour se connecter avec un compte de développeur avant d'utiliser l'outil XBOX Connected Storage.

## Utilisation

L'outil Connected Storage permet de récupérer un fichier XML représentant la sauvegarde de jeu au
[format de fichier d'importation et d'exportation (rubrique sous NDA)](/fr/tools/tools-console/commandlinetools/xbstorage#xbstorage_fileformat).
Le fichier XML est destiné à être utilisé avec l'[outil xbstorage.exe)](/fr/tools/tools-console/commandlinetools/xbstorage),
qui permet d'importer les données du fichier XML dans un espace de stockage connecté à utiliser avec le
XBOX Development Kit. L'outil gère automatiquement la décompression des sauvegardes compressées au format gzip.

Trois conditions sont requises pour récupérer le fichier XML d'une sauvegarde de jeu :

1. Un compte de développeur disposant de l'autorisation de lecture Tools Access. Pour en savoir plus,
   consultez les \[autorisations nécessaires pour utiliser l'outil Connected Storage]\[#permissions-needed-to-use-the-tool]].
2. L'ID de configuration de service (SCID) du titre. Vous le trouverez dans Partner Center.
3. Le gamertag classique de l'utilisateur dont la sauvegarde doit être récupérée.

#### Exemple d'utilisation en ligne de commande.

```
XblConnectedStorage --scid 00000000-0000-0000-0000-0000628cd0f2 --gamertag CrazyGiraffe
```

#### Options de ligne de commande

Utilisez l'option `--help` pour afficher la liste complète des options de ligne de commande prises en charge par l'outil.

Depuis la version 2020.6.0.0, la sortie est la suivante :

```shell theme={null}
XblConnectedStorage 2020.6.0.0
Copyright (C) 2021 Microsoft Corporation
USAGE:
Downloads the Connected Storage data for this user to ./output/xbstorage.xml:
XblConnectedStorage --scid 00000000-0000-0000-0000-0000628cd0f2 --gamertag CrazyGiraffe --output ./output/xbstorage.xml
 --sandbox TEST.0

  -c, --scid        Required. The service configuration ID (SCID) of the title

  -s, --sandbox     Required. The target sandbox for title storage

  -g, --gamertag    Required. The legacy gamertag of the player to retrieve storage for

  -o, --output      (Default: ./output/xbstorage.xml) The output file to write the xbstorage xml file to.

  --help            Display this help screen.

  --version         Display version information.
```

<a id="permissions-needed-to-use-the-tool" />

### Autorisations nécessaires pour utiliser l'outil

La protection de la vie privée des utilisateurs et des données de sauvegarde de jeu est importante. Un compte de développeur doit disposer de certaines
autorisations pour accéder aux données de sauvegarde de jeu avec l'outil XBOX Connected Storage. Pour afficher ou modifier
ces autorisations pour un compte de développeur, procédez comme suit :

1. Ouvrez la [page Gestion des utilisateurs](https://partner.microsoft.com/dashboard/account/v3/usermanagement#users)
   dans Microsoft Partner Center
2. Sélectionnez l'utilisateur ou le groupe dont vous voulez afficher ou modifier les autorisations
3. Cliquez sur le lien "Customize Permissions"
4. Sélectionnez le produit dont vous voulez afficher ou modifier les autorisations
5. Sélectionnez "XBOX Live"
6. Sélectionnez "Tools Access"

Un compte de développeur disposant de l'autorisation de lecture "Tools Access" est nécessaire pour télécharger les sauvegardes de jeu de ce
produit.

## Comprendre les messages d'erreur

### 500 Internal Server Error

Cette erreur se produit lorsque vous tentez d'accéder à une combinaison SCID/sandbox à laquelle le compte de développeur actuel
n'a pas l'autorisation d'accéder. Pour savoir comment résoudre ce problème, consultez la section
[Autorisations nécessaires pour utiliser l'outil](#permissions-needed-to-use-the-tool) de ce document.


## Related topics

- [Outils de développement pour les services XBOX](/fr/tools/tools-services/live-tools.md)
- [Outils pour les services XBOX](/fr/tools/tools-services/live-tools-nav.md)
- [Outil de réinitialisation des données de joueur (XblPlayerDataReset.exe)](/fr/tools/tools-services/live-player-data-reset.md)
- [Récupérer les fichiers de sauvegarde de jeu issus des tests de certification](/fr/services/xbox-services/fundamentals/sandboxes/live-get-certification-test-saves.md)
- [Outil Global Storage (GlobalStorage.exe)](/fr/tools/tools-services/live-global-storage-tool.md)