> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Alternador de sandbox para PC (XblPCSandbox.exe)

> Ferramenta de linha de comando XblPCSandbox.exe que mostra e alterna sandboxes dos serviços XBOX no PC e reinicia apps nelas, incluindo a Microsoft Store e o XBOX App.

O XblPCSandbox.exe é uma ferramenta de linha de comando que gerencia a sandbox dos serviços XBOX no PC. Use-a para:

* Mostrar a sandbox atual.
* Alternar para uma sandbox de desenvolvimento ou voltar para o RETAIL.
* Reiniciar apps do sistema (Microsoft Store e XBOX App) no modo sandbox.

## Introdução

Depois de instalar o Microsoft Game Development Kit (GDK), abra um prompt de comando do GDK e execute a ferramenta a partir dele. Você pode encontrar os prompts de comando do GDK realizando as seguintes ações:

1. Abra o menu **Iniciar** e pesquise **Microsoft GDK Command Prompts**.
2. Abra o atalho da pasta **Microsoft GDK Command Prompts** (selecione a versão mais recente do GDK instalada)

Esta ferramenta também é fornecida como parte do GDK e do `XboxLiveTools.zip`; veja [Ferramentas de desenvolvimento para serviços XBOX](https://docs.xbox.com/pt-BR/tools/tools-services/live-tools.md).

> [!NOTE]
>
> Definir a sandbox requer **privilégios elevados** (Executar como administrador). Se você executar a ferramenta sem privilégios elevados, ela tentará ser executada novamente em um estado elevado. Ler a sandbox (`/get`) e mostrar a ajuda (`/?`) não exigem elevação.

## Referência de comandos e opções

```cmd theme={null}
Usage: XblPCSandbox [command] [options]
```

| Comando | Descrição |
| - | - |
| `/get` | Exibe a sandbox atual. Se nenhuma sandbox estiver definida, o dispositivo está no RETAIL. |
| `/set <sandbox ID>` | Define a sandbox (por exemplo, `XDKS.1`). Reinicia o XBOX Live Auth Manager e reinicia todos os apps do sistema **abertos** no modo sandbox. Se você quiser voltar a sandbox para o RETAIL, use 'RETAIL' como nome da sandbox ou a opção /retail equivalente descrita abaixo. Oferece suporte a /noApps. |
| `/launchApps` | Reinicia a Microsoft Store e o XBOX App no modo sandbox, mas somente se eles já estiverem abertos. Útil após uma alternância com `/noApps`. |
| `/retail` | Equivalente a `XblPCSandbox RETAIL`. Uma opção de conveniência que redefine o dispositivo para a sandbox padrão do consumidor. |
| `/feedback` | Abre o Hub de Feedback para que você possa relatar problemas ou fornecer comentários sobre a experiência de alternância de sandbox. |

| Opções | Descrição |
| - | - |
| `/?` | Mostra informações de ajuda para todos os comandos e opções disponíveis, incluindo dicas de solução de problemas e um link para a documentação de solução de problemas. |
| `/help` | O mesmo que `/?`. |
| `/noApps` | Define a sandbox **sem** reiniciar os apps do sistema. Use `xblPCSandbox /launchApps` depois para reiniciá-los no modo sandbox quando estiver pronto. |
| `/version` | Mostra as informações de versão da ferramenta de linha de comando xblPCSandbox. |

## Obter a sandbox atual

```cmd theme={null}
XblPCSandbox /get
```

Exibe a sandbox atual dos serviços XBOX. Se nenhuma sandbox estiver definida, o dispositivo está no **RETAIL**.

## Definir a sandbox

```cmd theme={null}
XblPCSandbox /set <sandbox ID>
```

Define a sandbox dos serviços XBOX para o dispositivo. Por exemplo: `XblPCSandbox /set XDKS.1`

Ao definir a sandbox, a ferramenta:

1. Exibe a **sandbox atual** antes da alternância.
2. Mostra um **indicador de progresso** enquanto a alternância está em andamento.
3. Reinicia o serviço **XBOX Live Auth Manager**.
4. Reinicia os seguintes **apps do sistema** no modo sandbox, mas somente se eles já estiverem abertos:
   * Microsoft Store
   * XBOX App
5. Exibe a **nova sandbox** após a alternância, para que você possa confirmar imediatamente que ela foi aplicada.

Se um app do sistema **não estiver aberto** no momento da alternância, ele **não será iniciado** automaticamente.

> [!NOTE]
>
> A ferramenta corrige automaticamente o uso de maiúsculas e minúsculas nos nomes das sandboxes. Por exemplo, digitar `xdks.1` será corrigido para `XDKS.1`.
> Isso reduz erros causados pela diferenciação entre maiúsculas e minúsculas, já que os nomes das sandboxes ficam em maiúsculas.

### Definir a sandbox sem reiniciar os apps

```cmd theme={null}
XblPCSandbox /set <sandbox ID> /noApps
```

Define a sandbox sem reiniciar os apps do sistema. Você pode reiniciá-los mais tarde usando:

```cmd theme={null}
XblPCSandbox /apps
```

## Voltar para o RETAIL

```cmd theme={null}
XblPCSandbox /retail
```

ou

```cmd theme={null}
XblPCSandbox /set RETAIL
```

Redefine o dispositivo para a sandbox padrão do consumidor. Reinicia o XBOX Live Auth Manager e reinicia todos os apps do sistema abertos (Microsoft Store e XBOX App) de volta ao modo normal.

> [!TIP]
>
> Você precisa voltar para o RETAIL para atualizar o XBOX App ou os Gaming Services pela Microsoft Store. Esses apps não podem receber atualizações enquanto estão em uma sandbox de desenvolvimento.

## Iniciar apps do sistema no modo sandbox

```cmd theme={null}
XblPCSandbox /apps
```

Reinicia a Microsoft Store e o XBOX App no modo sandbox, mas somente se eles já estiverem abertos. Isso é útil após alternar sandboxes com a opção `/noApps`.

## Mostrar a ajuda

```cmd theme={null}
XblPCSandbox /?
```

Mostra informações de ajuda para todos os comandos e opções disponíveis. O texto de ajuda também inclui sugestões de solução de problemas e um link para a documentação [Solução de problemas de entrada e erros de sandbox](https://docs.xbox.com/pt-BR/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md).

## Fornecer comentários

```cmd theme={null}
XblPCSandbox /feedback
```

Abre o Hub de Feedback diretamente para que você possa relatar problemas ou fornecer comentários sobre a experiência de alternância de sandbox.

## Veja também

* [Visão geral de sandboxes](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
* [Visão geral de sandboxes avançadas](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
* [Solução de problemas de entrada e erros de sandbox](https://docs.xbox.com/pt-BR/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
* [Contas de teste](https://docs.xbox.com/pt-BR/services/xbox-services/develop/test-accounts/live-test-accounts.md)
* [Ferramentas de desenvolvimento para serviços XBOX](https://docs.xbox.com/pt-BR/tools/tools-services/live-tools.md)


## Related topics

- [Ferramentas de desenvolvimento para serviços XBOX](https://docs.xbox.com/pt-BR/tools/tools-services/live-tools.md)
- [Ferramentas para serviços XBOX](https://docs.xbox.com/pt-BR/tools/tools-services/live-tools-nav.md)
- [Ferramentas de serviços online para XBOX e PlayFab](https://docs.xbox.com/pt-BR/tools/tools-services/index.md)
- [Visão geral das áreas restritas dos serviços do Xbox](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [Perguntas frequentes sobre o Economy versão 2 (V2)](https://docs.xbox.com/pt-BR/tools/tools-pc/xbox-pc-remote-tools/faq.md)