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

# Ferramenta de Connected Storage do XBOX (XblConnectedStorage.exe)

> Ferramenta de linha de comando XblConnectedStorage.exe que baixa jogos salvos do XBOX de qualquer sandbox, incluindo o RETAIL, para ajudar a depurar problemas de salvamento difíceis de reproduzir.

A ferramenta de Connected Storage do XBOX é usada para baixar jogos salvos. Ela pode baixar jogos salvos de
qualquer sandbox, incluindo o RETAIL. Isso é útil ao depurar problemas difíceis de reproduzir.

Esta ferramenta de linha de comando faz parte do Microsoft Game Development Kit (GDK) e do `XboxLiveTools.zip`; veja
[Ferramentas de desenvolvimento para serviços XBOX](/pt-BR/tools/tools-services/live-tools). Ela também está disponível no GDK a partir da
versão 2104.

O XblConnectedStorage.exe é usado para baixar os dados do Connected Storage de um usuário. A
[ferramenta de conta de desenvolvedor dos serviços XBOX (XblDevAccount.exe)](/pt-BR/tools/tools-services/live-dev-account-tool) é necessária
para entrar com uma conta de desenvolvedor antes de usar a ferramenta de Connected Storage do XBOX.

## Uso

A ferramenta de Connected Storage pode ser usada para buscar um arquivo XML que representa o jogo salvo no
[formato de arquivo de importação e exportação (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xbstorage#xbstorage_fileformat).
O arquivo XML deve ser usado com a [ferramenta xbstorage.exe)](/pt-BR/tools/tools-console/commandlinetools/xbstorage),
que pode ser usada para importar dados do arquivo XML para um espaço do Connected Storage para uso com o
XBOX Development Kit. A ferramenta lida automaticamente com a descompactação de jogos salvos compactados com gzip.

Há três requisitos para buscar o arquivo XML de um jogo salvo:

1. Uma conta de desenvolvedor com permissões de leitura para a permissão Tools Access. Para saber mais,
   leia sobre as \[permissões necessárias para usar a ferramenta de Connected Storage]\[#permissions-needed-to-use-the-tool]].
2. O Service Configuration ID (SCID) do título. Ele pode ser encontrado no Partner Center.
3. O gamertag clássico do usuário cujo jogo salvo deve ser obtido.

#### Exemplo de uso da linha de comando.

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

#### Opções de linha de comando

Use a opção `--help` para ver a lista completa de opções de linha de comando disponíveis compatíveis com a ferramenta.

A partir da versão 2020.6.0.0, a saída é a seguinte:

```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" />

### Permissões necessárias para usar a ferramenta

Proteger a privacidade dos usuários e dos dados de jogos salvos é importante. Uma conta de desenvolvedor requer certas
permissões para acessar os dados de jogos salvos usando a ferramenta de Connected Storage do XBOX. Para exibir ou modificar
essas permissões de uma conta de desenvolvedor, siga estas etapas:

1. Abra a [página de gerenciamento de usuários](https://partner.microsoft.com/dashboard/account/v3/usermanagement#users)
   no Microsoft Partner Center
2. Selecione o usuário ou grupo cujas permissões você deseja exibir ou modificar
3. Clique no link "Customize Permissions"
4. Selecione o produto cujas permissões você deseja exibir ou modificar
5. Selecione "XBOX Live"
6. Selecione "Tools Access"

Uma conta de desenvolvedor com a permissão de leitura "Tools Access" é necessária para baixar jogos salvos desse
produto.

## Entender as mensagens de erro

### 500 Internal Server Error

Este erro ocorre ao tentar acessar uma combinação de SCID/sandbox que a conta de desenvolvedor atual
não tem permissão para acessar. Para obter orientações sobre como resolver esse problema, veja a seção
[Permissões necessárias para usar a ferramenta](#permissions-needed-to-use-the-tool) deste documento.


## Related topics

- [Ferramentas de desenvolvimento para serviços XBOX](/pt-BR/tools/tools-services/live-tools.md)
- [Ferramentas para serviços XBOX](/pt-BR/tools/tools-services/live-tools-nav.md)
- [Ferramenta de contas de teste do XBOX Live (XblTestAccountGui.exe)](/pt-BR/tools/tools-services/live-xbox-live-account-tool.md)
- [Ferramenta de redefinição de dados do jogador (XblPlayerDataReset.exe)](/pt-BR/tools/tools-services/live-player-data-reset.md)
- [Connected Storage](/pt-BR/services/xbox-services/storage/connected-storage/live-connected-storage-nav.md)