> ## 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, y compris 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 pourrait changer
ou être retirée en fonction des commentaires.

`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 sandbox que ciblent les commandes de configuration,
utilisez [`xbox sandbox list`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/sandbox).

Ces commandes fonctionnent avec la même configuration que celle que modifie Partner Center. Pour savoir ce que fait chaque
fonctionnalité des XBOX services et comment la configurer, consultez
[Vue d'ensemble de la configuration dans le 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` | Inspecter l'état de la configuration de travail et de la configuration publiée, télécharger et enregistrer des documents de configuration, et publier la 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-CA/tools/xbox-cli/commands/xbl/achievement-image) | `upload`, `get`, `list`, `download` | Inscrire, inspecter ou télécharger des images de succès. |

## Comportement commun

### Vendeur et sandbox

Toutes les commandes, sauf les 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-CA/tools/xbox-cli/commands/context), puis votre seul
vendeur; si vous en avez plusieurs, transmettez `--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-CA/tools/xbox-cli/commands/context.md). `--scid` ignore les deux.

* `--title-id` est en hexadécimal, comme l'affiche [`game get`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/game) : de `00000001` à
  `7FFFFFFF`, avec un préfixe `0x` facultatif. Pour les autres ID de titre, transmettez 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` effectués avec l'ID d'un titre lié sont refusés, même avec
  `--validate-only` (`bound_title_requires_scid`). L'erreur nomme le titre principal et le
  SCID; exécutez de nouveau la commande avec ce `--scid`.
* L'enregistrement ou la publication avec `--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, la commande échoue. `--allow-shared-configuration` ignore la question. Une écriture avec
  `--scid` ne demande pas de confirmation.
* `config save` et `config publish` écrivent dans stderr le vendeur et le SCID qu'ils 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.

### Erreurs

Une requête qui échoue se termine avec le code 1 et écrit dans 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 le libellé de
`detail`. Une erreur 429 inclut `retryAfterSeconds`; consultez
[Limites de débit](https://docs.xbox.com/fr-CA/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 qui a échoué
a pu être appliquée :

| Code de sortie | Signification |
| - | - |
| 1 | Rien n'a été modifié : la requête a été arrêtée 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. |

Avec le code de sortie 3, ne soumettez pas de nouveau la requête. stderr affiche une commande en lecture seule pour 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

Inspectez, 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 voient les joueurs et les comptes de test 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 sandbox 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 versions de travail et publiées les plus récentes, l'heure de validation (commit) de chaque
version, et si la version de travail comporte des modifications non publiées. L'heure de validation d'une version publiée est
l'heure de validation de cette version, et non le moment où la publication s'est terminée.

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

| Champ de `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 le titre | SCID de la configuration du titre. |
| `--title-id <hex-id>` | Ou le 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 le titre | SCID de la configuration du titre. |
| `--title-id <hex-id>` | Ou le SCID | ID de titre XBOX. Consultez [Ciblage du titre](#title-targeting). |
| `--sandbox-id <id>` | Oui | ID de sandbox, sensible à la casse. Valeur 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 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 de `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 (la valeur par défaut, qui nécessite un SCID ou un titre ainsi que `--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 le nom `<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; transmettez `--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 modifie `config save`, 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. Valeur par défaut : `sandbox`. |
| `--scid <guid>` | Ou le titre pour `sandbox` | SCID de la configuration du titre. |
| `--title-id <hex-id>` | Ou le 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. Valeur par défaut : la version la plus récente. |
| `--document <filename>` | Non | Nom du fichier de document à télécharger. Répétez l'option pour en ajouter d'autres. Valeur par défaut : tous les documents. |
| `--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 un modèle chacun : `--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. Valeur par défaut : `sandbox`. |
| `--scid <guid>` | Ou le titre pour `sandbox` | SCID de la configuration du titre. |
| `--title-id <hex-id>` | Ou le 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 avec `--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. Valeur 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` est false avec `--validate-only`,
sinon `Committed` est false), la commande écrit tout de même le résultat dans stdout, écrit chaque
message de validation dans 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 documents de travail les plus récents 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 de `config save`

Télécharger les documents de sandbox de brouillon les plus récents 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 seulement 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 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` soit `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 version de travail la plus récente du sandbox. |
| `--source-sandbox-id` différent de `--sandbox-id` | Publie la version de travail la plus récente du sandbox source dans la destination, et [remplace les fichiers de stockage de titre globaux 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 version de travail la plus récente n'est pas celle qui est
en ligne dans ce sandbox. Une publication entre sandbox sans `--configset` affiche alors un avertissement et nomme la version
qui est 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 qui y est en ligne, lorsqu'elle est trouvée.

Une publication à l'échelle du titre, `--sandbox-id HIDDEN`, publie toujours la configuration de travail la plus récente
dans `ALL`; elle n'accepte donc ni `--source-sandbox-id` ni `--configset`. Pour voir 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 sandbox. |
| `--sandbox-id HIDDEN` | Publie la configuration à l'échelle du titre, qu'utilisent tous les sandbox, 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 globaux](#cross-sandbox-publishing-replaces-global-title-storage-files). |

Dans un terminal, la commande 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 destructives](https://docs.xbox.com/fr-CA/tools/xbox-cli/safety.md).

Avant de demander une confirmation pour une publication dans RETAIL, la commande 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, la commande ne publie rien et ne demande pas de confirmation. Ainsi, dans un terminal, une publication dans RETAIL
avec `--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. Une publication dans RETAIL indique donc les ID des succès qu'elle ajoute et que RETAIL
n'a pas encore :

* Avec `--validate-only`, la liste est écrite dans stderr, et la sortie JSON la contient dans
  `achievementChanges.added`.
* Dans un terminal sans `--validate-only`, la liste précède la question, comme le montre
  la section [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 sandbox ne répertorient pas les succès.

#### Republication

`config publish` publie seulement 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 `config publish` de nouveau la relance.

Il arrive qu'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 impose la configuration
sélectionnée, par défaut la configuration de travail la plus récente de RETAIL, à RETAIL. Une publication dans
RETAIL à partir d'un autre sandbox, comme CERT, lève aussi 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 lors d'une première publication dans RETAIL
sans embargo, sont écrits dans 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
le montre la section [Erreurs](#errors).

#### La publication entre sandbox remplace les fichiers de stockage de titre globaux

> [!CAUTION]
>
> La publication d'un sandbox à un autre fait des fichiers de stockage de titre globaux 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 lisent tous les joueurs du jeu, comme les fils 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 tout ce que contient 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 dans le 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 sandbox écrit cet avertissement dans 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 le titre | SCID de la configuration du titre. |
| `--title-id <hex-id>` | — | Ou le SCID | ID de titre XBOX. Consultez [Ciblage du titre](#title-targeting). |
| `--sandbox-id <id>` | — | Oui | ID du sandbox de destination. Valeur par défaut : `XBOX_SANDBOX_ID`, puis l'ID de sandbox enregistré. |
| `--source-sandbox-id <id>` | — | Non | ID du sandbox source. Valeur par défaut : `--sandbox-id`. Non autorisée avec `--sandbox-id HIDDEN`. |
| `--validate-only` | — | Non | Valide sans publier. Pour RETAIL, répertorie aussi les [succès qu'ajoute la publication](#achievements-a-retail-publish-adds). |
| `--allow-shared-configuration` | — | Non | Publie avec `--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. Valeur par défaut : la plus récente. 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 configuration de travail la plus récente de SANDBOX1, pour 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 version de travail la plus récente de SANDBOX1 dans SANDBOX2. Cette opération remplace aussi les fichiers de stockage de titre
globaux 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
```

Transmettez ensuite le `SourceVersion` de la sortie comme `--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 même si rien n'a 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. Valeur par défaut : la version la plus récente. |
| `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 dans stdout. |

### Options de `schema list`

| Option | Obligatoire | Description |
| - | - | - |
| `--type <type>` | Non | Type de schéma dont il faut répertorier les versions. 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. Valeur par défaut : la version la plus récente 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 dans 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 le nom `<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 dans 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 typique

1. Trouvez les sandbox auxquels vous avez accès :

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

2. Vérifiez 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 de brouillon, ce qui enregistre aussi `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 répétez l'opération 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-CA/publishing/game-publishing/concepts/xbox-services.md)
- [Authentification des services XBOX](https://docs.xbox.com/fr-CA/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/live-xbox-live-authentication.md)
- [Configuration des services XBOX dans Partner Center](https://docs.xbox.com/fr-CA/services/xbox-services/fundamentals/portal-config/live-config-xbl-setup.md)
- [Sandboxes avancés des services XBOX](https://docs.xbox.com/fr-CA/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
- [API des services XBOX](https://docs.xbox.com/fr-CA/services/xbox-services/fundamentals/xbox-services-api/index.md)
