> ## 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 Sandbox Switcher (XblPCSandbox.exe)

> Outil en ligne de commande XblPCSandbox.exe qui affiche et change le sandbox des services XBOX sur PC, et relance les applications PC dans ce sandbox, notamment le Microsoft Store et l'application XBOX.

XblPCSandbox.exe est un outil en ligne de commande qui gère le sandbox des services XBOX sur PC. Utilisez-le pour :

* Afficher le sandbox actuel.
* Passer à un sandbox de développement ou revenir à RETAIL.
* Relancer les applications système (Microsoft Store et application XBOX) en mode sandbox.

## Prise en main

Après avoir installé le Microsoft Game Development Kit (GDK), ouvrez une invite de commandes GDK et exécutez l'outil à partir de celle-ci. Pour trouver les invites de commandes GDK, procédez comme suit :

1. Ouvrez le menu **Démarrer** et recherchez **Microsoft GDK Command Prompts**.
2. Ouvrez le raccourci depuis le dossier **Microsoft GDK Command Prompts** (sélectionnez la dernière version du GDK installée)

Cet outil est également fourni avec le GDK et `XboxLiveTools.zip` ; voir [Outils de développement pour les services XBOX](https://docs.xbox.com/fr/tools/tools-services/live-tools.md).

> [!NOTE]
>
> La définition du sandbox nécessite des **privilèges élevés** (Exécuter en tant qu'administrateur). Si vous exécutez l'outil sans privilèges élevés, il tente de se relancer avec élévation. La lecture du sandbox (`/get`) et l'affichage de l'aide (`/?`) ne nécessitent pas d'élévation.

## Référence des commandes et options

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

| Commande | Description |
| - | - |
| `/get` | Affiche le sandbox actuel. Si aucun sandbox n'est défini, l'appareil est en RETAIL. |
| `/set <sandbox ID>` | Définit le sandbox (par exemple, `XDKS.1`). Redémarre XBOX Live Auth Manager et relance en mode sandbox toutes les applications système **ouvertes**. Pour revenir au sandbox RETAIL, utilisez 'RETAIL' comme nom de sandbox, ou l'option équivalente /retail décrite ci-dessous. Prend en charge /noApps. |
| `/launchApps` | Relance le Microsoft Store et l'application XBOX en mode sandbox, mais uniquement s'ils sont déjà ouverts. Utile après un changement effectué avec `/noApps`. |
| `/retail` | Équivalent à `XblPCSandbox RETAIL`. Option pratique qui réinitialise l'appareil sur le sandbox grand public par défaut. |
| `/feedback` | Ouvre le Hub de commentaires pour que vous puissiez signaler des problèmes ou donner votre avis sur l'expérience de changement de sandbox. |

| Options | Description |
| - | - |
| `/?` | Affiche l'aide de toutes les commandes et options disponibles, y compris des conseils de dépannage et un lien vers la documentation de dépannage. |
| `/help` | Identique à `/?`. |
| `/noApps` | Définit le sandbox **sans** relancer les applications système. Utilisez ensuite `xblPCSandbox /launchApps` pour les relancer en mode sandbox lorsque vous êtes prêt. |
| `/version` | Affiche les informations de version de l'outil en ligne de commande xblPCSandbox. |

## Obtenir le sandbox actuel

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

Affiche le sandbox actuel des services XBOX. Si aucun sandbox n'est défini, l'appareil est en **RETAIL**.

## Définir le sandbox

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

Définit le sandbox des services XBOX pour l'appareil. Par exemple : `XblPCSandbox /set XDKS.1`

Lors de la définition du sandbox, l'outil :

1. Affiche le **sandbox actuel** avant le changement.
2. Affiche un **indicateur de progression** pendant le changement.
3. Redémarre le service **XBOX Live Auth Manager**.
4. Relance les **applications système** suivantes en mode sandbox, mais uniquement si elles sont déjà ouvertes :
   * Microsoft Store
   * Application XBOX
5. Affiche le **nouveau sandbox** après le changement, pour que vous puissiez confirmer immédiatement qu'il a été appliqué.

Si une application système n'est **pas ouverte** au moment du changement, elle n'est **pas lancée** automatiquement.

> [!NOTE]
>
> L'outil corrige automatiquement la casse des noms de sandbox. Par exemple, `xdks.1` sera corrigé en `XDKS.1`.
> Cela réduit les erreurs liées au respect de la casse, puisque les noms de sandbox sont en majuscules.

### Définir le sandbox sans relancer les applications

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

Définit le sandbox sans relancer les applications système. Vous pourrez les relancer plus tard avec :

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

## Revenir à RETAIL

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

ou

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

Réinitialise l'appareil sur le sandbox grand public par défaut. Redémarre XBOX Live Auth Manager et relance en mode normal toutes les applications système ouvertes (Microsoft Store et application XBOX).

> [!TIP]
>
> Vous devez revenir à RETAIL pour mettre à jour l'application XBOX ou Gaming Services depuis le Microsoft Store. Ces applications ne peuvent pas recevoir de mises à jour lorsqu'elles se trouvent dans un sandbox de développement.

## Lancer les applications système en mode sandbox

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

Relance le Microsoft Store et l'application XBOX en mode sandbox, mais uniquement s'ils sont déjà ouverts. C'est utile après un changement de sandbox effectué avec l'option `/noApps`.

## Afficher l'aide

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

Affiche l'aide de toutes les commandes et options disponibles. Le texte d'aide inclut également des suggestions de dépannage et un lien vers la documentation [Dépannage des erreurs de connexion et de sandbox](https://docs.xbox.com/fr/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md).

## Donner votre avis

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

Ouvre directement le Hub de commentaires pour que vous puissiez signaler des problèmes ou donner votre avis sur l'expérience de changement de sandbox.

## Voir aussi

* [Vue d'ensemble des sandbox](https://docs.xbox.com/fr/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
* [Vue d'ensemble des sandbox avancés](https://docs.xbox.com/fr/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
* [Dépannage des erreurs de connexion et de sandbox](https://docs.xbox.com/fr/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
* [Comptes de test](https://docs.xbox.com/fr/services/xbox-services/develop/test-accounts/live-test-accounts.md)
* [Outils de développement pour les services XBOX](https://docs.xbox.com/fr/tools/tools-services/live-tools.md)


## Related topics

- [Vue d'ensemble des sandboxes des services Xbox](https://docs.xbox.com/fr/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [Fonctionnalités du GDK absentes de Steamworks](https://docs.xbox.com/fr/build/steam-porting-guide/gdk-features-not-in-steamworks.md)
- [Outils de développement pour les services XBOX](https://docs.xbox.com/fr/tools/tools-services/live-tools.md)
- [Outils pour les services XBOX](https://docs.xbox.com/fr/tools/tools-services/live-tools-nav.md)
- [Outils des services en ligne pour XBOX et PlayFab](https://docs.xbox.com/fr/tools/tools-services/index.md)