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, comogame 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, como3 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 porGet, List o Search son de solo lectura. Lee
Seguridad y operaciones destructivas antes de ejecutar comandos que cambien algo.