Sdílet prostřednictvím

Export-Counter

  • Reference
Modul:
Microsoft.PowerShell.Diagnostics

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

Syntax

Export-Counter
      [-Path] <String>
      [-FileFormat <String>]
      [-MaxSize <UInt32>]
      -InputObject <PerformanceCounterSampleSet[]>
      [-Force]
      [-Circular]
      [<CommonParameters>]

Description

Rutina Export-Counter exportuje data čítače výkonu (Objekty PerformanceCounterSampleSet ) do protokolů souborů v binárním protokolu výkonu (.blg), hodnoty oddělené čárkami (.csv) nebo ve formátu 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 rutinamiGet-Counter.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 Export-Counter rutiny používá operátor kanálu (|). Příkaz Export-Counter používá proměnnou Cesta k určení výstupního souboru.

Vzhledem k tomu, že sada dat může být velmi velká, tento příklad odesílá data prostřednictvím Export-Counter 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 Threads.csv ze souboru. 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 pomocí parametru Path určuje umístění výstupního souboru. Pomocí parametrů Circular a MaxSize nasměruje rutinu Export-Counter tak, aby vytvořila kruhový protokol, 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 $C proměnné.

Druhý příkaz používá operátor kanálu (|) k odeslání dat $C do Export-Counter rutiny, který je uloží do Workingset.blg souboru ve 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í Import-Counter rutin Export-Counter znovu protokolovat existující data.

První příkaz použije rutinu Import-Counter k importu dat čítače výkonu DiskSpace.blg z protokolu. Uloží data do $All proměnné. 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 pomocí rutiny Where-Object vybere objekty s CookedValue menší než 15 (procent). Příkaz uloží výsledky do $LowSpace proměnné.

Třetí příkaz používá operátor kanálu (|) k odeslání dat v $LowSpace proměnné do rutiny Export-Counter . Příkaz používá parametr Path k označení, že vybraná data by se měla do LowDiskSpace.blg souboru protokolovat.

$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, je povinný parametr MaxSize .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileFormat

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

Tento parametr přijímá tyto hodnoty:

  • CSV
  • TSV
  • BLG

Výchozí hodnota je BLG.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Určuje jako pole data čítače, která se mají exportovat. Zadejte proměnnou, která obsahuje data, nebo příkaz, který získá data, například rutinuGet-Counter.Import-Counter

Type:PerformanceCounterSampleSet[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxSize

Určuje maximální velikost výstupního souboru v megabajtech (MB).

Pokud je zadán parametr Kruhový, pak když soubor protokolu dosáhne zadané maximální velikosti, nejstarší položky se odstraní při přidání novějších položek. Pokud není zadán parametr Circular, pak když soubor protokolu dosáhne zadané maximální velikosti, nepřidá se žádná nová data a rutina vygeneruje neukončující chybu.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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ě.

Type:String
Aliases:PSPath
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Vstupy

PerformanceCounterSampleSet

Data čítače výkonu můžete převést z Get-Counter této rutiny 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 možné číst všechny protokoly, které Export-Counter se generují. Například Sledování výkonu 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é prostředí Windows PowerShell pro Windows PowerShell, můžete pomocí rutiny Invoke-Command spustit Import-Counter příkaz na vzdáleném počítači.