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