Passer au contenu principal
La famille de commandes playfab mps est expérimentale. Son interface CLI pourrait changer ou être retirée en fonction des commentaires. playfab mps gère PlayFab Multiplayer Servers (MPS) : les builds ainsi que leurs alias et régions, les serveurs, les ressources, les certificats, les secrets, les images de conteneur, les quotas et les machines virtuelles (VM). Elle couvre les mêmes opérations que le module MpsPowershell de PlayFab; l’équivalent de sa commande Set-PfTitle est xbox context set playfab-title-id <id>. Consultez Contexte.

Arborescence des commandes

Chaque commande s’exécute sous xbox playfab mps.

Corps de la requête

La plupart des commandes MPS envoient l’objet de requête JSON de l’opération, comme playfab api : --body et --body-file ne peuvent pas être combinées. certificate upload et secret upload acceptent seulement --body-file, et asset upload n’accepte ni l’une ni l’autre; consultez leurs sections.

Commandes destructives

Ces commandes demandent d’abord une confirmation dans un terminal, et nécessitent --confirm (--yes, -y) ailleurs : build delete, build alias delete, build region delete, server shutdown, asset delete, certificate delete, secret delete, container-image repository delete et remote-user delete. Avec --body-file -, elles nécessitent --confirm même dans un terminal. Les autres commandes MPS qui modifient des éléments s’exécutent sans demander de confirmation. Consultez Sécurité et opérations destructives.

Pagination

Ces commandes de liste retournent une page de résultats par appel :
  • 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
Lorsqu’il existe d’autres résultats, le SkipToken de la réponse est défini. Pour obtenir la page suivante, ajoutez "SkipToken" avec cette valeur au corps de la requête, conservez ses autres champs, et répétez jusqu’à ce que SkipToken revienne avec la valeur null. Définissez "PageSize" dans le corps de la requête pour modifier le nombre de résultats que contient une page. Obtenir la première page de builds :
Si son SkipToken n’est pas null, obtenez la page suivante en transmettant ce jeton :
La sortie sous forme de tableau n’a pas de colonne pour SkipToken; lorsqu’il existe d’autres résultats, le tableau est donc suivi d’un avis dans stderr indiquant le jeton à envoyer.

Sortie sous forme de tableau

Les commandes de ces tableaux acceptent --output table; les autres commandes MPS ne l’acceptent pas. Consultez Sortie sous forme de tableau. Les commandes qui retournent un seul enregistrement l’affichent sur une seule ligne : Les colonnes masquées affichent ********, car la valeur est une information d’identification. La sortie JSON retourne la valeur réelle.

mps build create

build create exige --type, qui sélectionne l’API PlayFab qu’elle appelle, et accepte le corps de la requête comme les autres commandes MPS :

mps certificate upload et mps secret upload

certificate upload et secret upload acceptent leur corps de requête seulement avec --body-file <path>, ou --body-file - pour stdin, car il contient un mot de passe PFX ou une valeur secrète. Elles refusent --body, qui laisserait la valeur dans l’historique de l’interpréteur de commandes et dans les listes de processus. Aucune des deux n’accepte --output table. ForceUpdate remplace un certificat ou un secret qui porte déjà ce nom. Gardez le fichier de corps hors du contrôle de code source, et supprimez-le une fois qu’il est téléversé. certificate.json contient le PFX encodé en Base64 et son mot de passe :
Pour construire le corps sans écrire le secret dans un autre fichier, redirigez-le vers --body-file -. Ici, jq lit la valeur à partir de api-key.txt plutôt qu’à partir de ses propres arguments; la valeur reste donc absente des listes de processus :

mps asset upload

asset upload téléverse un fichier local en tant que ressource de serveur multijoueur. Elle accepte des options plutôt qu’un corps de requête, et écrit le nom de la ressource et l’état du téléversement en JSON.
Dernière modification le 19 novembre 2026