about_Telemetry

Korte beschrijving

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

Lange beschrijving

PowerShell verzendt eenvoudige telemetriegegevens 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 anonimiseert 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 host om de geografische locatie te bepalen. Het IP-adres wordt nooit opgenomen in de telemetriegegevens of opgeslagen in de database. Zie 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 geïmporteerde modules die eigendom zijn van Microsoft
• De namen van ingeschakelde experimentele functies
• 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_OPTOUT in op true, yesof 1. Deze omgevingsvariabele heeft alleen effect als deze wordt 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 de installatie voor PowerShell vast te leggen. Omdat deze informatie is opgenomen in de telemetriegegevens die naar Microsoft worden verzonden, moeten 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