Export-Counter
Exportuje data čítače výkonu do souborů protokolu.
Syntax
Default (Výchozí)
Export-Counter
[-Path] <String>
[-FileFormat <String>]
[-MaxSize <UInt32>]
-InputObject <PerformanceCounterSampleSet[]>
[-Force]
[-Circular]
[<CommonParameters>]
Description
Rutina Export-Counter exportuje data čítače výkonu (PerformanceCounterSampleSet objekty) do protokolů souborů v binárním protokolu výkonu (.blg), hodnoty oddělené čárkami (.csv) nebo hodnoty oddělené tabulátory (.tsv). Tuto rutinu použijete k protokolování dat čítačů výkonu.
Rutina Export-Counter je určená k exportu dat vrácených rutinami Get-Counter a Import-Counter.
Tato rutina běží jenom ve Windows 7, Windows Serveru 2008 R2 a novějších verzích Windows.
Příklady
PŘÍKLAD 1: Export dat čítačů do souboru
Tento příklad exportuje data čítače do souboru BLG.
Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $HOME\Counters.blg
Příkaz používá rutinu Get-Counter ke shromažďování dat času procesoru. K odeslání dat do rutiny | používá operátor kanálu (Export-Counter). Příkaz Export-Counter používá proměnnou Path k určení výstupního souboru.
Vzhledem k tomu, že sada dat může být velmi velká, tento příklad odešle data do Export-Counter prostřednictvím kanálu. Pokud byla data uložená v proměnné, můžete použít nepřiměřenou velikost paměti.
Příklad 2: Export souboru do formátu souboru čítače
Tento příklad převede soubor CSV na formát BLG s daty čítače.
Rutina Import-Counter importuje data čítače výkonu ze souboru Threads.csv. Příklad předpokládá, že tento soubor byl dříve exportován pomocí rutiny Export-Counter. Operátor kanálu (|) odešle importovaná data do rutiny Export-Counter. Příkaz použije parametr Path k určení umístění výstupního souboru. Pomocí parametrů Circular a MaxSize nasměruje rutinu Export-Counter k vytvoření kruhového protokolu, který se zabalí na 1 GB. Parametr MaxSize se vyjadřuje v megabajtech.
$1GBInMB = 1024 # 1GB = 1024MB
Import-Counter Threads.csv | Export-Counter -Path ThreadTest.blg -Circular -MaxSize $1GBInMB
Příklad 3: Získání dat čítačů ze vzdáleného počítače a uložení dat do souboru
Tento příklad ukazuje, jak získat data čítače výkonu ze vzdáleného počítače a uložit data do souboru na vzdáleném počítači.
První příkaz používá rutinu Get-Counter ke shromažďování dat čítačů pracovní sady ze vzdáleného počítače Server01. Příkaz uloží data do proměnné $C.
Druhý příkaz pomocí operátoru kanálu (|) odešle data v $C do rutiny Export-Counter, která je uloží do souboru Workingset.blg v Perf sdílené složce počítače Server01.
$C = Get-Counter -ComputerName Server01 -Counter "\Process(*)\Working Set - Private" -MaxSamples $C | Export-Counter -Path \\Server01\Perf\WorkingSet.blg
20
Příklad 4: Opětovné protokolování existujících dat
Tento příklad ukazuje, jak pomocí rutin Import-Counter a Export-Counter znovu protokolovat existující data.
První příkaz používá rutinu Import-Counter k importu dat čítače výkonu z protokolu DiskSpace.blg. Uloží data do proměnné $All. Tento soubor obsahuje ukázky čítače Logický disk% Volného místa na více než 200 vzdálených počítačích v podniku.
Druhý příkaz používá rutinu Where-Object k výběru objektů s CookedValue menší než 15 (procent). Příkaz uloží výsledky do proměnné $LowSpace.
Třetí příkaz používá operátor kanálu (|) k odeslání dat v proměnné $LowSpace do rutiny Export-Counter. Příkaz používá parametr Path k označení, že vybraná data by se měla protokolovat do souboru LowDiskSpace.blg.
$All = Import-Counter DiskSpace.blg
$LowSpace = $All | Where-Object {$_.CounterSamples.CookedValue -lt 15}
$LowSpace | Export-Counter -Path LowDiskSpace.blg
Parametry
-Circular
Označuje, že výstupní soubor je kruhový protokol s prvním formátem FIFO (First Out). Pokud tento parametr zahrnete, vyžaduje se parametr MaxSize.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| 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 |
-FileFormat
Určuje výstupní formát výstupního souboru protokolu.
Přijatelné hodnoty pro tento parametr jsou:
CSVTSVBLG
Výchozí hodnota je BLG.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| 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 |
-Force
Přepíše a nahradí existující soubor, pokud existuje v umístění určeném parametrem Cesta.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| 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 |
-InputObject
Určuje jako pole data čítače, která se mají exportovat. Zadejte proměnnou obsahující data nebo příkaz, který získá data, například Get-Counter nebo rutinu Import-Counter.
Vlastnosti parametru
| Typ: | |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-MaxSize
Určuje maximální velikost výstupního souboru v megabajtech (MB).
Pokud je zadán parametr Kruhový, po dosažení zadané maximální velikosti souboru protokolu se nejstarší položky odstraní při přidání novějších položek. Pokud parametr Circular není zadaný, pak když soubor protokolu dosáhne zadané maximální velikosti, nepřidá se žádná nová data a rutina vygeneruje neukončující chybu.
Vlastnosti parametru
| Typ: | UInt32 |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| 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 cestu a název souboru výstupního souboru. Zadejte relativní nebo absolutní cestu na místním počítači nebo cestu UNC (Uniform Naming Convention) ke vzdálenému počítači, například \\Computer\Share\file.blg. Tento parametr je povinný.
Formát souboru je určen hodnotou parametru FileFormat, nikoli příponou názvu souboru v cestě.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| 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
PerformanceCounterSampleSet
Data čítače výkonu můžete převést z Get-Counter nebo Import-Counter do této rutiny.
Výstupy
None
Poznámky
Generátor souborů protokolu očekává, že všechny vstupní objekty mají stejnou cestu čítače a že objekty jsou uspořádány ve vzestupném časovém pořadí.
Typ čítače a cesta prvního vstupního objektu určuje vlastnosti zaznamenané v souboru protokolu. Pokud jiné vstupní objekty nemají hodnotu pro zaznamenanou vlastnost, pole vlastnosti je prázdné. Pokud objekty mají hodnoty vlastností, které nebyly zaznamenány, budou hodnoty dalších vlastností ignorovány.
Sledování výkonu nemusí být schopné číst všechny protokoly, které Export-Counter generují. Sledování výkonu například vyžaduje, aby všechny objekty měly stejnou cestu a všechny objekty jsou oddělené stejným časovým intervalem.
Rutina Import-Counter nemá parametr ComputerName. Pokud je ale počítač nakonfigurovaný pro vzdálený Windows PowerShell pro Windows PowerShell, můžete ke spuštění příkazu Invoke-Command na vzdáleném počítači použít rutinu Import-Counter.
