Import-Counter
Importuje soubory protokolu čítače výkonu a vytvoří objekty, které představují jednotlivé vzorky čítačů v protokolu.
Syntax
GetCounterSet (Výchozí)
Import-Counter
[-Path] <String[]>
[-StartTime <DateTime>]
[-EndTime <DateTime>]
[-Counter <String[]>]
[-MaxSamples <Int64>]
[<CommonParameters>]
ListSetSet
Import-Counter
[-Path] <String[]>
-ListSet <String[]>
[<CommonParameters>]
SummarySet
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
Vlastnosti parametru
| Typ: | String[] |
| Default value: | All counter |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
GetCounterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-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.
Vlastnosti parametru
| Typ: | DateTime |
| Default value: | No end time |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
GetCounterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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é symboly. Chcete-li získat všechny sady čítačů v souboru, zadejte Import-Counter -ListSet *.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
ListSetSet
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-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.
Vlastnosti parametru
| Typ: | Int64 |
| Default value: | No maximum |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
GetCounterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-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.
Vlastnosti parametru
| Typ: | DateTime |
| Default value: | No start time |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
GetCounterSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Summary
Označuje, že tato rutina získá souhrn importovaných dat místo získání jednotlivých vzorků dat čítačů.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
SummarySet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
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
Invoke-Commandna vzdáleném počítači použít rutinuImport-Counter.
