about_Telemetry

Brève description

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.

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

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.

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

Désactiver la télémétrie

Il existe deux façons de désactiver l’envoi de données de télémétrie.

• Sur toutes les plateformes, définissez la variable $Env:POWERSHELL_TELEMETRY_OPTOUT d’environnement sur true, yesou 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.

• À compter de PowerShell 7.4.16 sur Windows, PowerShell respecte le paramètre Diagnostics et commentaires dans Windows. Procédez comme suit pour désactiver la télémétrie dans Windows.

  1. Ouvrez l’application Paramètres et accédez à Confidentialité &Diagnostics de sécurité > et commentaires.
  2. Développez la section Données de diagnostic .
  3. Sous Envoyer des données de diagnostic facultatives, définissez le bouton bascule sur Désactivé.

Lectures complémentaires

• 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