Поделиться через


about_Telemetry

Краткое описание

Описывает данные телеметрии, собранные в PowerShell, и способы отказа.

Подробное описание

PowerShell отправляет базовые данные телеметрии в Корпорацию Майкрософт с помощью Application Insights. Эти данные позволяют лучше понять среды с помощью PowerShell и позволяют нам определять приоритеты новых функций и исправлений. PowerShell анонимизирует данные телеметрии перед отправкой.

PowerShell отправляет следующие сведения при запуске:

  • Изготовитель, имя и версия операционной системы
  • Версия PowerShell
  • Значение переменной среды POWERSHELL_DISTRIBUTION_CHANNEL
  • Версия пакета SDK Application Insights, используемая PowerShell
  • Географическое расположение узла на основе IP-адреса
  • Параметры, передаваемые в pwsh без значений параметров
  • Параметр политики выполнения текущего сеанса
  • Случайным образом созданный GUID, представляющий пользователя, выполняющего экземпляр.
  • Случайным образом созданный GUID, представляющий экземпляр сеанса

Данные телеметрии запуска собираются только при запуске исполняемого pwsh файла. Эти сведения не отправляются, если подсистема PowerShell внедрена в другое хост-приложение.

Примечание.

Application Insights использует IP-адрес узлов для определения географического расположения. IP-адрес никогда не включается в данные телеметрии или хранится в базе данных. Дополнительные сведения см. в разделе "Геолокация" и "Обработка IP-адресов".

PowerShell отправляет следующие сведения во время сеанса:

  • Количество вызовов API PowerShell.Create()
  • Имена и версии модулей, принадлежащих Майкрософт, импортированные
  • Количество импортированных модулей с тегом CrescendoBuilt
  • Имена включенных экспериментальных функций
  • Имена отключенных экспериментальных функций
  • Значение переменной $PSNativeCommandUseErrorActionPreference предпочтения, либо truefalseunset
  • Количество операций открытия удаленного сеанса

PowerShell периодически отправляет эти сведения во время существования сеанса для всех ведущих приложений.

Чтобы отказаться от использования данных телеметрии, задайте для переменной среды $env:POWERSHELL_TELEMETRY_OPTOUT значение true, yes или 1. Чтобы эта переменная среды повлияла, ее необходимо задать перед запуском процесса PowerShell. Дополнительные сведения см. в about_Environment_Variables.

Переменная $env:POWERSHELL_DISTRIBUTION_CHANNEL среды устанавливается пакетами установщика для записи метода и источника установки для PowerShell. Так как эти сведения включены в данные телеметрии, отправленные корпорации Майкрософт, пользователи не должны изменять это значение.

Дополнительные сведения об этих переменных среды см. в about_Environment_Variables.

Дополнительные сведения об заявлении Корпорации Майкрософт о конфиденциальности см . в заявлении о конфиденциальности Майкрософт