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 (Objekty PerformanceCounterSampleSet) do souborů protokolu binárního protokolu výkonu (.blg), hodnoty oddělené čárkami (.csv) nebo hodnoty oddělené tabulátory (.tsv). Tuto rutinu můžete použít k protokolování dat čítačů výkonu.

Rutina Export-Counter je navrž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

PS C:\> Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $home\Counters.blg

Tento příkaz exportuje data čítače do souboru BLG.

Příkaz používá rutinu Get-Counter ke shromažďování dat času procesoru. Pomocí operátoru kanálu (|) odesílá data do rutiny Export-Counter. 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á, odešle tento příkaz data do exportu čítače prostřednictvím kanálu. Pokud byla data uložená v proměnné, může příkaz použít nepřiměřenou velikost paměti.

Příklad 2: Export souboru do formátu souboru čítače

The first command uses the built-in Windows PowerShell conversion feature to store the value of 1 gigabyte (GB) in bytes in the $1GBInBytes variable. When you type a value followed by K (kilobyte), MB (megabyte), or GB, Windows PowerShell returns the value in bytes.
PS C:\> $1GBInBytes = 1GB

The second command uses the Import-Counter cmdlet to import performance counter data from the Threads.csv file. The example presumes that this file was previously exported by using the **Export-Counter** cmdlet. A pipeline operator (|) sends the imported data to the **Export-Counter** cmdlet. The command uses the *Path* parameter to specify the location of the output file. It uses the *Circular* and *MaxSize* parameters to direct the **Export-Counter** cmdlet to create a circular log that wraps at 1 GB.
PS C:\> Import-Counter Threads.csv | Export-Counter -Path ThreadTest.blg -Circular -MaxSize $1GBinBytes

Tento příklad převede soubor CSV na formát BLG s daty čítače.

Příklad 3: Získání dat čítačů ze vzdáleného počítače a uložení dat do souboru

The first command uses the Get-Counter cmdlet to collect working set counter data from Server01, a remote computer. The command saves the data in the $C variable.
PS C:\> $C = Get-Counter -ComputerName Server01 -Counter "\Process(*)\Working Set - Private" -MaxSamples 20

The second command uses a pipeline operator (|) to send the data in $C to the **Export-Counter** cmdlet, which saves it in the Workingset.blg file in the Perf share of the Server01 computer.
PS C:\> $C | Export-Counter -Path \\Server01\Perf\WorkingSet.blg

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.

Příklad 4: Opětovné protokolování existujících dat

The first command uses the **Import-Counter** cmdlet to import performance counter data from the DiskSpace.blg log. It saves the data in the $All variable. This file contains samples of the "LogicalDisk\% Free Space" counter on more than 200 remote computers in the enterprise.
PS C:\> $All = Import-Counter DiskSpace.blg

The second command uses the **CounterSamples** property of the sample set object in $All and the Where-Object cmdlet (alias = "where") to select objects with **CookedValues** of less than 15 (percent). The command saves the results in the $LowSpace variable.
PS C:\> $LowSpace = $All.CounterSamples | where {$_.CookedValues -lt 15}

The third command uses a pipeline operator (|) to send the data in the $LowSpace variable to the **Export-Counter** cmdlet. The command uses the *Path* parameter to indicate that the selected data should be logged in the LowDiskSpace.blg file.
PS C:\> $LowSpace | Export-Counter -Path LowDiskSpace.blg

Tento příklad ukazuje, jak pomocí rutin Import-Counter a Export-Counter znovu protokolovat existující data.

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:False
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:BLG
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:False
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 rutinu Get-Counter nebo 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.

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:0
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 importu 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é čítač exportu generuje. 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.