Export-Counter

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

Das cmdlet Export-Counter exportiert Leistungsindikatordaten (PerformanceCounterSampleSet-Objekte) in Protokolldateien im Binärleistungsprotokoll (BLG), kommagetrennten Wert (.csv) oder tabtrennten Wertformat (TSV). Mit diesem Cmdlet können Sie Leistungsindikatordaten protokollieren.

Das Cmdlet Export-Counter dient zum Exportieren von Daten, die von den Cmdlets Get-Counter und Import-Counter zurückgegeben werden.

Dieses Cmdlet wird nur unter Windows 7, Windows Server 2008 R2 und höheren Versionen von Windows ausgeführt.

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

Mit diesem Befehl werden Leistungsindikatorendaten in eine BLG-Datei exportiert.

Der Befehl verwendet das Cmdlet Get-Counter, um Prozessorzeitdaten zu sammeln. Es verwendet einen Pipelineoperator (|), um die Daten an das Cmdlet Export-Counter zu senden. Der Befehl Export-Counter verwendet die Variable Path, um die Ausgabedatei anzugeben.

Da der Datensatz möglicherweise sehr groß ist, sendet dieser Befehl die Daten an Export-Counter über die Pipeline. Wenn die Daten in einer Variablen gespeichert wurden, verwendet der Befehl möglicherweise einen unverhältnismäßigen Arbeitsspeicher.

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 diesem Beispiel wird eine CSV-Datei in ein Zählerdaten-BLG-Format konvertiert.

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 diesem Beispiel wird gezeigt, wie Sie Leistungsindikatorendaten von einem Remotecomputer abrufen und die Daten in einer Datei auf dem Remotecomputer speichern.

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 diesem Beispiel wird gezeigt, wie Sie die Import-Counter und Export-Counter Cmdlets verwenden, um vorhandene Daten erneut zu protokollieren.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können Leistungsindikatorendaten von Get-Counter- oder Import-Counter- an dieses Cmdlet weiterleiten.

• Der Protokolldatei-Generator erwartet, dass alle Eingabeobjekte denselben Zählerpfad haben und dass die Objekte in aufsteigender Zeitreihenfolge angeordnet sind.

  Der Zählertyp und Pfad des ersten Eingabeobjekts bestimmt die in der Protokolldatei aufgezeichneten Eigenschaften. Wenn andere Eingabeobjekte keinen Wert für eine aufgezeichnete Eigenschaft haben, ist das Eigenschaftenfeld leer. Wenn die Objekte Eigenschaftswerte aufweisen, die nicht aufgezeichnet wurden, werden die zusätzlichen Eigenschaftswerte ignoriert.

  Der Leistungsmonitor kann möglicherweise nicht alle Protokolle lesen, die Export-Counter- generiert. Der Leistungsmonitor erfordert beispielsweise, dass alle Objekte denselben Pfad haben und dass alle Objekte durch dasselbe Zeitintervall getrennt werden.

  Das Cmdlet Import-Counter verfügt nicht über einen ComputerName Parameter. Wenn der Computer jedoch für Windows PowerShell-Remotecomputer konfiguriert ist, können Sie das cmdlet Invoke-Command verwenden, um einen Import-Counter Befehl auf einem Remotecomputer auszuführen.