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äknardata (PerformanceCounterSampleSet-objekt ) för att logga filer i binär prestandalogg (.blg), kommaavgränsat värde (.csv) eller tabbavgränsat värde (.tsv). Du använder den här cmdleten för att logga prestandaräknardata.

Cmdleten Export-Counter är utformad för att exportera data som returneras av Get-Counter cmdletarna 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

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

Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $HOME\Counters.blg

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 Sökväg för att ange utdatafilen.

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

Exempel 2: Exportera en fil till ett räknarfilformat

I det här exemplet konverteras en CSV-fil till ett BLG-format för räknardata.

Cmdleten Import-Counter importerar prestandaräknardata från Threads.csv filen. Exemplet förutsätter att den här filen tidigare exporterades med hjälp av cmdleten Export-Counter . En pipelineoperator (|) skickar importerade data till cmdleten Export-Counter . Kommandot använder parametern Path för att ange platsen för utdatafilen. Den använder parametrarna Circular och MaxSize för att dirigera cmdleten Export-Counter för att skapa en cirkellogg som omsluts till 1 GB. Parametern MaxSize uttrycks i megabyte.

$1GBInMB = 1024 # 1GB = 1024MB
Import-Counter Threads.csv | Export-Counter -Path ThreadTest.blg -Circular -MaxSize $1GBInMB

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

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.

Det första kommandot använder cmdleten Get-Counter för att samla in arbetsuppsättningsräknare från Server01, en fjärrdator. Kommandot sparar data i variabeln $C .

Det andra kommandot använder en pipelineoperator (|) för att skicka in data $C till cmdleten Export-Counter Workingset.blg , vilket sparar dem i filen i Perf server01-datorns resurs.

$C = Get-Counter -ComputerName Server01 -Counter "\Process(*)\Working Set - Private" -MaxSamples $C | Export-Counter -Path \\Server01\Perf\WorkingSet.blg

20

Exempel 4: Logga om befintliga data

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

Det första kommandot använder cmdleten Import-Counter för att importera prestandaräknardata från loggen DiskSpace.blg . Den sparar data i variabeln $All . Den här filen innehåller exempel på räknaren "LogicalDisk % ledigt utrymme" på mer än 200 fjärrdatorer i företaget.

Det andra kommandot använder cmdleten Where-Object för att välja objekt med CookedValue på mindre än 15 (procent). Kommandot sparar resultatet i variabeln $LowSpace .

Det tredje kommandot använder en pipelineoperator (|) för att skicka data i variabeln $LowSpace till cmdleten Export-Counter . Kommandot använder parametern Path för att ange att de valda data ska loggas i LowDiskSpace.blg filen.

$All = Import-Counter DiskSpace.blg
$LowSpace = $All | Where-Object {$_.CounterSamples.CookedValue -lt 15}
$LowSpace | Export-Counter -Path LowDiskSpace.blg

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:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FileFormat

Anger utdataformatet för utdataloggfilen.

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

  • CSV
  • TSV
  • BLG

Standardvärdet är BLG.

Typ:String
Position:Named
Standardvärde:None
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 Sökväg .

Typ:SwitchParameter
Position:Named
Standardvärde:None
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 i megabyte (MB).

Om parametern Cirkulär har angetts tas de äldsta posterna bort när loggfilen når den angivna maximala storleken när nyare poster läggs till. Om parametern Cirkulär inte har angetts 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:1
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 ComputerName-parameter . 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.