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

# Compte de test

> Créez, mettez à jour et supprimez des lots de comptes de test XBOX, suivez leurs travaux de création, lisez les lots avec leurs comptes et vérifiez si l'accès du lot d'un compte a expiré.

Les comptes de test XBOX sont créés par lots pour un vendeur Partner Center. Ces commandes créent,
mettent à jour et suppriment des lots, suivent le travail qui crée les comptes, et lisent les lots et les
comptes qu'ils contiennent. Elles ne peuvent pas modifier des comptes individuels, et elles ne retournent jamais de mots de passe. Votre
compte doit avoir le rôle de compte de test Partner Center pour le vendeur.

Chaque commande accepte `--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`.

## Commandes

| Commande | Description |
| - | - |
| `test-account batch list` | Répertorie les lots de comptes de test du vendeur, du plus récent au plus ancien. |
| `test-account batch get <batch-id>` | Affiche un lot et ses comptes. |
| `test-account get <email>` | Trouve le lot qui contient un compte et indique si son accès a expiré. Consultez [Rechercher un compte](#looking-up-an-account). |
| `test-account batch create` | Crée un lot de comptes de test et attend la fin de son travail de création. Consultez [Créer un lot](#creating-a-batch). |
| `test-account batch update <batch-id>` | Modifie les sandbox, l'expiration de l'accès aux sandbox ou les étiquettes d'un lot, et attend que le lot les affiche. Consultez [Mettre à jour un lot](#updating-a-batch). |
| `test-account batch delete <batch-id>` | Supprime un lot et attend qu'il n'existe plus. Consultez [Supprimer un lot](#deleting-a-batch). |
| `test-account job get <job-id>` | Affiche une fois l'état d'un travail de création. |
| `test-account job wait <job-id>` | Attend un travail de création jusqu'à ce qu'il cesse de s'exécuter ou que le délai d'attente expire. |

`batch create`, `batch update` et `batch delete` demandent une confirmation avant de modifier quoi que ce soit, et sont
envoyées une seule fois, sans jamais de nouvelle tentative. Consultez [Sécurité et opérations destructives](https://docs.xbox.com/fr-CA/tools/xbox-cli/safety.md).

## Options de lecture des lots

| Option | Commandes | Description |
| - | - | - |
| `--seller-id <id>` | `batch list`, `batch get`, `test-account get` | ID de vendeur Partner Center. |
| `--mine` | `list` | Seulement les lots que vous avez créés. Ne peut pas être combinée avec `--created-by-id`. |
| `--created-by-id <id>` | `list` | Seulement les lots créés par cet ID d'utilisateur Partner Center numérique. Ne peut pas être combinée avec `--mine`. |
| `--email-prefix <text>` | `list` | Seulement les lots dont le modèle d'adresse courriel commence par ce texte, sans tenir compte de la casse. |
| `--tag <tag>` | `list` | Seulement les lots qui ont exactement cette étiquette. Accepte une seule valeur. |
| `--state <state>` | `list` | `complete` ou `pending`, en minuscules. |
| `--limit <count>` | `list` | Retourne au plus ce nombre de lots correspondants parmi les plus récents. |
| `--include-sandboxes` | `list` | Retourne aussi les étiquettes (`keywords`) et le `sandboxAccess` de chaque lot. Sans `--limit`, répertorie au plus les 10 lots correspondants les plus récents; définissez `--limit` pour en répertorier davantage. |
| `--expired` | `list` | Seulement les lots dont l'accès aux sandbox a expiré. `--limit` s'applique alors aux lots expirés. Consultez [Lots expirés](#expired-batches). |
| `--output <format>` | `batch list`, `batch get`, `test-account get` | `json` (par défaut), `json-compact` ou `table`. |

Les étiquettes apparaissent sous le nom `keywords` dans la sortie JSON et dans les codes d'erreur comme
`test_account_keyword_invalid`. `--tag` correspond à une étiquette entière, et non à une partie d'étiquette.

Si vous ne pouvez pas lire tous les lots du vendeur, vous n'obtenez aucune erreur : `batch list` retourne seulement les
lots que vous avez créés.

### Lots expirés

Un lot est expiré une fois que sa date `accessExpirationDate`, soit la date de fin de son accès aux sandbox, est
passée. Un lot sans date n'expire jamais. L'expiration n'indique pas si les comptes peuvent toujours
se connecter.

`batch list --expired` lit toute la liste du vendeur pour trouver les lots expirés; elle est donc
plus lente pour un vendeur qui a beaucoup de lots. Elle ne peut pas être combinée avec `--include-sandboxes`; exécutez
`batch get` sur un lot expiré pour voir son accès aux sandbox.

## Forme de la réponse

`list` retourne :

```json theme={null}
{
  "batches": [
    {
      "id": 123456,
      "emailTemplate": "ABCDEF-smoke",
      "batchSize": 2,
      "createdBy": 7654321,
      "familyPermission": "Adult",
      "creationDate": "2026-09-12T04:00:00+00:00",
      "accessExpirationDate": "2027-03-12T04:00:00+00:00",
      "locale": "en-US",
      "keywords": null,
      "sandboxAccess": null,
      "isComplete": true,
      "jobId": null,
      "progress": null
    }
  ]
}
```

* `keywords` et `sandboxAccess` sont `null`, sauf si vous transmettez `--include-sandboxes`. `get`
  les retourne toujours.
* `isComplete` signifie que le travail de création s'est arrêté, et non que tous les comptes ont été créés. Comparez
  le nombre de comptes retournés par `get` avec `batchSize`, et lisez `progress` pour obtenir le message
  d'état.
* `createdBy` est un ID d'utilisateur Partner Center numérique.
* `jobId` est le travail en cours d'exécution du lot, et a la valeur `null` une fois le travail arrêté. Les travaux de mise à jour et de suppression
  apparaissent aussi ici, mais seul un travail de création peut être suivi avec
  [`job wait`](#following-a-creation-job).

`get` retourne le même objet de lot, ainsi que ses comptes :

```json theme={null}
{
  "batch": { "id": 123456, "batchSize": 2, "isComplete": true },
  "accounts": [
    {
      "xuid": "2814600000000001",
      "email": "ABCDEF-smoke-1@example.com",
      "gamertag": "SmokeOne",
      "isDeleted": false
    }
  ]
}
```

Chaque compte contient seulement `xuid`, `email`, `gamertag` et `isDeleted`. `xuid` est une chaîne.

## Erreurs lors de la lecture des lots

`batch list`, `batch get` et `test-account get` se terminent avec le code 1 en cas d'échec. Lorsque le service retourne
une erreur JSON, stderr reçoit une erreur JSON avec `status`, `title`, `detail`, `code` lorsque la
réponse en contient un, et son `correlationId`; la plupart ajoutent un conseil dans `detail`. Les autres échecs
affichent une ligne de texte. Vérifiez le code de sortie avant d'analyser stderr.

| État | Signification |
| - | - |
| 400 | Un filtre a été rejeté, ou vous avez plusieurs vendeurs et n'en avez choisi aucun; transmettez `--seller-id`. |
| 403 | Vous n'êtes pas membre de ce vendeur, ou vous n'avez pas le rôle de compte de test Partner Center pour celui-ci. Pour `batch get`, le lot appartient peut-être à un autre vendeur (transmettez `--seller-id`), ou un autre développeur l'a créé et vous ne pouvez pas lire tous les lots du vendeur. Si l'erreur vous demande de vous connecter de nouveau, faites-le. |
| 404 | Aucun lot avec cet ID n'existe, ou les comptes de test ne sont pas encore disponibles. |
| 429 | Avec le code `rate_limited`, vous avez envoyé trop de requêtes en peu de temps. L'erreur inclut `retryAfterSeconds`; consultez [Limites de débit](https://docs.xbox.com/fr-CA/tools/xbox-cli/cli-for-agents.md#rate-limits). |
| 502 | Le service n'a pas pu traiter la requête; réessayez. Le service peut retourner 502 plutôt que 403 lorsque vous n'avez pas le rôle de compte de test ou, pour `batch get`, lorsqu'un autre développeur a créé le lot. Avec un compte Microsoft personnel, une nouvelle tentative n'aide pas; consultez [Problèmes connus](https://docs.xbox.com/fr-CA/tools/xbox-cli/known-issues.md#some-commands-dont-work-yet-with-a-personal-microsoft-account). |
| 503 | Les comptes de test ne sont pas disponibles. |
| 504 | Le service n'a pas répondu à temps; réessayez. |

## Rechercher un compte

`test-account get <email>` indique si le lot qui contient un compte a expiré. L'adresse courriel
doit se terminer par `@xboxtest.com`. La commande effectue la recherche dans les 10 lots les plus récents dont le modèle
d'adresse courriel correspond au nom du compte. Lorsqu'elle n'y trouve pas le compte, elle indique que les lots plus
anciens n'ont pas été examinés et affiche des commandes `batch list` et `batch get` pour les vérifier
vous-même.

Elle retourne ce qui suit, abrégé ici; `batch` contient tous les champs de lot que `batch list`
retourne :

```json theme={null}
{
  "account": { "xuid": "2814600000000001", "email": "ABCD-tester00007@xboxtest.com", "gamertag": "TesterSeven", "isDeleted": false },
  "batch": { "id": 123456, "emailTemplate": "ABCD-tester", "accessExpirationDate": "2026-01-01T00:00:00+00:00" },
  "expired": true,
  "expiredOn": "2026-01-01T00:00:00+00:00"
}
```

`expiredOn` est `null` lorsque le lot n'a pas expiré. Un compte supprimé est signalé seulement lorsqu'aucune
copie active n'existe, avec `account.isDeleted` défini. La commande se termine avec le code 0 chaque fois qu'elle trouve le
compte, expiré ou non; les scripts doivent donc lire `expired`. Elle se termine avec le code 1 dans les cas suivants :

* Le compte ne se trouve pas dans les lots que vous pouvez voir. Il appartient peut-être à un autre vendeur; essayez donc
  `--seller-id`. Ou encore, un autre développeur a créé son lot et vous ne pouvez pas lire tous les lots
  du vendeur.
* L'adresse courriel figure dans plus d'un lot. stderr répertorie une commande `batch get` pour chacun.
* Une requête échoue, comme décrit dans [Erreurs lors de la lecture des lots](#errors-when-reading-batches).

## Créer un lot

`batch create` démarre un travail qui crée les comptes, puis attend qu'il s'arrête. Les comptes
sont comptabilisés dans la limite de comptes de test du vendeur jusqu'à ce que le lot soit
[supprimé](#deleting-a-batch).

Dans un terminal, la commande affiche le [sélecteur de question de sécurité](#choosing-a-security-question),
répertorie les valeurs qu'elle enverra, y compris les valeurs par défaut des options que vous avez omises, et vous demande de
confirmer. Elle vous [invite](#secrets) ensuite à entrer le mot de passe et la réponse de sécurité, se connecte et envoie
la requête. `--confirm` (`--yes`, `-y`) ignore seulement la confirmation.

Sans terminal, transmettez `--password-file`, `--security-answer-file` et `--confirm`. Sans
`--confirm`, la commande affiche les valeurs, refuse et n'envoie rien.

| Option | Description |
| - | - |
| `--email-prefix <text>` | Obligatoire. Le groupe de sandbox, un trait d'union et un modèle, par exemple `ABCD-tester`. Le groupe de sandbox est la partie d'un ID de sandbox avant le point, comme `ABCD` dans `ABCD.1`. |
| `--count <count>` | Obligatoire. Nombre de comptes à créer; au moins 1. Le service définit le maximum. |
| `--sandbox-id <id>` | Obligatoire. Un sandbox auquel les comptes peuvent accéder. Répétez l'option pour ajouter d'autres sandbox. |
| `--password-file <path>` | Fichier contenant le mot de passe des comptes, ou `-` pour stdin. Consultez [Secrets](#secrets). |
| `--security-answer-file <path>` | Fichier contenant la réponse de sécurité, ou `-` pour stdin. Consultez [Secrets](#secrets). |
| `--child-count <count>` | Nombre total de comptes enfants dans le lot, tous liés au premier compte; 0 ou plus. `--count 5 --child-count 2` crée 5 comptes et 2 enfants, et non 2 pour chacun. Le service définit le maximum. |
| `--first-name <text>` | Valeur par défaut : `Test`. |
| `--last-name <text>` | Valeur par défaut : `Account`. |
| `--security-question <text>` | La question de sécurité attribuée à chaque compte. Consultez [Choisir une question de sécurité](#choosing-a-security-question). |
| `--alternate-email <text>` | Valeur par défaut : votre adresse courriel. |
| `--access-expiration <date>` | Moment où l'accès aux sandbox expire, comme `2026-12-31`, interprété en UTC. Valeur par défaut : dans trois mois. |
| `--tag <tag>` | Une étiquette à stocker sur le lot, que `batch list --tag` pourra retrouver plus tard. Répétez l'option pour ajouter d'autres étiquettes. |
| `--locale <locale>` | Valeur par défaut : `en-US`. |
| `--subscription <name>` | Le niveau des comptes pour les XBOX services, `Silver` ou `Gold`, sans tenir compte de la casse. Valeur par défaut : `Gold`. |
| `--seller-id <id>` | Vendeur pour lequel créer les comptes. |
| `--confirm`, `--yes`, `-y` | Crée le lot sans invite de confirmation. |
| `--no-wait` | Retourne dès que le service accepte le travail. Ne peut pas être combinée avec `--timeout`. |
| `--timeout <duration>` | Durée d'attente du travail, comme `90s`, `10m`, `2h` ou `1d`. Valeur par défaut : `5m`; au maximum `7d`. |
| `--output <format>` | `json` (par défaut), `json-compact` ou `table`. |

### Choisir une question de sécurité

Dans un terminal, lorsque vous ne transmettez ni `--security-question` ni `--security-answer-file`, la
commande affiche un sélecteur numéroté contenant ces questions. Entrée sélectionne la première. Pour en choisir une
sans le sélecteur, transmettez son texte avec `--security-question` :

1. What is your favorite hobby?
2. Who is your favorite athlete?
3. What is your maternal grandmother's first name?
4. What was your childhood best friend's first name?
5. What was the name of your first pet?
6. What is your current best friend's first name?
7. What was your favorite city to visit as a child?

Sans terminal, ou avec un fichier de réponse et sans question, la question est
`What is your favorite hobby?`. Ctrl+C dans le sélecteur annule l'opération sans rien créer.
Le choix d'une question ne confirme pas la création.

### Secrets

Le mot de passe et la réponse de sécurité ne sont jamais acceptés comme valeurs d'option ni comme variables
d'environnement; ils restent ainsi absents de l'historique de l'interpréteur de commandes, des listes de processus et des journaux. Chacun provient :

* De son option `--password-file` ou `--security-answer-file`. Un seul saut de ligne final est supprimé.
* De `-` à la place d'un chemin, qui le lit à partir de stdin. Seul l'un des deux peut lire stdin.
* En l'absence d'option de fichier, d'une invite dans le terminal qui n'affiche pas ce que vous tapez.

Le mot de passe doit comporter de 8 à 16 caractères et contenir au moins trois des éléments suivants : lettres minuscules,
lettres majuscules, chiffres et symboles. Le trait de soulignement ne compte pas comme un symbole. Le mot de passe
ne peut pas être identique à la réponse de sécurité.

### Attente et codes de sortie

Pendant l'attente, la commande affiche la progression dans stderr. Elle écrit le travail final dans stdout, sous
la même forme que [`job get`](#following-a-creation-job).

| Code de sortie | Signification |
| - | - |
| 0 | Le travail a réussi, ou a été accepté avec `--no-wait`. stderr indique la commande pour le suivre. |
| 1 | Rien n'a été créé : la requête a été refusée ou rejetée, a échoué ou a été annulée avant son envoi, ou a reçu une erreur 503 avec `feature_disabled` ou `service_configuration_invalid`. |
| 2 | Le travail a échoué. Certains comptes ont peut-être été créés; stderr indique les nombres et la commande pour inspecter le lot. |
| 3 | Le résultat est inconnu. Consultez [Lorsque le résultat est inconnu](#when-the-outcome-is-unknown). |
| 4 | Le lot existe, mais l'attente a pris fin avant l'arrêt du travail : le délai `--timeout` s'est écoulé, vous avez appuyé sur Ctrl+C, ou la lecture du travail a échoué. Le travail continue de s'exécuter. stderr indique la commande pour reprendre l'attente. Ne créez pas le lot de nouveau. |

### Lorsque le résultat est inconnu

Lorsque la CLI ne peut pas déterminer si le service a créé un lot, par exemple lorsque la connexion est interrompue
après l'envoi de la requête ou que le service retourne une erreur `5xx`, elle se termine avec le code 3. Elle n'envoie jamais
la création de nouveau. stderr affiche l'heure à laquelle la requête a commencé, en UTC, ainsi que ces étapes :

1. Attendez quelques minutes; un lot encore en cours de création pourrait ne pas encore être répertorié.
2. Exécutez `xbox test-account batch list --mine --email-prefix <prefix>` et recherchez un lot avec
   le même préfixe d'adresse courriel et le même modèle, créé à cette heure ou après.
3. Si le `jobId` de ce lot est défini, suivez-le avec
   `xbox test-account job wait <job-id> --batch-id <batch-id>`. Si `jobId` est `null`, le travail s'est
   arrêté; inspectez-le avec `xbox test-account batch get <batch-id>`.
4. Créez le lot de nouveau seulement si aucun lot de ce type n'existe.

Les commandes affichées conservent les options de vendeur, de profil et de connexion que vous avez utilisées; vous pouvez donc les copier
telles quelles.

### Erreurs lors de la création

Les échecs écrivent dans stderr une erreur JSON avec `status`, `title`, `detail`, et `code` lorsque la
réponse en contient un. Basez votre logique sur `code`, et non sur `detail`.

| Code | Signification |
| - | - |
| `test_account_sandbox_access_denied` | Vous ne pouvez pas accorder l'accès à l'une des valeurs de `--sandbox-id`. Si tous les sandbox sont refusés, votre compte n'est peut-être pas lié au vendeur, le vendeur n'a peut-être aucun sandbox, ou Partner Center ne vous permet peut-être pas de gérer les comptes de test. |
| `test_account_count_invalid` | `--count` est en dehors des valeurs autorisées par le service. |
| `test_account_child_count_invalid` | `--child-count` est en dehors des valeurs autorisées par le service. |
| `test_account_email_prefix_invalid` | `--email-prefix` n'est pas composé d'un groupe de sandbox, d'un trait d'union et d'un modèle, comme `ABCD-tester`. |
| `test_account_name_invalid` | `--first-name` ou `--last-name` a été rejeté. |
| `test_account_password_invalid` | Le mot de passe ne respecte pas les règles de mot de passe. |
| `test_account_security_question_invalid` | `--security-question` a été rejeté. |
| `test_account_security_answer_invalid` | La réponse de sécurité a été rejetée, par exemple parce qu'elle est identique au mot de passe ou qu'elle figure dans la question de sécurité. |
| `test_account_alternate_email_invalid` | `--alternate-email` a été rejeté. |
| `test_account_keyword_invalid` | Une valeur de `--tag` a été rejetée, ou il y en a trop. |
| `test_account_locale_invalid` | `--locale` n'est pas pris en charge; essayez `en-US`. |
| `test_account_subscription_unavailable` | Ce `--subscription` n'est pas disponible; essayez `--subscription Silver`. |
| `test_account_limit_exceeded` | Le vendeur a atteint sa limite de comptes de test. |
| `test_account_access_denied` | Vous n'avez pas le rôle Partner Center permettant de créer des comptes de test pour ce vendeur. |
| `test_account_create_outcome_unknown` | Code de sortie 3; consultez [Lorsque le résultat est inconnu](#when-the-outcome-is-unknown). |
| `downstream_request_rejected` | La requête a été rejetée sans qu'un champ soit nommé, par exemple parce que le groupe de `--email-prefix` ne fait pas partie de vos groupes de sandbox, ou que la question ou la réponse de sécurité est trop longue. |
| `downstream_throttled` | Les requêtes sont limitées et rien n'a été créé. Attendez, puis réessayez. |
| `rate_limited` | 429 : vous avez envoyé trop de requêtes en peu de temps et rien n'a été créé. Consultez [Limites de débit](https://docs.xbox.com/fr-CA/tools/xbox-cli/cli-for-agents.md#rate-limits). |
| Tout autre code, ou aucun, avec une erreur 5xx | Code de sortie 3, car un lot pourrait exister; consultez [Lorsque le résultat est inconnu](#when-the-outcome-is-unknown). |
| `feature_disabled`, `service_configuration_invalid` | 503 : la création de comptes de test n'est pas disponible. Code de sortie 1. |
| `invalid_request`, ou une erreur `400` sans code | La requête était mal formée ou une valeur n'est pas autorisée; `detail` ou `errors` nomme le champ. Une CLI plus récente que le service peut obtenir cette erreur pour une option que le service ne prend pas encore en charge. |

## Suivre un travail de création

`batch create` affiche les ID du lot et du travail dès que le travail est accepté. Un travail peut s'exécuter pendant
des jours; vous pouvez donc arrêter l'attente à tout moment et le suivre plus tard :

| Option | Commandes | Description |
| - | - | - |
| `<job-id>` | `get`, `wait` | Obligatoire. L'ID du travail provenant de `batch create`, ou le `jobId` d'un lot provenant de `batch list`. |
| `--batch-id <id>` | `get`, `wait` | Obligatoire. Le lot auquel appartient le travail. |
| `--seller-id <id>` | `get`, `wait` | Vendeur propriétaire du lot. |
| `--timeout <duration>` | `wait` | Durée d'attente, comme `90s`, `10m`, `2h` ou `1d`. Valeur par défaut : `5m`; au maximum `7d`. |
| `--output <format>` | `get`, `wait` | `json` (par défaut), `json-compact` ou `table`. |

Les deux commandes retournent le travail :

```json theme={null}
{
  "batchId": 123456,
  "jobId": "0f8e5b2a-1c3d-4e5f-8a9b-0c1d2e3f4a5b",
  "state": "running",
  "total": 5,
  "succeeded": 3,
  "failed": 0,
  "errorCode": null,
  "errorMessage": null,
  "progress": "Creating accounts"
}
```

`state` est `running`, `succeeded` ou `failed`. `errorCode` est `test_account_job_failed` lorsque le
travail a échoué. `job wait` fait de nouvelles tentatives en cas d'échecs de lecture temporaires, comme une limitation ou une
connexion interrompue.

| Code de sortie | `job get` | `job wait` |
| - | - | - |
| 0 | En cours d'exécution ou réussi | Réussi |
| 1 | La requête a échoué | La première lecture a échoué, par exemple en raison d'un ID de travail ou de lot erroné; rien n'est écrit dans stdout |
| 2 | Échec | Échec |
| 4 | Non utilisé | L'attente a pris fin avant l'arrêt du travail : le délai `--timeout` s'est écoulé, vous avez appuyé sur Ctrl+C, ou la lecture du travail a échoué. Le travail continue de s'exécuter. stderr indique la commande pour reprendre l'attente; exécutez-la une fois l'erreur dans stderr corrigée ou disparue. |

### Erreurs lors du suivi d'un travail

Ces codes d'erreur concernent l'ID du travail, `--batch-id` ou `--seller-id` :

| `code` | Signification |
| - | - |
| `test_account_job_not_in_batch` | 404 : le travail ne se trouve pas dans le lot nommé par `--batch-id`. |
| `test_account_batch_not_found` | 404 : ce lot n'existe pas pour ce vendeur. |
| `downstream_request_rejected` | 404 : aucun travail avec cet ID n'existe. |
| `test_account_access_denied` | 403 : le lot ou le travail appartient à un autre vendeur; `--batch-id` ou `--seller-id` est donc peut-être erroné. Sinon, un autre développeur a démarré le travail et vous ne pouvez pas lire tous les lots du vendeur. |

## Mettre à jour un lot

`batch update` modifie tous les comptes d'un lot : elle peut leur donner accès à d'autres sandbox,
leur retirer un accès, modifier la date d'expiration de cet accès, et ajouter des étiquettes au lot ou remplacer ses étiquettes. Elle
attend ensuite que le lot affiche la modification.

Dans un terminal, la commande affiche d'abord chaque modification demandée à côté de la valeur actuelle
du lot, avertit lorsqu'un travail est encore en cours d'exécution sur le lot, et demande une confirmation. Transmettez `--confirm` (`--yes`,
`-y`) pour ignorer l'invite. Sans terminal et sans `--confirm`, elle affiche les modifications,
refuse et n'envoie rien.

| Option | Description |
| - | - |
| `<batch-id>` | Obligatoire. L'ID du lot, provenant de `batch list` ou de `batch create`. |
| `--add-sandbox-id <id>` | Sandbox auquel donner accès aux comptes. Répétez l'option pour ajouter d'autres sandbox. |
| `--remove-sandbox-id <id>` | Sandbox auquel retirer l'accès des comptes. Répétez l'option pour d'autres sandbox. Un sandbox ne peut pas être à la fois ajouté et retiré. |
| `--access-expiration <date>` | Nouvelle date d'expiration de l'accès aux sandbox des comptes, comme `2026-12-31`. Elle doit être dans le futur, et le service ne conserve que le jour. Le service refuse cette option pour un lot sans sandbox. |
| `--tag <tag>` | Étiquette à ajouter au lot, d'au plus 100 caractères. Une étiquette que le lot possède déjà, sans tenir compte de la casse, est ignorée. Répétez l'option pour ajouter d'autres étiquettes. Ne peut pas être combinée avec `--clear-tags`. |
| `--replace-tags` | Remplace toutes les étiquettes du lot par les valeurs de `--tag`. Nécessite `--tag`. La casse compte ici; remplacer `smoke` par `Smoke` constitue donc une modification. |
| `--clear-tags` | Supprime toutes les étiquettes du lot. |
| `--allow-not-mine` | Permet de modifier un lot créé par un autre développeur. Sans cette option, la mise à jour est refusée avec `test_account_batch_not_owned`. Vos autorisations pourraient tout de même la refuser. |
| `--seller-id <id>` | Vendeur propriétaire du lot. |
| `--confirm`, `--yes`, `-y` | Met à jour sans invite de confirmation. |
| `--no-wait` | Retourne dès que le service accepte la mise à jour. Ne peut pas être combinée avec `--timeout`. |
| `--timeout <duration>` | Durée d'attente de la mise à jour, comme `90s`, `10m` ou `2h`. Valeur par défaut : `5m`; au maximum `7d`. |
| `--output <format>` | `json` (par défaut), `json-compact` ou `table`. |

Transmettez au moins une modification. Un lot peut avoir au plus 20 étiquettes. `--replace-tags` et
`--clear-tags` conservent l'étiquette qui indique l'outil ayant créé le lot, laquelle n'est pas comptabilisée
dans la limite. La modification des sandbox ou de l'expiration nécessite l'accès à ces sandbox;
la prolongation de l'expiration nécessite l'accès à tous les sandbox du lot.

La commande retourne les valeurs du lot une fois la mise à jour terminée :

```json theme={null}
{
  "batchId": 123456,
  "jobId": "0f8e5b2a-1c3d-4e5f-8a9b-0c1d2e3f4a5b",
  "state": "updated",
  "sandboxes": ["ABCD.1", "ABCD.2"],
  "accessExpirationDate": "2026-12-31T00:00:00+00:00",
  "keywords": ["smoke"]
}
```

`state` est `updated` une fois que le lot affiche la modification, ou `updating` avec `--no-wait` ou lorsque
l'attente prend fin avant. Lorsque le lot a déjà toutes les valeurs demandées, rien ne change :
`state` est `unchanged`, `jobId` est `null`, et la commande se termine avec le code 0. Les travaux de mise à jour ne peuvent pas être
suivis avec `job get` ni `job wait`.

### Attente et codes de sortie lors de la mise à jour

| Code de sortie | Signification |
| - | - |
| 0 | Le lot affiche la modification, il avait déjà ces valeurs, ou la mise à jour a été acceptée avec `--no-wait`. |
| 1 | Rien n'a été modifié : la requête a été refusée ou rejetée, a échoué avant son envoi, le lot n'a pas pu être lu avant l'invite, ou vous avez refusé. |
| 2 | Le travail de mise à jour s'est terminé, mais le lot n'affiche pas la modification. stderr nomme les champs qui diffèrent. Lisez le lot avec `batch get`, puis mettez-le à jour de nouveau. |
| 3 | Le résultat est inconnu. Lisez le lot avec la commande `batch get` affichée avant de faire une nouvelle mise à jour. Une fois qu'aucun travail n'est en cours d'exécution, vous pouvez renvoyer la même modification sans risque. |
| 4 | La mise à jour a été acceptée, mais l'attente a pris fin alors qu'elle était encore en cours d'exécution : le délai `--timeout` s'est écoulé, vous avez appuyé sur Ctrl+C, ou la lecture du lot a échoué. Un `jobId` qui ne disparaît jamais laisse supposer que le travail a échoué ou est bloqué. |

### Erreurs lors de la mise à jour

| `code` | Signification |
| - | - |
| `test_account_batch_not_owned` | 403 : un autre développeur a créé le lot. Transmettez `--allow-not-mine` pour lever cette vérification. |
| `test_account_sandbox_access_denied` | 403 : vous n'avez pas accès à un sandbox visé par la modification. La prolongation de l'expiration nécessite l'accès à tous les sandbox du lot. |
| `test_account_batch_not_found` | 404 : ce lot n'existe pas pour ce vendeur. |
| `test_account_batch_busy` | 409 : un travail est en cours d'exécution sur le lot. Attendez que `batch get` affiche `jobId` avec la valeur `null`. |
| `test_account_keyword_invalid` | 400 : une valeur de `--tag` n'est pas autorisée. |
| `test_account_access_denied` | Vous n'avez pas le rôle Partner Center permettant de gérer les comptes de test pour ce vendeur ou, avec `--allow-not-mine`, de modifier un lot que vous n'avez pas créé. |
| `downstream_throttled` | Les requêtes sont limitées. Attendez, puis réessayez. |
| `rate_limited` | 429 : vous avez envoyé trop de requêtes en peu de temps. Consultez [Limites de débit](https://docs.xbox.com/fr-CA/tools/xbox-cli/cli-for-agents.md#rate-limits). |
| `test_account_update_outcome_unknown` | 502 : code de sortie 3. |
| `feature_disabled`, `service_configuration_invalid` | 503 : les comptes de test ne sont pas disponibles. Code de sortie 1. |

Une erreur `404` ou `405` sans code signifie que la mise à jour des lots n'est pas disponible.

## Supprimer un lot

`batch delete` supprime un lot entier, puis attend qu'il n'existe plus. Chaque compte du lot
perd son accès aux sandbox, et son enregistrement de compte de test est supprimé. Les comptes
Microsoft et les profils XBOX des comptes ne sont pas fermés.

Dans un terminal, la commande affiche d'abord le modèle d'adresse courriel, la taille et le créateur du lot, avertit
lorsqu'un travail est encore en cours d'exécution sur celui-ci, et demande une confirmation. Transmettez `--confirm` (`--yes`, `-y`) pour ignorer
l'invite. Sans terminal et sans `--confirm`, elle affiche ce qu'elle supprimerait, refuse
et n'envoie rien. Il n'existe pas de suppression en bloc; supprimez les lots un à la fois.

| Option | Description |
| - | - |
| `<batch-id>` | Obligatoire. L'ID du lot, provenant de `batch list` ou de `batch create`. |
| `--allow-not-mine` | Permet de supprimer un lot créé par un autre développeur. Sans cette option, la suppression est refusée avec `test_account_batch_not_owned`. Vos autorisations pourraient tout de même la refuser, avec `test_account_access_denied`. |
| `--seller-id <id>` | Vendeur propriétaire du lot. |
| `--confirm`, `--yes`, `-y` | Supprime sans invite de confirmation. |
| `--no-wait` | Retourne dès que le service accepte la suppression. Ne peut pas être combinée avec `--timeout`. |
| `--timeout <duration>` | Durée d'attente jusqu'à ce que le lot n'existe plus, comme `90s`, `10m` ou `2h`. Valeur par défaut : `5m`; au maximum `7d`. |
| `--output <format>` | `json` (par défaut), `json-compact` ou `table`. |

La commande retourne :

```json theme={null}
{
  "batchId": 123456,
  "jobId": "0f8e5b2a-1c3d-4e5f-8a9b-0c1d2e3f4a5b",
  "state": "deleted",
  "emailTemplate": "ABCD-tester",
  "batchSize": 5
}
```

`state` est `deleted` une fois que le lot n'existe plus, ou `deleting` avec `--no-wait` ou lorsque l'attente
prend fin avant. Les travaux de suppression ne peuvent pas être suivis avec `job get` ni `job wait`; pendant l'exécution de la suppression,
le lot affiche son `jobId`.

### Attente et codes de sortie lors de la suppression

| Code de sortie | Signification |
| - | - |
| 0 | Le lot n'existe plus, ou la suppression a été acceptée avec `--no-wait`. |
| 1 | Rien n'a été supprimé : la requête a été refusée ou rejetée, a échoué avant son envoi, le lot n'a pas pu être lu avant l'invite, ou vous avez refusé. |
| 2 | Le travail de suppression s'est arrêté, mais le lot existe toujours. Inspectez-le avec `batch get`. |
| 3 | Le résultat est inconnu. Lisez le lot avec la commande `batch get` affichée : une erreur `404` avec `test_account_batch_not_found` signifie qu'il a été supprimé, et un `jobId` défini signifie que la suppression est probablement en cours d'exécution. Si `jobId` est `null`, attendez une minute et lisez-le de nouveau; supprimez-le de nouveau seulement s'il est toujours `null`. |
| 4 | La suppression a été acceptée, mais l'attente a pris fin alors que le lot existait encore : le délai `--timeout` s'est écoulé, vous avez appuyé sur Ctrl+C, ou la lecture du lot a échoué. Un `jobId` qui reste défini avec un `progress` inchangé laisse supposer que la suppression est bloquée. |

### Erreurs lors de la suppression

| `code` | Signification |
| - | - |
| `test_account_batch_not_owned` | 403 : un autre développeur a créé le lot; le message indique son ID d'utilisateur Partner Center. Transmettez `--allow-not-mine` pour lever cette vérification. |
| `test_account_batch_not_found` | 404 : ce lot n'existe pas pour ce vendeur, ou il a déjà été supprimé. Seul ce code signifie que le lot n'existe plus. |
| `test_account_batch_busy` | 409 : un travail est en cours d'exécution sur le lot, possiblement une suppression déjà en cours. Attendez que `batch get` affiche `jobId` avec la valeur `null`, ou retourne `404` avec `test_account_batch_not_found`. |
| `test_account_access_denied` | Vous n'avez pas le rôle Partner Center permettant de gérer les comptes de test pour ce vendeur ou, avec `--allow-not-mine`, de supprimer un lot que vous n'avez pas créé. |
| `downstream_throttled` | Les requêtes sont limitées. Attendez, puis réessayez. |
| `rate_limited` | 429 : vous avez envoyé trop de requêtes en peu de temps. Consultez [Limites de débit](https://docs.xbox.com/fr-CA/tools/xbox-cli/cli-for-agents.md#rate-limits). |
| `test_account_delete_outcome_unknown` | 502 ou 504 : code de sortie 3. Une erreur 504 sans code est traitée de la même façon. |
| `feature_disabled`, `service_configuration_invalid` | 503 : les comptes de test ne sont pas disponibles. Code de sortie 1. |

Une erreur `404` ou `405` sans code signifie que la suppression des lots n'est pas disponible.

## Sortie sous forme de tableau

Toutes les commandes acceptent `--output table`. Les heures sont affichées en UTC, et les lignes de résumé sont écrites dans
stderr; stdout contient donc seulement le tableau.

| Commande | Colonnes |
| - | - |
| `test-account batch list` | `BATCH ID`, `EMAIL TEMPLATE`, `SIZE`, `STATE` (`complete` ou `pending`), `CREATED BY`, `CREATED (UTC)`, `EXPIRES (UTC)`, puis `SANDBOXES` avec `--include-sandboxes`. |
| `test-account batch get` | Une ligne par compte : `EMAIL`, `GAMERTAG`, `XUID` et `DELETED`. stderr résume le lot et son accès aux sandbox. |
| `test-account get` | Une ligne : `EMAIL`, `GAMERTAG`, `BATCH ID`, `EMAIL TEMPLATE`, `EXPIRES (UTC)` et `EXPIRED` (`yes` ou `no`). |
| `test-account batch create`, `job get`, `job wait` | Une ligne : `BATCH ID`, `JOB ID`, `STATE` (`running`, `succeeded` ou `failed`), `TOTAL`, `SUCCEEDED`, `FAILED`. |
| `test-account batch update` | Une ligne : `BATCH ID`, `JOB ID`, `STATE` (`updated`, `updating` ou `unchanged`), `EXPIRES (UTC)`. stderr répertorie les sandbox et les mots-clés. |
| `test-account batch delete` | Une ligne : `BATCH ID`, `JOB ID`, `STATE` (`deleted` ou `deleting`), `EMAIL TEMPLATE`, `SIZE`. |

## Exemples

Ces commandes répertorient et lisent des lots, des comptes et des travaux :

```bash theme={null}
xbox test-account batch list --mine --limit 5

xbox test-account batch list --state pending --output table

xbox test-account batch list --email-prefix ABCDEF-smoke --include-sandboxes

xbox test-account batch get 123456 --output table

xbox test-account batch list --expired --limit 10

xbox test-account get ABCD-tester00007@xboxtest.com --output table

xbox test-account batch get 123456 --seller-id 1234567 --output json-compact

xbox test-account job get 0f8e5b2a-1c3d-4e5f-8a9b-0c1d2e3f4a5b --batch-id 123456 --output table
```

Créer un lot de cinq comptes. La commande demande le mot de passe et la réponse de sécurité,
puis vous demande de confirmer :

```bash theme={null}
xbox test-account batch create --email-prefix ABCD-tester --count 5 --sandbox-id ABCD.1
```

Créer un lot sans surveillance, avec les secrets lus à partir de fichiers, sans invite et avec une attente d'au plus
30 minutes :

```bash theme={null}
xbox test-account batch create --email-prefix ABCD-smoke --count 2 --sandbox-id ABCD.1 \
  --password-file ./password.txt --security-answer-file ./answer.txt \
  --subscription Silver --tag smoke --timeout 30m --confirm
```

Attendre jusqu'à deux heures qu'un travail de création se termine :

```bash theme={null}
xbox test-account job wait 0f8e5b2a-1c3d-4e5f-8a9b-0c1d2e3f4a5b --batch-id 123456 --timeout 2h
```

Ajouter un sandbox et définir la date d'expiration de l'accès aux sandbox. La commande affiche les modifications, vous demande
de confirmer, puis attend que le lot les affiche :

```bash theme={null}
xbox test-account batch update 123456 --add-sandbox-id ABCD.2 --access-expiration 2026-12-31
```

Ajouter deux étiquettes sans surveillance, sans attendre :

```bash theme={null}
xbox test-account batch update 123456 --tag smoke --tag nightly --confirm --no-wait
```

Remplacer toutes les étiquettes par une seule :

```bash theme={null}
xbox test-account batch update 123456 --tag nightly --replace-tags --confirm
```

Supprimer un lot. La commande affiche le lot, vous demande de confirmer, puis attend qu'il n'existe plus :

```bash theme={null}
xbox test-account batch delete 123456
```

Supprimer un lot créé par un autre développeur, sans surveillance et sans attendre :

```bash theme={null}
xbox test-account batch delete 123456 --allow-not-mine --confirm --no-wait
```


## Related topics

- [Comptes de test](https://docs.xbox.com/fr-CA/services/xbox-services/develop/test-accounts/index.md)
- [Pratiques exemplaires et tests des gamertags modernes](https://docs.xbox.com/fr-CA/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [Vue d'ensemble des sandboxes des services XBOX](https://docs.xbox.com/fr-CA/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [Créer et gérer des comptes de test XBOX](https://docs.xbox.com/fr-CA/publishing/game-publishing/how-to/how-to-create-and-manage-test-accounts.md)
- [Récupérer les fichiers de sauvegarde de jeu issus des tests de certification](https://docs.xbox.com/fr-CA/services/xbox-services/fundamentals/sandboxes/live-get-certification-test-saves.md)
