跳转到主要内容
playfab mps 命令系列属于实验性功能。其 CLI 接口可能会根据反馈而更改或被删除。 playfab mps 管理 PlayFab Multiplayer Servers (MPS):生成及其别名和区域、服务器、资产、证书、机密、容器映像、配额和虚拟机 (VM)。它涵盖与 PlayFab 的 MpsPowershell 模块相同的操作;与其 Set-PfTitle 等效的是 xbox context set playfab-title-id <id>。请参阅上下文。

命令树

每个命令都在 xbox playfab mps 下运行。

请求正文

大多数 MPS 命令会发送操作的 JSON 请求对象,与 playfab api 类似: --body 和 --body-file 不能结合使用。certificate upload 和 secret upload 仅接受 --body-file,asset upload 两者都不接受;请参阅它们各自的部分。

破坏性命令

以下命令在终端中会先进行询问,在其他环境中则需要 --confirm (--yes, -y):build delete、build alias delete、build region delete、server shutdown、asset delete、certificate delete、secret delete、container-image repository delete 和 remote-user delete。使用 --body-file - 时,即使在终端中也需要 --confirm。其他进行更改的 MPS 命令会直接运行而不询问。请参阅安全性和破坏性操作。

分页

以下列表命令每次调用返回一页结果:
  • 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
当存在更多结果时,会设置响应的 SkipToken。若要获取下一页,请将带有该值的 "SkipToken" 添加到请求正文中,保留其他字段,并重复此操作,直到返回的 SkipToken 为 null。在请求正文中设置 "PageSize" 可更改每页包含的结果数。 获取第一页生成:
如果其 SkipToken 不为 null,请传递该令牌以获取下一页:
表格输出没有 SkipToken 列,因此当存在更多结果时,表格之后会在 stderr 上显示一条通知,其中包含要发送的令牌。

表格输出

以下表格中的命令接受 --output table;其他 MPS 命令不接受。请参阅表格输出。 返回单条记录的命令将其显示为一行: 已编辑的列会打印 ********,因为该值是凭据。JSON 输出会返回实际值。

mps build create

build create 需要 --type(它选择要调用的 PlayFab API),并像其他 MPS 命令一样接受请求正文:

mps certificate upload 和 mps secret upload

certificate upload 和 secret upload 仅通过 --body-file <path>(或用于 stdin 的 --body-file -)接受请求正文,因为正文包含 PFX 密码或机密值。它们拒绝 --body,因为该选项会将值留在 shell 历史记录和进程列表中。两者都不接受 --output table。 ForceUpdate 会替换已使用该名称的证书或机密。请勿将正文文件纳入源代码管理,并在上传后将其删除。 certificate.json 包含 Base64 编码的 PFX 及其密码:
若要在不将机密写入其他文件的情况下构建正文,请将其通过管道传递给 --body-file -。此处,jq 从 api-key.txt 而不是从其自身的参数中读取该值,因此该值不会出现在进程列表中:

mps asset upload

asset upload 将本地文件作为多人游戏服务器资产上传。它接受选项而不是请求正文,并以 JSON 形式写入资产名称和上传状态。
最后修改于 2026年11月19日