à propos de la télémétrie

Brève description

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

Description longue

PowerShell envoie des données de télémétrie de base à Microsoft à travers Application Insights. Ces données nous permettent de mieux comprendre les environnements dans lesquels PowerShell est utilisé, ainsi que de classer par ordre de priorité les correctifs et les nouvelles fonctionnalités. PowerShell anonymise les informations de télémétrie avant leur envoi.

PowerShell envoie les informations suivantes au démarrage :

• Fabricant, nom et version du système d’exploitation
• La version de PowerShell
• La valeur de la variable d’environnement POWERSHELL_DISTRIBUTION_CHANNEL
• La version du kit SDK Application Insights utilisée par PowerShell
• L’emplacement géographique de l’hôte, en fonction de l’adresse IP
• Les paramètres transmis à pwsh sans les valeurs des paramètres
• La stratégie d'exécution de la session en cours.
• Un GUID généré de manière aléatoire représentant l’utilisateur exécutant l’instance
• Un 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ée dans la base de données. Pour plus d’informations, consultez Gestion de la géolocalisation et des adresses IP.

PowerShell envoie les informations suivantes pendant la session :

• Le nombre d’appels à l’API PowerShell.Create()
• Les noms et les versions des modules importés appartenant à Microsoft
• Le nombre de modules importés qui ont la balise CrescendoBuilt
• Les noms des fonctionnalités expérimentales activées
• Les noms des fonctionnalités expérimentales désactivées
• La valeur de la variable de préférence $PSNativeCommandUseErrorActionPreference, true, false ou unset
• Le nombre d’opérations d’ouverture de session à distance
• Les noms des sous-systèmes inscrits : Completion et general. Si le nom du sous-système n’est pas l’un de ces noms, anonymous est envoyé comme nom.
• Le nombre de suggestions de commentaires CommandNotFound fournies.
• Le nombre d'utilisations de PowerShellUnsafeAssemblyLoad et le succès ou l'échec du chargement.

PowerShell envoie ces informations régulièrement pendant la durée 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 un effet, elle doit être définie avant de démarrer le processus PowerShell. Pour plus d'informations, voir about_Environment_Variables.

La variable d’environnement $Env:POWERSHELL_DISTRIBUTION_CHANNEL 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 Déclaration de confidentialité Microsoft