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

# Mise à niveau

> Recherchez une version stable plus récente de la CLI et obtenez des instructions pour la mettre à jour manuellement.

`xbox upgrade` recherche sur GitHub une version stable plus récente et, s'il y en a une, vous indique comment
l'installer. Elle ne télécharge et n'installe rien, et vous n'avez pas besoin de vous connecter.

```bash theme={null}
xbox upgrade
```

## Options

| Option | Description |
| - | - |
| `--check` | Recherche une version plus récente. C'est le comportement par défaut : `xbox upgrade` et `xbox upgrade --check` font donc la même chose. |
| `--output <format>` | `json` (par défaut) ou `json-compact`. `table` n'est pas disponible. |

`--confirm` (`--yes`, `-y`) est refusée, car rien n'est installé.

## Résultat

Une vérification réussie écrit un objet JSON sur stdout :

| Champ | Description |
| - | - |
| `schemaVersion` | `1`. |
| `currentVersion` | La version en cours d'exécution, la même que celle qu'affiche `xbox --version`. |
| `latestVersion` | La dernière version stable, sans le `v` initial. |
| `updateAvailable` | `true` lorsque la dernière version stable est plus récente que la version en cours d'exécution. |
| `releaseNotesUrl` | La page de la version sur GitHub. |
| `message` | Un résumé destiné à être lu par des personnes. |
| `instructions` | La procédure de mise à jour, lorsque `updateAvailable` vaut `true` ; sinon, un tableau vide. |

```bash theme={null}
xbox upgrade --output json-compact
```

```json theme={null}
{"schemaVersion":1,"currentVersion":"1.2.0","latestVersion":"1.3.0","updateAvailable":true,"releaseNotesUrl":"https://github.com/xbox/cli/releases/tag/v1.3.0","message":"A newer stable XBOX CLI release is available. Update manually using the instructions below.","instructions":["..."]}
```

Pour installer la mise à jour, consultez [Mettre à jour une installation ZIP](https://docs.xbox.com/fr/tools/xbox-cli/installation.md#update-a-zip-installation),
ou, pour WinGet, [Windows : installer avec WinGet](https://docs.xbox.com/fr/tools/xbox-cli/installation.md#windows-install-with-winget). Une
version peut arriver sur WinGet quelques heures après sa parution sur GitHub : `winget upgrade` ne la propose donc
peut-être pas encore.

## Codes de sortie

| Code de sortie | Signification |
| - | - |
| `0` | La vérification a réussi, qu'une mise à jour soit disponible ou non. Lisez `updateAvailable`. |
| `1` | La vérification a échoué, et stdout est vide. |

La vérification ne se connecte pas à GitHub. Une erreur HTTP 404 signifie qu'aucune version stable publique n'a été trouvée, et une
erreur HTTP 403 ou 429 signifie que GitHub a refusé la requête ou en a limité le débit. Dans les deux cas, ouvrez plutôt la
[page des versions](https://github.com/xbox/cli/releases) dans votre navigateur.


## Related topics

- [Mises à niveau de compte](https://docs.xbox.com/fr/services/playfab/pricing/account-upgrades.md)
- [Tutoriel de mise à niveau suite à la restructuration de l'API d'entité](https://docs.xbox.com/fr/services/playfab/live-service-management/game-configuration/entities/entity-api-restructure-upgrade-tutorial.md)
- [Notes de publication PlayFab 2017](https://docs.xbox.com/fr/services/playfab/release-notes/2017.md)
- [Notes de publication PlayFab 2016](https://docs.xbox.com/fr/services/playfab/release-notes/2016.md)
- [API XBOX PC Remote Iteration](https://docs.xbox.com/fr/reference/remoting/remoteiteration_members.md)
