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

> Obtén o cambia el sandbox de XBOX que usa este equipo Windows, como XblPCSandbox.exe.

Los comandos `pc` obtienen o cambian el sandbox de XBOX que usa este equipo Windows. Son
experimentales y solo se ejecutan en Windows. Consulta
[Comandos experimentales](https://docs.xbox.com/es/tools/xbox-cli/cli-command-lifecycle.md).

Un PC usa un sandbox a la vez, para todos los usuarios y todos los juegos que contiene, y los juegos inician sesión en ese
sandbox. El valor predeterminado es `RETAIL`. Para probar un juego en un sandbox de desarrollo como `ABCDEF.1`,
cambia primero el PC a ese sandbox. Para ver qué sandboxes tiene tu cuenta de Partner Center, usa
[`xbox sandbox list`](https://docs.xbox.com/es/tools/xbox-cli/commands/sandbox).

## Comandos

Cada comando ejecuta `XblPCSandbox.exe`, el conmutador de sandbox de PC de los servicios de XBOX, y funciona como
describe [su documentación](https://learn.microsoft.com/gaming/gdk/docs/tools/tools-services/live-pc-sandbox-switcher).

| Comando | Equivale a | Descripción |
| - | - | - |
| `pc sandbox get` | `XblPCSandbox /get` | Obtiene el sandbox que usa este PC. |
| `pc sandbox set <sandbox-id>` | `XblPCSandbox /set <sandbox-id>` o `/retail` | Cambia este PC a un sandbox, o de vuelta a `RETAIL`. |
| `pc sandbox launch-apps` | `XblPCSandbox /launchApps` | Cierra y vuelve a abrir la Microsoft Store y la aplicación XBOX en el sandbox de este PC. |

Para el comando `/feedback` de la herramienta, ejecuta `XblPCSandbox /feedback` directamente.

## Cambio de sandbox

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

`pc sandbox set` cambia el sandbox para todos los usuarios del PC. Pregunta antes de cambiarlo y, después,
muestra una solicitud del Control de cuentas de usuario (UAC) para obtener derechos de administrador. Reinicia los servicios de XBOX
en el PC y vuelve a abrir la Microsoft Store y la aplicación XBOX si estaban abiertas. Después, comprueba que el
PC usa el nuevo sandbox.

`set` realiza el cambio aunque el PC ya use el sandbox. Volver a ejecutarlo reinicia los servicios,
lo que corrige un inicio de sesión que todavía usa el sandbox anterior. Si eso no ayuda, reinicia el PC y consulta
[Solución de problemas de sandboxes](https://aka.ms/XboxLiveSandboxHelp).

Cambia a `RETAIL` antes de actualizar la aplicación XBOX o Gaming Services desde la Microsoft Store.

## Instalación de la herramienta

`XblPCSandbox.exe` se incluye con el XBOX Game Development Kit (GDK) y en `XboxLiveTools.zip`, en
la página de [versiones de las herramientas de desarrollo de los servicios de XBOX](https://github.com/microsoft/xbox-live-developer-tools/releases).
Gaming Services, el servicio de Windows que ejecuta las características de XBOX en el PC, debe estar instalado.
La CLI busca la herramienta en este orden:

1. La opción de configuración `XblPCSandbox:Path`, como la variable de entorno `XBOX_XBLPCSANDBOX__PATH`.
2. La carpeta que contiene la CLI.
3. Cada carpeta de `PATH`.

## Opciones

| Opción | Comando | Descripción |
| - | - | - |
| `--confirm`, `--yes`, `-y` | `set` | Realiza el cambio sin la solicitud de confirmación. Obligatoria fuera de un terminal interactivo. |
| `--no-apps` | `set` | No vuelve a abrir la Microsoft Store ni la aplicación XBOX, como `/noApps` de la herramienta. Ejecuta `launch-apps` más tarde para volver a abrirlas. |
| `--output <format>` | todos | `json` (predeterminado), `json-compact` o `table`. |

## Salida

`get` y `launch-apps` devuelven `{"sandbox": "ABCDEF.1"}`, y `set` devuelve
`{"sandbox": "ABCDEF.1", "previousSandbox": "RETAIL"}`. Con `--output table`, las columnas son
`SANDBOX` y, para `set`, `PREVIOUS SANDBOX`. La salida propia de la herramienta va a stderr.

## Errores

| Causa | Qué sucede |
| - | - |
| Se rechazó la solicitud de UAC | El sandbox no cambia. |
| Gaming Services falta o no funciona | La salida de la herramienta indica la causa, y el error incluye un vínculo a la herramienta de reparación de Gaming Services. |
| El cambio no surtió efecto | La herramienta informó de que se completó correctamente, pero el PC usa otro sandbox. Vuelve a realizar el cambio y, si sigue fallando, reinicia el PC. |
| No se encontró la herramienta | El error indica dónde buscó la CLI y cómo instalar la herramienta. |
| Pulsaste Ctrl+C | La CLI detiene la herramienta. Si habías aceptado la solicitud de UAC, es posible que el cambio termine igualmente; compruébalo con `xbox pc sandbox get`. |

Los errores de la herramienta incluyen un vínculo a [Solución de problemas de sandboxes](https://aka.ms/XboxLiveSandboxHelp) y
sugieren `XblPCSandbox /feedback` para notificar un problema.

## Ejemplos

Obtener el sandbox que usa este PC:

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

Cambiar a un sandbox de desarrollo sin volver a abrir la Microsoft Store ni la aplicación XBOX y, después, volver a abrirlas:

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

Volver a `RETAIL`:

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


## Related topics

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