Export-Counter
Performans sayacı verilerini günlük dosyalarına aktarır.
Syntax
Default (Varsayılan)
Export-Counter
[-Path] <String>
[-FileFormat <String>]
[-MaxSize <UInt32>]
-InputObject <PerformanceCounterSampleSet[]>
[-Force]
[-Circular]
[<CommonParameters>]
Description
Export-Counter cmdlet'i, performans sayacı verilerini (PerformanceCounterSampleSet nesneleri) ikili performans günlüğündeki (.blg), virgülle ayrılmış değer (.csv) veya sekmeyle ayrılmış değer (.tsv) biçimindeki dosyaları günlüğe kaydeder. Performans sayacı verilerini günlüğe kaydetmek için bu cmdlet'i kullanırsınız.
Export-Counter cmdlet'i, Get-Counter ve Import-Counter cmdlet'leri tarafından döndürülen verileri dışarı aktarmak için tasarlanmıştır.
Bu cmdlet yalnızca Windows 7, Windows Server 2008 R2 ve Windows'un sonraki sürümlerinde çalışır.
Örnekler
ÖRNEK 1: Sayaç verilerini bir dosyaya dışarı aktarma
Bu örnek, sayaç verilerini bir BLG dosyasına aktarır.
Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $HOME\Counters.blg
komut, işlemci zamanı verilerini toplamak için Get-Counter cmdlet'ini kullanır. Verileri | cmdlet'ine göndermek için bir işlem hattı işleci (Export-Counter) kullanır.
Export-Counter komutu, çıkış dosyasını belirtmek için Path değişkenini kullanır.
Veri kümesi çok büyük olabileceğinden, bu örnek verileri işlem hattı üzerinden Export-Counter gönderir. Veriler bir değişkene kaydedildiyse, orantısız miktarda bellek kullanabilirsiniz.
Örnek 2: Dosyayı sayaç dosyası biçiminde dışarı aktarma
Bu örnek, CSV dosyasını bir sayaç verileri BLG biçimine dönüştürür.
Import-Counter cmdlet'i performans sayacı verilerini Threads.csv dosyasından içeri aktarır. Örnekte, bu dosyanın daha önce Export-Counter cmdlet'i kullanılarak dışarı aktarıldığı varsayılır. İşlem hattı işleci (|), içeri aktarılan verileri Export-Counter cmdlet'ine gönderir. Komut, çıkış dosyasının konumunu belirtmek için Path parametresini kullanır.
cmdlet'ini 1 GB'a kaydıran dairesel bir günlük oluşturmaya yönlendirmek için Döngüsel ve MaxSize Export-Counter kullanır.
MaxSize parametresi megabayt cinsinden ifade edilir.
$1GBInMB = 1024 # 1GB = 1024MB
Import-Counter Threads.csv | Export-Counter -Path ThreadTest.blg -Circular -MaxSize $1GBInMB
Örnek 3: Uzak bilgisayardan sayaç verilerini alma ve verileri bir dosyaya kaydetme
Bu örnekte, uzak bir bilgisayardan performans sayacı verilerini alma ve verileri uzak bilgisayardaki bir dosyaya kaydetme gösterilmektedir.
İlk komut, uzak bir bilgisayar olan Server01'den çalışma kümesi sayaç verilerini toplamak için Get-Counter cmdlet'ini kullanır. komutu verileri $C değişkenine kaydeder.
İkinci komut, | içindeki verileri $C cmdlet'ine göndermek için bir işlem hattı işleci (Export-Counter) kullanır ve bu da verileri Server01 bilgisayarının Workingset.blg paylaşımındaki Perf dosyasına kaydeder.
$C = Get-Counter -ComputerName Server01 -Counter "\Process(*)\Working Set - Private" -MaxSamples $C | Export-Counter -Path \\Server01\Perf\WorkingSet.blg
20
Örnek 4: Mevcut verileri yeniden günlüğe kaydetme
Bu örnekte, var olan verileri yeniden günlüğe kaydetmek için Import-Counter ve Export-Counter cmdlet'lerinin nasıl kullanılacağı gösterilmektedir.
İlk komut, performans sayacı verilerini Import-Counter günlüğünden içeri aktarmak için DiskSpace.blg cmdlet'ini kullanır. Verileri $All değişkenine kaydeder. Bu dosya, kuruluştaki 200'den fazla uzak bilgisayarda "LogicalDisk% Boş Alan" sayacının örneklerini içerir.
İkinci komut, Where-Object 15'ten (yüzde) küçük nesneleri seçmek için cmdlet'ini kullanır. komutu sonuçları $LowSpace değişkenine kaydeder.
Üçüncü komut, | değişkenindeki verileri $LowSpace cmdlet'ine göndermek için bir işlem hattı işleci (Export-Counter) kullanır. Komut, seçilen verilerin dosyasında günlüğe kaydedilmesi gerektiğini belirtmek için LowDiskSpace.blg parametresini kullanır.
$All = Import-Counter DiskSpace.blg
$LowSpace = $All | Where-Object {$_.CounterSamples.CookedValue -lt 15}
$LowSpace | Export-Counter -Path LowDiskSpace.blg
Parametreler
-Circular
Çıkış dosyasının ilk giriş, ilk çıkış (FIFO) biçiminde döngüsel bir günlük olduğunu gösterir. Bu parametreyi eklediğinizde MaxSize parametresi gerekir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-FileFormat
Çıkış günlük dosyasının çıkış biçimini belirtir.
Bu parametre için kabul edilebilir değerler şunlardır:
CSVTSVBLG
Varsayılan değer şudur: BLG.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
Path parametresi tarafından belirtilen konumda varsa, varolan bir dosyanın üzerine yazar ve değiştirir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-InputObject
Dışarı aktaracak sayaç verilerini dizi olarak belirtir. verileri içeren bir değişken veya Get-Counter veya Import-Counter cmdlet'i gibi verileri alan bir komut girin.
Parametre özellikleri
| Tür: | |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-MaxSize
Çıktı dosyasının en büyük boyutunu megabayt (MB) cinsinden belirtir.
Döngüsel parametresi belirtilirse, günlük dosyası belirtilen en büyük boyuta ulaştığında, daha yenileri eklendikçe en eski girdiler silinir. Döngüsel parametresi belirtilmezse, günlük dosyası belirtilen boyuta ulaştığında yeni veri eklenmez ve cmdlet sonlandırılmayan bir hata oluşturur.
Parametre özellikleri
| Tür: | UInt32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Path
Çıkış dosyasının yolunu ve dosya adını belirtir. Yerel bilgisayarda göreli veya mutlak bir yol ya da \\Computer\Share\file.blggibi uzak bir bilgisayarın Tekdüzen Adlandırma Kuralı (UNC) yolunu girin. Bu parametre gereklidir.
Dosya biçimi, yoldaki dosya adı uzantısı tarafından değil, FileFormat parametresinin değeriyle belirlenir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
PerformanceCounterSampleSet
Performans sayacı verilerini Get-Counter veya Import-Counter bu cmdlet'e yöneltebilirsiniz.
Çıkışlar
None
Notlar
Günlük dosyası oluşturucu, tüm giriş nesnelerinin aynı sayaç yoluna sahip olmasını ve nesnelerin artan zaman sırasına göre düzenlenmesini bekler.
İlk giriş nesnesinin sayaç türü ve yolu, günlük dosyasına kaydedilen özellikleri belirler. Diğer giriş nesnelerinin kaydedilmiş bir özellik için değeri yoksa, özellik alanı boş olur. Nesneler kaydedilmemiş özellik değerlerine sahipse, ek özellik değerleri yoksayılır.
Performans İzleyicisi, Export-Counter oluşturulan tüm günlükleri okuyamayabilir. Örneğin, Performans İzleyicisi tüm nesnelerin aynı yola sahip olmasını ve tüm nesnelerin aynı zaman aralığıyla ayrılmasını gerektirir.
Import-Counter cmdlet'in ComputerName parametresi yok. Ancak, bilgisayar uzak Windows PowerShell Windows PowerShell için yapılandırılmışsa, uzak bir bilgisayarda Invoke-Command komutu çalıştırmak için Import-Counter cmdlet'ini kullanabilirsiniz.
