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

> Obtenez ou changez le sandbox XBOX qu'utilise ce PC Windows, comme avec XblPCSandbox.exe.

Les commandes `pc` obtiennent ou changent le sandbox XBOX qu'utilise ce PC Windows. Elles sont
expérimentales et ne s'exécutent que sous Windows. Consultez
[Commandes expérimentales](https://docs.xbox.com/fr/tools/xbox-cli/cli-command-lifecycle.md).

Un PC utilise un seul sandbox à la fois, pour tous les utilisateurs et tous les jeux qu'il contient, et les jeux se connectent à ce
sandbox. La valeur par défaut est `RETAIL`. Pour tester un jeu dans un sandbox de développement tel que `ABCDEF.1`,
basculez d'abord le PC vers celui-ci. Pour voir de quels sandbox dispose votre compte Partner Center, utilisez
[`xbox sandbox list`](https://docs.xbox.com/fr/tools/xbox-cli/commands/sandbox).

## Commandes

Chaque commande exécute `XblPCSandbox.exe`, le PC Sandbox Switcher des XBOX services, et fonctionne comme le décrit
[sa documentation](https://learn.microsoft.com/gaming/gdk/docs/tools/tools-services/live-pc-sandbox-switcher).

| Commande | Équivalent | Description |
| - | - | - |
| `pc sandbox get` | `XblPCSandbox /get` | Obtient le sandbox qu'utilise ce PC. |
| `pc sandbox set <sandbox-id>` | `XblPCSandbox /set <sandbox-id>`, ou `/retail` | Bascule ce PC vers un sandbox, ou de nouveau vers `RETAIL`. |
| `pc sandbox launch-apps` | `XblPCSandbox /launchApps` | Ferme et rouvre le Microsoft Store et l'application XBOX dans le sandbox de ce PC. |

Pour la commande `/feedback` de l'outil, exécutez directement `XblPCSandbox /feedback`.

## Changement de sandbox

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

`pc sandbox set` change le sandbox pour tous les utilisateurs du PC. Elle demande une confirmation avant de basculer, puis
affiche une invite du Contrôle de compte d'utilisateur (UAC) pour obtenir les droits d'administrateur. Elle redémarre les XBOX services
sur le PC, et rouvre le Microsoft Store et l'application XBOX s'ils étaient ouverts. Elle vérifie ensuite que le
PC utilise le nouveau sandbox.

`set` effectue le basculement même lorsque le PC utilise déjà le sandbox. L'exécuter de nouveau redémarre les services,
ce qui corrige une connexion qui utilise encore l'ancien sandbox. Si cela ne suffit pas, redémarrez le PC et consultez
[Résolution des problèmes liés aux sandbox](https://aka.ms/XboxLiveSandboxHelp).

Basculez vers `RETAIL` avant de mettre à jour l'application XBOX ou Gaming Services depuis le Microsoft Store.

## Installation de l'outil

`XblPCSandbox.exe` est fourni avec le kit de développement de jeux XBOX (GDK), ainsi que dans `XboxLiveTools.zip` sur
la page des [versions des outils de développement des XBOX services](https://github.com/microsoft/xbox-live-developer-tools/releases).
Gaming Services, le service Windows qui exécute les fonctionnalités XBOX sur le PC, doit être installé.
La CLI recherche l'outil dans cet ordre :

1. Le paramètre `XblPCSandbox:Path`, par exemple via la variable d'environnement `XBOX_XBLPCSANDBOX__PATH`.
2. Le dossier qui contient la CLI.
3. Chaque dossier du `PATH`.

## Options

| Option | Commande | Description |
| - | - | - |
| `--confirm`, `--yes`, `-y` | `set` | Bascule sans l'invite de confirmation. Obligatoire en dehors d'un terminal interactif. |
| `--no-apps` | `set` | Ne rouvre pas le Microsoft Store et l'application XBOX, comme `/noApps` de l'outil. Exécutez `launch-apps` plus tard pour les rouvrir. |
| `--output <format>` | toutes | `json` (par défaut), `json-compact` ou `table`. |

## Sortie

`get` et `launch-apps` renvoient `{"sandbox": "ABCDEF.1"}`, et `set` renvoie
`{"sandbox": "ABCDEF.1", "previousSandbox": "RETAIL"}`. Avec `--output table`, les colonnes sont
`SANDBOX`, ainsi que `PREVIOUS SANDBOX` pour `set`. La sortie propre de l'outil est écrite sur stderr.

## Erreurs

| Cause | Conséquence |
| - | - |
| L'invite UAC a été refusée | Le sandbox n'est pas modifié. |
| Gaming Services est absent ou ne fonctionne pas | La sortie de l'outil indique la cause, et l'erreur renvoie vers le Gaming Services Repair Tool. |
| Le basculement n'a pas pris effet | L'outil a signalé une réussite, mais le PC utilise un autre sandbox. Effectuez de nouveau le basculement, puis redémarrez le PC si l'échec persiste. |
| L'outil est introuvable | L'erreur indique où la CLI a cherché et comment installer l'outil. |
| Vous avez appuyé sur Ctrl+C | La CLI arrête l'outil. Si vous aviez accepté l'invite UAC, le basculement peut tout de même se terminer ; vérifiez avec `xbox pc sandbox get`. |

Les erreurs de l'outil renvoient vers [Résolution des problèmes liés aux sandbox](https://aka.ms/XboxLiveSandboxHelp) et
suggèrent `XblPCSandbox /feedback` pour signaler un problème.

## Exemples

Obtenir le sandbox qu'utilise ce PC :

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

Basculer vers un sandbox de développement sans rouvrir le Microsoft Store et l'application XBOX, puis les
rouvrir :

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

Revenir à `RETAIL` :

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


## Related topics

- [PC Bootstrapper](https://docs.xbox.com/fr/build/gdk-and-engines/guides/pc-bootstrapper.md)
- [Inscription de jeux PC](https://docs.xbox.com/fr/tools/tools-pc/title-registration-pc.md)
- [XBOX PC Remote Tools](https://docs.xbox.com/fr/tools/tools-pc/xbox-pc-remote-tools/index.md)
- [Fiddler sur PC Windows](https://docs.xbox.com/fr/build/console-features/networking/tools/fiddler-pc.md)
- [Améliorations de l'empaquetage PC](https://docs.xbox.com/fr/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md)
