> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 安全性和破坏性操作

> 哪些 XBOX CLI 命令只进行读取,哪些在更改内容之前会进行询问,哪些会执行其名称未体现的操作,以及更改结果未知时应如何处理。

XBOX CLI 以你的权限执行操作,并且通常针对生产游戏和卖家。本页介绍哪些命令只进行读取,哪些在更改内容之前会进行询问,少数会执行其名称未体现的操作的命令,以及更改结果未知时应如何处理。有关 AI 代理在进行更改之前必须询问的内容,请参阅[通过代理使用 XBOX CLI](https://docs.xbox.com/zh-CN/tools/xbox-cli/cli-for-agents.md)。

命令会从标志、`XBOX_` 环境变量或通过 `xbox context set` 保存的值中获取其游戏、卖家或沙盒。会更改内容的命令会在 stderr 上指明你未在其命令行中传递的每个值,因此请在进行生产更改之前检查这些值。请参阅
[上下文](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/context.md)。

## 哪些操作是只读的

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

命令的帮助中有一个 `SAFETY` 部分,说明该命令是读取还是更改内容。

## 哪些操作会先询问

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

| 命令 | 何时需要确认 |
| - | - |
| 通过任何命令(包括 `playfab api`)执行的任何 PlayFab `Delete*` 或 `Shutdown*` 操作 | 始终 |
| `playfab economy inventory operation execute` | 当批次包含 `Delete` 操作时。即使在终端中,如果没有 `--confirm`,它也会拒绝运行。 |
| `playfab api-policy set --overwrite` | 始终。即使在终端中,如果没有 `--confirm`,它也会拒绝运行。 |
| [`audience create`、`audience update`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/audience) | 始终 |
| [`game create`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/game) | 始终 |
| [`playtest create`、`update`、`publish`、`delete`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playtest) | 始终 |
| [`sandbox create`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/sandbox) | 始终 |
| [`test-account batch create`、`update`、`delete`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/test-account) | 始终 |
| [`xbl config publish`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/xbl#config-publish) | 发布到 RETAIL、CERT、CERT.DEBUG 或 HIDDEN 时,或者从另一个沙盒发布时。使用 `--validate-only` 时从不需要。 |
| 通过 `--title-id` 运行的 [`xbl config save`、`xbl config publish`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/xbl#title-targeting) | 当其他游戏共享该配置时。`--allow-shared-configuration` 会跳过该问题;`--confirm` 不会。 |
| [`pc sandbox set`](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/pc) | 始终 |

## 命令名称未体现的内容

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

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

如果更改在 CLI 发送后被中断(例如因为 Ctrl+C、超时或连接断开),或者服务返回 HTTP 5xx 错误,则该更改可能已被应用。
命令会说明其结果未知,如以下 PlayFab 错误所示:

```text theme={null}
Request failed: /Admin/SetTitleData may have reached PlayFab, but the request was canceled, so its outcome is unknown. Check whether it was applied before retrying.
```

| 命令 | 结果未知时的退出代码 |
| - | - |
| `audience create` 和 `update`,`playtest create`、`update`、`publish` 和 `delete`,`sandbox create`,`test-account batch create`、`update` 和 `delete`,以及 `xbl config save` 和 `publish` | `3` |
| 其他命令,包括每个 `playfab` 命令 | `1`,但 `game create` 除外:如果你在它发送请求后按下 Ctrl+C,它会以 `130` 退出。当 PlayFab 以错误 JSON 进行响应时,stderr 上的 JSON 还会包含 `outcomeUnknown` 字段。 |

在再次运行更改之前,请读取受影响的状态。`playfab` 以外的命令会输出一个可用于检查的只读命令。CLI 从不自行重试更改。

某些等待作业的命令在请求已被接受但等待结束时会以 `4` 退出。请勿再次运行这些命令;有关如何继续等待,请参阅该命令的页面。


## Related topics

- [通过代理使用 XBOX CLI](https://docs.xbox.com/zh-CN/tools/xbox-cli/cli-for-agents.md)
- [命令](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands.md)
- [PlayFab API 集成](https://docs.xbox.com/zh-CN/tools/xbox-cli/playfab-api.md)
- [PlayFab](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab.md)
- [多人游戏服务器](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playfab/mps.md)
