Freigeben über

Export-Counter

  • Referenz
Modul:
Microsoft.PowerShell.Diagnostics

Exportiert Leistungsindikatordaten in Protokolldateien.

Syntax

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

Beschreibung

Das Export-Counter Cmdlet exportiert Leistungsindikatordaten (PerformanceCounterSampleSet-Objekte ) in Protokolldateien im Binären Leistungsprotokoll (.blg), kommagetrennten Wert (.csv) oder im Format tabstopptrennter Werte (.tsv). Mit diesem Cmdlet protokollieren Sie Leistungsindikatordaten.

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

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

Beispiele

BEISPIEL 1: Exportieren von Leistungsindikatorendaten in eine Datei

In diesem Beispiel werden Gegendaten in eine BLG-Datei exportiert.

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

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

Da der Datensatz möglicherweise sehr groß ist, sendet dieses Beispiel die Daten an Export-Counter die Pipeline. Wenn die Daten in einer Variablen gespeichert wurden, können Sie einen unverhältnismäßig hohen Arbeitsspeicher verwenden.

Beispiel 2: Exportieren einer Datei in ein Zählerdateiformat

In diesem Beispiel wird eine CSV-Datei in ein Zählerdaten-BLG-Format konvertiert.

Das Import-Counter Cmdlet importiert Leistungsindikatordaten aus der Threads.csv Datei. Im Beispiel wird davon ausgegangen, dass diese Datei zuvor mithilfe des Export-Counter Cmdlets exportiert wurde. Ein Pipelineoperator (|) sendet die importierten Daten an das Export-Counter Cmdlet. Der Befehl verwendet den Parameter "Path ", um den Speicherort der Ausgabedatei anzugeben. Es verwendet die Parameter "Circular " und "MaxSize ", um das Export-Counter Cmdlet zu leiten, um ein Zirkelprotokoll zu erstellen, das um 1 GB umschließt. Der Parameter "MaxSize " wird in Megabyte ausgedrückt.

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

Beispiel 3: Abrufen von Leistungsindikatoren von einem Remotecomputer und Speichern der Daten in einer Datei

Dieses Beispiel zeigt, wie Sie Leistungsindikatordaten von einem Remotecomputer abrufen und die Daten in einer Datei auf dem Remotecomputer speichern können.

Der erste Befehl verwendet das Get-Counter Cmdlet zum Sammeln von Arbeitssatzzählerdaten von Server01, einem Remotecomputer. Der Befehl speichert die Daten in der $C Variablen.

Der zweite Befehl verwendet einen Pipelineoperator (|), um die Daten an $C das Export-Counter Cmdlet zu senden, wodurch sie in der Workingset.blg Datei in der Perf Freigabe des Servers01-Computers gespeichert wird.

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

20

Beispiel 4: Erneutes Protokollieren vorhandener Daten

In diesem Beispiel wird gezeigt, wie sie vorhandene Daten mithilfe der Import-Counter Cmdlets Export-Counter erneut protokollieren.

Der erste Befehl verwendet das Import-Counter Cmdlet, um Leistungsindikatordaten aus dem DiskSpace.blg Protokoll zu importieren. Sie speichert die Daten in der $All Variablen. Diese Datei enthält Beispiele für den Zähler "LogicalDisk% Free Space" auf mehr als 200 Remotecomputern im Unternehmen.

Der zweite Befehl verwendet das Where-Object Cmdlet, um Objekte mit "CookedValue" von weniger als 15 (Prozent) auszuwählen. Der Befehl speichert die Ergebnisse in der $LowSpace Variablen.

Der dritte Befehl verwendet einen Pipelineoperator (|), um die Daten in der $LowSpace Variablen an das Export-Counter Cmdlet zu senden. Der Befehl verwendet den Parameter "Path ", um anzugeben, dass die ausgewählten Daten in der LowDiskSpace.blg Datei protokolliert werden sollen.

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

Parameter

-Circular

Gibt an, dass die Ausgabedatei ein Zirkelprotokoll mit dem ersten FiFO-Format (First Out) ist. Wenn Sie diesen Parameter einschließen, ist der MaxSize-Parameter erforderlich.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FileFormat

Gibt das Ausgabeformat für die Ausgabeprotokolldatei an.

Zulässige Werte für diesen Parameter:

  • CSV
  • TSV
  • BLG

Der Standardwert ist BLG.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Überschreibt und ersetzt eine vorhandene Datei, wenn eine in dem durch den Path-Parameter angegebenen Speicherort vorhanden ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt als Array die zu exportierenden Zählerdaten an. Geben Sie eine Variable ein, die die Daten oder einen Befehl enthält, der die Daten abruft, z. B. das Get-Counter Import-Counter Cmdlet.

Typ:PerformanceCounterSampleSet[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MaxSize

Gibt die maximale Größe der Ausgabedatei in Megabyte (MB) an.

Wenn der Parameter "Circular " angegeben ist, werden die ältesten Einträge gelöscht, wenn die Protokolldatei die angegebene maximale Größe erreicht. Wenn der Parameter "Circular " nicht angegeben ist, wird beim Erreichen der angegebenen maximalen Größe keine neuen Daten hinzugefügt, und das Cmdlet generiert einen nicht beendeten Fehler.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Bestimmt den Pfad und den Dateinamen der Ausgabedatei. Geben Sie einen relativen oder absoluten Pfad auf dem lokalen Computer oder einen UNC-Pfad (Uniform Naming Convention) zu einem Remotecomputer ein, z \\Computer\Share\file.blg. B. . Dieser Parameter ist erforderlich.

Das Dateiformat wird durch den Wert des FileFormat-Parameters und nicht durch die Dateinamenerweiterung im Pfad bestimmt.

Typ:String
Aliase:PSPath
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

PerformanceCounterSampleSet

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

Ausgaben

None

Hinweise

Der Protokolldatei-Generator erwartet, dass alle Eingabeobjekte den gleichen Indikatorpfad haben und dass die Objekte in aufsteigender Zeitreihenfolge angeordnet werden.

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

Leistungsmonitor können möglicherweise nicht alle generierten Export-Counter Protokolle lesen. Beispielsweise erfordert Leistungsmonitor, dass alle Objekte denselben Pfad haben und dass alle Objekte durch dasselbe Zeitintervall getrennt werden.

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