Saltar al contenido principal
Esta página es la referencia de comandos de la XBOX CLI. Abarca el propio xbox: las opciones globales, los formatos de salida y los códigos de salida que comparten todos los comandos. Cada comando siguiente tiene su propia página, y cada servicio de playfab tiene una página en commands/playfab/. Ejecuta xbox <command> --help para ver la misma referencia en tu terminal. La Ayuda etiqueta los comandos experimentales, cuyo contrato de CLI puede cambiar o quitarse. Consulta Comandos experimentales.

Comandos principales

Comandos de soporte

Opciones globales

Todos los comandos aceptan estas opciones. Algunas solo afectan a determinados comandos, como indica la tabla; en los demás se aceptan y se omiten. Las opciones invalidan la configuración y las variables de entorno; consulta Configuración.

Formatos de salida

Los comandos de datos escriben su resultado en stdout, y los errores y diagnósticos en stderr. Los comandos de PlayFab encapsulan cada resultado en un sobre de respuesta que --data-only quita; consulta Sobre de respuesta. --data-only no tiene efecto en otros comandos ni con --output table. Algunos comandos escriben texto para personas en lugar de JSON, y sus páginas lo indican. auth status escribe texto a menos que pases --output json o --output json-compact; consulta Auth. Las operaciones de archivo, como playfab file upload, no escriben nada en stdout e informan de lo que hicieron en stderr; consulta Archivos.

Salida en tabla

Las tablas están pensadas para leerse en un terminal. Sus columnas pueden cambiar en cualquier versión, por lo que los scripts y los agentes deben usar --output json-compact. Un comando sin vista de tabla rechaza table:

Progreso

Los comandos que leen muchas páginas, como game list, o que esperan una solicitud, como xbl config publish, muestran su progreso en una línea de stderr: Reading games... 1646 found, 25 pages, 84s. La línea solo aparece cuando stderr es un terminal, y se borra antes del resultado.

Códigos de salida

Todos los comandos comparten estos códigos de salida. Los comandos que cambian algo pueden agregar los suyos, como 3 cuando el resultado de un cambio es desconocido, y sus páginas los enumeran. Una llamada a PlayFab con errores escribe el JSON del error en stderr en el formato de --output; consulta Respuestas de error de PlayFab. Un comando desconocido escribe un error y el uso en stderr; consulta Ayuda. Si presionas Ctrl+C después de que un comando haya enviado un cambio, indica en stderr si el cambio podría haberse realizado. Sale con el código que documenta su página, o con 1 en el caso de un comando de PlayFab. Compruébalo antes de volver a ejecutarlo; consulta Una escritura interrumpida indica que su resultado es desconocido.

Seguridad

Muchos comandos cambian títulos, vendedores y juegos de producción, y solo las operaciones de PlayFab cuyos nombres empiezan por Get, List o Search son de solo lectura. Lee Seguridad y operaciones destructivas antes de ejecutar comandos que cambien algo.
Última modificación el 19 de noviembre de 2026