Saltar al contenido principal
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 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.
  2. Busca en los problemas existentes.
  3. Si no se ha notificado, notifícalo con xbox 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 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.

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. Consulta Autenticación para automatización (entidad de servicio).

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 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, 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 usan el vendedor que seleccionaste por última vez en Partner Center, no el que pasas con --seller-id o guardas en el contexto, 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 no es el último que seleccionaste en Partner Center, xbox sandbox list y xbox sandbox get 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 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, 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 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, 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. 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:
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:

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.
Última modificación el 19 de noviembre de 2026