Aracılığıyla paylaş

Measure-Command

Modül:
Microsoft.PowerShell.Utility Module

Betik bloklarını ve cmdlet'leri çalıştırmak için gereken süreyi ölçer.

Sözdizimi

Default EnterprisePublishing 

Measure-Command
    [-InputObject <PSObject>]
    [-Expression] <ScriptBlock>
    [<CommonParameters>]

Description

Measure-Command cmdlet'i dahili olarak bir betik bloğu veya cmdlet çalıştırır, işlemin yürütülmesini zamanlar ve yürütme süresini döndürür.

Uyarı

Measure-Command tarafından çalıştırılan betik blokları alt kapsamda değil geçerli kapsamda çalıştırılır.

Örnekler

Örnek 1: Komutu ölçme

Bu örnek, Windows PowerShell olay günlüğündeki olayları alan bir Get-EventLog komutunu çalıştırmak için gereken süreyi ölçer.

Measure-Command { Get-EventLog "Windows PowerShell" }

Örnek 2: Measure-Command iki çıkışı karşılaştırma

İlk komut, Get-ChildItem dizininde ve alt dizinlerinde yalnızca dosyaları almak için .txt parametresini kullanan özyinelemeli bir C:\Windows komutunu işlemek için gereken süreyi ölçer.

İkinci komut, sağlayıcıya özgü Get-ChildItem parametresini kullanan özyinelemeli bir komutunu işlemek için gereken süreyi ölçer.

Bu komutlar, PowerShell komutlarında sağlayıcıya özgü bir filtre kullanmanın değerini gösterir.

Measure-Command { Get-ChildItem -Path C:\Windows\*.txt -Recurse }

Days              : 0
Hours             : 0
Minutes           : 0
Seconds           : 8
Milliseconds      : 618
Ticks             : 86182763
TotalDays         : 9.9748568287037E-05
TotalHours        : 0.00239396563888889
TotalMinutes      : 0.143637938333333
TotalSeconds      : 8.6182763
TotalMilliseconds : 8618.2763

Measure-Command {Get-ChildItem C:\Windows -Filter "*.txt" -Recurse}

Days              : 0
Hours             : 0
Minutes           : 0
Seconds           : 1
Milliseconds      : 140
Ticks             : 11409189
TotalDays         : 1.32050798611111E-05
TotalHours        : 0.000316921916666667
TotalMinutes      : 0.019015315
TotalSeconds      : 1.1409189
TotalMilliseconds : 1140.9189

Örnek 3: Measure-Command'a boru girişi

Measure-Command'e yöneltilen nesneler, İfade parametresine geçirilen betik bloğunda kullanılabilir. Betik bloğu, işlem hattındaki her nesne için bir kez yürütülür.

# Perform a simple operation to demonstrate the InputObject parameter
# Note that no output is displayed.
10, 20, 50 | Measure-Command -Expression { for ($i=0; $i -lt $_; $i++) {$i} }

Days              : 0
Hours             : 0
Minutes           : 0
Seconds           : 0
Milliseconds      : 12
Ticks             : 122672
TotalDays         : 1.41981481481481E-07
TotalHours        : 3.40755555555556E-06
TotalMinutes      : 0.000204453333333333
TotalSeconds      : 0.0122672
TotalMilliseconds : 12.2672

Örnek 4: Ölçülen komutun çıktısını görüntüleme

İfadenin çıkışını Measure-Command görüntülemek için Out-Defaultiçin bir kanal kullanabilirsiniz.

# Perform the same operation as above adding Out-Default to every execution.
# This will show that the ScriptBlock is in fact executing for every item.
10, 20, 50 | Measure-Command -Expression {for ($i=0; $i -lt $_; $i++) {$i}; "$($_)" | Out-Default }

10
20
50


Days              : 0
Hours             : 0
Minutes           : 0
Seconds           : 0
Milliseconds      : 11
Ticks             : 113745
TotalDays         : 1.31649305555556E-07
TotalHours        : 3.15958333333333E-06
TotalMinutes      : 0.000189575
TotalSeconds      : 0.0113745
TotalMilliseconds : 11.3745

Örnek 5: Alt kapsamda yürütmeyi ölçme

Measure-Command betik bloğunu geçerli kapsamda çalıştırdığından, betik bloğu geçerli kapsamdaki değerleri değiştirebilir. Geçerli kapsamda değişiklik yapmamak için betik bloğunu küme ayraçları ({}) sarmalamalı ve bloğu alt kapsamda yürütmek için çağırma işlecini (&) kullanmalısınız.

$foo = 'Value 1'
$null = Measure-Command { $foo = 'Value 2' }
$foo
$null = Measure-Command { & { $foo = 'Value 3' } }
$foo

Value 2
Value 2

Çağırma işleci hakkında daha fazla bilgi için bkz. about_Operators.

Parametreler

-Expression

Zamanlanan ifadeyi belirtir. İfadeyi ayraç içine alın ({}).

Parametre özellikleri

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

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İş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

InputObject parametresine bağlı nesneler, İfade parametresine geçirilen betik bloğu için isteğe bağlı girişlerdir. Betik bloğunun içinde, $_ işlem hattındaki geçerli nesneye başvurmak için kullanılabilir.

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

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

Bir nesneyi bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

TimeSpan

Bu cmdlet, sonucu temsil eden bir zaman aralığı nesnesi döndürür.