about_Telemetry

Descrição breve

Descreve a telemetria coletada no PowerShell e como desativar.

Descrição longa

O PowerShell envia dados básicos de telemetria para a Microsoft usando o Application Insights. Esses dados nos permitem entender melhor os ambientes usando o PowerShell e nos permitem priorizar novos recursos e correções. O PowerShell anonimiza as informações de telemetria antes de enviar.

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 executa a instância
• Um GUID gerado aleatoriamente representando a instância da sessão

Os dados de telemetria de inicialização são coletados somente ao iniciar o pwsh executável. Essas informações não serão enviadas se o mecanismo do PowerShell estiver incorporado 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 Localização geográfica e tratamento de endereços IP.

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

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

O PowerShell envia essas informações periodicamente durante o tempo de vida da sessão para todos os aplicativos host.

Para recusar essa telemetria, defina a variável de ambiente $env:POWERSHELL_TELEMETRY_OPTOUT para true, yes ou 1. Para que essa variável de ambiente tenha efeito, ela deve ser definida antes de iniciar o processo do PowerShell. Para obter mais informações, consulte about_Environment_Variables.

A $env:POWERSHELL_DISTRIBUTION_CHANNEL variável de ambiente é definida pelos pacotes do instalador para registrar o método e a origem da instalação do PowerShell. Como essas informações estão incluídas nos dados de telemetria enviados à 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.

Para obter mais informações sobre a declaração de privacidade da Microsoft, consulte Política de Privacidade da Microsoft