Pular para o conteúdo principal
A família de comandos playfab mps é Experimental. Sua interface de CLI pode mudar ou ser removida com base em comentários. playfab mps gerencia os PlayFab Multiplayer Servers (MPS): builds e seus aliases e regiões, servidores, ativos, certificados, segredos, imagens de contêiner, cotas e máquinas virtuais (VMs). Ele abrange as mesmas operações que o módulo MpsPowershell do PlayFab; o equivalente ao seu Set-PfTitle é xbox context set playfab-title-id <id>. Consulte Contexto.

Árvore de comandos

Cada comando é executado em xbox playfab mps.

Corpo da solicitação

A maioria dos comandos MPS envia o objeto de solicitação JSON da operação, como playfab api: --body e --body-file não podem ser combinadas. certificate upload e secret upload aceitam somente --body-file, e asset upload não aceita nenhuma delas; consulte as seções correspondentes.

Comandos destrutivos

Estes comandos pedem confirmação primeiro em um terminal e exigem --confirm (--yes, -y) em outros contextos: build delete, build alias delete, build region delete, server shutdown, asset delete, certificate delete, secret delete, container-image repository delete e remote-user delete. Com --body-file -, eles exigem --confirm mesmo em um terminal. Outros comandos MPS que alteram algo são executados sem pedir confirmação. Consulte Segurança e operações destrutivas.

Paginação

Estes comandos de listagem retornam uma página de resultados por chamada:
  • 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
Quando há mais resultados, o SkipToken da resposta é definido. Para obter a próxima página, adicione "SkipToken" com esse valor ao corpo da solicitação, mantenha os outros campos e repita até que SkipToken volte como null. Defina "PageSize" no corpo da solicitação para alterar quantos resultados uma página contém. Obtenha a primeira página de builds:
Se o SkipToken dela não for null, obtenha a próxima página passando esse token:
A saída em tabela não tem coluna para SkipToken; portanto, quando há mais resultados, a tabela é seguida por um aviso em stderr com o token a ser enviado.

Saída em tabela

Os comandos destas tabelas aceitam --output table; os outros comandos MPS não. Consulte Saída em tabela. Os comandos que retornam um único registro o mostram como uma linha: As colunas ocultadas imprimem ********, porque o valor é uma credencial. A saída JSON retorna o valor real.

mps build create

build create exige --type, que seleciona a API do PlayFab que ele chama, e aceita o corpo da solicitação como os outros comandos MPS:

mps certificate upload e mps secret upload

certificate upload e secret upload aceitam o corpo da solicitação somente com --body-file <path>, ou --body-file - para stdin, porque ele contém uma senha de PFX ou um valor secreto. Eles recusam --body, que deixaria o valor no histórico do shell e nas listagens de processos. Nenhum deles aceita --output table. ForceUpdate substitui um certificado ou segredo que já tenha o nome. Mantenha o arquivo de corpo fora do controle do código-fonte e exclua-o depois que ele for carregado. certificate.json contém o PFX codificado em Base64 e sua senha:
Para criar o corpo sem gravar o segredo em outro arquivo, redirecione-o para --body-file -. Aqui, jq lê o valor de api-key.txt em vez de seus próprios argumentos, de modo que o valor fica fora das listagens de processos:

mps asset upload

asset upload carrega um arquivo local como um ativo de servidor multijogador. Ele aceita opções em vez de um corpo de solicitação e grava o nome do ativo e o status do carregamento como JSON.
Última modificação em 19 de novembro de 2026