Passer au contenu principal
La XBOX CLI collecte une télémétrie d’utilisation limitée et anonyme pour aider Microsoft à comprendre quelles commandes sont utilisées, quelle est leur fiabilité et combien de temps elles prennent. Vous pouvez la désactiver. La télémétrie ne modifie jamais la sortie ni le code de sortie d’une commande. Microsoft traite ces données comme décrit dans la déclaration de confidentialité de Microsoft. L’avis de confidentialité du dépôt couvre la collecte de données par le logiciel.

Données collectées

Chaque exécution de xbox crée au plus un événement, xbox.cli.command_invocation, avec ces champs et rien d’autre : Un nom de commande ou d’option que la CLI ne définit pas est envoyé comme unknown ou omis : une valeur saisie au mauvais endroit n’est donc jamais envoyée.

Emplacement approximatif

La CLI n’envoie jamais votre emplacement. Toutefois, Application Insights déduit un emplacement approximatif (pays, région ou état, et ville) à partir de l’adresse IP qui envoie l’événement, et le stocke avec chaque événement. L’adresse IP elle-même n’est pas conservée ; elle est stockée sous la forme 0.0.0.0. L’emplacement est utilisé uniquement pour comprendre l’adoption selon les marchés. La désactivation arrête toute télémétrie, y compris cet emplacement.

Données non collectées

La CLI ne collecte pas les valeurs des arguments ou des options, les corps de requête ou de réponse, les ID de titre PlayFab, les ID de vendeur, les ID de sandbox, les noms d’utilisateur, les ID de locataire ou de compte, les jetons d’accès, les chemins de fichiers, les secrets configurés, les messages d’erreur ni le nom de la machine.

Moment de l’envoi de l’événement

Lorsqu’une commande réussit, la CLI enregistre l’événement sur le disque, et une exécution ultérieure l’envoie : la commande n’attend donc pas le réseau. Lorsqu’une commande échoue, la CLI attend au plus 300 millisecondes pour envoyer son événement et ceux qui ont été enregistrés. En CI, où la CLI risque de ne pas être exécutée à nouveau, elle envoie l’événement avant de se terminer au lieu de l’enregistrer. Cela peut ajouter jusqu’à environ 5 secondes lorsque le point de terminaison est lent, et l’événement est abandonné s’il n’est pas envoyé dans ce délai.

En-tête de version

Indépendamment de la télémétrie, chaque requête que la CLI envoie avec un jeton d’accès comporte un en-tête User-Agent: XboxDevCLI/<version>, comme XboxDevCLI/0.1.0.9, afin que ces services puissent savoir quelles versions de la CLI les appellent. Il ne contient rien d’autre, et la désactivation de la télémétrie ne le supprime pas.

Avis lors de la première exécution

La première fois que la CLI collecte de la télémétrie sur une machine, elle écrit cet avis sur stderr, une seule fois :

Désactiver la télémétrie

Pour une seule commande

Passez --disable-telemetry :

Pour la session de shell actuelle

Définissez XBOX_TELEMETRY_OPTOUT dans PowerShell :
Dans bash ou zsh :
Les valeurs 1, true et yes désactivent la télémétrie, quelle que soit la configuration par ailleurs. Définir XBOX_TELEMETRY__ENABLED sur false la désactive également.

Pour chaque nouveau terminal

Définissez la variable pour votre compte. Sous Windows, exécutez cette commande, puis rouvrez votre terminal, ainsi que votre IDE si vous utilisez son terminal intégré :
Sous Linux et macOS, ajoutez la ligne export au fichier de démarrage de votre shell, comme ~/.zshrc ou ~/.bashrc, de la même manière que la page Installation ajoute la CLI au PATH.

Destination de la télémétrie

Les builds de version envoient la télémétrie à une ressource Azure Monitor Application Insights appartenant à Microsoft, que vous ne pouvez pas modifier. La CLI ignore APPLICATIONINSIGHTS_CONNECTION_STRING : un hôte qui la définit pour sa propre application ne redirige donc pas la télémétrie de la CLI.
Dernière modification le 19 novembre 2026