Diagnostiikkatietojen katseluohjelma PowerShellin yleiskatsaukselleDiagnostic Data Viewer for PowerShell Overview

Koskee seuraavia:Applies to

  • Windows 10, versio 1803 ja uudemmatWindows10, version 1803 and newer
  • Windows Server, versio 1803Windows Server, version 1803
  • Windows Server 2019Windows Server 2019

JohdantoIntroduction

Diagnostiikkatietojen katseluohjelma PowerShellille on PowerShell-moduuli, jolla voit tarkastella diagnostiikkatietoja, joita laite lähettää Microsoftille ryhmitellen tiedot yksinkertaisiin luokkiin sen mukaan, miten Microsoft käyttää niitä.The Diagnostic Data Viewer for PowerShell is a PowerShell module that lets you review the diagnostic data your device is sending to Microsoft, grouping the info into simple categories based on how it's used by Microsoft.

VaatimuksetRequirements

Sinulla on oltava järjestelmänvalvojan oikeudet laitteessa, jotta voit käyttää PowerShell-moduulia.You must have administrative privilege on the device in order to use this PowerShell module. Tämä moduuli edellyttää käyttöjärjestelmän versiota 1803 tai uudempaa.This module requires OS version 1803 and higher.

Asenna ja käytä diagnostiikkatietojen katseluohjelmaa PowerShellilleInstall and Use the Diagnostic Data Viewer for PowerShell

Sinun on asennettava moduuli, ennen kuin voit käyttää diagnostiikkatietojen katseluohjelmaa PowerShellille.You must install the module before you can use the Diagnostic Data Viewer for PowerShell.

Laajennetun PowerShell-istunnon avaaminenOpening an Elevated PowerShell session

Diagnostiikkatietojen katseluohjelman PowerShellille käyttäminen edellyttää järjestelmänvalvojan oikeuksia (laajennettuja).Using the Diagnostic Data Viewer for PowerShell requires administrative (elevated) privilege. Laajennetun PowerShell-kehotteen voi avata kahdella eri tavalla.There are two ways to open an elevated PowerShell prompt. Voit käyttää kumpaa tahansa menetelmää.You can use either method.

  • Valitse Aloitus > Windows PowerShell > Suorita järjestelmänvalvojanaGo to Start > Windows PowerShell > Run as administrator
  • Valitse Aloitus > Komentokehote > Suorita järjestelmänvalvojana ja suorita komentoGo to Start > Command prompt > Run as administrator, and run the command C:\> powershell.exe

Asenna Diagnostiikkatietojen katseluohjelma PowerShellilleInstall the Diagnostic Data Viewer for PowerShell

Tärkeä

On suositeltavaa tutustua ohjeisiin kohdassa PowerShell-valikoiman käytön aloittaminen.It is recommended to visit the documentation on Getting Started with PowerShell Gallery. Tämä sivu sisältää tarkempia tietoja PowerShell-moduulin asentamisesta.This page provides more specific details on installing a PowerShell module.

Asenna diagnostiikkatietojen katseluohjelma PowerShellille -moduulin uusin versio suorittamalla seuraava komento laajennetussa PowerShell-istunnossa:To install the newest version of the Diagnostic Data Viewer PowerShell module, run the following command within an elevated PowerShell session:

PS C:\> Install-Module -Name Microsoft.DiagnosticDataViewer

Jos haluat nähdä lisätietoja moduulista, tutustu PowerShell-valikoimaan.To see more information about the module, visit PowerShell Gallery.

Ota käyttöön tietojen tarkasteleminenTurn on data viewing

Ennen kuin voit käyttää tätä työkalua, sinun on otettava käyttöön tietojen tarkasteleminen.Before you can use this tool, you must turn on data viewing. Tietojen tarkastelun ottaminen käyttöön mahdollistaa sen, että Windows voi tallentaa laitteesi diagnostiikkatietojen paikalliset historiatiedot tarkasteltavaksesi, ennen kuin poistat toiminnon käytöstä.Turning on data viewing enables Windows to store a local history of your device's diagnostic data for you to view until you turn it off.

Huomaa, että tämä asetus ei ohjaa, lähettääkö laitteesi diagnostiikkatietoja.Note that this setting does not control whether your device sends diagnostic data. Sen sijaan se ohjaa, lähettääkö Windows-laitteesi paikallisen kopion tarkasteltavaksi lähetetyistä diagnostiikkatiedoista.Instead, it controls whether your Windows device saves a local copy of the diagnostic data sent for your viewing.

Tietojen tarkastelun ottaminen käyttöön Asetukset-sivullaTo turn on data viewing through the Settings page

  1. Valitse Aloitus, valitse Asetukset > Tietosuoja > Diagnostiikka ja palaute.Go to Start, select Settings > Privacy > Diagnostics & feedback.

  2. Diagnostiikkatiedot-kohdassa ota käyttöön Jos tietojen tarkastelu on käytössä, näet diagnostiikkatiedot -vaihtoehto.Under Diagnostic data, turn on the If data viewing is enabled, you can see your diagnostics data option.

    Sijainti tietojen tarkastelemisen ottamiseksi käyttöön

Tietojen tarkastelun ottaminen käyttöön PowerShellin kauttaTo turn on data viewing through PowerShell

Suorita seuraava komento laajennetussa PowerShell-istunnossa:Run the following command within an elevated PowerShell session:

PS C:\> Enable-DiagnosticDataViewing

Kun tietojen tarkasteleminen on käytössä, Windows-tietokone aloittaa tallentamaan historiaa diagnostiikkatiedoista, jotka lähetetään Microsoftille tästä lähtien.Once data viewing is enabled, your Windows machine will begin saving a history of diagnostic data that is sent to Microsoft from this point on.

Tärkeä

Tietojen tarkastelun ottaminen käyttää enintään 1 gigatavun (oletusasetus) levytilaa järjestelmälevyllä.Turning on data viewing can use up to 1GB (default setting) of disk space on your system drive. On suositeltavaa poistaa käytöstä tietojen tarkasteleminen, kun et enää käytä diagnostiikkatietojen katseluohjelmaa.We recommend that you turn off data viewing when you're done using the Diagnostic Data Viewer. Lisätietoja tietojen tarkastelun poistamisesta käytöstä on tämän artikkelin kohdassa Tietojen tarkastelun poistaminen käytöstä.For info about turning off data viewing, see the Turn off data viewing section in this article.

Diagnostiikkatietojen katseluohjelma PowerShellille - Käytön aloittaminenGetting Started with Diagnostic Data Viewer for PowerShell

Jos haluat tarkastella cmdlet-komennon käyttöä, sen hyväksymiä parametrejä ja esimerkkejä, suorita seuraava komento laajennetusta PowerShell-istunnosta:To see how to use the cmdlet, the parameters it accepts, and examples, run the following command from an elevated PowerShell session:

PS C:\> Get-Help Get-DiagnosticData

Aloita diagnostiikkatietojen tarkasteleminenTo Start Viewing Diagnostic Data

Laajennetusta PowerShell-istunnosta suorita seuraava komento:From an elevated PowerShell session, run the following command:

PS C:\> Get-DiagnosticData

Jos tapahtumien määrä on suuri ja haluat pysäyttää komennon, kirjoita Ctrl+C.If the number of events is large, and you'd like to stop the command, enter Ctrl+C.

Tärkeä

Yllä oleva komento voi tuottaa vain vähän tai ei ollenkaan tuloksia, jos otit tietojen tarkastelun käyttöön hiljattain.The above command may produce little to no results if you enabled data viewing recently. Voi kestää useamman minuutin, ennen kuin Windows-laite voi näyttää lähettämiään diagnostiikkatietoja.It can take several minutes before your Windows device can show diagnostic data it has sent. Käytä laitettasi tavalliseen tapaan sillä aikaa ja yritä uudelleen.Use your device as you normally would in the mean time and try again.

Saavuta enemmän diagnostiikkatietojen katseluohjelmalla PowerShellilleDoing more with the Diagnostic Data Viewer for PowerShell

Diagnostiikkatietojen katseluohjelma PowerShellille tarjoaa seuraavat ominaisuudet laitteesi diagnostiikkatietojen tarkasteluun ja suodattamiseen.The Diagnostic Data Viewer for PowerShell provides you with the following features to view and filter your device's diagnostic data. Voit käyttää myös muita monipuolisia PowerShell-työkaluja tämän moduulin kanssa.You can also use the extensive suite of other PowerShell tools with this module.

  • Tarkastele diagnostiikan tapahtumia.View your diagnostic events. Suorittamalla PS C:\> Get-DiagnosticData voit tarkastella diagnostiikan tapahtumia.Running PS C:\> Get-DiagnosticData, you can review your diagnostic events. Nämä tapahtumat vastaavat toimintoja, jotka tapahtuivat ja lähetettiin Microsoftille.These events reflect activities that occurred and were sent to Microsoft.

    Kukin tapahtuma näkyy PowerShell-objektina.Each event is displayed as a PowerShell Object. Oletusarvoisesti kussakin tapahtumassa näkyy tapahtuman nimi, aikan, jolloin Windows-laite näki sen, onko tapahtuma Perustasoa, sen diagnostiikan tapahtuman luokkaja yksityiskohtainen JSON-näkymä sen sisältämistä tiedoista näyttäen tapahtuman täsmälleen sellaisena, kuin se lähetettiin Microsoftille.By default each event shows the event name, the time when it was seen by your Windows device, whether the event is Basic, its diagnostic event category, and a detailed JSON view of the information it contains, which shows the event exactly as it was when sent to Microsoft. Microsoft käyttää näitä tietoja Windows-käyttöjärjestelmän jatkuvaan parantamiseen.Microsoft uses this info to continually improve the Windows operating system.

  • Tarkastele diagnostiikkatapahtumien luokkia.View diagnostic event categories. Kukin tapahtuma näyttää diagnostiikan tapahtuman luokat, johon se kuuluu.Each event shows the diagnostic event categories that it belongs to. Nämä luokat määrittävät, miten Microsoft käyttää tapahtumia.These categories define how events are used by Microsoft. Luokat näkyvät numeerisina tunnuksina.The categories are shown as numeric identifiers. Saat lisätietoja näistä luokista kohdasta Windowsin diagnostiikkatiedot.For more information about these categories, see Windows Diagnostic Data.

    Voit tarkastella kunkin numeerisen tunnuksen edustamaa diagnostiikan luokkaa ja mitä luokka tarkoittaa, suorittamalla komennon:To view the diagnostic category represented by each numeric identifier and what the category means, you can run the command:

    PS C:\> Get-DiagnosticDataTypes
    
  • Suodata tapahtuman lähetysajan perusteella.Filter events by when they were sent. Voit tarkastella tapahtumia määritetyllä aikavälillä määrittämällä alkamisajan ja päättymisajan kullekin komennolle.You can view events within specified time ranges by specifying a start time and end time of each command. Jos esimerkiksi haluat nähdä kaikki diagnostiikkatiedot, jotka on lähetetty 12 ja 6 tuntia aiemman, suorita seuraava komento.For example, to see all diagnostic data sent between 12 and 6 hours ago, run the following command. Huomaa, että tiedot näytetään vanhimmat tiedot ensin.Note that data is shown in order of oldest first.

    PS C:\> Get-DiagnosticData -StartTime (Get-Date).AddHours(-12) -EndTime (Get-Date).AddHours(-6)
    
  • Laajenna jokaisen komennon tulokset.Export the results of each command. Voit viedä jokaisen komennon tulokset erilliseen tiedostoon, esimerkiksi csv-tiedostoon, käyttämällä putkea |.You can export the results of each command to a separate file such as a csv by using pipe |. EsimerkiksiFor example,

    PS C:\> Get-DiagnosticData | Export-Csv 'mydata.csv'
    

Poista käytöstä tietojen tarkasteleminenTurn off data viewing

Kun olet saanut diagnostiikkatiedot arvioitua, suosittelemme poistamaan käytöstä tietojen tarkastelemisen, jotta et käytä enempää muistia.When you're done reviewing your diagnostic data, we recommend turning off data viewing to prevent using up more memory. Tietojen tarkastelun poistaminen käytöstä lopettaa Windowsin diagnostiikkatietojen historian tallentamisen ja tyhjentää olemassa olevan diagnostiikkatietojen historian laitteestasi.Turning off data viewing stops Windows from saving a history of your diagnostic data and clears the existing history of diagnostic data from your device.

Tietojen tarkastelun poistaminen käytöstä Asetukset-sivullaTo turn off data viewing through the Settings page

  1. Valitse Aloitus, valitse Asetukset > Tietosuoja > Diagnostiikka ja palaute.Go to Start, select Settings > Privacy > Diagnostics & feedback.

  2. Diagnostiikkatiedot-kohdassa poista käytöstä Jos tietojen tarkastelu on käytössä, näet diagnostiikkatiedot -vaihtoehto.Under Diagnostic data, turn off the If data viewing is enabled, you can see your diagnostics data option.

    Sijainti tietojen tarkastelemisen poistamiseksi käytöstä

Tietojen tarkastelun poistaminen käytöstä PowerShellin kauttaTo turn off data viewing through PowerShell

Suorita seuraava komento laajennetussa PowerShell-istunnossa:Within an elevated PowerShell session, run the following command:

PS C:\> Disable-DiagnosticDataViewing

Tietojen historian koon muokkaaminenModifying the size of your data history

Oletusarvon mukaan työkalu näyttää korkeintaan 1 Gt tai 30 päivän tiedot (sen mukaan, kumpi toteutuu ensin).By default, the tool will show you up to 1GB or 30 days of data (whichever comes first). Kun joko aika- tai tilaraja saavutetaan, tiedot poistetaan vaiheittainen vanhimmasta arvopisteestä aloittaen.Once either the time or space limit is reached, the data is incrementally dropped with the oldest data points dropped first.

Tietojen historian koon muokkaaminenModify the size of your data history

Tärkeä

Sen diagnostiikkatietojen enimmäismäärän muokkaaminen, jota työkalu voi tarkastella, saattaa vaikuttaa tietokoneesi suorituskykyyn.Modifying the maximum amount of diagnostic data viewable by the tool may come with performance impacts to your machine.

Tärkeä

Jos muutat tietojen historian enimmäiskokoa suuremmasta arvosta pienemmäksi arvoksi, sinun on levytilan vapauttamista varten poistettava tietojen tarkasteleminen käytöstä ja otettava se uudelleen käyttöön.If you modify the maximum data history size from a larger value to a lower value, you must turn off data viewing and turn it back on in order to reclaim disk space.

Voit muuttaa tarkasteltavaa tietojen historian enimmäiskokoa (megatavuina).You can change the maximum data history size (in megabytes) that you can view. Voit esimerkiksi asettaa tietojen historian enimmäiskooksi 2048 megatavua (2 Gt) suorittamalla seuraavan komennon.For example, to set the maximum data history size to 2048MB (2GB), you can run the following command.

PS C:\> Set-DiagnosticStoreCapacity -Size 2048

Voit muuttaa tarkasteltavaa tietojen historian enimmäisaikaa (tunteina).You can change the maximum data history time (in hours) that you can view. Voit esimerkiksi asettaa tietojen historian enimmäisajaksi 24 tuntia suorittamalla seuraavan komennon.For example, to set the maximum data history time to 24 hours, you can run the following command.

PS C:\> Set-DiagnosticStoreCapacity -Time 24

Tärkeä

Voit joutua käynnistämään tietokoneen, jotta uudet asetukset tulevat voimaan.You may need to restart your machine for the new settings to take effect.

Tärkeä

Jos Storen Diagnostiikkatietojen katseluohjelma -sovellus on asennettu samaan laitteeseen, tietojen historian kokoon tehdyt muutokset PowerShell-moduulin kautta näkyvät myös sovelluksessa.If you have the Diagnostic Data Viewer store app installed on the same device, modifications to the size of your data history through the PowerShell module will also be reflected in the app.

Tietojen historian koon palauttaminenReset the size of your data history

Jos haluat palauttaa tietojen historian koon takaisin sen alkuperäiseen 1 Gt:n oletusarvoon, suorita seuraava komento laajennetussa PowerShell-istunnossa:To reset the maximum data history size back to its original 1GB default value, run the following command in an elevated PowerShell session:

PS C:\> Set-DiagnosticStoreCapacity -Size 1024 -Time 720 

Kun palautat tietojen historian koon pienemmäksi arvoksi, sinun on levytilan vapauttamista varten poistettava tietojen tarkasteleminen käytöstä ja otettava se uudelleen käyttöön.When resetting the size of your data history to a lower value, be sure to turn off data viewing and turn it back on in order to reclaim disk space.