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

# Configuration des XBOX services

> Gérez la configuration des XBOX services, notamment son état, ses documents, sa publication, ses schémas et les images de succès.

La famille de commandes `xbl` est expérimentale. Son interface CLI peut changer
ou être supprimée en fonction des retours.

`xbox xbl` gère la configuration des XBOX services (l'état de la configuration de travail et de la configuration publiée,
les documents de configuration, la publication et les schémas de configuration) ainsi que
les images de succès. Pour répertorier les sandboxes que ciblent les commandes de configuration,
utilisez [`xbox sandbox list`](https://docs.xbox.com/fr/tools/xbox-cli/commands/sandbox).

Ces commandes fonctionnent avec la même configuration que celle modifiée par Partner Center. Pour savoir ce que fait chaque
fonctionnalité des XBOX services et comment la configurer, consultez
[Vue d'ensemble de la configuration du portail](https://devdocs.xbox.com/services/xbox-services/fundamentals/portal-config/live-portal-config-overview)
dans la documentation pour les développeurs XBOX.

| Groupe | Commandes | Objectif |
| - | - | - |
| `config` | `list`, `status`, `download`, `save`, `publish` | Examiner l'état de la configuration de travail et de la configuration publiée, télécharger et enregistrer des documents de configuration, et publier une configuration dans un sandbox. |
| `schema` | `list`, `get`, `download` | Répertorier les types et versions de schémas de configuration, obtenir une version ou télécharger des XSD. |
| [`achievement-image`](https://docs.xbox.com/fr/tools/xbox-cli/commands/xbl/achievement-image) | `upload`, `get`, `list`, `download` | Inscrire, examiner ou télécharger des images de succès. |

## Comportement commun

### Vendeur et sandbox

Toutes les commandes, à l'exception des commandes `schema`, acceptent `--seller-id`. Sans cette option, une commande utilise
`XBOX_SELLER_ID` ou le vendeur enregistré avec [`xbox context set`](https://docs.xbox.com/fr/tools/xbox-cli/commands/context), puis votre seul
vendeur ; si vous en avez plusieurs, passez `--seller-id`.

`config status` et `config publish` prennent `--sandbox-id` dans `XBOX_SANDBOX_ID` ou dans le
`sandbox-id` enregistré lorsque vous l'omettez. `config download` et `config save` nécessitent `--sandbox-id` sur
la ligne de commande pour les documents de sandbox.

### Ciblage du titre

`config list`, `config status`, `config publish`, ainsi que `config download` et
`config save` limités à un sandbox, acceptent l'identificateur de configuration de service (SCID) du titre avec `--scid`, ou son
ID de titre XBOX avec `--title-id`, mais pas les deux. Sans l'un ni l'autre, ils utilisent `XBOX_TITLE_ID` ou le
`title-id` enregistré ; consultez [Contexte](https://docs.xbox.com/fr/tools/xbox-cli/commands/context.md). `--scid` ignore les deux.

* `--title-id` est hexadécimal, tel que l'affiche [`game get`](https://docs.xbox.com/fr/tools/xbox-cli/commands/game) : de `00000001` à
  `7FFFFFFF`, avec un préfixe `0x` facultatif. Pour les autres ID de titre, passez le SCID.
* Les lectures d'un titre lié à la configuration d'un autre titre utilisent le SCID du titre principal.
* `config save` et `config publish` à l'aide de l'ID d'un titre lié sont refusées, même avec
  `--validate-only` (`bound_title_requires_scid`). L'erreur nomme le titre principal et
  le SCID ; relancez la commande avec ce `--scid`.
* L'enregistrement ou la publication à l'aide de `--title-id` dans une configuration à laquelle d'autres titres sont liés
  la modifie pour tous ces titres. Dans un terminal, la CLI répertorie les titres liés et demande d'abord une confirmation ;
  sans terminal, elle échoue. `--allow-shared-configuration` ignore la question. Une écriture à l'aide de
  `--scid` ne demande pas de confirmation.
* `config save` et `config publish` écrivent sur stderr le vendeur et le SCID qu'elles ont utilisés. Les commandes
  de lecture le font avec `--verbose`.

Ces commandes enregistrent un ID de titre, puis l'utilisent pour lire, télécharger et valider la
configuration de ce titre dans XDKS.1. La dernière nomme plutôt le titre avec `--title-id` :

```powershell theme={null}
xbox context set title-id 1234ABCD
xbox xbl config list --output table
xbox xbl config status --sandbox-id XDKS.1
xbox xbl config download --sandbox-id XDKS.1 --view draft --dest .\xbox-config
xbox xbl config save --sandbox-id XDKS.1 --file ".\xbox-config\*.xml" --validate-only
xbox xbl config status --title-id 1234ABCD --sandbox-id XDKS.1
```

### Sortie

Toutes les commandes `xbl` acceptent `--output table` ainsi que `json` (par défaut) et
`json-compact`. Le tableau des options de chaque commande répertorie les colonnes de son tableau de sortie.

### Erreurs

Une requête qui échoue se termine avec le code 1 et écrit sur stderr une erreur JSON avec `status`, `title`, `detail`
et `code` lorsque le service en envoie un. Basez votre logique sur `status` ou `code`, et non sur la formulation de
`detail`. Une erreur 429 inclut `retryAfterSeconds` ; consultez
[Limites de débit](https://docs.xbox.com/fr/tools/xbox-cli/cli-for-agents.md#rate-limits).

Lorsque la validation des XBOX services rejette la configuration, l'erreur répertorie chaque message sous
`validation` :

```json theme={null}
{
  "status": 409,
  "title": "Validation failed.",
  "detail": "The configuration failed XBOX services validation. See validation for each message. MS-CV: ...",
  "code": "validation_failed",
  "validation": [
    {
      "severity": "Error",
      "documentName": "achievements2017.xml",
      "message": "XblLimited products do not support achievements or stats2013/stats2015 configuration. Please remove the unsupported configuration. Document failing validation: achievements2017.xml."
    }
  ]
}
```

`config save` et `config publish` sans `--validate-only` indiquent si une modification ayant échoué
a pu être appliquée :

| Code de sortie | Signification |
| - | - |
| 1 | Rien n'a été modifié : la requête a été interrompue ou a échoué avant son envoi, ou a été rejetée avec une erreur `4xx` autre que `408`. |
| 3 | Le résultat est inconnu : Ctrl+C, un délai d'expiration ou une perte de connexion après l'envoi de la requête, tout autre état d'erreur, ou une réponse de réussite que la CLI ne peut pas lire. |

En cas de code de sortie 3, ne renvoyez pas la requête. stderr affiche une commande en lecture seule permettant de vérifier : pour un enregistrement,
`config download --view draft`, afin de comparer avec les fichiers que vous avez enregistrés ; pour une publication,
`config status`.

***

## config

Examinez, téléchargez, enregistrez et publiez la configuration des XBOX services pour un SCID. Un sandbox
contient une configuration de travail, que `config save` modifie, et une configuration publiée,
que les joueurs et les comptes de test voient une fois que `config publish` a mis la configuration de travail
en ligne.

| Commande | Description |
| - | - |
| `config list` | Répertorie l'état de la configuration de travail et de la configuration publiée dans tous les sandboxes accessibles. |
| `config status` | Obtient l'état de la configuration de travail et de la configuration publiée pour un sandbox, ainsi que sa dernière publication. |
| `config download` | Télécharge et extrait un ensemble de documents. |
| `config save` | Valide ou enregistre un ensemble de documents de travail. |
| `config publish` | Valide ou démarre la publication d'un ensemble de configuration. |

### `config list` et `config status`

Les deux commandes indiquent les dernières versions de travail et publiées, l'heure de validation de chaque
version, et si la version de travail comporte des modifications non publiées. L'heure de validation publiée est
l'heure de validation de la version publiée, et non l'heure de fin de la publication.

`config list` renvoie un tableau contenant un objet par sandbox. `config status` renvoie un objet
pour un sandbox et ajoute sa dernière publication sous `lastPublish`, ou `null` lorsqu'il n'y en a aucune à
signaler. Pour `--sandbox-id ALL`, `lastPublish` vaut toujours `null`, car la configuration
à l'échelle du titre dans `ALL` est mise en ligne par une publication dans `HIDDEN`.

| Champ `lastPublish` | Description |
| - | - |
| `status` | `Running`, `Success` ou `Failed`. `null` lorsque le service n'en signale aucun. |
| `jobId` | L'ID du travail de publication. |
| `message` | Le message du service concernant la publication, ou `null`. |

```json theme={null}
{
  "sandbox": "SANDBOX1",
  "hasWorkingConfiguration": true,
  "workingVersion": 9,
  "workingCommitTime": "2026-10-29T21:40:12+00:00",
  "hasPublishedConfiguration": true,
  "publishedVersion": 9,
  "publishedCommitTime": "2026-10-29T21:40:12+00:00",
  "hasUnpublishedChanges": false,
  "lastPublish": {
    "status": "Success",
    "jobId": "11111111-2222-3333-4444-555555555555",
    "message": null
  }
}
```

#### Options de `config list`

| Option | Obligatoire | Description |
| - | - | - |
| `--scid <guid>` | Ou titre | SCID de la configuration du titre. |
| `--title-id <hex-id>` | Ou SCID | ID de titre XBOX. Consultez [Ciblage du titre](#title-targeting). |
| `--seller-id <id>` | Non | ID de vendeur Partner Center. |
| `--output <format>` | Non | `json` (par défaut), `json-compact` ou `table`. |

#### Options de `config status`

| Option | Obligatoire | Description |
| - | - | - |
| `--scid <guid>` | Ou titre | SCID de la configuration du titre. |
| `--title-id <hex-id>` | Ou SCID | ID de titre XBOX. Consultez [Ciblage du titre](#title-targeting). |
| `--sandbox-id <id>` | Oui | ID de sandbox, sensible à la casse. Vaut par défaut `XBOX_SANDBOX_ID`, puis l'ID de sandbox enregistré. |
| `--seller-id <id>` | Non | ID de vendeur Partner Center. |
| `--output <format>` | Non | `json` (par défaut), `json-compact` ou `table`. |

Les tableaux de sortie des deux commandes comportent les colonnes `SANDBOX`, `WORKING`, `WORKING COMMIT`,
`PUBLISHED`, `PUBLISHED COMMIT` et `UNPUBLISHED`. `config status` ajoute `PUBLISH STATUS`,
le `status` de la dernière publication.

#### Exemples de `config list` et `config status`

```bash theme={null}
# Every accessible sandbox for one title
xbox xbl config list \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --output table

# One sandbox, single JSON object
xbox xbl config status \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1

# Compact output for scripting
xbox xbl config status \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 --output json-compact
```

### `config download` et `config save`

Téléchargez, validez et enregistrez des ensembles de documents de configuration des XBOX services. Un ensemble de documents
appartient à un sandbox (par défaut, ce qui nécessite un SCID ou un titre et `--sandbox-id`) ou au
compte (`--type account`, qui n'accepte ni SCID, ni titre, ni sandbox).

`config download` enregistre l'ETag de l'ensemble de documents à côté des documents, sous la forme `<sandbox>.etag`, ou
`Account.etag` pour l'étendue du compte ; sous Windows, le fichier est masqué. `config save` lit le fichier ETag
situé à côté du premier fichier auquel correspond `--file`, et le réécrit après un enregistrement. Si la
configuration a changé depuis que vous l'avez téléchargée, l'enregistrement échoue ; passez `--force` pour enregistrer par-dessus
ces modifications, ou `--etag` pour fournir vous-même un ETag.

`config save` ne demande pas de confirmation avant d'enregistrer, et `--confirm` ne s'y applique pas. Exécutez-la d'abord avec
`--validate-only`.

#### Options de `config download`

| Option | Obligatoire | Description |
| - | - | - |
| `--view <draft\|published>` | Oui | `draft`, la configuration de travail que `config save` modifie, ou `published`, la configuration en ligne que voient les joueurs et les comptes de test. Partner Center utilise les deux mêmes noms. |
| `--dest <directory>` | Oui | Répertoire dans lequel les documents et le fichier ETag sont enregistrés. |
| `--type <sandbox\|account>` | Non | Étendue des documents. Vaut `sandbox` par défaut. |
| `--scid <guid>` | Ou titre pour `sandbox` | SCID de la configuration du titre. |
| `--title-id <hex-id>` | Ou SCID pour `sandbox` | ID de titre XBOX. Consultez [Ciblage du titre](#title-targeting). |
| `--sandbox-id <id>` | Pour `sandbox` | ID de sandbox, sensible à la casse. |
| `--version <number>` | Non | Version historique positive de l'ensemble de documents. Vaut la dernière version par défaut. |
| `--document <filename>` | Non | Nom de fichier du document à télécharger. Répétez l'option pour en ajouter d'autres. Vaut tous les documents par défaut. |
| `--seller-id <id>` | Non | ID de vendeur Partner Center. |
| `--output <format>` | Non | `json` (par défaut), `json-compact` ou `table` avec les colonnes `TYPE`, `SANDBOX`, `VIEW`, `VERSION`, `FILES` et `DESTINATION`. |

#### Options de `config save`

| Option | Obligatoire | Description |
| - | - | - |
| `--file <path-or-glob>` | Oui | Fichier local ou modèle glob de nom de fichier entre guillemets. Répétez `--file` pour en ajouter d'autres, un chemin ou modèle par option : `--file a.xml --file b.xml`. Le nom de chaque fichier est son nom de document. Une valeur qui ne correspond à aucun fichier fait échouer la commande. |
| `--type <sandbox\|account>` | Non | Étendue des documents. Vaut `sandbox` par défaut. |
| `--scid <guid>` | Ou titre pour `sandbox` | SCID de la configuration du titre. |
| `--title-id <hex-id>` | Ou SCID pour `sandbox` | ID de titre XBOX. Consultez [Ciblage du titre](#title-targeting). |
| `--sandbox-id <id>` | Pour `sandbox` | ID de sandbox, sensible à la casse. |
| `--validate-only` | Non | Valide sans enregistrer. |
| `--allow-shared-configuration` | Non | Enregistre à l'aide de `--title-id` dans une configuration à laquelle d'autres titres sont liés, sans demander de confirmation. Consultez [Ciblage du titre](#title-targeting). |
| `--etag <value>` | Non | ETag par rapport auquel enregistrer. Vaut par défaut le fichier ETag enregistré. |
| `--force` | Non | Enregistre par-dessus les modifications apportées depuis l'ETag enregistré. |
| `--message <text>` | Non | Message d'enregistrement. |
| `--seller-id <id>` | Non | ID de vendeur Partner Center. |
| `--output <format>` | Non | `json` (par défaut), `json-compact` ou `table` avec les colonnes `TYPE`, `SANDBOX`, `VALIDATE ONLY`, `CAN COMMIT`, `COMMITTED`, `FILES` et `ETAG FILE`. |

Lorsque les XBOX services ne peuvent pas enregistrer les documents (`CanCommit` à false avec `--validate-only`,
sinon `Committed` à false), la commande écrit tout de même le résultat sur stdout, écrit chaque
message de validation sur stderr, laisse le fichier ETag inchangé et se termine avec le code 1 :

```text theme={null}
XBOX services can't save these documents:
Error: achievements2017.xml: The root namespace doesn't match the document type. (NamespaceDocTypeMismatch)
```

Des documents identiques aux derniers documents de travail ne constituent pas un échec : rien n'est enregistré,
`ValidationInfo` signale `FilesNotChangedCommit`, et la commande se termine avec le code 0.

#### Exemples de `config download` et `config save`

Télécharger les derniers documents de sandbox à l'état de brouillon dans `xbox-config` :

```bash theme={null}
xbox xbl config download \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 --view draft --dest xbox-config
```

Après avoir modifié les documents, validez-les tous, ou uniquement les deux que vous avez modifiés :

```bash theme={null}
xbox xbl config save \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 \
  --file "xbox-config/*.xml" --validate-only

xbox xbl config save \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 \
  --file xbox-config/achievements2017.xml --file xbox-config/localization.xml --validate-only
```

Les enregistrer avec un message :

```bash theme={null}
xbox xbl config save \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 \
  --file "xbox-config/*.xml" --message "Update achievements"
```

Télécharger un document tel qu'il était dans la version publiée 7 :

```bash theme={null}
xbox xbl config download \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 \
  --view published --version 7 --document achievements.xml --dest xbox-config
```

Télécharger les documents à l'état de brouillon du compte :

```bash theme={null}
xbox xbl config download --type account --view draft --dest xbox-config --output table
```

### `config publish`

Publiez une version de travail de la configuration des XBOX services dans la configuration publiée
d'un sandbox. La publication est asynchrone : démarrez-la avec `config publish`, puis exécutez
[`config status`](#config-list-and-config-status) pour le sandbox de destination jusqu'à ce que
`lastPublish.status` vaille `Success` ou `Failed`.

#### Sélection de la source

`--sandbox-id` est la destination. La source est une version de travail du sandbox source,
qui est par défaut la destination :

| Scénario | Effet |
| - | - |
| `--source-sandbox-id` omis ou égal à `--sandbox-id` | Publie la dernière version de travail du sandbox. |
| `--source-sandbox-id` différent de `--sandbox-id` | Publie la dernière version de travail du sandbox source dans la destination, et [remplace les fichiers de stockage de titre global de la destination](#cross-sandbox-publishing-replaces-global-title-storage-files). |
| `--configset <number>` | Publie cette version de travail du sandbox source. |

Lorsque le sandbox source comporte des modifications non publiées, sa dernière version de travail n'est pas celle qui est
en ligne dans ce sandbox. Une publication entre sandboxes sans `--configset` émet alors un avertissement et nomme la version
en ligne :

```text theme={null}
Warning: XDKS.1 has unpublished changes. This publish uses its latest working version, 53; what's live in XDKS.1 is working version 52. To publish that instead, add --configset 52.
```

Pour promouvoir exactement ce qui est en ligne dans la source, exécutez d'abord la commande avec `--validate-only` et ajoutez le
`--configset` qu'elle suggère. Dans la sortie JSON, `SourceVersion` est la version de travail utilisée,
`sourceHasUnpublishedChanges` indique si elle diffère de ce qui est en ligne dans la source, et
`sourceLiveVersion` est la version en ligne dans celle-ci, lorsqu'elle est trouvée.

Une publication à l'échelle du titre, `--sandbox-id HIDDEN`, publie toujours la dernière configuration de travail
de `ALL` ; elle n'accepte donc ni `--source-sandbox-id` ni `--configset`. Pour savoir quelle version sera mise
en ligne, exécutez d'abord `config status --sandbox-id ALL` et lisez `workingVersion`.

#### Confirmation

`config publish` demande une confirmation avant de publier dans les cas suivants :

| Publication | Raison de la demande |
| - | - |
| `--sandbox-id RETAIL` | Les joueurs voient la modification une fois la publication terminée. |
| `--sandbox-id CERT` ou `CERT.DEBUG` | La certification XBOX effectue ses tests dans ces sandboxes. |
| `--sandbox-id HIDDEN` | Publie la configuration à l'échelle du titre, que tous les sandboxes utilisent, y compris RETAIL. |
| `--source-sandbox-id` différent de `--sandbox-id` | Remplace d'abord les documents de travail de la destination qui portent les mêmes noms, ainsi que ses [fichiers de stockage de titre global](#cross-sandbox-publishing-replaces-global-title-storage-files). |

Dans un terminal, elle décrit la publication et demande une confirmation. Sans terminal, elle refuse et se termine avec le code 1.
`--confirm` (`--yes`, `-y`) ignore la question, et `--validate-only` ne demande jamais de confirmation. Consultez
[Sécurité et opérations destructrices](https://docs.xbox.com/fr/tools/xbox-cli/safety.md).

Avant de demander une confirmation pour une publication dans RETAIL, elle valide la publication et répertorie les
[succès qu'elle ajoute](#achievements-a-retail-publish-adds). Si vous répondez oui, elle publie
la version de travail qu'elle a validée ; ce qui est mis en ligne correspond donc à ce qui a été répertorié :

```console theme={null}
$ xbox xbl config publish --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --source-sandbox-id CERT --sandbox-id RETAIL
This publish adds 2 achievements to RETAIL: 1, 2. Once they're live in RETAIL, achievements can't be removed, and their unlock rules and gamerscore can't change.
This publishes working version 52 of CERT's configuration to RETAIL for SCID aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee.
RETAIL is live: players see the change when the publish finishes.
Publishing from CERT first replaces RETAIL's working documents that have the same names.
Warning: publishing from CERT to RETAIL replaces RETAIL's global title storage files with CERT's. Files with the same path are overwritten, files only CERT holds are added, and files only RETAIL holds are deleted. Deleted files can't be recovered.

Publish to RETAIL? [y/N]:
```

Lorsque cette validation échoue, elle ne publie rien et ne demande pas de confirmation. Ainsi, dans un terminal, une publication
dans RETAIL à l'aide de `--title-id` dans une configuration à laquelle d'autres titres sont liés nécessite
`--allow-shared-configuration`. Avec `--confirm`, aucune liste n'est affichée ; exécutez donc d'abord `--validate-only`
pour la voir.

#### Succès ajoutés par une publication dans RETAIL

Une fois que des succès sont en ligne dans RETAIL, ils ne peuvent plus être supprimés, et leurs règles de déverrouillage et leur
gamerscore ne peuvent plus changer. C'est pourquoi une publication dans RETAIL indique quels ID de succès elle ajoute alors que RETAIL
ne les possède pas encore :

* Avec `--validate-only`, la liste est écrite sur stderr, et la sortie JSON la contient dans
  `achievementChanges.added`.
* Dans un terminal sans `--validate-only`, la liste précède la question, comme indiqué
  dans [Confirmation](#confirmation).

```console theme={null}
$ xbox xbl config publish --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --source-sandbox-id CERT --sandbox-id RETAIL --validate-only
This publish would add 2 achievements to RETAIL: 1, 2. Once they're live in RETAIL, achievements can't be removed, and their unlock rules and gamerscore can't change.
```

Une publication qui n'en ajoute aucun l'indique. Les autres sandboxes ne répertorient pas les succès.

#### Republication

`config publish` ne publie que les modifications. Lorsque rien n'a changé depuis la dernière
publication réussie de la destination, aucune publication ne démarre, et le `Status` du résultat est `AlreadyPublished`. Après
l'échec d'une publication, exécuter de nouveau `config publish` la relance.

Il arrive que XBOX verrouille RETAIL pour un produit ; une publication de RETAIL vers RETAIL échoue alors avec
`retail_locked`. Pour publier malgré tout, ajoutez `--republish` : cette option force la
configuration sélectionnée, par défaut la dernière configuration de travail de RETAIL, dans RETAIL. Une publication dans
RETAIL depuis un autre sandbox, comme CERT, lève également le verrou, mais elle remplace les
documents de travail de RETAIL par ceux de ce sandbox.

`--republish` effectue une publication complète, même lorsque rien n'a changé. Elle ne peut pas être combinée avec
`--validate-only`.

#### Diagnostics

Les diagnostics de validation des XBOX services, comme l'avertissement émis pour une première publication dans RETAIL
sans embargo, sont écrits sur stderr, un par ligne. La sortie JSON les conserve dans
`ValidationResult`.

```text theme={null}
XBOX services warning (FirstRetailPublishWithoutEffectiveEmbargo): This is the first time these Xbox Gameplay Settings will be published to RETAIL, and no embargo is configured.
```

Lorsque la validation échoue, `config publish` se termine avec le code 1 et répertorie chaque message sous `validation`, comme
indiqué dans [Erreurs](#errors).

#### La publication entre sandboxes remplace les fichiers de stockage de titre global

> [!CAUTION]
>
> Une publication d'un sandbox vers un autre fait des fichiers de stockage de titre global de la destination
> une copie exacte de ceux de la source. Les fichiers que seule la destination possède sont supprimés et ne peuvent pas être
> récupérés.

Les fichiers globaux sont les fichiers que lit chaque joueur du jeu, comme les flux d'actualités et les cartes :

| Fichier | Source | Destination avant | Destination après |
| - | - | - | - |
| `news.json` | Présent | Présent | Remplacé par la copie de la source |
| `tuning.cfg` | Présent | — | Ajouté |
| `maps.bin` | — | Présent | **Supprimé** |

La copie reprend le contenu de la source au moment de l'exécution de la publication. Les données propres aux joueurs ne sont pas
touchées, et une publication au sein d'un même sandbox laisse les fichiers globaux intacts. Pour conserver un fichier de la destination,
ajoutez-le au sandbox source avant de publier.

Chaque publication entre sandboxes écrit cet avertissement sur stderr, y compris avec `--validate-only`,
et l'inclut dans la question de [confirmation](#confirmation) :

```text theme={null}
Warning: publishing from SANDBOX1 to SANDBOX2 replaces SANDBOX2's global title storage files with SANDBOX1's. Files with the same path are overwritten, files only SANDBOX1 holds are added, and files only SANDBOX2 holds are deleted. Deleted files can't be recovered.
```

#### Options de `config publish`

| Option | Alias | Obligatoire | Description |
| - | - | - | - |
| `--scid <guid>` | — | Ou titre | SCID de la configuration du titre. |
| `--title-id <hex-id>` | — | Ou SCID | ID de titre XBOX. Consultez [Ciblage du titre](#title-targeting). |
| `--sandbox-id <id>` | — | Oui | ID du sandbox de destination. Vaut par défaut `XBOX_SANDBOX_ID`, puis l'ID de sandbox enregistré. |
| `--source-sandbox-id <id>` | — | Non | ID du sandbox source. Vaut `--sandbox-id` par défaut. Non autorisée avec `--sandbox-id HIDDEN`. |
| `--validate-only` | — | Non | Valide sans publier. Pour RETAIL, répertorie également les [succès ajoutés par la publication](#achievements-a-retail-publish-adds). |
| `--allow-shared-configuration` | — | Non | Publie à l'aide de `--title-id` dans une configuration à laquelle d'autres titres sont liés, sans demander de confirmation. Consultez [Ciblage du titre](#title-targeting). |
| `--configset <number>` | — | Non | Version de travail positive du sandbox source. Vaut sa dernière version par défaut. Non autorisée avec `--sandbox-id HIDDEN`. |
| `--republish` | — | Non | Effectue une publication complète même lorsque rien n'a changé, ou dans un RETAIL verrouillé après une migration. Consultez [Republication](#republishing). |
| `--confirm` | `--yes`, `-y` | Non | Publie sans demander de confirmation. Consultez [Confirmation](#confirmation). |
| `--seller-id <id>` | — | Non | ID de vendeur Partner Center. |
| `--output <format>` | `-o` | Non | `json` (par défaut), `json-compact` ou `table` avec les colonnes `STATUS`, `SOURCE`, `DESTINATION`, `VALIDATE ONLY` et `SOURCE VERSION`. |

#### Exemples de `config publish`

Valider une publication dans SANDBOX1 sans publier :

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 --validate-only
```

Publier la dernière configuration de travail de SANDBOX1, afin qu'elle soit en ligne dans SANDBOX1 :

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1
```

Publier la dernière version de travail de SANDBOX1 dans SANDBOX2. Cette opération remplace également les fichiers de stockage de titre global
de SANDBOX2 par ceux de SANDBOX1 :

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --source-sandbox-id SANDBOX1 --sandbox-id SANDBOX2
```

Publier la version de travail 42 de SANDBOX1 dans SANDBOX2 :

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee \
  --source-sandbox-id SANDBOX1 --sandbox-id SANDBOX2 --configset 42
```

Valider une publication de CERT vers RETAIL, ce qui répertorie les succès qu'elle ajoute :

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --source-sandbox-id CERT --sandbox-id RETAIL --validate-only
```

Passez ensuite le `SourceVersion` de la sortie en tant que `--configset` pour publier la version que vous avez validée,
sans invite :

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --source-sandbox-id CERT --sandbox-id RETAIL --configset 52 --confirm
```

Publier de nouveau SANDBOX1 bien que rien n'ait changé :

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 --republish
```

Vérifier la publication dans SANDBOX2 :

```bash theme={null}
xbox xbl config status \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX2 --output table
```

***

## schema

Découvrez et téléchargez les schémas des documents de configuration des XBOX services.

| Commande | Description |
| - | - |
| `schema list` | Répertorie tous les types de schémas. |
| `schema list --type <type>` | Répertorie les versions d'un type de schéma. |
| `schema get --type <type>` | Obtient une version d'un type de schéma : son type, sa version et son espace de noms. Vaut la dernière version par défaut. |
| `schema download --dest <directory>` | Enregistre des XSD dans un répertoire : une version, toutes les versions d'un type, ou toutes les versions de tous les types. |
| `schema download --type <type> --version <n> --dest -` | Écrit un XSD sur stdout. |

### Options de `schema list`

| Option | Obligatoire | Description |
| - | - | - |
| `--type <type>` | Non | Type de schéma dont les versions sont à répertorier. Omettez-la pour répertorier tous les types. |
| `--output <format>` | Non | `json` (par défaut), `json-compact` ou `table` avec les colonnes `TYPE`, `VERSION`, `NAMESPACE`, `PATH` et `BYTES`. |

### Options de `schema get`

| Option | Obligatoire | Description |
| - | - | - |
| `--type <type>` | Oui | Type de schéma. |
| `--version <number>` | Non | Version positive du schéma. Vaut par défaut la dernière version du type. |
| `--output <format>` | Non | `json` (par défaut), `json-compact` ou `table` avec les colonnes `TYPE`, `VERSION` et `NAMESPACE`. |

`schema get` écrit un objet JSON :

```json theme={null}
{
  "type": "achievements2017",
  "version": 1,
  "namespace": "http://config.mgt.xboxlive.com/schema/achievements2017/1"
}
```

### Options de `schema download`

| Option | Obligatoire | Description |
| - | - | - |
| `--dest <directory>` | Oui | Répertoire des fichiers XSD enregistrés, ou `-` pour écrire un XSD sur stdout. `-` nécessite à la fois `--type` et `--version`. |
| `--type <type>` | Non | Type de schéma. Omettez-la pour télécharger tous les types. |
| `--version <number>` | Non | Version positive du schéma. Nécessite `--type`. Omettez-la pour télécharger toutes les versions. |
| `--output <format>` | Non | `json` (par défaut), `json-compact` ou `table` avec les colonnes `TYPE`, `VERSION`, `NAMESPACE`, `PATH` et `BYTES`. |

Chaque schéma est enregistré sous la forme `<type>_<version>.xsd`, avec le type en minuscules, et la commande
affiche les chemins enregistrés. Avec `--dest -`, elle écrit plutôt le XSD brut sur stdout, et
`--output` ne s'applique pas.

### Exemples de `schema`

```bash theme={null}
# List every schema type
xbox xbl schema list

# List versions of one type, as a table
xbox xbl schema list --type achievements2017 --output table

# Get the latest version of one type
xbox xbl schema get --type achievements2017

# Redirect one XSD straight to a file
xbox xbl schema download --type achievements2017 --version 1 --dest - > achievements2017_1.xsd

# Save one XSD into a directory
xbox xbl schema download --type achievements2017 --version 1 --dest schemas

# Download every version of one schema type
xbox xbl schema download --type achievements2017 --dest schemas

# Download every version of every schema type
xbox xbl schema download --dest schemas
```

***

## Un aller-retour de configuration type

1. Trouvez les sandboxes auxquels vous pouvez accéder :

   ```bash theme={null}
   xbox sandbox list --output table
   ```

2. Consultez l'état de la configuration de travail et de la configuration publiée :

   ```bash theme={null}
   xbox xbl config list \
     --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --output table
   ```

3. Téléchargez l'ensemble de documents à l'état de brouillon, ce qui enregistre également `SANDBOX1.etag` :

   ```bash theme={null}
   xbox xbl config download \
     --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 --view draft --dest xbox-config
   ```

4. Modifiez les documents dans `xbox-config`, puis validez-les :

   ```bash theme={null}
   xbox xbl config save \
     --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 \
     --file "xbox-config/*.xml" --validate-only
   ```

5. Enregistrez-les :

   ```bash theme={null}
   xbox xbl config save \
     --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 \
     --file "xbox-config/*.xml" --message "Update configuration"
   ```

6. Publiez-les dans SANDBOX1 :

   ```bash theme={null}
   xbox xbl config publish \
     --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1
   ```

7. Vérifiez la publication, et recommencez jusqu'à ce que son état soit `Success` ou `Failed` :

   ```bash theme={null}
   xbox xbl config status \
     --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 --output table
   ```


## Related topics

- [Configuration des XBOX services](https://docs.xbox.com/fr/publishing/game-publishing/concepts/xbox-services.md)
- [Configuration des services XBOX dans Partner Center](https://docs.xbox.com/fr/services/xbox-services/fundamentals/portal-config/live-config-xbl-setup.md)
- [Authentification des services XBOX](https://docs.xbox.com/fr/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/live-xbox-live-authentication.md)
- [Sandboxes avancés des services XBOX](https://docs.xbox.com/fr/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
- [API des services XBOX](https://docs.xbox.com/fr/services/xbox-services/fundamentals/xbox-services-api/index.md)
