about_Telemetry

Kurzbeschreibung

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 an pwsh übergebenen Parameter ohne die Parameterwerte
• 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

Starttelemetriedaten werden nur beim Starten der ausführbaren Datei pwsh gesammelt. Diese Informationen werden nicht gesendet, wenn das PowerShell-Modul in eine andere Hostanwendung eingebettet ist.

Anmerkung

Application Insights verwendet die HOST-IP-Adresse, um den geografischen Standort zu ermitteln. Die IP-Adresse ist niemals in den Telemetriedaten enthalten oder in der Datenbank gespeichert. Weitere Informationen finden Sie unter Geolocation- und IP-Adressbehandlung.

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
• Der Wert der $PSNativeCommandUseErrorActionPreference-Einstellungsvariablen, entweder true, false oder unset.
• Die Anzahl der Öffnungsvorgänge der Remotesitzung
• Die Namen registrierter Subsysteme: Completion und general. Wenn der Name des Subsystems nicht einer dieser Namen ist, wird anonymous als Name übermittelt.
• Die Anzahl der bereitgestellten CommandNotFound-Feedbackvorschläge.
• Die Anzahl der Nutzungen von PowerShellUnsafeAssemblyLoad und ob der Ladevorgang erfolgreich war oder nicht.

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

Wenn Sie diese Telemetrie deaktivieren möchten, legen Sie die Umgebungsvariable $Env:POWERSHELL_TELEMETRY_OPTOUT auf true, yesoder 1fest. 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 Installationsmethode und -quelle 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 unter Microsoft-Datenschutzbestimmungen