Measure-Object

Modül:

Microsoft.PowerShell.Utility Module

Nesnelerin sayısal özelliklerini ve metin dosyaları gibi dize nesnelerindeki karakterleri, sözcükleri ve satırları hesaplar.

Sözdizimi

GenericMeasure EnterprisePublishing

Measure-Object
    [[-Property] <PSPropertyExpression[]>]
    [-InputObject <PSObject>]
    [-StandardDeviation]
    [-Sum]
    [-AllStats]
    [-Average]
    [-Maximum]
    [-Minimum]
    [<CommonParameters>]

TextMeasure

Measure-Object
    [[-Property] <PSPropertyExpression[]>]
    [-InputObject <PSObject>]
    [-Line]
    [-Word]
    [-Character]
    [-IgnoreWhiteSpace]
    [<CommonParameters>]

Description

Measure-Object cmdlet'i belirli nesne türlerinin özellik değerlerini hesaplar. Measure-Object, komuttaki parametrelere bağlı olarak üç tür ölçüm gerçekleştirir.

Measure-Object cmdlet'i nesnelerin özellik değerleri üzerinde hesaplamalar yapar. belirtilen Measure-Objectile nesneleri saymak veya nesneleri saymak için kullanabilirsiniz. ,Minimum, En Fazla, Toplam, StandardDeviation ve sayısal değerlerin Ortalama hesaplamak için de kullanabilirsiniz. Dize nesneleri için, satır, sözcük ve karakter sayısını saymak için Measure-Object de kullanabilirsiniz.

Örnekler

Örnek 1: Dizindeki dosya ve klasörleri sayma

Bu komut geçerli dizindeki dosya ve klasörleri sayar.

Get-ChildItem | Measure-Object

Örnek 2: Dizindeki dosyaları ölçme

Bu komut, geçerli dizindeki tüm dosyaların boyutlarının Minimum, En Fazlave Toplam ve dizindeki bir dosyanın ortalama boyutunu görüntüler.

Get-ChildItem | Measure-Object -Property Length -Minimum -Maximum -Sum -Average

Örnek 3: Metin dosyasındaki metni ölçme

Bu komut, Text.txt dosyasındaki karakter, sözcük ve satır sayısını görüntüler. Raw parametresi olmadan, Get-Content dosyayı bir satır dizisi olarak verir.

İlk komut, dosyaya varsayılan metin eklemek için Set-Content kullanır.

"One", "Two", "Three", "Four" | Set-Content -Path C:\Temp\tmp.txt
Get-Content C:\Temp\tmp.txt | Measure-Object -Character -Line -Word

Lines Words Characters Property
----- ----- ---------- --------
    4     4         15

Örnek 4: Belirtilen Özelliği içeren nesneleri ölçme

Bu örnek, DisplayName özelliğine sahip nesne sayısını sayar. İlk iki komut yerel makinedeki tüm hizmetleri ve işlemleri alır. Üçüncü komut, birleştirilmiş hizmet ve işlem sayısını sayar. Son komut, iki koleksiyonu birleştirir ve sonucu Measure-Object.

System.Diagnostics.Process nesnesinin DisplayName özelliği yoktur ve son sayının dışında bırakılır.

$services = Get-Service
$processes = Get-Process
$services + $processes | Measure-Object
$services + $processes | Measure-Object -Property DisplayName

Count    : 682
Average  :
Sum      :
Maximum  :
Minimum  :
Property :

Count    : 290
Average  :
Sum      :
Maximum  :
Minimum  :
Property : DisplayName

Örnek 5: CSV dosyasının içeriğini ölçme

Bu komut, bir şirketin çalışanlarının ortalama hizmet yıllarını hesaplar.

ServiceYrs.csv dosyası, her çalışanın çalışan numarasını ve yıllarını içeren bir CSV dosyasıdır. Tablodaki ilk satır, EmpNoüst bilgi satırıdır Years.

dosyayı içeri aktarmak için Import-Csv kullandığınızda sonuç, EmpNo ve Yearsnot özelliklerine sahip pscustomObject elde edilir. Bir nesnenin diğer özellikleri gibi bu özelliklerin değerlerini hesaplamak için Measure-Object kullanabilirsiniz.

Import-Csv D:\test\serviceyrs.csv | Measure-Object -Property Years -Minimum -Maximum -Average

Örnek 6: Boole değerlerini ölçme

Bu örnekte Measure-Object Boole değerlerini nasıl ölçebileceği gösterilmektedir. Bu durumda, geçerli dizindeki klasörlerin (dosyalara karşı) insidansını ölçmek için PSIsContainerBoole özelliğini kullanır.

Get-ChildItem | Measure-Object -Property PSIsContainer -Maximum -Sum -Minimum -Average

Count             : 126
Average           : 0.0634920634920635
Sum               : 8
Maximum           : 1
Minimum           : 0
StandardDeviation :
Property          : PSIsContainer

Örnek 7: Ölçü dizeleri

Aşağıdaki örnek satır sayısını, önce tek bir dizeyi, sonra da birkaç dizeyi ölçer. `n yeni satır karakteri, dizeleri birden çok satıra ayırır.

# The newline character `n separates the string into separate lines, as shown in the output.
"One`nTwo`nThree"
"One`nTwo`nThree" | Measure-Object -Line

One
Two
Three


Lines Words Characters Property
----- ----- ---------- --------
    3

# The first string counts as a single line.
# The second string is separated into two lines by the newline character.
"One", "Two`nThree" | Measure-Object -Line

Lines Words Characters Property
----- ----- ---------- --------
    3

# The Word switch counts the number of words in each InputObject
# Each InputObject is treated as a single line.
"One, Two", "Three", "Four Five" | Measure-Object -Word -Line

Lines Words Characters Property
----- ----- ---------- --------
    3     5

Örnek 8: Tüm değerleri ölçme

PowerShell 6'nın AllStatstüm istatistikleri birlikte ölçmenizi sağlar.

1..5 | Measure-Object -AllStats

Count             : 5
Average           : 3
Sum               : 15
Maximum           : 5
Minimum           : 1
StandardDeviation : 1.58113883008419
Property          :

Örnek 9: Scriptblock özelliklerini kullanarak ölçme

PowerShell 6'da başlayarak ScriptBlock Measure-Object özelliklerini destekler. Aşağıdaki örnekte, bir dizindeki tüm dosyaların MegaBytes cinsinden boyutunu belirlemek için ScriptBlock özelliğinin nasıl kullanılacağı gösterilmektedir.

Get-ChildItem | Measure-Object -Sum {$_.Length/1MB}

Örnek 10: Karma tablo ölçme

PowerShell 6'da başlayarak karma Measure-Object tablo girişinin ölçülebilir olduğunu destekler. Aşağıdaki örnek, 3 num nesnesinin anahtarı için en büyük değeri belirler.

@{num=3}, @{num=4}, @{num=5} | Measure-Object -Maximum Num

Count             : 3
Average           :
Sum               :
Maximum           : 5
Minimum           :
StandardDeviation :
Property          : num

Örnek 11: Standart Sapması Ölçme

PowerShell 6'da başlayarak StandardDeviation Measure-Object parametresini destekler. Aşağıdaki örnek, tüm işlemler tarafından kullanılan CPU için standart sapması belirler. Büyük bir sapma, en çok CPU kullanan az sayıda işlemi gösterir.

Get-Process | Measure-Object -Average -StandardDeviation CPU

Count             : 303
Average           : 163.032384488449
Sum               :
Maximum           :
Minimum           :
StandardDeviation : 859.444048419069
Property          : CPU

Örnek 12: Joker karakter kullanarak ölçme

PowerShell 6'da başlayarak, Measure-Object özellik adlarında joker karakterler kullanarak nesnelerin ölçülünü destekler. Aşağıdaki örnek, bir dizi işlem arasında herhangi bir disk belleği bellek kullanımı türünün üst sınırını belirler.

Get-Process | Measure-Object -Maximum *paged*memory*size

Count             : 303
Average           :
Sum               :
Maximum           : 735784
Minimum           :
StandardDeviation :
Property          : NonpagedSystemMemorySize

Count             : 303
Average           :
Sum               :
Maximum           : 352104448
Minimum           :
StandardDeviation :
Property          : PagedMemorySize

Count             : 303
Average           :
Sum               :
Maximum           : 2201968
Minimum           :
StandardDeviation :
Property          : PagedSystemMemorySize

Count             : 303
Average           :
Sum               :
Maximum           : 719032320
Minimum           :
StandardDeviation :
Property          : PeakPagedMemorySize

Parametreler

-AllStats

Cmdlet'in belirtilen özelliklerin tüm istatistiklerini görüntülediğini gösterir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

GenericMeasure

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

-Average

Cmdlet'in belirtilen özelliklerin ortalama değerini gösterdiğini gösterir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

GenericMeasure

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

-Character

Cmdlet'in giriş nesnelerindeki karakter sayısını saydığını gösterir.

Uyarı

Word, Char ve Line anahtarları, her giriş nesnesinin içinde sayar ve giriş nesneleri arasında . Bkz. Örnek 7.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

TextMeasure

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

-IgnoreWhiteSpace

Cmdlet'in karakter sayılarındaki boşluğu yoksaydığını gösterir. Varsayılan olarak, boşluk yoksayılmaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

TextMeasure

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

Ölçülecek nesneleri belirtir. Nesneleri içeren bir değişken girin veya nesneleri alan bir komut veya ifade yazın.

Komutun sonuçlarını öğesine göndermek yerine ile Measure-ObjectMeasure-Object parametresini kullandığınızda, InputObject değeri tek bir nesne olarak değerlendirilir.

Nesnelerin tanımlı özelliklerde belirli değerlere sahip olup olmadığına bağlı olarak bir nesne koleksiyonunu ölçmek istiyorsanız, işlem hattında Measure-Object kullanmanız önerilir.

Parametre özellikleri

Tür:	PSObject
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	True
Ö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

-Line

Cmdlet'in giriş nesnelerindeki satır sayısını saydığını gösterir.

Uyarı

Word, Char ve Line anahtarları, her giriş nesnesinin içinde sayar ve giriş nesneleri arasında . Bkz. Örnek 7.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

TextMeasure

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

-Maximum

Cmdlet'in belirtilen özelliklerin en yüksek değerini görüntülendiğini gösterir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

GenericMeasure

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

-Minimum

Cmdlet'in belirtilen özelliklerin en düşük değerini görüntülediğini gösterir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

GenericMeasure

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

-Property

Ölçülecek bir veya daha fazla özelliği belirtir. Başka ölçü belirtmezseniz, Measure-Object belirttiğiniz özelliklere sahip nesneleri sayar.

Özelliği parametresinin değeri yeni bir hesaplanmış özellik olabilir. Hesaplanan özellik bir betik bloğu olmalıdır. Daha fazla bilgi için, about_Calculated_Propertiesbölümüne bakın.

Parametre özellikleri

Tür:	PSPropertyExpression[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

(All)

Position:	0
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

-StandardDeviation

Cmdlet'in belirtilen özelliklerin değerlerinin standart sapması görüntülendiğini gösterir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

GenericMeasure

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

-Sum

Cmdlet'in belirtilen özelliklerin değerlerinin toplamını görüntülediğini gösterir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

GenericMeasure

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

-Word

Cmdlet'in giriş nesnelerindeki sözcük sayısını saydığını gösterir.

Uyarı

Word, Char ve Line anahtarları, her giriş nesnesinin içinde sayar ve giriş nesneleri arasında . Bkz. Örnek 7.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

TextMeasure

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

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

PSObject

Nesneleri bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

GenericMeasureInfo

Varsayılan olarak, bu cmdlet bir GenericMeasureInfo nesnesi döndürür.

TextMeasureInfo

Word parametresini kullandığınızda, bu cmdlet bir TextMeasureInfo nesnesi döndürür.

Notlar

PowerShell, Measure-Objectiçin aşağıdaki diğer adları içerir:

• Tüm platformlar:
  • measure

PowerShell 7.3'te başlayarak, Measure-Object StrictMode'da çalışmadığınız sürece ölçülen özelliği eksik olan bir nesne işlenirken artık hata döndürmez. StrictMode'da, Measure-Object belirtilen özelliği eksik olan bir nesne işlenirken döndürürSystem.Management.Automation.PSArgumentException.

İlişkili Bağlantılar

• Hesaplanan_Özellikler_Hakkında
• Nesneleri Karşılaştır
• ForEach-Object
• Nesne Grubu
• Yeni Nesne
• Nesne Seç
• Nesneyi Sırala
• Tee-Object komutu
• Where-Object