跳转到主要内容
XBOX CLI 以你的权限执行操作,并且通常针对生产游戏和卖家。本页介绍哪些命令只进行读取,哪些在更改内容之前会进行询问,少数会执行其名称未体现的操作的命令,以及更改结果未知时应如何处理。有关 AI 代理在进行更改之前必须询问的内容,请参阅通过代理使用 XBOX CLI。 命令会从标志、XBOX_ 环境变量或通过 xbox context set 保存的值中获取其游戏、卖家或沙盒。会更改内容的命令会在 stderr 上指明你未在其命令行中传递的每个值,因此请在进行生产更改之前检查这些值。请参阅 上下文。

哪些操作是只读的

仅当 PlayFab 操作的名称以 Get、List 或 Search 开头时(例如 /Admin/GetTitleData 或 /MultiplayerServer/ListBuildSummariesV2),它才是只读的。其他所有操作都会更改内容。这一点对于 xbox playfab api <api-path> 最为重要,因为你在其中键入的是操作的路径,而不是命令名称。 命令的帮助中有一个 SAFETY 部分,说明该命令是读取还是更改内容。

哪些操作会先询问

大多数会更改内容的命令都会在不询问的情况下运行。以下命令在终端中会先询问;如果没有终端,除非你传递 --confirm(--yes、-y),否则它们会拒绝运行:

命令名称未体现的内容

  • 如果 playfab service-principal set 失败,则在某次 set 成功之前,服务主体可能在工作室中没有任何访问权限,这可能会导致以该服务主体身份登录的管道停止运行。请传递 --expected-version,使 set 失败而不是覆盖其他人的更改。
  • playfab privacy export 会将玩家在该发行商的所有游戏中的数据通过电子邮件发送到游戏的通知电子邮件地址。导出及其电子邮件无法撤回。
  • 从另一个沙盒运行 xbl config publish 会将目标的全局游戏存储文件替换为源的文件,并删除仅目标拥有的文件。已删除的文件无法恢复。
  • xbl config publish --sandbox-id HIDDEN 会发布游戏范围的配置,每个沙盒(包括 RETAIL)都会使用该配置。

中断的写入会报告其结果未知

如果更改在 CLI 发送后被中断(例如因为 Ctrl+C、超时或连接断开),或者服务返回 HTTP 5xx 错误,则该更改可能已被应用。 命令会说明其结果未知,如以下 PlayFab 错误所示:
在再次运行更改之前,请读取受影响的状态。playfab 以外的命令会输出一个可用于检查的只读命令。CLI 从不自行重试更改。 某些等待作业的命令在请求已被接受但等待结束时会以 4 退出。请勿再次运行这些命令;有关如何继续等待,请参阅该命令的页面。
最后修改于 2026年11月19日