about_Telemetry

Deskripsi singkat

Menjelaskan telemetri yang dikumpulkan di PowerShell dan cara menolak.

Deskripsi panjang

PowerShell mengirim data telemetri dasar ke Microsoft menggunakan Application Insights. Data ini memungkinkan kami untuk lebih memahami lingkungan menggunakan PowerShell dan memungkinkan kami memprioritaskan fitur dan perbaikan baru. PowerShell menganonimkan informasi telemetri sebelum mengirim.

PowerShell mengirimkan informasi berikut saat startup:

  • Produsen, nama, dan versi sistem operasi
  • Versi PowerShell
  • Nilai variabel lingkungan POWERSHELL_DISTRIBUTION_CHANNEL
  • Versi Application Insights SDK yang digunakan oleh PowerShell
  • Lokasi geografis host, berdasarkan alamat IP
  • Parameter diteruskan ke pwsh tanpa nilai parameter
  • Pengaturan Kebijakan Eksekusi dari sesi saat ini
  • GUID yang dihasilkan secara acak yang mewakili pengguna yang menjalankan instans
  • GUID yang dihasilkan secara acak yang mewakili instans sesi

Data telemetri startup hanya dikumpulkan saat memulai executable pwsh . Informasi ini tidak dikirim jika mesin PowerShell disematkan di beberapa aplikasi host lainnya.

Catatan

Application Insights menggunakan Alamat IP host untuk menentukan lokasi geografis. Alamat IP tidak pernah disertakan dalam data telemetri atau disimpan dalam database. Untuk informasi selengkapnya, lihat Penanganan geolokasi dan alamat IP.

PowerShell mengirimkan informasi berikut selama sesi:

  • Jumlah panggilan ke PowerShell.Create() API
  • Nama dan versi modul milik Microsoft yang diimpor
  • Jumlah modul yang diimpor yang memiliki CrescendoBuilt tag
  • Nama fitur eksperimental yang diaktifkan
  • Nama fitur eksperimental yang dinonaktifkan
  • $PSNativeCommandUseErrorActionPreference Nilai variabel preferensi, baik true, false atauunset
  • Jumlah operasi pembukaan sesi jarak jauh

PowerShell mengirimkan informasi ini secara berkala selama masa pakai sesi untuk semua aplikasi host.

Untuk menolak telemetri ini, atur variabel $env:POWERSHELL_TELEMETRY_OPTOUT lingkungan ke true, yes, atau 1. Agar variabel lingkungan ini berpengaruh, variabel harus diatur sebelum memulai proses PowerShell. Untuk informasi selengkapnya, lihat about_Environment_Variables.

Variabel $env:POWERSHELL_DISTRIBUTION_CHANNEL lingkungan diatur oleh paket alat penginstal untuk merekam metode dan sumber penginstalan untuk PowerShell. Karena informasi ini disertakan dalam data telemetri yang dikirim ke Microsoft, pengguna tidak boleh mengubah nilai ini.

Untuk informasi selengkapnya tentang variabel lingkungan ini, lihat about_Environment_Variables.

Untuk informasi selengkapnya tentang pernyataan Microsoft tentang privasi, lihat Pernyataan Privasi Microsoft