about_Telemetry

Descrição curta

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. Estes dados permitem-nos compreender melhor os ambientes que utilizam o PowerShell, além de priorizar novas funcionalidades e correções. O PowerShell torna anônimas as informações de telemetria antes do envio.

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 de parâmetro
• A configuração de Política de Execução da sessão atual
• Um GUID gerado aleatoriamente representando o usuário que executa 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 executável pwsh. 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 Tratamento de Endereço IP.

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

• O número de chamadas para a API PowerShell.Create()
• Os nomes e versões dos módulos de propriedade da Microsoft importados
• A contagem de módulos importados que têm a tag CrescendoBuilt
• Os nomes dos recursos experimentais habilitados
• Os nomes das funcionalidades experimentais desativadas
• Valor da $PSNativeCommandUseErrorActionPreference variável de preferência true, false ou unset
• A contagem de operações de abertura de sessão remota
• Os nomes dos subsistemas registrados: Completion e general. Se o nome do subsistema não for um desses, anonymous será enviado como o nome.
• A contagem de sugestões de feedback CommandNotFound fornecidas.
• A contagem do uso de PowerShellUnsafeAssemblyLoad, bem como se a carga foi ou não bem-sucedida.

O PowerShell envia essas informações periodicamente durante a vida útil 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, confira about_Environment_Variables.

A variável de ambiente $Env:POWERSHELL_DISTRIBUTION_CHANNEL é 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 Microsoft Privacy Statement