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

cmdlet Export-Counter mengekspor data penghitung kinerja (performanceCounterSampleSet objek) 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.

Cmdlet Export-Counter dirancang untuk mengekspor data yang dikembalikan oleh cmdlet Get-Counter 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 cmdlet Get-Counter untuk mengumpulkan data waktu prosesor. Ini menggunakan operator alur (|) untuk mengirim data ke cmdlet Export-Counter. 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.

cmdlet Import-Counter mengimpor data penghitung kinerja dari file Threads.csv. Contohnya mengasumsikan bahwa file ini sebelumnya diekspor dengan menggunakan cmdlet Export-Counter. Operator alur (|) mengirim data yang diimpor ke cmdlet Export-Counter. Perintah menggunakan parameter Jalur untuk menentukan lokasi file output. Ini menggunakan parameter Circular dan MaxSize untuk mengarahkan cmdlet Export-Counter 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 cmdlet Get-Counter untuk mengumpulkan data penghitung set kerja dari Server01, komputer jarak jauh. Perintah menyimpan data dalam variabel $C.

Perintah kedua menggunakan operator alur (|) untuk mengirim data dalam $C ke cmdlet Export-Counter, yang menyimpannya dalam file Workingset.blg di berbagi Perf 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 cmdlet Import-Counter dan Export-Counter untuk mencatat ulang data yang ada.

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

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

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

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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-FileFormat

Menentukan format output file log output.

Nilai yang dapat diterima untuk parameter ini adalah:

  • CSV
  • TSV
  • BLG

Nilai defaultnya adalah BLG.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Force

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

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-InputObject

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

Jenis:PerformanceCounterSampleSet[]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard: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.

Jenis:UInt32
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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 dengan ekstensi nama file di jalur.

Jenis:String
Alias:PSPath
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard: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 hasilkan. Misalnya, Monitor Performa mengharuskan semua objek memiliki jalur yang sama dan bahwa semua objek dipisahkan oleh interval waktu yang sama.

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