about_Telemetry

Kurze Beschreibung

Beschreibt die in PowerShell gesammelte Telemetrie und die Deaktivierung.

Lange Beschreibung

PowerShell sendet grundlegende Telemetriedaten mithilfe von Application Insights an Microsoft. Mit diesen Daten können wir die Umgebungen mithilfe von PowerShell besser verstehen und neue Features und Fixes priorisieren. PowerShell anonymisiert die Telemetrieinformationen vor dem Senden.

PowerShell sendet beim Start die folgenden Informationen:

• Hersteller, Name und Version des Betriebssystems
• Die Version von PowerShell
• Der Wert der umgebungsvariablen POWERSHELL_DISTRIBUTION_CHANNEL
• Die Version des Application Insights SDK, das von PowerShell verwendet wird
• Der geografische Standort des Hosts basierend auf der IP-Adresse
• Die Parameter, die ohne parameterwerte an pwsh übergeben werden
• Die Einstellung der Ausführungsrichtlinie der aktuellen Sitzung
• Eine zufällig generierte GUID, die den Benutzer darstellt, der die Instanz ausführt
• Eine zufällig generierte GUID, die die Sitzungsinstanz darstellt

Start-Telemetriedaten werden nur gesammelt, wenn die pwsh ausführbare Datei gestartet wird. Diese Informationen werden nicht gesendet, wenn das PowerShell-Modul in eine andere Hostanwendung eingebettet ist.

PowerShell sendet während der Sitzung die folgenden Informationen:

• Die Anzahl der Aufrufe der PowerShell.Create() API
• Die Namen und Versionen von von Microsoft importierten Modulen
• Die Anzahl der importierten Module mit dem CrescendoBuilt Tag
• Die Namen der aktivierten experimentellen Features
• Die Namen deaktivierter experimenteller Features
• Wert der Einstellungsvariable$PSNativeCommandUseErrorActionPreference, entweder trueoder falseunset
• Die Anzahl der geöffneten Remotesitzungen

PowerShell sendet diese Informationen während der Lebensdauer der Sitzung für alle Hostanwendungen regelmäßig.

Wenn Sie diese Telemetriedaten nicht senden möchten, legen Sie die Umgebungsvariable $env:POWERSHELL_TELEMETRY_OPTOUT auf true, yes oder 1 fest. Damit diese Umgebungsvariable wirksam wird, muss sie vor dem Starten des PowerShell-Prozesses festgelegt werden. Weitere Informationen finden Sie unter about_Environment_Variables.

Die $env:POWERSHELL_DISTRIBUTION_CHANNEL Umgebungsvariable wird von den Installationspaketen festgelegt, um die Methode und die Installationsquelle für PowerShell aufzuzeichnen. Da diese Informationen in den an Microsoft gesendeten Telemetriedaten enthalten sind, sollten Benutzer diesen Wert nicht ändern.

Weitere Informationen zu diesen Umgebungsvariablen finden Sie unter about_Environment_Variables.

Weitere Informationen zu den Datenschutzbestimmungen von Microsoft finden Sie in den Datenschutzbestimmungen von Microsoft.