Partager via


about_Telemetry

Description courte

Décrit les données de télémétrie collectées dans PowerShell et comment refuser.

Description longue

PowerShell envoie des données de télémétrie de base à Microsoft à l’aide d’Application Insights. Ces données nous permettent de mieux comprendre les environnements utilisant PowerShell et de hiérarchiser les nouvelles fonctionnalités et correctifs. PowerShell anonymise les informations de télémétrie avant l’envoi.

PowerShell envoie les informations suivantes au démarrage :

  • Fabricant, nom et version du système d’exploitation
  • La version de PowerShell
  • Valeur de la variable d’environnement POWERSHELL_DISTRIBUTION_CHANNEL
  • Version du Kit de développement logiciel (SDK) Application Insights utilisée par PowerShell
  • Emplacement géographique de l’hôte, en fonction de l’adresse IP
  • Paramètres passés à pwsh sans les valeurs de paramètre
  • Paramètre de stratégie d’exécution de la session active
  • GUID généré de manière aléatoire représentant l’utilisateur exécutant le instance
  • GUID généré de manière aléatoire représentant la session instance

Les données de télémétrie de démarrage sont collectées uniquement au démarrage de l’exécutable pwsh . Ces informations ne sont pas envoyées si le moteur PowerShell est incorporé dans une autre application hôte.

Notes

Application Insights utilise l’adresse IP des hôtes pour déterminer l’emplacement géographique. L’adresse IP n’est jamais incluse dans les données de télémétrie ou stockée dans la base de données. Pour plus d’informations, consultez Géolocalisation et gestion des adresses IP.

PowerShell envoie les informations suivantes pendant la session :

  • Nombre d’appels à l’API PowerShell.Create()
  • Noms et versions des modules appartenant à Microsoft importés
  • Noms des fonctionnalités expérimentales activées
  • Nombre d’opérations d’ouverture de session à distance

PowerShell envoie régulièrement ces informations pendant la durée de vie de la session pour toutes les applications hôtes.

Pour refuser la collecte de ces données de télémétrie, définissez la variable d’environnement $env:POWERSHELL_TELEMETRY_OPTOUT sur true, yes ou 1. Pour que cette variable d’environnement ait effet, elle doit être définie avant de démarrer le processus PowerShell. Pour plus d’informations, consultez about_Environment_Variables.

La $env:POWERSHELL_DISTRIBUTION_CHANNEL variable d’environnement est définie par les packages du programme d’installation pour enregistrer la méthode et la source d’installation pour PowerShell. Étant donné que ces informations sont incluses dans les données de télémétrie envoyées à Microsoft, les utilisateurs ne doivent pas modifier cette valeur.

Pour plus d’informations sur ces variables d’environnement, consultez about_Environment_Variables.

Pour plus d’informations sur la déclaration de Microsoft sur la confidentialité, consultez Déclaration de confidentialité Microsoft