Číst v angličtině

Sdílet prostřednictvím


Import-Counter

Importuje soubory protokolu čítače výkonu a vytvoří objekty, které představují jednotlivé vzorky čítačů v protokolu.

Syntaxe

Import-Counter
      [-Path] <String[]>
      [-StartTime <DateTime>]
      [-EndTime <DateTime>]
      [-Counter <String[]>]
      [-MaxSamples <Int64>]
      [<CommonParameters>]
Import-Counter
      [-Path] <String[]>
      -ListSet <String[]>
      [<CommonParameters>]
Import-Counter
      [-Path] <String[]>
      [-Summary]
      [<CommonParameters>]

Description

Rutina Import-Counter importuje data čítače výkonu ze souborů protokolu čítačů výkonu a vytvoří objekty pro každou ukázku čítače v souboru. PerformanceCounterSampleSet objekty, které vytváří, jsou identické s objekty, které Get-Counter vrací, když shromažďuje data čítače výkonu.

Data můžete importovat ze souborů protokolu výkonu oddělených čárkami (.csv), hodnoty oddělené tabulátory (.tsv) a binárního protokolu výkonu (.blg). Pokud používáte .blg soubory, můžete v každém příkazu importovat až 32 souborů. K filtrování importovaných dat můžete použít parametry Import-Counter.

Spolu s rutinami Get-Counter a Export-Counter umožňuje tato funkce shromažďovat, exportovat, importovat, kombinovat, filtrovat, manipulovat a znovu exportovat data čítačů výkonu v prostředí Windows PowerShell.

Příklady

Příklad 1: Import všech dat čítačů ze souboru

$data = Import-Counter -Path ProcessorData.csv

Tento příkaz naimportuje všechna data čítačů ze souboru ProcessorData.csv do proměnné $data.

Příklad 2: Import konkrétních dat čítačů ze souboru

$i = Import-Counter -Path "ProcessorData.blg" -Counter "\\SERVER01\Processor(_Total)\Interrupts/sec"

Tento příkaz importuje pouze "Processor(_total)\Interrupts/sec" data čítače ze souboru ProcessorData.blg do proměnné $i.

Příklad 3: Vyberte data z čítače výkonu a pak je exportujte do souboru.

Tento příklad ukazuje, jak vybrat data ze souboru protokolu čítače výkonu (.blg) a pak exportovat vybraná data do .csv souboru. První čtyři příkazy získají cesty čítače ze souboru a uloží je do proměnné s názvem $data. Poslední dva příkazy importuje vybraná data a pak exportuje jenom vybraná data.

$data = Import-Counter .\ProcessorData.blg
$data[0].CounterSamples | Format-Table -Property Path

Path
----
\\SERVER01\Processor(_Total)\DPC Rate
\\SERVER01\Processor(1)\DPC Rate
\\SERVER01\Processor(0)\DPC Rate
\\SERVER01\Processor(_Total)\% Idle Time
\\SERVER01\Processor(1)\% Idle Time
\\SERVER01\Processor(0)\% Idle Time
\\SERVER01\Processor(_Total)\% C3 Time
\\SERVER01\Processor(1)\% C3 Time

$intCtrs = $Data[0].Countersamples | Where-Object {$_.Path -like "*Interrupts/sec"} | ForEach-Object {$_.Path}
$intCtrs

\\SERVER01\Processor(_Total)\Interrupts/sec
\\SERVER01\Processor(1)\Interrupts/sec
\\SERVER01\Processor(0)\Interrupts/sec

$i = Import-Counter -Path .\ProcessorData.blg -Counter $intCtrs
$i | Export-Counter -Path .\Interrupts.csv -Format CSV

První příkaz používá Import-Counter k importu všech dat čítačů výkonu ze souborů ProcessorData.blg. Příkaz uloží data do proměnné $data.

Druhý příkaz zobrazí cesty čítačů v proměnné $data. Pokud chcete zobrazit zobrazení zobrazené ve výstupu příkazu, použije příklad rutinu Format-Table k formátování jako tabulku cest čítačů prvního čítače v proměnné $data.

Třetí příkaz získá cesty čítače, které končí Interrupts/sec a uloží cesty do proměnné $intCtrs. Používá rutinu Where-Object k filtrování cest čítačů a rutiny ForEach-Object k získání pouze hodnoty vlastnosti Path každého vybraného objektu cesty.

Čtvrtý příkaz zobrazí vybrané cesty čítačů v proměnné $intCtrs.

Pátý příkaz k importu dat používá rutinu Import-Counter. Používá proměnnou $intCtrs jako hodnotu parametru Counter k importu pouze dat pro cesty čítačů v $intCtrs.

Šestý příkaz používá rutinu Export-Counter k exportu dat do souboru Interrupts.csv.

Příklad 4: Zobrazení všech cest čítačů ve skupině importovaných sad čítačů

Tento příklad ukazuje, jak zobrazit všechny cesty čítačů ve skupině importovaných sad čítačů.

Import-Counter -Path ProcessorData.csv -ListSet *

CounterSetName     : Processor
MachineName        : \\SERVER01
CounterSetType     : MultiInstance
Description        :
Paths              : {\\SERVER01\Processor(*)\DPC Rate, \\SERVER01\Processor(*)\% Idle Time, \\SERVER01
\Processor(*)\% C3 Time, \\SERVER01\Processor(*)\% Interrupt Time...}
PathsWithInstances : {\\SERVER01\Processor(_Total)\DPC Rate, \\SERVER01\Processor(1)\DPC Rate, \\SERVER01
\Processor(0)\DPC Rate, \\SERVER01\Processor(_Total)\% Idle Time...}
Counter            : {\\SERVER01\Processor(*)\DPC Rate, \\SERVER01\Processor(*)\% Idle Time, \\SERVER01
\Processor(*)\% C3 Time, \\SERVER01\Processor(*)\% Interrupt Time...}

Import-Counter -Path ProcessorData.csv -ListSet * | ForEach-Object {$_.Paths}

\\SERVER01\Processor(*)\DPC Rate
\\SERVER01\Processor(*)\% Idle Time
\\SERVER01\Processor(*)\% C3 Time
\\SERVER01\Processor(*)\% Interrupt Time
\\SERVER01\Processor(*)\% C2 Time
\\SERVER01\Processor(*)\% User Time
\\SERVER01\Processor(*)\% C1 Time
\\SERVER01\Processor(*)\% Processor Time
\\SERVER01\Processor(*)\C1 Transitions/sec
\\SERVER01\Processor(*)\% DPC Time
\\SERVER01\Processor(*)\C2 Transitions/sec
\\SERVER01\Processor(*)\% Privileged Time
\\SERVER01\Processor(*)\C3 Transitions/sec
\\SERVER01\Processor(*)\DPCs Queued/sec
\\SERVER01\Processor(*)\Interrupts/sec

První příkaz používá parametr ListSet rutiny Import-Counter k získání všech sad čítačů reprezentovaných v datovém souboru čítače.

Druhý příkaz získá všechny cesty čítače ze sady seznamů.

Příklad 5: Import dat čítačů z rozsahu časových razítek

Tento příklad importuje pouze data čítače, která mají časové razítko mezi počátečními koncovými oblastmi zadanými v příkazu.

Import-Counter -Path ".\disk.blg" | Format-Table -Property Timestamp
$start = [datetime]"7/9/2008 3:47:00 PM"; $end = [datetime]"7/9/2008 3:47:59 PM"
Import-Counter -Path Disk.blg -StartTime $start -EndTime $end

První příkaz v tabulce obsahuje časové razítka všech dat v souboru ProcessorData.blg.

Druhý příkaz uloží konkrétní časová razítka do $start a $end proměnných. Řetězce se přetypují na objekty DateTime.

Třetí příkaz používá rutinu Import-Counter k získání pouze dat čítačů, která mají časové razítko mezi počátečním a koncovým časem (včetně). Příkaz používá startTime a EndTime parametry Import-Counter k určení rozsahu.

Příklad 6: Import zadaného počtu nejstarších vzorků ze souboru protokolu čítače výkonu

Tento příklad ukazuje, jak importovat pět nejstarších a pět nejnovějších ukázek ze souboru protokolu čítače výkonu.

Import-Counter -Path "Disk.blg" -MaxSamples 5
(Import-Counter -Path Disk.blg)[-1 .. -5]

První příkaz použije rutinu Import-Counter k importu prvních (nejstarších) pěti ukázek ze souboru Disk.blg. Příkaz používá parametr MaxSamples k omezení importu na pět vzorků čítačů.

Druhý příkaz používá maticový zápis a operátor rozsahu Prostředí Windows PowerShell (..) k získání posledních pěti vzorků čítačů ze souboru. Toto je pět nejnovějších ukázek.

Příklad 7: Získání souhrnu dat čítačů ze souboru

Import-Counter "D:\Samples\Memory.blg" -Summary

OldestRecord            NewestRecord            SampleCount
------------            ------------            -----------
7/10/2008 2:59:18 PM    7/10/2008 3:00:27 PM    1000

Tento příkaz používá parametr Summary rutiny Import-Counter k získání souhrnu dat čítačů v souboru Memory.blg.

Příklad 8: Aktualizace souboru protokolu čítače výkonu

Tento příklad aktualizuje soubor protokolu čítače výkonu.

$counters = Import-Counter OldData.blg -ListSet * | ForEach-Object {$_.PathsWithInstances}
Get-Counter -Counter $Counters -MaxSamples 20 | Export-Counter C:\Logs\NewData.blg

První příkaz pomocí parametru ListSetImport-Counter získá čítače v OldData.blg, existující soubor protokolu čítačů. Příkaz používá operátor kanálu (|) k odeslání dat do příkazu ForEach-Object, který získá pouze hodnoty PathsWithInstances vlastnost každého objektu.

Druhý příkaz získá aktualizovaná data pro čítače v proměnné $counters. Pomocí rutiny Get-Counter získáte aktuální ukázku a pak výsledky vyexportujete do souboru NewData.blg.

Příklad 9: Import dat protokolu výkonu z více souborů a jejich uložení

$counters = "D:\test\pdata.blg", "D:\samples\netlog.blg" | Import-Counter

Tento příkaz importuje data protokolu výkonu ze dvou protokolů a uloží je do proměnné $counters. Příkaz pomocí operátoru kanálu odešle cesty protokolu výkonu do čítače importu, který importuje data ze zadaných cest.

Všimněte si, že každá cesta je uzavřená v uvozovkách a že cesty jsou navzájem oddělené čárkou.

Parametry

-Counter

Určuje jako pole řetězců čítače výkonu. Ve výchozím nastavení Import-Counter importuje všechna data ze všech čítačů ve vstupních souborech. Zadejte jednu nebo více cest čítače. Zástupné cardy jsou povoleny v části instance cesty.

Každá cesta čítače má následující formát. V cestě je vyžadována hodnota ComputerName. Například:

  • \\<ComputerName>\<CounterSet>(<Instance>)\<CounterName>

Například:

  • \\Server01\Processor(2)\% User Time
  • \\Server01\Processor(*)\% Processor Time
Typ:String[]
Position:Named
Default value:All counter
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-EndTime

Určuje koncové datum a čas, kdy tato rutina importuje data čítačů mezi startTime a časovými razítky tohoto parametru. Zadejte objekt DateTime, například objekt vytvořený rutinou Get-Date. Ve výchozím nastavení Import-Counter importuje všechna data čítačů v souborech určených parametrem Path.

Typ:DateTime
Position:Named
Default value:No end time
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ListSet

Určuje sady čítačů výkonu, které jsou reprezentovány v exportovaných souborech. Příkazy s tímto parametrem neimportují žádná data.

Zadejte jeden nebo více názvů sady čítačů. Jsou povoleny zástupné cardy. Chcete-li získat všechny sady čítačů v souboru, zadejte Import-Counter -ListSet *.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-MaxSamples

Určuje maximální počet vzorků každého čítače k importu. Ve výchozím nastavení Get-Counter importuje všechna data v souborech určených parametrem Cesta.

Typ:Int64
Position:Named
Default value:No maximum
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Path

Určuje cesty k souborům, které se mají importovat. Tento parametr je povinný.

Zadejte cestu a název souboru .csv, .tsvnebo .blg soubor, který jste exportovali pomocí rutiny Export-Counter. V každém příkazu můžete zadat jenom jeden .csv nebo .tsv soubor, ale v každém příkazu můžete zadat více .blg souborů (až 32). Řetězce cest k souboru (v uvozovkách) můžete také pipetovat do Import-Counter.

Typ:String[]
Aliasy:PSPath
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-StartTime

Určuje počáteční datum a čas, kdy tato rutina získá data čítače. Zadejte objekt DateTime, například objekt vytvořený rutinou Get-Date. Ve výchozím nastavení Import-Counter importuje všechna data čítačů v souborech určených parametrem Path.

Typ:DateTime
Position:Named
Default value:No start time
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Summary

Označuje, že tato rutina získá souhrn importovaných dat místo získání jednotlivých vzorků dat čítačů.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

K této rutině můžete připojit cesty protokolu čítače výkonu.

Výstupy

Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet, Microsoft.PowerShell.Commands.GetCounter.CounterSet, Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo

Tato rutina vrátí Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet. Pokud použijete parametr ListSet, vrátí tato rutina objekt Microsoft.PowerShell.Commands.GetCounter.CounterSet objektu. Pokud použijete parametr Summary, vrátí tato rutina objekt Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo objektu.

Poznámky

  • Tato rutina nemá parametr ComputerName. Pokud je však počítač nakonfigurovaný pro vzdálenou správu Prostředí Windows PowerShell, můžete ke spuštění příkazu Import-Counter na vzdáleném počítači použít rutinu Invoke-Command.