hakkında_Telemetri

Kısa açıklama

PowerShell'de toplanan telemetriyi ve geri çevirmeyi açıklar.

Uzun açıklama

PowerShell, Application Insights kullanarak temel telemetri verilerini Microsoft'a gönderir. Bu veriler, PowerShell kullanarak ortamları daha iyi anlamamıza olanak tanır ve yeni özellik ve düzeltmelere öncelik vermemizi sağlar. PowerShell, göndermeden önce telemetri bilgilerini anonim hale getirir.

PowerShell başlangıçta aşağıdaki bilgileri gönderir:

  • İşletim sisteminin üreticisi, adı ve sürümü
  • PowerShell sürümü
  • POWERSHELL_DISTRIBUTION_CHANNEL ortam değişkeninin değeri
  • PowerShell tarafından kullanılan Application Insights SDK sürümü
  • IP adresine göre konağın coğrafi konumu
  • Parametre değerleri olmadan pwsh'ye geçirilen parametreler
  • Geçerli oturumun Yürütme İlkesi ayarı
  • Örneği çalıştıran kullanıcıyı temsil eden rastgele oluşturulmuş bir GUID.
  • Oturum örneğini temsil eden rastgele oluşturulan GUID

Başlangıç telemetri verileri, yalnızca pwsh yürütülebilir dosyası başlatıldığında toplanır. PowerShell altyapısı başka bir konak uygulamasına eklenmişse bu bilgiler gönderilmez.

Not

Application Insights, coğrafi konumu belirlemek için konakların IP Adresini kullanır. IP Adresi hiçbir zaman telemetri verilerine dahil değildir veya veritabanında depolanmaz. Daha fazla bilgi için bkz. coğrafi konum ve IP adresi işleme.

PowerShell oturum sırasında aşağıdaki bilgileri gönderir:

  • PowerShell.Create() API'sine yapılan çağrıların sayısı
  • İçeri aktarılan Microsoft'a ait modüllerin adları ve sürümleri
  • CrescendoBuilt etiketine sahip içeri aktarılan modüllerin sayısı
  • Etkin deneysel özelliklerin adları
  • Devre dışı bırakılan deneysel özelliklerin adları
  • $PSNativeCommandUseErrorActionPreference tercih değişkeninin değeri, ya true, false ya da unset olabilir.
  • Uzak oturum açma işlemlerinin sayısı
  • Kayıtlı alt sistemlerin adları: Completion ve general. Alt sistem adının adı bunlardan biri değilse, ad olarak anonymous gönderilir.
  • Sağlanan CommandNotFound geri bildirim önerilerinin sayısı.
  • PowerShellUnsafeAssemblyLoad kullanım sayısı ve yüklemenin başarılı olup olmadığı.

$Env:POWERSHELL_DISTRIBUTION_CHANNEL ortam değişkeni, yükleyici paketleri tarafından PowerShell yükleme yöntemini ve kaynağını kaydedecek şekilde ayarlanır. Bu bilgiler Microsoft'a gönderilen telemetri verilerine eklendiğinden, kullanıcıların bu değeri değiştirmemesi gerekir.

PowerShell bu bilgileri tüm platformlardaki tüm konak uygulamaları için oturumun ömrü boyunca düzenli aralıklarla gönderir.

Telemetriyi devre dışı bırakma

Telemetrinin gönderilmesini devre dışı bırakmanın iki yolu vardır.

  • Tüm platformlarda ortam değişkenini $Env:POWERSHELL_TELEMETRY_OPTOUT , trueveya yesolarak 1ayarlayın. Bu ortam değişkeninin etkili olması için PowerShell işlemi başlatılmadan önce ayarlanması gerekir. Daha fazla bilgi için bkz. about_Environment_Variables.

  • Windows PowerShell 7.6.2 sürümünden başlayarak PowerShell, Windows'daki Diagnostics & feedback ayarına saygı gösterir. Windows telemetriyi devre dışı bırakmak için aşağıdaki adımları kullanın.

    1. Ayarlar uygulamasını açın ve Gizlilik ve güvenlik>Tanılama ve geri bildirim'e gidin.
    2. Tanılama verileri bölümünü genişletin.
    3. İsteğe bağlı tanılama verilerini gönder'in altında iki durumlu düğmeyi Kapalı olarak ayarlayın.

Daha fazla bilgi