Passer au contenu principal
L’XBOX CLI recueille une télémétrie d’utilisation anonyme et limitée pour aider Microsoft à comprendre quelles commandes sont utilisées, leur fiabilité et leur durée d’exécution. 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 le décrit la Déclaration de confidentialité de Microsoft. L’avis de confidentialité du dépôt couvre la collecte de données par le logiciel.

Ce qui est recueilli

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é sous la forme unknown ou omis; ainsi, une valeur tapée au mauvais endroit n’est jamais envoyée.

Emplacement approximatif

La CLI n’envoie jamais votre emplacement. Toutefois, Application Insights déduit un emplacement approximatif (pays, région ou province/É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 sert uniquement à comprendre l’adoption dans les différents marchés. La désactivation arrête toute la télémétrie, y compris cet emplacement.

Ce qui n’est pas recueilli

La CLI ne recueille pas les valeurs des arguments ou des options, les corps des requêtes ou des réponses, 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 fichier, les secrets configurés, les messages d’erreur ni le nom de l’ordinateur.

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; ainsi, la commande n’attend 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 pourrait ne pas s’exécuter de nouveau, elle envoie plutôt 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 retire pas.

Avis à la première exécution

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

Désactivation

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 la commande suivante, 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 façon que 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 changer. La CLI ignore APPLICATIONINSIGHTS_CONNECTION_STRING; ainsi, un hôte qui la définit pour sa propre application ne redirige pas la télémétrie de la CLI.
Dernière modification le 19 novembre 2026