Bagikan melalui

Export-Counter

  • Referensi
Modul:
Microsoft.PowerShell.Diagnostics

Mengekspor data penghitung kinerja ke file log.

Sintaks

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

Deskripsi

Export-Counter Cmdlet mengekspor data penghitung kinerja (objek PerformanceCounterSampleSet) untuk mencatat file dalam log performa biner (.blg), nilai yang dipisahkan koma (.csv), atau format nilai yang dipisahkan tab (.tsv). Anda menggunakan cmdlet ini untuk mencatat data penghitung kinerja.

Export-Counter Cmdlet dirancang untuk mengekspor data yang dikembalikan oleh Get-Counter cmdlet dan Import-Counter .

Cmdlet ini hanya berjalan pada Windows 7, Windows Server 2008 R2, dan versi Windows yang lebih baru.

Contoh

CONTOH 1: Mengekspor data penghitung ke file

Contoh ini mengekspor data penghitung ke file BLG.

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

Perintah menggunakan Get-Counter cmdlet untuk mengumpulkan data waktu prosesor. Ini menggunakan operator alur (|) untuk mengirim data ke Export-Counter cmdlet. Perintah Export-Counter menggunakan variabel Jalur untuk menentukan file output.

Karena himpunan data mungkin sangat besar, contoh ini mengirim data ke Export-Counter melalui alur. Jika data disimpan dalam variabel, Anda mungkin menggunakan jumlah memori yang tidak proporsional.

Contoh 2: Mengekspor file ke format file penghitung

Contoh ini mengonversi file CSV ke format BLG data penghitung.

Import-Counter Cmdlet mengimpor data penghitung kinerja dari Threads.csv file. Contohnya mengasumsikan bahwa file ini sebelumnya diekspor dengan menggunakan Export-Counter cmdlet. Operator alur (|) mengirim data yang diimpor ke Export-Counter cmdlet. Perintah menggunakan parameter Jalur untuk menentukan lokasi file output. Ini menggunakan parameter Circular dan MaxSize untuk mengarahkanExport-Counter cmdlet untuk membuat log melingkar yang membungkus pada 1 GB. Parameter MaxSize dinyatakan dalam megabyte.

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

Contoh 3: Mendapatkan data penghitung dari komputer jarak jauh dan menyimpan data ke file

Contoh ini menunjukkan cara mendapatkan data penghitung kinerja dari komputer jarak jauh dan menyimpan data dalam file di komputer jarak jauh.

Perintah pertama menggunakan Get-Counter cmdlet untuk mengumpulkan data penghitung set kerja dari Server01, komputer jarak jauh. Perintah menyimpan data dalam $C variabel.

Perintah kedua menggunakan operator alur (|) untuk mengirim data $C ke Export-Counter cmdlet, yang menyimpannya dalam Workingset.blg file di Perf berbagi komputer Server01.

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

20

Contoh 4: Mencatat ulang data yang sudah ada

Contoh ini menunjukkan cara menggunakan Import-Counter cmdlet dan Export-Counter untuk mencatat ulang data yang ada.

Perintah pertama menggunakan Import-Counter cmdlet untuk mengimpor data penghitung kinerja dari DiskSpace.blg log. Ini menyimpan data dalam $All variabel. File ini berisi sampel penghitung "Ruang Kosong LogicalDisk% pada lebih dari 200 komputer jarak jauh di perusahaan.

Perintah kedua menggunakan Where-Object cmdlet untuk memilih objek dengan CookedValue kurang dari 15 (persen). Perintah menyimpan hasil dalam $LowSpace variabel.

Perintah ketiga menggunakan operator alur (|) untuk mengirim data dalam $LowSpace variabel ke Export-Counter cmdlet. Perintah menggunakan parameter Jalur untuk menunjukkan bahwa data yang dipilih harus dicatat dalam LowDiskSpace.blg file.

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

Parameter

-Circular

Menunjukkan bahwa file output adalah log melingkar dengan format first in, first out (FIFO). Saat Anda menyertakan parameter ini, parameter MaxSize diperlukan.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileFormat

Menentukan format output file log output.

Nilai yang dapat diterima untuk parameter ini adalah:

  • CSV
  • TSV
  • BLG

Nilai defaultnya adalah BLG.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Menimpa dan mengganti file yang ada jika ada di lokasi yang ditentukan oleh parameter Jalur .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Menentukan, sebagai array, data penghitung yang akan diekspor. Masukkan variabel yang berisi data atau perintah yang mendapatkan data, seperti Get-Counter cmdlet atau Import-Counter .

Type:PerformanceCounterSampleSet[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxSize

Menentukan ukuran maksimum file output dalam megabyte (MB).

Jika parameter Melingkar ditentukan, maka ketika file log mencapai ukuran maksimum yang ditentukan, entri terlama akan dihapus saat yang lebih baru ditambahkan. Jika parameter Melingkar tidak ditentukan, maka ketika file log mencapai ukuran maksimum yang ditentukan, tidak ada data baru yang ditambahkan dan cmdlet menghasilkan kesalahan yang tidak mengakhiri.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Menentukan jalur dan nama file file output. Masukkan jalur relatif atau absolut di komputer lokal, atau jalur Uniform Naming Convention (UNC) ke komputer jarak jauh, seperti \\Computer\Share\file.blg. Parameter ini diperlukan.

Format file ditentukan oleh nilai parameter FileFormat , bukan oleh ekstensi nama file di jalur.

Type:String
Aliases:PSPath
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Input

PerformanceCounterSampleSet

Anda dapat menyalurkan data penghitung kinerja dari Get-Counter atau Import-Counter ke cmdlet ini.

Output

None

Catatan

Generator file log mengharapkan bahwa semua objek input memiliki jalur penghitung yang sama dan bahwa objek diatur dalam urutan waktu naik.

Jenis penghitung dan jalur objek input pertama menentukan properti yang direkam dalam file log. Jika objek input lainnya tidak memiliki nilai untuk properti yang direkam, bidang properti kosong. Jika objek memiliki nilai properti yang tidak direkam, nilai properti tambahan diabaikan.

Monitor Performa mungkin tidak dapat membaca semua log yang Export-Counter dihasilkan. Misalnya, Monitor Performa mengharuskan semua objek memiliki jalur yang sama dan bahwa semua objek dipisahkan oleh interval waktu yang sama.

Import-Counter Cmdlet tidak memiliki parameter ComputerName. Namun, jika komputer dikonfigurasi untuk Windows PowerShell Windows PowerShell jarak jauh, Anda dapat menggunakan Invoke-Command cmdlet untuk menjalankan Import-Counter perintah di komputer jarak jauh.