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

# Problemas conocidos

> Problemas y características sin terminar de la versión más reciente de la XBOX CLI, y cómo solucionarlos.

En esta página se enumeran los problemas conocidos de la versión más reciente de la XBOX CLI, incluidas
las características sin terminar. Si tu problema aparece aquí, no es necesario que lo notifiques.

Solo se admite la versión más reciente. [`xbox upgrade`](https://docs.xbox.com/es/tools/xbox-cli/commands/upgrade) te indica si
hay una más reciente disponible. Una entrada marcada como **Corregido** está corregida en la versión más reciente y
se quitará en la siguiente.

## Si tu problema no aparece en la lista

1. Comprueba que ejecutas la versión más reciente con [`xbox upgrade`](https://docs.xbox.com/es/tools/xbox-cli/commands/upgrade).
2. Busca en los [problemas existentes](https://github.com/xbox/cli/issues).
3. Si no se ha notificado, notifícalo con [`xbox feedback`](https://docs.xbox.com/es/tools/xbox-cli/commands/feedback), que
   abre un informe de errores con los detalles de tu entorno ya rellenados. Los problemas son públicos, así que no incluyas
   nada que no compartirías públicamente.

## Actualización de la CLI

### `xbox upgrade` falla con HTTP 301

**Corregido**

El repositorio público de la CLI se ha movido, y [`xbox upgrade`](https://docs.xbox.com/es/tools/xbox-cli/commands/upgrade) en la v0.2.1 falla
siempre con `HTTP 301: GitHub release metadata is unavailable`.

**Solución alternativa:** descarga la versión más reciente siguiendo [Instalación](https://docs.xbox.com/es/tools/xbox-cli/installation.md).

## Inicio de sesión y permisos

### Algunos comandos todavía no funcionan con una cuenta Microsoft personal

Cuando inicias sesión con una cuenta Microsoft personal en lugar de una cuenta profesional o educativa,
los comandos de configuración de los servicios XBOX, cuentas de prueba, paquetes, playtests y audiencias
no funcionan. Los comandos de configuración de los servicios XBOX y de cuentas de prueba fallan con HTTP 502,
que se notifica como que el servicio no está disponible, pero volver a intentarlo no sirve de nada.

**Solución alternativa:** únete a tu vendedor en Partner Center con una cuenta profesional o educativa e inicia
sesión en la CLI con esa cuenta.

### `xbox game`, `xbox xbl` y comandos similares todavía no aceptan entidades de servicio

Una entidad de servicio puede iniciar sesión, pero los comandos `audience`, `game`, `package`, `playtest`, `sandbox`,
`seller`, `test-account` y `xbl` fallan con un error de autorización cuando ella los ejecuta,
porque el servicio al que llaman todavía no acepta entidades de servicio.

**Solución alternativa:** ejecuta esos comandos como un usuario que haya iniciado sesión. Los comandos `xbox playfab` funcionan con una
entidad de servicio una vez que una persona le concede acceso con
[`xbox playfab service-principal set`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/service-principal). Consulta
[Autenticación para automatización (entidad de servicio)](https://docs.xbox.com/es/tools/xbox-cli/authentication.md#automation-service-principal-authentication).

### Se deniegan comandos para algunos vendedores cuando perteneces a más de uno

Si perteneces a más de un vendedor de Partner Center, los comandos de configuración de los servicios XBOX,
cuentas de prueba, paquetes, playtests y audiencias pueden denegarse para todos los
vendedores excepto el último que seleccionaste en Partner Center.

**Solución alternativa:** selecciona el vendedor que quieras en Partner Center y vuelve a ejecutar el comando.

### `xbox seller list` a veces omite uno de tus vendedores

Si perteneces a más de un vendedor de Partner Center, [`xbox seller list`](https://docs.xbox.com/es/tools/xbox-cli/commands/seller)
a veces omite uno de ellos sin mostrar ningún error, y la siguiente ejecución puede incluirlo. Mientras
falta, los comandos para ese vendedor, como [`xbox audience list`](https://docs.xbox.com/es/tools/xbox-cli/commands/audience), pueden
denegarse, y no se sabe que seleccionarlo en Partner Center sirva de ayuda.

### Los comandos `xbox game` omiten `--seller-id`

[`xbox game list`, `xbox game get` y `xbox game create`](https://docs.xbox.com/es/tools/xbox-cli/commands/game) usan el vendedor que
seleccionaste por última vez en Partner Center, no el que pasas con `--seller-id` o guardas en el
[contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md), por lo que `game create` puede crear el juego en otro vendedor. Un
id. de vendedor que no es tuyo, como uno mal escrito, no hace que fallen; devuelven tus
propios juegos.

**Solución alternativa:** selecciona el vendedor que quieras en Partner Center y comprueba que `xbox game list`
muestra sus juegos antes de crear uno. El cambio puede tardar hasta 15 minutos en llegar a la CLI.

### Los comandos `xbox sandbox` solo muestran sandboxes globales

Cuando el vendedor que pasas con `--seller-id` o guardas en el [contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md) no es el
último que seleccionaste en Partner Center,
[`xbox sandbox list` y `xbox sandbox get`](https://docs.xbox.com/es/tools/xbox-cli/commands/sandbox) solo encuentran los sandboxes `CERT`,
`CERT.DEBUG` y `RETAIL`, sin fallar. `xbox sandbox create` crea el
sandbox en el último vendedor que seleccionaste y, si es otro vendedor, sale con `4` porque
no puede volver a leer el sandbox. No vuelvas a crearlo.

**Solución alternativa:** selecciona el vendedor que quieras en Partner Center y vuelve a ejecutar el comando con
ese vendedor. El cambio puede tardar hasta 15 minutos en llegar a la CLI.

## Pruebas con playtests y audiencias

### `xbox audience list` puede agotar el tiempo de espera

[`xbox audience list`](https://docs.xbox.com/es/tools/xbox-cli/commands/audience) puede tardar tanto que la solicitud agote el
tiempo de espera. `--name` no ayuda, porque filtra la lista después de leer todas las audiencias.

## Configuración de los servicios XBOX

### Algunos documentos XML descargados declaran una codificación incorrecta

Algunos documentos XML publicados que guarda
[`xbox xbl config download --view published`](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl), como
`mpsdtitleinfo.xml` y `titlename-localization.xml`, declaran `encoding="utf-16"` pero están
codificados como UTF-8, por lo que un lector de XML que confíe en la declaración no puede cargarlos.

**Solución alternativa:** descodifica el archivo como UTF-8 antes de analizarlo.

## PlayFab

### `xbox playfab api /Admin/UpdatePolicy` puede sobrescribir la directiva sin confirmación

Con `"OverwritePolicy": true` en el cuerpo de la solicitud, esta llamada reemplaza toda la directiva de acceso
a la API del título sin las protecciones de `xbox playfab api-policy set --overwrite`: no
requiere `--confirm` y puede usar el título del contexto guardado o de `XBOX_PLAYFAB_TITLE_ID`.
Una directiva incorrecta puede impedir el acceso al título a todos los jugadores.

**Solución alternativa:** usa [`xbox playfab api-policy set --overwrite`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/api-policy)
en su lugar, que requiere `--confirm` y que el título se pase con `--playfab-title-id`.

### `playfab title-data delete` y `playfab player-data delete` no preguntan primero

Otros comandos que eliminan algo preguntan antes de ejecutarse, o se niegan a ejecutarse sin `--confirm`. Estos
dos eliminan inmediatamente las claves que indicas.

### `--keys` y `--member-ids` aceptan listas separadas por comas

`--keys` en `xbox playfab title-data` y `xbox playfab player-data`, y `--member-ids` en
[`xbox playfab group member`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/group), aceptan listas separadas por comas. Se
cambiarán a opciones repetidas, por lo que habrá que actualizar los scripts que los usan.

Hasta entonces, `--keys` no puede indicar una clave que contenga una coma. Para leer una, pásala con
`--key`, que acepta el nombre completo, pero `delete` solo tiene `--keys`.

**Solución alternativa:** para eliminar la clave, llama a la API que usa `delete` con
[`xbox playfab api`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/api). Para los datos de título, establece el valor de la clave en `null`,
con `/Admin/SetTitleInternalData` en su lugar para los datos de título internos:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab api /Admin/SetTitleData --body '{"Key":"Level,Bonus","Value":null}'
```

Para los datos de jugadores, incluye la clave en `KeysToRemove`, usando la API de actualización correspondiente a la
visibilidad de los datos que se indica en [Datos de jugadores](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/player-data.md):

```bash theme={null}
xbox --playfab-title-id ABC123 playfab api /Admin/UpdateUserData --body '{"PlayFabId":"PLAYER123","KeysToRemove":["Level,Bonus"]}'
```

## Scripts y agentes

### La mayoría de los comandos salen con 1 cuando se desconoce si un cambio se aplicó

Algunos comandos salen con `3` cuando no pueden determinar si se realizó un cambio, por ejemplo, cuando la
solicitud agota el tiempo de espera después de enviarse, y sus páginas lo indican. Todos los demás comandos, incluidos
todos los comandos de PlayFab, salen con `1` para cualquier error, por lo que un script no puede distinguir este caso de un
cambio que no se realizó.

**Solución alternativa:** cuando falle un comando que cambia algo, comprueba el estado actual antes de
volver a ejecutarlo.


## Related topics

- [Introducción a Unity para el desarrollo en PC (contenido)](https://docs.xbox.com/es/build/gdk-and-engines/unity/unity.md)
- [Notas de la versión - XBOX PC Remote Tools (marzo de 2026)](https://docs.xbox.com/es/tools/tools-pc/xbox-pc-remote-tools/release-notes/2603.md)
- [Preguntas frecuentes y guía de solución de problemas de XBOX PC Remote Tools](https://docs.xbox.com/es/tools/tools-pc/xbox-pc-remote-tools/faq.md)
- [Uso de Playtest](https://docs.xbox.com/es/publishing/game-publishing/concepts/playtest-preview.md)
- [Notas de compatibilidad del GDK con Visual Studio 2019](https://docs.xbox.com/es/tools/tools-console/visualstudio/vs-2019-support-notes.md)
