通过

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 拥有的模块的名称和版本
  • 已启用的实验功能的名称
  • 远程会话打开操作的计数

PowerShell 在所有主机应用程序的会话生存期内定期发送此信息。

要选择退出此遥测，请将环境变量 $env:POWERSHELL_TELEMETRY_OPTOUT 设置为 true、yes 或 1。 若要使此环境变量生效，必须在启动 PowerShell 进程之前对其进行设置。 有关详细信息，请参阅 about_Environment_Variables。

$env:POWERSHELL_DISTRIBUTION_CHANNEL环境变量由安装程序包设置，用于记录 PowerShell 的安装方法和源。 由于此信息包含在发送给 Microsoft 的遥测数据中，因此用户不应更改此值。

有关这些环境变量的详细信息，请参阅 about_Environment_Variables。

有关 Microsoft 关于隐私的声明的详细信息，请参阅 Microsoft 隐私声明