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