Visão geral do Visualizador de Dados de Diagnóstico para PowerShell
Aplicável ao
- Windows 11, versão 21H2 e posteriores
- Windows 10, versão 1803 ou posterior.
- Windows Server, versão 1803
- Windows Server 2019
Introdução
O Visualizador de Dados de Diagnóstico para PowerShell é um módulo do PowerShell que permite analisar os dados de diagnóstico que o dispositivo está enviando à Microsoft, agrupando as informações em categorias simples com base em como elas são usadas pela Microsoft.
Requisitos
Você deve ter privilégios administrativos no dispositivo para usar esse módulo do PowerShell. Esse módulo requer o sistema operacional versão 1803 ou superior.
Instalar e usar o Visualizador de Dados de Diagnóstico para PowerShell
Você deve instalar o módulo para poder usar o Visualizador de Dados de Diagnóstico para PowerShell.
Abrir uma sessão do PowerShell com privilégios elevados
O uso do Visualizador de Dados de Diagnóstico para PowerShell requer privilégios administrativos (elevados). Há duas maneiras de abrir um prompt do PowerShell com privilégios elevados. Você pode usar qualquer um dos métodos.
- Vá para Iniciar>Windows PowerShell>Executar como administrador
- Vá para Iniciar>Prompt de comando>Executar como administrador e execute o comando
C:\> powershell.exe
Instalar o Visualizador de Dados de Diagnóstico para PowerShell
Importante
É recomendável visitar a documentação em Introdução à Galeria do PowerShell. Esta página fornece detalhes mais específicos sobre como instalar um módulo do PowerShell.
Para instalar a versão mais recente do módulo Visualizador de Dados de Diagnóstico do PowerShell, execute o seguinte comando em uma sessão do PowerShell com privilégios elevados:
PS C:\> Install-Module -Name Microsoft.DiagnosticDataViewer
Para ver mais informações sobre o módulo, visite a Galeria do PowerShell.
Ativar a visualização de dados
Para usar essa ferramenta, você deve ativar a visualização de dados. Ativar a visualização de dados permite que o Windows armazene um histórico local de dados de diagnóstico do dispositivo para você visualizar até desativá-lo.
Observe que essa configuração não controla se o dispositivo envia dados de diagnóstico. Ela controla se o dispositivo Windows salva uma cópia local dos dados de diagnóstico enviados para sua visualização.
Para ativar a visualização de dados por meio da página Configurações
Vá para Iniciar, selecione Configurações>Privacidade>Comentários e diagnóstico.
Em Dados de diagnóstico, ative a opção Se a exibição de dados estiver habilitada, você poderá ver seus dados de diagnóstico.
Para ativar a exibição de dados por meio do PowerShell
Execute o seguinte comando em uma sessão do PowerShell com privilégios elevados:
PS C:\> Enable-DiagnosticDataViewing
Depois que a visualização de dados for habilitada, seu computador Windows começará a salvar um histórico de dados de diagnóstico enviados à Microsoft desse momento em diante.
Importante
Ativar a visualização de dados pode usar até 1 GB (configuração padrão) de espaço em disco na unidade do sistema. É recomendável desativar a visualização de dados ao terminar de usar o Visualizador de Dados de Diagnóstico. Para obter informações sobre como desativar a visualização de dados, consulte a seção Desativar a visualização de dados neste artigo.
Introdução ao Visualizador de Dados de Diagnóstico para PowerShell
Para ver como usar o cmdlet, os parâmetros que ele aceita e exemplos, execute o seguinte comando em uma sessão do PowerShell com privilégios elevados:
PS C:\> Get-Help Get-DiagnosticData
Para começar a visualizar dados de diagnóstico
Em uma sessão do PowerShell com privilégios elevados, execute o seguinte comando:
PS C:\> Get-DiagnosticData
Se o número de eventos for grande e você quiser interromper o comando, digite Ctrl+C.
Importante
O comando acima pode produzir pouco ou nenhum resultado se você habilitou a visualização de dados recentemente. Pode levar vários minutos para seu dispositivo Windows mostrar os dados de diagnóstico que foram enviados. Use seu dispositivo normalmente enquanto isso e tente novamente.
Fazer mais com o Visualizador de Dados de Diagnóstico para PowerShell
O Visualizador de Dados de Diagnóstico para PowerShell fornece os seguintes recursos para exibir e filtrar os dados de diagnóstico do dispositivo. Você também pode usar o amplo conjunto de ferramentas do PowerShell com esse módulo.
Visualizar os eventos de diagnóstico. Executando
PS C:\> Get-DiagnosticData, você pode analisar os eventos de diagnóstico. Esses eventos refletem as atividades que ocorreram e foram enviadas à Microsoft.Cada evento é exibido como um Objeto do PowerShell. Por padrão, cada evento mostra o nome do evento, a hora em ele foi visto pelo dispositivo Windows, se o evento é Básico, sua categoria de evento de diagnóstico e uma exibição JSON detalhada das informações que ele contém, que mostra o evento exatamente como ele foi enviado à Microsoft. A Microsoft usa essas informações para melhorar continuamente o sistema operacional Windows.
Exibir categorias de evento de diagnóstico. Cada evento mostra as categorias de evento de diagnóstico às quais ele pertence. Essas categorias definem como os eventos são usados pela Microsoft. As categorias são mostradas como identificadores numéricos. Para obter mais informações sobre essas categorias, consulte Dados de Diagnóstico do Windows.
Para visualizar a categoria de diagnóstico representada por cada identificador numérico e o que a categoria significa, você pode executar o comando:
PS C:\> Get-DiagnosticDataTypesFiltrar os eventos por quando eles foram enviados. Você pode visualizar os eventos em intervalos de tempo especificados, ao especificar a hora de início e a hora de término de cada comando. Por exemplo, para ver todos os dados de diagnóstico enviados entre 12 e 6 horas atrás, execute o comando a seguir. Observe que os dados são mostrados na ordem do mais antigo primeiro.
PS C:\> Get-DiagnosticData -StartTime (Get-Date).AddHours(-12) -EndTime (Get-Date).AddHours(-6)Exportar os resultados de cada comando. Você pode exportar os resultados de cada comando para um arquivo separado, como um csv, usando pipe
|. Por exemplo,PS C:\> Get-DiagnosticData | Export-Csv 'mydata.csv'
Desativar a visualização de dados
Quando você terminar de analisar os dados de diagnóstico, recomendamos desativar a visualização de dados para evitar o consumo de mais memória. Desativar a visualização de dados impede que o Windows salve um histórico de dados de diagnóstico e limpa o histórico de dados de diagnóstico existente do dispositivo.
Para desativar a visualização de dados por meio da página Configurações
Vá para Iniciar, selecione Configurações>Privacidade>Comentários e diagnóstico.
Em Dados de diagnóstico, desative a opção Se a exibição de dados estiver habilitada, você poderá ver seus dados de diagnóstico.
Para desabilitar a exibição de dados por meio do PowerShell
Em uma sessão do PowerShell com privilégios elevados, execute o seguinte comando:
PS C:\> Disable-DiagnosticDataViewing
Modificação do tamanho do histórico de dados
Por padrão, a ferramenta mostrará até 1 GB ou 30 dias de dados (o que ocorrer primeiro). Quando o tempo ou o espaço limite for atingido, os dados serão removidos de forma incremental com os dados mais antigos removidos primeiro.
Modificar o tamanho do histórico de dados
Importante
Modificar a quantidade máxima de dados de diagnóstico que podem ser visualizados pela ferramenta pode gerar impactos no desempenho do computador.
Importante
Se você modificar o tamanho máximo do histórico de dados de um valor maior para um valor menor, desative a visualização de dados e ative-a novamente para recuperar o espaço em disco.
Você pode alterar o tamanho máximo do histórico de dados (em megabytes) que pode ser exibido. Por exemplo, para definir o tamanho máximo do histórico de dados para 2048 MB (2 GB), você pode executar o comando a seguir.
PS C:\> Set-DiagnosticStoreCapacity -Size 2048
Você pode alterar o tempo máximo do histórico de dados (em horas) que você pode visualizar. Por exemplo, para definir o tempo máximo do histórico de dados para 24 horas, você pode executar o comando a seguir.
PS C:\> Set-DiagnosticStoreCapacity -Time 24
Importante
Talvez seja necessário reiniciar o computador para as novas configurações entrarem em vigor.
Importante
Se você tiver o app Visualizador de Dados de Diagnóstico da Store instalado no mesmo dispositivo, as modificações do tamanho do histórico de dados pelo módulo do PowerShell também serão refletidas no app.
Redefinir o tamanho do histórico de dados
Para redefinir o tamanho máximo do histórico de dados para o valor original padrão de 1 GB, execute o seguinte comando em uma sessão do PowerShell com privilégios elevados:
PS C:\> Set-DiagnosticStoreCapacity -Size 1024 -Time 720
Quando você redefinir o tamanho do seu histórico de dados para um valor menor, não se esqueça de desativar a visualização de dados e ativá-la novamente para recuperar o espaço em disco.