Passer au contenu principal
La famille de commandes playfab mps est expérimentale. Son interface CLI peut changer ou être supprimée en fonction des retours. playfab mps gère les serveurs multijoueurs PlayFab (MPS) : les builds ainsi que leurs alias et régions, les serveurs, les ressources, les certificats, les secrets, les images conteneur, les quotas et les machines virtuelles (VM). Elle couvre les mêmes opérations que le module MpsPowershell de PlayFab ; l’équivalent de son 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 uniquement --body-file, et asset upload n’accepte ni l’une ni l’autre ; consultez leurs sections.

Commandes destructrices

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 destructrices.

Pagination

Ces commandes de liste renvoient 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 soit renvoyé avec la valeur null. Définissez "PageSize" dans le corps de la requête pour modifier le nombre de résultats par page. Obtenir la première page de builds :
Si son SkipToken n’est pas null, obtenez la page suivante en passant 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 sur 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 renvoient 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 renvoie la valeur réelle.

mps build create

build create nécessite --type, qui sélectionne l’API PlayFab appelée, 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 n’acceptent leur corps de requête qu’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 du shell 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 chargé. certificate.json contient le PFX encodé en Base64 et son mot de passe :
Pour créer le corps sans écrire le secret dans un autre fichier, redirigez-le vers --body-file -. Ici, jq lit la valeur depuis api-key.txt plutôt que depuis ses propres arguments ; la valeur n’apparaît donc pas dans les listes de processus :

mps asset upload

asset upload charge 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 chargement au format JSON.
Dernière modification le 19 novembre 2026