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

# Sécurité et opérations destructrices

> Quelles commandes de l'XBOX CLI ne font que lire, lesquelles demandent une confirmation avant de modifier quelque chose, lesquelles font quelque chose que leur nom n'indique pas, et quoi faire lorsque le résultat d'une modification est inconnu.

L'XBOX CLI agit avec vos autorisations, souvent sur des titres et des vendeurs de production. Cette page indique
quelles commandes ne font que lire, lesquelles demandent une confirmation avant de modifier quelque chose, les quelques commandes qui font quelque chose
que leur nom n'indique pas, et quoi faire lorsque le résultat d'une modification est inconnu. Pour savoir ce qu'un agent d'IA
doit demander avant une modification, consultez [Utiliser l'XBOX CLI à partir d'agents](https://docs.xbox.com/fr-CA/tools/xbox-cli/cli-for-agents.md).

Une commande obtient son titre, son vendeur ou son sandbox à partir d'un indicateur, d'une variable d'environnement `XBOX_` ou d'une
valeur enregistrée avec `xbox context set`. Une commande qui modifie quelque chose nomme sur stderr chaque
valeur que vous n'avez pas passée sur sa ligne de commande; vérifiez-la donc avant une modification de production. Consultez
[Contexte](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/context.md).

## Ce qui est en lecture seule

Une opération PlayFab est en lecture seule uniquement si son nom commence par `Get`, `List` ou `Search`, comme
`/Admin/GetTitleData` ou `/MultiplayerServer/ListBuildSummariesV2`. Toute autre opération
modifie quelque chose. C'est particulièrement important pour `xbox playfab api <api-path>`, où vous tapez le
chemin de l'opération, et non un nom de commande.

L'aide d'une commande comprend une section `SAFETY` qui indique si elle lit ou modifie quelque chose.

## Ce qui demande une confirmation

La plupart des commandes qui modifient quelque chose s'exécutent sans demander de confirmation. Celles-ci demandent d'abord une confirmation dans un terminal, et
sans terminal, elles refusent de s'exécuter, sauf si vous passez `--confirm` (`--yes`, `-y`) :

| Commande | Quand une confirmation est nécessaire |
| - | - |
| Toute opération PlayFab `Delete*` ou `Shutdown*`, au moyen de n'importe quelle commande, y compris `playfab api` | Toujours |
| `playfab economy inventory operation execute` | Lorsque le lot contient une opération `Delete`. La commande refuse de s'exécuter sans `--confirm`, même dans un terminal. |
| `playfab api-policy set --overwrite` | Toujours. La commande refuse de s'exécuter sans `--confirm`, même dans un terminal. |
| [`audience create`, `audience update`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/audience) | Toujours |
| [`game create`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/game) | Toujours |
| [`playtest create`, `update`, `publish`, `delete`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/playtest) | Toujours |
| [`sandbox create`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/sandbox) | Toujours |
| [`test-account batch create`, `update`, `delete`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/test-account) | Toujours |
| [`xbl config publish`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/xbl#config-publish) | Vers RETAIL, CERT, CERT.DEBUG ou HIDDEN, ou à partir d'un autre sandbox. Jamais avec `--validate-only`. |
| [`xbl config save`, `xbl config publish`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/xbl#title-targeting) par `--title-id` | Lorsque d'autres titres partagent la configuration. `--allow-shared-configuration` permet d'éviter la question; `--confirm` ne le permet pas. |
| [`pc sandbox set`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/pc) | Toujours |

## Ce que le nom d'une commande n'indique pas

* Si [`playfab service-principal set`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/playfab/service-principal) échoue, le principal
  de service peut n'avoir aucun accès au studio tant qu'une commande `set` n'a pas réussi, ce qui peut arrêter un
  pipeline qui se connecte en tant que ce principal. Passez `--expected-version` pour que `set` échoue au lieu de remplacer
  la modification de quelqu'un d'autre.
* [`playfab privacy export`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/playfab/privacy) envoie par courriel les données du joueur, provenant de tous
  les titres de l'éditeur auxquels il a joué, à l'adresse courriel de notification du titre. L'exportation
  et son courriel ne peuvent pas être rappelés.
* [`xbl config publish`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/xbl#cross-sandbox-publishing-replaces-global-title-storage-files)
  à partir d'un autre sandbox remplace les fichiers de stockage global du titre de la destination par ceux de la
  source, et supprime les fichiers que seule la destination possède. Les fichiers supprimés ne peuvent pas être récupérés.
* `xbl config publish --sandbox-id HIDDEN` publie la configuration à l'échelle du titre, qu'utilisent tous les
  sandboxes, y compris RETAIL.

## Une écriture interrompue signale que son résultat est inconnu

Si une modification est interrompue après que la CLI l'a envoyée, par exemple par Ctrl+C, par un délai d'expiration ou par une
perte de connexion, ou si le service répond par une erreur HTTP 5xx, la modification a peut-être été appliquée.
La commande indique que son résultat est inconnu, comme dans cette erreur 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.
```

| Commandes | Code de sortie lorsque le résultat est inconnu |
| - | - |
| `audience create` et `update`, `playtest create`, `update`, `publish` et `delete`, `sandbox create`, `test-account batch create`, `update` et `delete`, ainsi que `xbl config save` et `publish` | `3` |
| Autres commandes, y compris toutes les commandes `playfab` | `1`, sauf `game create`, qui se termine avec le code `130` lorsque vous appuyez sur Ctrl+C après l'envoi de la requête. Lorsque PlayFab a répondu par un JSON d'erreur, le JSON sur stderr contient aussi un champ `outcomeUnknown`. |

Lisez l'état concerné avant d'exécuter de nouveau la modification. Les commandes autres que `playfab` affichent une
commande en lecture seule permettant d'effectuer la vérification. La CLI ne réessaie jamais une modification d'elle-même.

Certaines commandes qui attendent une tâche se terminent avec le code `4` lorsque la requête a été acceptée, mais que l'attente
a pris fin. Ne les exécutez pas de nouveau; consultez la page de la commande pour savoir comment continuer d'attendre.


## Related topics

- [Commandes](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands.md)
- [Intégration de l'API PlayFab](https://docs.xbox.com/fr-CA/tools/xbox-cli/playfab-api.md)
- [Utiliser l'XBOX CLI à partir d'agents](https://docs.xbox.com/fr-CA/tools/xbox-cli/cli-for-agents.md)
- [PlayFab](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/playfab.md)
- [API](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/playfab/api.md)
