Share via


about_Telemetry

Korte beschrijving

Beschrijft de telemetrie die wordt verzameld in PowerShell en hoe u zich afmeldt.

Lange beschrijving

PowerShell verzendt basistelemetriegegevens naar Microsoft met behulp van Application Insights. Met deze gegevens kunnen we de omgevingen beter begrijpen met behulp van PowerShell en kunnen we prioriteit geven aan nieuwe functies en oplossingen. PowerShell geanonimiseerd de telemetriegegevens voordat ze worden verzonden.

PowerShell verzendt de volgende informatie bij het opstarten:

  • De fabrikant, naam en versie van het besturingssysteem
  • De versie van PowerShell
  • De waarde van de omgevingsvariabele POWERSHELL_DISTRIBUTION_CHANNEL
  • De versie van de Application Insights SDK die wordt gebruikt door PowerShell
  • De geografische locatie van de host, op basis van het IP-adres
  • De parameters die worden doorgegeven aan pwsh zonder de parameterwaarden
  • De instelling Uitvoeringsbeleid van de huidige sessie
  • Een willekeurig gegenereerde GUID die de gebruiker vertegenwoordigt die het exemplaar uitvoert
  • Een willekeurig gegenereerde GUID die het sessie-exemplaar vertegenwoordigt

Opstarttelemetriegegevens worden alleen verzameld bij het starten van het pwsh uitvoerbare bestand. Deze informatie wordt niet verzonden als de PowerShell-engine is ingesloten in een andere hosttoepassing.

Notitie

Application Insights gebruikt het IP-adres van de hosts om de geografische locatie te bepalen. Het IP-adres wordt nooit opgenomen in de telemetriegegevens of opgeslagen in de database. Zie De verwerking van geolocatie en IP-adressen voor meer informatie.

PowerShell verzendt de volgende informatie tijdens de sessie:

  • Het aantal aanroepen naar de PowerShell.Create() API
  • De namen en versies van microsoft-modules geïmporteerd
  • Het aantal geïmporteerde modules met de CrescendoBuilt tag
  • De namen van ingeschakelde experimentele functies
  • De namen van uitgeschakelde experimentele functies
  • Waarde van $PSNativeCommandUseErrorActionPreference voorkeursvariabele, ofwel true, false of unset
  • Het aantal open bewerkingen voor externe sessies

PowerShell verzendt deze informatie periodiek tijdens de levensduur van de sessie voor alle hosttoepassingen.

Als u zich wilt afmelden voor deze telemetrie, stelt u de omgevingsvariabele $env:POWERSHELL_TELEMETRY_OPTOUTtruein op , yesof 1. Voordat deze omgevingsvariabele effect heeft, moet deze worden ingesteld voordat het PowerShell-proces wordt gestart. Zie about_Environment_Variables voor meer informatie.

De $env:POWERSHELL_DISTRIBUTION_CHANNEL omgevingsvariabele wordt ingesteld door de installatiepakketten om de methode en bron van installatie voor PowerShell vast te leggen. Omdat deze informatie is opgenomen in de telemetriegegevens die naar Microsoft worden verzonden, mogen gebruikers deze waarde niet wijzigen.

Zie about_Environment_Variables voor meer informatie over deze omgevingsvariabelen.

Zie de Privacyverklaring van Microsoft voor meer informatie over de privacyverklaring van Microsoft