Delen via

Export-Counter

Module:
Microsoft.PowerShell.Diagnostics Module

Hiermee exporteert u prestatiemeteritems naar logboekbestanden.

Syntax

Default (Standaard) 

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

Description

De Export-Counter cmdlet exporteert prestatiemeteritems (PerformanceCounterSampleSet-objecten) naar logboekbestanden in binaire prestatielogboeken (.blg), door komma's gescheiden waarden (.csv) of door tabs gescheiden waarden (.tsv) indeling. U gebruikt deze cmdlet om prestatiemeteritems te registreren.

De Export-Counter cmdlet is ontworpen om gegevens te exporteren die worden geretourneerd door de Get-Counter en Import-Counter cmdlets.

Deze cmdlet wordt alleen uitgevoerd op Windows 7, Windows Server 2008 R2 en latere versies van Windows.

Voorbeelden

VOORBEELD 1: Tellergegevens exporteren naar een bestand

In dit voorbeeld worden tellergegevens geëxporteerd naar een BLG-bestand.

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

De opdracht maakt gebruik van de Get-Counter cmdlet voor het verzamelen van processortijdgegevens. Er wordt een pijplijnoperator (|) gebruikt om de gegevens naar de Export-Counter-cmdlet te verzenden. De opdracht Export-Counter maakt gebruik van de variabele Path om het uitvoerbestand op te geven.

Omdat de gegevensset erg groot kan zijn, verzendt dit voorbeeld de gegevens naar Export-Counter via de pijplijn. Als de gegevens zijn opgeslagen in een variabele, kunt u een onevenredige hoeveelheid geheugen gebruiken.

Voorbeeld 2: Een bestand exporteren naar een tellerbestandsindeling

In dit voorbeeld wordt een CSV-bestand geconverteerd naar een BLG-indeling voor tellergegevens.

De Import-Counter-cmdlet importeert prestatiemeteritems uit het Threads.csv-bestand. In het voorbeeld wordt ervan uitgegaan dat dit bestand eerder is geëxporteerd met behulp van de cmdlet Export-Counter. Een pijplijnoperator (|) verzendt de geïmporteerde gegevens naar de Export-Counter-cmdlet. De opdracht gebruikt de parameter Path om de locatie van het uitvoerbestand op te geven. Het maakt gebruik van de parameters Circular en MaxSize om de Export-Counter-cmdlet te leiden om een cirkelvormig logboek te maken dat wordt verpakt op 1 GB. De parameter MaxSize wordt uitgedrukt in megabytes.

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

Voorbeeld 3: Tellergegevens ophalen van een externe computer en de gegevens opslaan in een bestand

In dit voorbeeld ziet u hoe u prestatiemeteritems van een externe computer opslaat en de gegevens opslaat in een bestand op de externe computer.

De eerste opdracht maakt gebruik van de Get-Counter cmdlet voor het verzamelen van werksetgegevens van Server01, een externe computer. Met de opdracht worden de gegevens opgeslagen in de $C variabele.

De tweede opdracht maakt gebruik van een pijplijnoperator (|) om de gegevens in $C te verzenden naar de Export-Counter-cmdlet, die deze opslaat in het Workingset.blg bestand in de Perf share van de Server01-computer.

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

20

Voorbeeld 4: Bestaande gegevens opnieuw registreren

In dit voorbeeld ziet u hoe u de Import-Counter- en Export-Counter-cmdlets gebruikt om bestaande gegevens opnieuw te registreren.

De eerste opdracht maakt gebruik van de Import-Counter cmdlet om prestatiemeteritemgegevens uit het DiskSpace.blg logboek te importeren. De gegevens worden opgeslagen in de $All-variabele. Dit bestand bevat voorbeelden van de teller 'LogicalDisk% Vrije ruimte' op meer dan 200 externe computers in de onderneming.

De tweede opdracht gebruikt de cmdlet Where-Object om objecten te selecteren met CookedValue van minder dan 15 (procent). Met de opdracht worden de resultaten opgeslagen in de $LowSpace variabele.

De derde opdracht maakt gebruik van een pijplijnoperator (|) om de gegevens in de $LowSpace variabele naar de Export-Counter cmdlet te verzenden. De opdracht gebruikt de parameter Path om aan te geven dat de geselecteerde gegevens moeten worden vastgelegd in het LowDiskSpace.blg-bestand.

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

Parameters

-Circular

Geeft aan dat het uitvoerbestand een cirkelvormig logboek is met de FIFO-indeling (first out). Wanneer u deze parameter opneemt, is de parameter MaxSize vereist.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-FileFormat

Hiermee geeft u de uitvoerindeling van het uitvoerlogboekbestand.

De acceptabele waarden voor deze parameter zijn:

  • CSV
  • TSV
  • BLG

De standaardwaarde is BLG.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Force

Hiermee wordt een bestaand bestand overschreven en vervangen als er een bestand bestaat op de locatie die is opgegeven door de parameter Path.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-InputObject

Hiermee geeft u als matrix de tellergegevens op die moeten worden geëxporteerd. Voer een variabele in die de gegevens bevat of een opdracht waarmee de gegevens worden opgehaald, zoals de Get-Counter of Import-Counter cmdlet.

Parametereigenschappen

Type:

PerformanceCounterSampleSet[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-MaxSize

Hiermee geeft u de maximale grootte van het uitvoerbestand in megabytes (MB).

Als de parameter Circular is opgegeven, worden de oudste vermeldingen verwijderd wanneer het logboekbestand de opgegeven maximumgrootte bereikt. Als de parameter Circular niet is opgegeven, wordt er geen nieuwe gegevens toegevoegd wanneer het logboekbestand de opgegeven maximale grootte bereikt en genereert de cmdlet een fout die niet wordt beëindigd.

Parametereigenschappen

Type:UInt32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Path

Hiermee geeft u het pad en de bestandsnaam van het uitvoerbestand. Voer een relatief of absoluut pad in op de lokale computer of een UNC-pad (Uniform Naming Convention) naar een externe computer, zoals \\Computer\Share\file.blg. Deze parameter is vereist.

De bestandsindeling wordt bepaald door de waarde van de parameter FileFormat, niet door de bestandsnaamextensie in het pad.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:PSPath

Parametersets

(All)
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PerformanceCounterSampleSet

U kunt prestatiemeteritems van Get-Counter of Import-Counter naar deze cmdlet doorsluisen.

Uitvoerwaarden

None

Notities

De logboekbestandsgenerator verwacht dat alle invoerobjecten hetzelfde pad hebben en dat de objecten in oplopende tijdsvolgorde zijn gerangschikt.

Het tellertype en het pad van het eerste invoerobject bepaalt de eigenschappen die zijn vastgelegd in het logboekbestand. Als andere invoerobjecten geen waarde hebben voor een vastgelegde eigenschap, is het eigenschapsveld leeg. Als de objecten eigenschapswaarden bevatten die niet zijn vastgelegd, worden de extra eigenschapswaarden genegeerd.

Prestatiemeter kan mogelijk niet alle logboeken lezen die Export-Counter genereert. Prestatiemeter vereist bijvoorbeeld dat alle objecten hetzelfde pad hebben en dat alle objecten worden gescheiden door hetzelfde tijdsinterval.

De cmdlet Import-Counter heeft geen ComputerName-parameter. Als de computer echter is geconfigureerd voor externe Windows PowerShell Windows PowerShell Windows PowerShell, kunt u de Invoke-Command cmdlet gebruiken om een Import-Counter opdracht uit te voeren op een externe computer.