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

# PC

> Obtenha ou troque a sandbox do XBOX que este PC com Windows usa, como o XblPCSandbox.exe.

Os comandos `pc` obtêm ou trocam a sandbox do XBOX que este PC com Windows usa. Eles são
Experimentais e são executados somente no Windows. Consulte
[Comandos experimentais](https://docs.xbox.com/pt-BR/tools/xbox-cli/cli-command-lifecycle.md).

Um PC usa uma sandbox por vez, para todos os usuários e todos os jogos nele, e os jogos entram nessa
sandbox. O padrão é `RETAIL`. Para testar um jogo em uma sandbox de desenvolvimento, como `ABCDEF.1`,
troque o PC para ela primeiro. Para ver quais sandboxes sua conta do Partner Center tem, use
[`xbox sandbox list`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/sandbox).

## Comandos

Cada comando executa o `XblPCSandbox.exe`, o XBOX services PC Sandbox Switcher, e funciona da forma que
[a documentação dele](https://learn.microsoft.com/gaming/gdk/docs/tools/tools-services/live-pc-sandbox-switcher)
descreve.

| Comando | Equivale a | Descrição |
| - | - | - |
| `pc sandbox get` | `XblPCSandbox /get` | Obtém a sandbox que este PC usa. |
| `pc sandbox set <sandbox-id>` | `XblPCSandbox /set <sandbox-id>` ou `/retail` | Troca este PC para uma sandbox ou de volta para `RETAIL`. |
| `pc sandbox launch-apps` | `XblPCSandbox /launchApps` | Fecha e reabre a Microsoft Store e o aplicativo XBOX na sandbox deste PC. |

Para o comando `/feedback` da ferramenta, execute `XblPCSandbox /feedback` diretamente.

## Trocar de sandbox

```bash theme={null}
xbox pc sandbox set ABCDEF.1 --confirm
```

`pc sandbox set` altera a sandbox para todos os usuários do PC. Ele pergunta antes de trocar e, em seguida,
mostra uma solicitação do Controle de Conta de Usuário (UAC) para obter direitos de administrador. Ele reinicia os XBOX services
no PC e reabre a Microsoft Store e o aplicativo XBOX se eles estavam abertos. Depois, verifica se o
PC usa a nova sandbox.

`set` faz a troca mesmo quando o PC já usa a sandbox. Executá-lo novamente reinicia os serviços,
o que corrige uma entrada que ainda usa a sandbox antiga. Se isso não ajudar, reinicie o PC e consulte
[Solução de problemas de sandboxes](https://aka.ms/XboxLiveSandboxHelp).

Troque para `RETAIL` antes de atualizar o aplicativo XBOX ou o Gaming Services pela Microsoft Store.

## Instalar a ferramenta

O `XblPCSandbox.exe` é fornecido com o XBOX Game Development Kit (GDK) e no `XboxLiveTools.zip` na
página de [versões das ferramentas de desenvolvimento dos XBOX services](https://github.com/microsoft/xbox-live-developer-tools/releases).
O Gaming Services, o serviço do Windows que executa os recursos do XBOX no PC, precisa estar instalado.
A CLI procura a ferramenta nesta ordem:

1. A configuração `XblPCSandbox:Path`, como a variável de ambiente `XBOX_XBLPCSANDBOX__PATH`.
2. A pasta que contém a CLI.
3. Cada pasta em `PATH`.

## Opções

| Opção | Comando | Descrição |
| - | - | - |
| `--confirm`, `--yes`, `-y` | `set` | Faz a troca sem a solicitação de confirmação. Obrigatória fora de um terminal interativo. |
| `--no-apps` | `set` | Não reabre a Microsoft Store nem o aplicativo XBOX, como o `/noApps` da ferramenta. Execute `launch-apps` mais tarde para reabri-los. |
| `--output <format>` | todos | `json` (padrão), `json-compact` ou `table`. |

## Saída

`get` e `launch-apps` retornam `{"sandbox": "ABCDEF.1"}`, e `set` retorna
`{"sandbox": "ABCDEF.1", "previousSandbox": "RETAIL"}`. Com `--output table`, as colunas são
`SANDBOX` e, para `set`, `PREVIOUS SANDBOX`. A saída da própria ferramenta vai para stderr.

## Erros

| Causa | O que acontece |
| - | - |
| A solicitação do UAC foi recusada | A sandbox não é alterada. |
| O Gaming Services está ausente ou não está funcionando | A saída da ferramenta indica a causa, e o erro tem um link para a Gaming Services Repair Tool. |
| A troca não entrou em vigor | A ferramenta relatou sucesso, mas o PC usa outra sandbox. Execute a troca novamente e reinicie o PC se ela ainda falhar. |
| A ferramenta não foi encontrada | O erro informa onde a CLI procurou e como instalar a ferramenta. |
| Você pressionou Ctrl+C | A CLI interrompe a ferramenta. Se você tiver aceitado a solicitação do UAC, a troca ainda poderá ser concluída; verifique com `xbox pc sandbox get`. |

Os erros da ferramenta têm links para [Solução de problemas de sandboxes](https://aka.ms/XboxLiveSandboxHelp) e
sugerem `XblPCSandbox /feedback` para relatar um problema.

## Exemplos

Obter a sandbox que este PC usa:

```bash theme={null}
xbox pc sandbox get
```

Trocar para uma sandbox de desenvolvimento sem reabrir a Microsoft Store e o aplicativo XBOX e, em seguida, reabri-los:

```bash theme={null}
xbox pc sandbox set ABCDEF.1 --confirm --no-apps
xbox pc sandbox launch-apps
```

Voltar para `RETAIL`:

```bash theme={null}
xbox pc sandbox set RETAIL --confirm
```


## Related topics

- [PC Bootstrapper](https://docs.xbox.com/pt-BR/build/gdk-and-engines/guides/pc-bootstrapper.md)
- [XBOX PC Remote Tools](https://docs.xbox.com/pt-BR/tools/tools-pc/xbox-pc-remote-tools/index.md)
- [Registro de jogos para PC](https://docs.xbox.com/pt-BR/tools/tools-pc/title-registration-pc.md)
- [Melhorias no empacotamento para PC](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md)
- [XBOX PC Remote Iteration API](https://docs.xbox.com/pt-BR/reference/remoting/remoteiteration_members.md)
