Dela via

Export-Counter

  • Referens
Modul:
Microsoft.PowerShell.Diagnostics

Exporterar prestandaräknare till loggfiler.

Syntax

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

Description

Cmdleten Export-Counter exporterar prestandaräknaredata (PerformanceCounterSampleSet-objekt) för att logga filer i binär prestandalogg (.blg), kommaavgränsat värde (.csv) eller tab-separated value (.tsv). Du kan använda den här cmdleten för att logga prestandaräknardata.

Cmdleten Export-Counter är utformad för att exportera data som returneras av cmdletarna Get-Counter och Import-Counter.

Den här cmdleten körs endast på Windows 7, Windows Server 2008 R2 och senare versioner av Windows.

Exempel

Exempel 1: Exportera räknardata till en fil

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

Det här kommandot exporterar räknardata till en BLG-fil.

Kommandot använder cmdleten Get-Counter för att samla in processortidsdata. Den använder en pipelineoperator (|) för att skicka data till cmdleten Export-Counter. Kommandot Export-Counter använder variabeln Path för att ange utdatafilen.

Eftersom datamängden kan vara mycket stor skickar det här kommandot data till Export-Counter via pipelinen. Om data sparades i en variabel kan kommandot använda en oproportionerlig mängd minne.

Exempel 2: Exportera en fil till ett räknarfilformat

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

Det här exemplet konverterar en CSV-fil till ett BLG-format för räknardata.

Exempel 3: Hämta räknardata från en fjärrdator och spara data i en fil

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

Det här exemplet visar hur du hämtar prestandaräknardata från en fjärrdator och sparar data i en fil på fjärrdatorn.

Exempel 4: Logga om befintliga data

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

Det här exemplet visar hur du använder cmdletarna Import-Counter och Export-Counter för att logga om befintliga data.

Parametrar

-Circular

Anger att utdatafilen är en cirkellogg med fifo-format (först in, först ut). När du inkluderar den här parametern krävs parametern MaxSize.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FileFormat

Anger utdataformatet för utdataloggfilen.

De godtagbara värdena för den här parametern är:

  • CSV
  • TSV
  • BLG

Standardvärdet är BLG.

Typ:String
Position:Named
Standardvärde:BLG
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Skriver över och ersätter en befintlig fil om det finns en på den plats som anges av parametern Path.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Anger, som en matris, de räknardata som ska exporteras. Ange en variabel som innehåller data eller ett kommando som hämtar data, till exempel cmdleten Get-Counter eller Import-Counter.

Typ:PerformanceCounterSampleSet[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-MaxSize

Anger den maximala storleken på utdatafilen.

Om parametern Circular anges tas de äldsta posterna bort när loggfilen når den angivna maximala storleken när nyare poster läggs till. Om parametern Circular inte anges läggs inga nya data till när loggfilen når den angivna maximala storleken och cmdleten genererar ett icke-avslutande fel.

Typ:UInt32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger sökvägen och filnamnet för utdatafilen. Ange en relativ eller absolut sökväg på den lokala datorn eller en UNC-sökväg (Uniform Naming Convention) till en fjärrdator, till exempel \\Computer\Share\file.blg. Den här parametern krävs.

Filformatet bestäms av värdet för parametern FileFormat, inte filnamnstillägget i sökvägen.

Typ:String
Alias:PSPath
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

PerformanceCounterSampleSet

Du kan skicka prestandaräknare från Get-Counter eller Import-Counter till den här cmdleten.

Utdata

None

Kommentarer

  • Loggfilgeneratorn förväntar sig att alla indataobjekt har samma räknarsökväg och att objekten ordnas i stigande tidsordning.

    Räknartypen och sökvägen för det första indataobjektet avgör egenskaperna som registrerats i loggfilen. Om andra indataobjekt inte har något värde för en registrerad egenskap är egenskapsfältet tomt. Om objekten har egenskapsvärden som inte har registrerats ignoreras de extra egenskapsvärdena.

    Prestandaövervakaren kanske inte kan läsa alla loggar som Export-Counter genererar. Prestandaövervakaren kräver till exempel att alla objekt har samma sökväg och att alla objekt avgränsas med samma tidsintervall.

    Cmdleten Import-Counter har ingen -parameter för ComputerName. Men om datorn har konfigurerats för Windows PowerShell-fjärrdatorn Windows PowerShell kan du använda cmdleten Invoke-Command för att köra ett Import-Counter-kommando på en fjärrdator.