Export-Counter
Exporterar prestandaräknare till loggfiler.
Syntax
Default (Standard)
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) format. 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 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
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 Path 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 filen Threads.csv. 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 Export-Counter-cmdleten till 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 data i $C till cmdleten Export-Counter, vilket sparar dem i Workingset.blg-filen i Perf-resursen på Server01-datorn.
$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 cmdletarna Import-Counter 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 DiskSpace.blg loggen. 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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-FileFormat
Anger utdataformatet för utdataloggfilen.
De godtagbara värdena för den här parametern är:
CSVTSVBLG
Standardvärdet är BLG.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Force
Skriver över och ersätter en befintlig fil om det finns en på den plats som anges av parametern Path.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-MaxSize
Anger den maximala storleken på utdatafilen i megabyte (MB).
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.
Parameteregenskaper
| Typ: | UInt32 |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | PSPath |
Parameteruppsättningar
(All)
| Position: | 1 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
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.
