> ## 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 s'exécutent seulement sous Windows. Consultez
[Commandes expérimentales](https://docs.xbox.com/fr-CA/tools/xbox-cli/cli-command-lifecycle.md).

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

## Commandes

Chaque commande exécute `XblPCSandbox.exe`, le sélecteur de sandbox PC 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`.

## Changer 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 toujours l'ancien sandbox. Si cela ne suffit pas, redémarrez le PC et consultez
[Dépannage des sandbox](https://aka.ms/XboxLiveSandboxHelp).

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

## Installer l'outil

`XblPCSandbox.exe` est fourni avec le Game Development Kit XBOX (GDK), et 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 cherche l'outil dans cet ordre :

1. Le paramètre `XblPCSandbox:Path`, comme 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 l'option `/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` retournent `{"sandbox": "ABCDEF.1"}`, et `set` retourne
`{"sandbox": "ABCDEF.1", "previousSandbox": "RETAIL"}`. Avec `--output table`, les colonnes sont
`SANDBOX`, ainsi que `PREVIOUS SANDBOX` pour `set`. La propre sortie de l'outil est écrite sur stderr.

## Erreurs

| Cause | Ce qui se produit |
| - | - |
| L'invite UAC a été refusée | Le sandbox n'est pas changé. |
| Gaming Services est manquant ou ne fonctionne pas | La sortie de l'outil indique la cause, et l'erreur renvoie au 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 s'il échoue toujours. |
| 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 pourrait tout de même se terminer; vérifiez avec `xbox pc sandbox get`. |

Les erreurs de l'outil renvoient à [Dépannage des 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-CA/build/gdk-and-engines/guides/pc-bootstrapper.md)
- [Inscription de jeux PC](https://docs.xbox.com/fr-CA/tools/tools-pc/title-registration-pc.md)
- [XBOX PC Remote Tools](https://docs.xbox.com/fr-CA/tools/tools-pc/xbox-pc-remote-tools/index.md)
- [Fiddler sur PC Windows](https://docs.xbox.com/fr-CA/build/console-features/networking/tools/fiddler-pc.md)
- [Améliorations de l'empaquetage PC](https://docs.xbox.com/fr-CA/build/core-features/common/packaging/overviews/packaging-msixvc2-overview.md)
