> ## 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.

# Herramienta XBOX Connected Storage (XblConnectedStorage.exe)

> Herramienta de línea de comandos XblConnectedStorage.exe que descarga partidas guardadas de XBOX desde cualquier sandbox, incluido RETAIL, para ayudar a depurar problemas de guardado difíciles de reproducir.

La herramienta XBOX Connected Storage se usa para descargar partidas guardadas. Puede descargar partidas guardadas desde
cualquier sandbox, incluido RETAIL. Esto resulta útil al depurar problemas difíciles de reproducir.

Esta herramienta de línea de comandos forma parte del Microsoft Game Development Kit (GDK) y de `XboxLiveTools.zip`; consulte
[Herramientas de desarrollo para los servicios XBOX](/tools/tools-services/live-tools). También está disponible en el GDK a partir de
la versión 2104.

XblConnectedStorage.exe se usa para descargar los datos de almacenamiento conectado de un usuario. La
[herramienta de cuenta de desarrollador de los servicios XBOX (XblDevAccount.exe)](/tools/tools-services/live-dev-account-tool) es necesaria
para iniciar sesión con una cuenta de desarrollador antes de usar la herramienta XBOX Connected Storage.

## Uso

La herramienta de almacenamiento conectado puede usarse para obtener un archivo XML que representa la partida guardada en el
[formato de archivo de importación y exportación (tema con NDA)](/tools/tools-console/commandlinetools/xbstorage#xbstorage_fileformat).
El archivo XML está pensado para usarse con la [herramienta xbstorage.exe)](/tools/tools-console/commandlinetools/xbstorage).
que puede usarse para importar datos del archivo XML a un espacio de almacenamiento conectado para su uso con
el XBOX Development Kit. La herramienta gestiona automáticamente la descompresión de las partidas guardadas comprimidas con gzip.

Hay tres requisitos para obtener el archivo XML de una partida guardada:

1. Una cuenta de desarrollador con permisos de lectura para el permiso "Tools Access". Para obtener más información,
   lea sobre los \[permisos necesarios para usar la herramienta Connected Storage]\[#permissions-needed-to-use-the-tool]].
2. El identificador de configuración de servicio (SCID) del título. Puede encontrarse en Partner Center.
3. El gamertag clásico del usuario cuya partida guardada se va a extraer.

#### Ejemplo de uso de la línea de comandos.

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

#### Opciones de línea de comandos

Use la opción `--help` para ver la lista completa de opciones de línea de comandos disponibles que admite la herramienta.

A partir de la versión 2020.6.0.0, la salida es la siguiente:

```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.
```

### Permisos necesarios para usar la herramienta

Proteger la privacidad de los usuarios y los datos de las partidas guardadas es importante. Una cuenta de desarrollador requiere ciertos
permisos para acceder a los datos de partidas guardadas mediante la herramienta XBOX Connected Storage. Para ver o modificar
esos permisos para una cuenta de desarrollador, siga estos pasos:

1. Abra la [página de administración de usuarios](https://partner.microsoft.com/dashboard/account/v3/usermanagement#users)
   en Microsoft Partner Center
2. Seleccione el usuario o grupo cuyos permisos desea ver o modificar
3. Haga clic en el vínculo "Customize Permissions"
4. Seleccione el producto cuyos permisos desea ver o modificar
5. Seleccione "XBOX Live"
6. Seleccione "Tools Access"

Se necesita una cuenta de desarrollador con el permiso de lectura "Tools Access" para descargar partidas guardadas de ese
producto.

## Comprender los mensajes de error

### 500 Internal Server Error

Este error se produce al intentar acceder a una combinación de SCID y sandbox a la que la cuenta de desarrollador actual
no tiene permisos de acceso. Para obtener orientación sobre cómo resolver este problema, consulte la sección
[Permisos necesarios para usar la herramienta](#permissions-needed-to-use-the-tool) de este documento.


## Related topics

- [Herramientas de desarrollo para los servicios XBOX](/es/tools/tools-services/live-tools.md)
- [Herramientas para los servicios XBOX](/es/tools/tools-services/live-tools-nav.md)
- [Herramienta de restablecimiento de datos de jugador (XblPlayerDataReset.exe)](/es/tools/tools-services/live-player-data-reset.md)
- [Connected Storage](/es/services/xbox-services/storage/connected-storage/live-connected-storage-nav.md)
- [Connected Storage frente a almacenamiento de títulos](/es/services/xbox-services/storage/live-connected-storage-vs-title-storage.md)