about_Telemetry

Descrição breve

Descreve a telemetria coletada no PowerShell e como recusar.

Descrição longa

O PowerShell envia dados básicos de telemetria para Microsoft usando o Application Insights. Com esses dados, podemos entender melhor os ambientes nos quais o PowerShell é usado, além de priorizar novos recursos e correções. A telemetria inclui informações anônimas sobre o host que executa o PowerShell e informações sobre como o PowerShell é usado.

O PowerShell envia as seguintes informações na inicialização:

  • O fabricante, o nome e a versão do sistema operacional
  • A versão do PowerShell
  • O valor da variável de ambiente POWERSHELL_DISTRIBUTION_CHANNEL
  • A versão do SDK do Application Insights usada pelo PowerShell
  • A localização geográfica do host, com base no endereço IP
  • Um GUID gerado aleatoriamente que representa o usuário que está executando a instância
  • Um GUID gerado aleatoriamente representando a instância de sessão

Os dados de telemetria de inicialização só são coletados ao iniciar o pwsh executável. Essas informações não serão enviadas se o mecanismo do PowerShell estiver inserido em algum outro aplicativo host.

Observação

O Application Insights usa o endereço IP dos hosts para determinar a localização geográfica. O Endereço IP nunca é incluído nos dados de telemetria ou armazenado no banco de dados. Para obter mais informações, consulte Geolocalização e manipulação de endereço IP.

O PowerShell envia as seguintes informações durante a sessão:

  • A contagem de chamadas para a PowerShell.Create() API
  • Os nomes dos módulos de propriedade Microsoft carregados
  • Os nomes dos recursos experimentais habilitados
  • A contagem de operações abertas de sessão remota

Essas informações são enviadas periodicamente durante o tempo de vida da sessão. Essas informações são enviadas independentemente do aplicativo host.

Para recusar essa telemetria, defina a variável de ambiente $env:POWERSHELL_TELEMETRY_OPTOUT para true, yes ou 1.

A $env:POWERSHELL_DISTRIBUTION_CHANNEL variável de ambiente é definida pelos pacotes do instalador para registrar o método e a fonte de instalação do PowerShell. Como essas informações são incluídas nos dados de telemetria enviados para Microsoft, os usuários não devem alterar esse valor.

Para obter mais informações sobre essas variáveis de ambiente, consulte about_Environment_Variables.