Import-Counter

Reference

Modul:: Microsoft.PowerShell.Diagnostics

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če výkonu a vytvoří objekty pro každou ukázku čítače v souboru. Objekty PerformanceCounterSampleSet , které vytváří, jsou identické s objekty, které Get-Counter se vrátí při shromažďování dat čí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ů. Parametry můžete použít Import-Counter k filtrování importovaných dat.

Tato funkce umožňuje společně s Get-Counter Export-Counter rutinami shromažďovat, exportovat, importovat, kombinovat, filtrovat, manipulovat a znovu exportovat data čítače 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 importuje všechna data čítačů ProcessorData.csv ze souboru do $data proměnné.

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 data čítače Processor(_total)\Interrupts/sec ze ProcessorData.blg souboru do $i proměnné.

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če výkonu ProcessorData.blg ze souborů. Příkaz uloží data do $data proměnné.

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

Třetí příkaz získá cesty čítače, které končí Interrupts/sec a uloží cesty v $intCtrs proměnné. Pomocí rutiny Where-Object vyfiltruje cesty čítače a rutina ForEach-Object získá pouze hodnotu vlastnosti Path každého vybraného objektu cesty.

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

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

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

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žije parametr Import-Counter ListSet rutiny k získání všech sad čítačů, které jsou reprezentovány 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 ProcessorData.blg souboru.

Druhý příkaz uloží konkrétní časová razítka do $start proměnných.$end Ř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 k určení rozsahu používá parametry Import-Counter StartTime a EndTime.

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 Disk.blg souboru. 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 Windows PowerShellu (..) 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á k získání souhrnu dat čítačů v souboru parametr Import-Counter Summary rutinyMemory.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 používá parametr ListSet k získání čítačů v OldData.blg, existující soubor Import-Counter protokolu čítače. Příkaz používá operátor kanálu (|) k odeslání dat do ForEach-Object příkazu, který získá pouze hodnoty PathsWithInstances vlastnost každého objektu.

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

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ží data do $counters proměnné. 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. Hodnota ComputerName je vyžadována v cestě. Například:

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

Pří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 časem StartTime a časovými razítky tohoto parametru. Zadejte objekt DateTime, například objekt vytvořený rutinouGet-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 Path .

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 souboru, .csv.tsv.blg který jste exportovali pomocí rutiny.Export-Counter V každém příkazu můžete zadat pouze 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 na 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ý rutinouGet-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 . Pokud použijete parametr Summary , vrátí tato rutina objekt Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo .

Poznámky

Tato rutina nemá parametr ComputerName . Pokud je však počítač nakonfigurovaný pro vzdálenou vzdálenou komunikace prostředí Windows PowerShell, můžete pomocí rutiny Invoke-Command spustit Import-Counter příkaz na vzdáleném počítači.

Sdílet prostřednictvím

Import-Counter

Syntaxe

Description

Příklady

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

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

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

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

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

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

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

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

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

Parametry

-Counter

-EndTime

-ListSet

-MaxSamples

-Path

-StartTime

-Summary

Vstupy

Výstupy

Poznámky

Další materiály

Sdílet prostřednictvím

Import-Counter

Syntaxe

Description

Příklady

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

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

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

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

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

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

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

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

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

Parametry

-Counter

-EndTime

-ListSet

-MaxSamples

-Path

-StartTime

-Summary

Vstupy

Výstupy

Poznámky

Související odkazy

Další materiály