> ## 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-TW/tools/xbox-cli/cli-for-agents.md)。

命令會從旗標、`XBOX_` 環境變數，或以 `xbox context set` 儲存的值取得其遊戲、賣方或沙箱。會變更內容的命令會在 stderr 上指出您未在其命令列上傳遞的每個值，因此請在進行生產變更之前檢查這些值。請參閱[內容](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/context.md)。

## 哪些是唯讀的

只有名稱以 `Get`、`List` 或 `Search` 開頭的 PlayFab 作業才是唯讀的，例如 `/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-TW/tools/xbox-cli/commands/audience) | 一律需要 |
| [`game create`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/game) | 一律需要 |
| [`playtest create`、`update`、`publish`、`delete`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playtest) | 一律需要 |
| [`sandbox create`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/sandbox) | 一律需要 |
| [`test-account batch create`、`update`、`delete`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/test-account) | 一律需要 |
| [`xbl config publish`](https://docs.xbox.com/zh-TW/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-TW/tools/xbox-cli/commands/xbl#title-targeting) | 當其他遊戲共用該組態時。`--allow-shared-configuration` 會略過此問題；`--confirm` 則不會。 |
| [`pc sandbox set`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/pc) | 一律需要 |

## 命令名稱未表明的事項

* 如果 [`playfab service-principal set`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/service-principal) 失敗，服務主體在 `set` 成功之前，可能在工作室中沒有任何存取權，這可能會使以其身分登入的管線停止。請傳遞 `--expected-version`，讓 `set` 失敗，而不是覆寫其他人的變更。
* [`playfab privacy export`](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/privacy) 會將玩家在該發行者每個遊玩過的遊戲中的資料，以電子郵件傳送至遊戲的通知電子郵件地址。匯出及其電子郵件無法撤回。
* 從其他沙箱執行 [`xbl config publish`](https://docs.xbox.com/zh-TW/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

- [命令](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands.md)
- [從代理程式使用 XBOX CLI](https://docs.xbox.com/zh-TW/tools/xbox-cli/cli-for-agents.md)
- [PlayFab API 整合](https://docs.xbox.com/zh-TW/tools/xbox-cli/playfab-api.md)
- [多人遊戲伺服器](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab/mps.md)
- [PlayFab](https://docs.xbox.com/zh-TW/tools/xbox-cli/commands/playfab.md)
