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). U kunt deze cmdlet gebruiken om prestatiemeteritemgegevens te registreren.

De cmdlet Export-Counter 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

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

Met deze opdracht worden tellergegevens geëxporteerd naar een BLG-bestand.

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

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

Voorbeeld 2: Een bestand exporteren naar een tellerbestandsindeling

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

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

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

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

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

Voorbeeld 4: Bestaande gegevens opnieuw registreren

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

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

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:False
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-bestand
  • TSV
  • BLG

De standaardwaarde is BLG.

Parametereigenschappen

Type:String
Default value:BLG
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:False
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 cmdlet 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.

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:0
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 uit Get-Counter- of Import-Counter- naar deze cmdlet sluisen.

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 exportteller 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.