Saltar al contenido principal
La familia de comandos playfab mps es experimental. Su interfaz de la CLI puede cambiar o quitarse en función de los comentarios. playfab mps administra PlayFab Multiplayer Servers (MPS): las compilaciones y sus alias y regiones, los servidores, los recursos, los certificados, los secretos, las imágenes de contenedor, las cuotas y las máquinas virtuales (VM). Abarca las mismas operaciones que el módulo MpsPowershell de PlayFab; el equivalente de su Set-PfTitle es xbox context set playfab-title-id <id>. Consulta Contexto.

Árbol de comandos

Cada comando se ejecuta en xbox playfab mps.

Cuerpo de la solicitud

La mayoría de los comandos de MPS envían el objeto de solicitud JSON de la operación, igual que playfab api: --body y --body-file no se pueden combinar. certificate upload y secret upload aceptan solo --body-file, y asset upload no acepta ninguna de las dos; consulta sus secciones.

Comandos destructivos

Estos comandos preguntan primero en un terminal y, en otros entornos, necesitan --confirm (--yes, -y): build delete, build alias delete, build region delete, server shutdown, asset delete, certificate delete, secret delete, container-image repository delete y remote-user delete. Con --body-file -, necesitan --confirm incluso en un terminal. Los demás comandos de MPS que cambian algo se ejecutan sin preguntar. Consulta Seguridad y operaciones destructivas.

Paginación

Estos comandos de lista devuelven una página de resultados por llamada:
  • build list, build alias list
  • server list, server list-archived
  • asset list, certificate list, secret list
  • container-image list, container-image list-tags
  • virtual-machine list
Cuando hay más resultados, se establece el SkipToken de la respuesta. Para obtener la página siguiente, agrega "SkipToken" con ese valor al cuerpo de la solicitud, conserva sus demás campos y repite hasta que SkipToken vuelva como null. Establece "PageSize" en el cuerpo de la solicitud para cambiar cuántos resultados contiene una página. Obtén la primera página de compilaciones:
Si su SkipToken no es null, obtén la página siguiente pasando ese token:
La salida de tabla no tiene ninguna columna para SkipToken, por lo que, cuando hay más resultados, la tabla va seguida de un aviso en stderr con el token que se debe enviar.

Salida de tabla

Los comandos de estas tablas aceptan --output table; los demás comandos de MPS no. Consulta Salida de tabla. Los comandos que devuelven un solo registro lo muestran como una fila: Las columnas censuradas imprimen ********, porque el valor es una credencial. La salida JSON devuelve el valor real.

mps build create

build create requiere --type, que selecciona la API de PlayFab a la que llama, y acepta el cuerpo de la solicitud igual que los demás comandos de MPS:

mps certificate upload y mps secret upload

certificate upload y secret upload aceptan el cuerpo de la solicitud solo con --body-file <path>, o --body-file - para stdin, porque contiene una contraseña de PFX o un valor secreto. Rechazan --body, que dejaría el valor en el historial del shell y en las listas de procesos. Ninguno de los dos acepta --output table. ForceUpdate reemplaza un certificado o secreto que ya tiene ese nombre. Mantén el archivo de cuerpo fuera del control de código fuente y elimínalo una vez cargado. certificate.json contiene el PFX codificado en Base64 y su contraseña:
Para crear el cuerpo sin escribir el secreto en otro archivo, canalízalo a --body-file -. Aquí, jq lee el valor de api-key.txt en lugar de sus propios argumentos, por lo que el valor no aparece en las listas de procesos:

mps asset upload

asset upload carga un archivo local como recurso de servidor multijugador. Acepta opciones en lugar de un cuerpo de solicitud, y escribe el nombre del recurso y el estado de la carga como JSON.
Última modificación el 19 de noviembre de 2026