Freigeben über


about_Telemetry

Kurze Beschreibung

Beschreibt die in PowerShell gesammelten Telemetriedaten und die Deaktivierung.

Lange Beschreibung

PowerShell sendet grundlegende Telemetriedaten mithilfe von Application Insights an Microsoft. Diese Daten ermöglichen es uns, die Umgebungen mithilfe von PowerShell besser zu verstehen, und ermöglichen es uns, neue Features und Fehlerbehebungen zu priorisieren. PowerShell anonymisiert die Telemetrieinformationen vor dem Senden.

PowerShell sendet die folgenden Informationen beim Start:

  • Hersteller, Name und Version des Betriebssystems
  • Die Version von PowerShell
  • Der Wert der umgebungsvariablen POWERSHELL_DISTRIBUTION_CHANNEL
  • Die Von PowerShell verwendete Version des Application Insights SDK
  • Der geografische Standort des Hosts basierend auf der IP-Adresse
  • Die parameter, die ohne die Parameterwerte an pwsh übergeben werden
  • Die Ausführungsrichtlinieneinstellung der aktuellen Sitzung
  • Eine zufällig generierte GUID, die den Benutzer darstellt, der die instance
  • Eine zufällig generierte GUID, die die sitzungsbasierte instance

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

Hinweis

Application Insights verwendet die HOST-IP-Adresse, um den geografischen Standort zu bestimmen. Die IP-Adresse wird nie 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 der importierten Microsoft-Module
  • Die Namen aktivierter experimenteller Features
  • Die Anzahl der Vorgänge zum Öffnen von Remotesitzungen

PowerShell sendet diese Informationen in regelmäßigen Abständen während der Lebensdauer der Sitzung für alle Hostanwendungen.

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 Quelle der Installation für PowerShell aufzuzeichnen. Da diese Informationen in den telemetrischen Daten enthalten sind, die an Microsoft gesendet werden, 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.