about_Telemetry

Descrizione breve

Descrive i dati di telemetria raccolti in PowerShell e come rifiutare esplicitamente.

Descrizione lunga

PowerShell invia dati di telemetria di base a Microsoft tramite Application Insights. Questi dati consentono di comprendere meglio gli ambienti che usano PowerShell e consentono di classificare in ordine di priorità le nuove funzionalità e le correzioni. PowerShell rende anonime le informazioni di telemetria prima dell'invio.

PowerShell invia le informazioni seguenti all'avvio:

• Produttore, nome e versione del sistema operativo
• Versione di PowerShell
• Valore della variabile di ambiente POWERSHELL_DISTRIBUTION_CHANNEL
• Versione di Application Insights SDK usata da PowerShell
• Posizione geografica dell'host, in base all'indirizzo IP
• Parametri passati a pwsh senza i valori dei parametri
• Impostazione dei criteri di esecuzione della sessione corrente
• GUID generato in modo casuale che rappresenta l'utente che esegue l'istanza
• GUID generato in modo casuale che rappresenta l'istanza di sessione

I dati di telemetria di avvio vengono raccolti solo all'avvio del pwsh file eseguibile. Queste informazioni non vengono inviate se il motore di PowerShell è incorporato in un'altra applicazione host.

Nota

Application Insights usa l'indirizzo IP degli host per determinare la posizione geografica. L'indirizzo IP non viene mai incluso nei dati di telemetria o archiviati nel database. Per altre informazioni, vedere Georilevazione e gestione degli indirizzi IP.

PowerShell invia le informazioni seguenti durante la sessione:

• Numero di chiamate all'API PowerShell.Create()
• Nomi e versioni dei moduli di proprietà di Microsoft importati
• Conteggio dei moduli importati con il CrescendoBuilt tag
• Nomi delle funzionalità sperimentali abilitate
• Nomi delle funzionalità sperimentali disabilitate
• Valore della variabile di $PSNativeCommandUseErrorActionPreferencetruepreferenza, o falseunset
• Numero di operazioni di apertura sessione remota
• Nomi dei sottosistemi registrati: Completion e general. Se il nome del sottosistema non è uno di questi, anonymous viene inviato come nome.
• Conteggio dei suggerimenti per CommandNotFound i commenti e suggerimenti forniti.
• Conteggio dell'utilizzo PowerShellUnsafeAssemblyLoad e se il carico ha avuto esito positivo o negativo.

PowerShell invia periodicamente queste informazioni durante la durata della sessione per tutte le applicazioni host.

Per rifiutare esplicitamente questa telemetria, impostare la variabile di ambiente $env:POWERSHELL_TELEMETRY_OPTOUT su true, yes o 1. Affinché questa variabile di ambiente abbia effetto, è necessario impostarla prima di avviare il processo di PowerShell. Per altre informazioni, vedere about_Environment_Variables.

La $env:POWERSHELL_DISTRIBUTION_CHANNEL variabile di ambiente viene impostata dai pacchetti del programma di installazione per registrare il metodo e l'origine dell'installazione per PowerShell. Poiché queste informazioni sono incluse nei dati di telemetria inviati a Microsoft, gli utenti non devono modificare questo valore.

Per altre informazioni su queste variabili di ambiente, vedere about_Environment_Variables.

Per altre informazioni sull'informativa sulla privacy di Microsoft, vedere Informativa sulla privacy di Microsoft