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

# Actualizar

> Busca una versión estable más reciente de la CLI y obtén instrucciones para actualizarla manualmente.

`xbox upgrade` busca en GitHub una versión estable más reciente y, si la hay, te indica cómo
instalarla. No descarga ni instala nada, y no necesitas iniciar sesión.

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

## Opciones

| Opción | Descripción |
| - | - |
| `--check` | Busca una versión más reciente. Es el valor predeterminado, por lo que `xbox upgrade` y `xbox upgrade --check` hacen lo mismo. |
| `--output <format>` | `json` (predeterminado) o `json-compact`. `table` no está disponible. |

`--confirm` (`--yes`, `-y`) se rechaza, porque no se instala nada.

## Resultado

Una comprobación correcta escribe un objeto JSON en stdout:

| Campo | Descripción |
| - | - |
| `schemaVersion` | `1`. |
| `currentVersion` | La versión en ejecución, la misma que muestra `xbox --version`. |
| `latestVersion` | La versión estable más reciente, sin la `v` inicial. |
| `updateAvailable` | `true` cuando la versión estable más reciente es posterior a la versión en ejecución. |
| `releaseNotesUrl` | La página de la versión en GitHub. |
| `message` | Un resumen para que lo lean las personas. |
| `instructions` | Cómo actualizar, cuando `updateAvailable` es `true`; de lo contrario, una matriz vacía. |

```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":["..."]}
```

Para instalar la actualización, consulta [Actualizar una instalación desde ZIP](https://docs.xbox.com/es/tools/xbox-cli/installation.md#update-a-zip-installation)
o, para WinGet, [Windows: instalar con WinGet](https://docs.xbox.com/es/tools/xbox-cli/installation.md#windows-install-with-winget). Una
versión puede llegar a WinGet unas horas después de aparecer en GitHub, por lo que es posible que `winget upgrade` todavía no
la ofrezca.

## Códigos de salida

| Código de salida | Significado |
| - | - |
| `0` | La comprobación se completó correctamente, tanto si hay una actualización disponible como si no. Lee `updateAvailable`. |
| `1` | La comprobación falló y stdout está vacío. |

La comprobación no inicia sesión en GitHub. Un HTTP 404 significa que no encontró ninguna versión estable pública, y un
HTTP 403 o 429 significa que GitHub rechazó la solicitud o limitó su velocidad. En cualquier caso, abre la
[página de versiones](https://github.com/xbox/cli/releases) en el explorador.


## Related topics

- [Actualizar directiva](https://docs.xbox.com/es/services/playfab/api-references/rest/admin/authentication/update-policy.md)
- [Actualizar prohibiciones](https://docs.xbox.com/es/services/playfab/api-references/rest/server/account-management/update-bans.md)
- [Actualizar rol](https://docs.xbox.com/es/services/playfab/api-references/rest/groups/groups/update-role.md)
- [Actualizar grupo](https://docs.xbox.com/es/services/playfab/api-references/rest/groups/groups/update-group.md)
- [Actualizar lobby](https://docs.xbox.com/es/services/playfab/api-references/rest/multiplayer/lobby/update-lobby.md)
