Sdílet prostřednictvím

Export-Counter

  • Reference
Modul:
Microsoft.PowerShell.Diagnostics

Exportuje data čítače výkonu do souborů protokolu.

Syntaxe

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 Export-Counter používá operátor kanálu (|). 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.

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

-FileFormat

Určuje výstupní formát výstupního souboru protokolu.

Přijatelné hodnoty pro tento parametr jsou:

  • CSV
  • TSV
  • BLG

Výchozí hodnota je BLG.

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

-Force

Přepíše a nahradí existující soubor, pokud existuje v umístění určeném parametrem Cesta.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:PerformanceCounterSampleSet[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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ě.

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

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 Import-Counter na vzdáleném počítači použít rutinu Invoke-Command.