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 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
- Os parâmetros passados para pwsh sem os valores dos parâmetros
- A configuração da Política de Execução da sessão atual
- Um GUID gerado aleatoriamente que representa o usuário que executa a instância
- Um GUID gerado aleatoriamente que representa a instância da 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 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
- A contagem de módulos importados que têm a
CrescendoBuilttag - Os nomes dos recursos experimentais habilitados
- Os nomes dos recursos experimentais desativados
- Valor da variável de
$PSNativeCommandUseErrorActionPreferencepreferência, outrue,falseouunset - 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 fonte de 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 a Política de Privacidade da Microsoft
