Partager via

about_Telemetry

  • Article

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 à l’aide de PowerShell et nous permet de hiérarchiser les nouvelles fonctionnalités et correctifs. PowerShell anonymise les informations de télémétrie avant d’envoyer.

PowerShell envoie les informations suivantes au démarrage :

  • Fabricant, nom et version du système d’exploitation
  • 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 l’instance
  • GUID généré de façon aléatoire représentant l’instance de session

Les données de télémétrie de démarrage sont collectées uniquement lors du 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.

Remarque

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ées dans la base de données. Pour plus d’informations, consultez La gestion de la géolocalisation et de l’adresse 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
  • Nombre de modules importés qui ont la CrescendoBuilt balise
  • Noms des fonctionnalités expérimentales activées
  • Noms des fonctionnalités expérimentales désactivées
  • Valeur de la variable de $PSNativeCommandUseErrorActionPreference préférence, soit true, false soit unset
  • Nombre d’opérations d’ouverture de session à distance

PowerShell envoie ces informations régulièrement 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 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 confidentialité de Microsoft, consultez la Déclaration de confidentialité microsoft