Share via

about_Telemetry

  • 發行項

簡短描述

描述 PowerShell 中收集的遙測，以及如何退出宣告。

詳細描述

PowerShell 會使用 Application Insights 將基本遙測數據傳送給 Microsoft。 此數據可讓我們進一步瞭解使用PowerShell的環境，並讓我們設定新功能和修正的優先順序。 PowerShell 會先匿名傳送遙測資訊。

PowerShell 會在啟動時傳送下列資訊：

  • 操作系統的製造商、名稱和版本
  • PowerShell 的版本
  • POWERSHELL_DISTRIBUTION_CHANNEL環境變數的值
  • PowerShell 所使用的 Application Insights SDK 版本
  • 主機的地理位置，根據IP位址
  • 傳遞至 pwsh 的參數沒有參數值
  • 目前會話的執行原則設定
  • 隨機產生的 GUID，代表執行 實例的使用者
  • 代表會話實例的隨機產生的 GUID

啟動遙測數據只會在啟動 pwsh 可執行檔時收集。 如果 PowerShell 引擎內嵌在其他主機應用程式中，則不會傳送此資訊。

注意

Application Insights 會使用主機 IP 位址來判斷地理位置。 IP 位址絕不會包含在遙測數據或儲存在資料庫中。 如需詳細資訊，請參閱 地理位置和IP位址處理。

PowerShell 會在會話期間傳送下列資訊：

  • 對 API 的 PowerShell.Create() 呼叫計數
  • 匯入的 Microsoft 擁有模組名稱和版本
  • 具有 CrescendoBuilt 標籤的匯入模組計數
  • 已啟用實驗功能的名稱
  • 已停用實驗性功能的名稱
  • 喜好設定變數的值 $PSNativeCommandUseErrorActionPreference ，可以是 true、 false 或 unset
  • 遠程會話開啟作業的計數

PowerShell 會在所有主應用程式的會話存留期間定期傳送此資訊。

若要離開此遙測，請將環境變數 $env:POWERSHELL_TELEMETRY_OPTOUT 設定為 true、 yes或 1。 若要讓此環境變數生效，必須先設定它，才能啟動PowerShell程式。 如需詳細資訊，請參閱 about_Environment_Variables。

$env:POWERSHELL_DISTRIBUTION_CHANNEL環境變數是由安裝程式套件所設定，以記錄PowerShell安裝的方法和來源。 由於此資訊包含在傳送給 Microsoft 的遙測數據中，使用者不應該變更此值。

如需這些環境變數的詳細資訊，請參閱 about_Environment_Variables。

如需有關 Microsoft 隱私權聲明的詳細資訊，請參閱 Microsoft 隱私聲明