about_Automatic_Variables
Kısa açıklama
Ve için durum bilgilerini depolayan ve PowerShell tarafından oluşturulan ve tutulan değişkenleri açıklar.
Uzun açıklama
Kavramsal olarak, bu değişkenlerin çoğu salt okunur olarak kabul edilir. Bu kişilere yazılabilir olsalar da geriye dönük uyumluluk için bu kişilere yazılmamalıdır .
PowerShell'deki otomatik değişkenlerin listesi aşağıdadır:
$$
Oturum tarafından alınan son satırdaki son belirteci içerir.
$?
Son komutun yürütme durumunu içerir. Son komut başarılıysa True , başarısız olursa False değerini içerir.
bir işlem hattında birden çok aşamada çalıştırılan cmdlet'ler ve gelişmiş işlevler için, örneğin hem hem end
de process
bloklarında, veya herhangi bir noktada çağrılırken this.WriteError()
veya $PSCmdlet.WriteError()
herhangi bir noktada ve gibi False olarak this.ThrowTerminatingError()
$PSCmdlet.ThrowTerminatingError()
ayarlanır.$?
Write-Error
Cmdlet yürütüldükten hemen sonra her zaman $?
False olarak ayarlanır, ancak çağıran bir işlev için False olarak ayarlanmadı$?
:
function Test-WriteError
{
Write-Error "Bad"
"The `$? variable is: $?"
}
Test-WriteError
"Now the `$? variable is: $?"
Test-WriteError:
Line |
7 | Test-WriteError
| ~~~~~~~~~~~~~~~
| Bad
The $? variable is: False
Now the $? variable is: True
İkinci amaç için bunun $PSCmdlet.WriteError()
yerine kullanılmalıdır.
Yerel komutlar için (yürütülebilir dosyalar), $?
0 olduğunda $LASTEXITCODE
True, başka bir değer olduğunda $LASTEXITCODE
ise False olarak ayarlanır.
Not
PowerShell 7'ye kadar, parantez (...)
içinde bir deyimi sarmalama, alt ifade söz dizimi $(...)
veya dizi ifadesi @(...)
her zaman True olarak sıfırlanır$?
. Örneğin, (Write-Error)
True olarak gösterilir$?
. Bu davranış PowerShell 7'de değiştirildiğinden $?
, bu ifadelerdeki son komut çalıştırmasının gerçek başarısını her zaman yansıtır.
$^
Oturum tarafından alınan son satırdaki ilk belirteci içerir.
$_
ile $PSItem
aynı. İşlem hattı nesnesindeki geçerli nesneyi içerir. İşlem hattındaki her nesne üzerinde eylem gerçekleştiren komutlarda bu değişkeni kullanabilirsiniz.
Daha fazla bilgi için bkz. about_PSItem.
$args
Bir işleve, betike veya betik bloğuna geçirilen bildirilmemiş parametreler için bir değer dizisi içerir. İşlev oluşturduğunuzda, parametreleri anahtar sözcüğüyle bildirebilir veya işlev adından sonra parantez içinde virgülle param
ayrılmış bir parametre listesi ekleyebilirsiniz.
Bir olay eyleminde $args
değişken, işlenen olayın olay bağımsız değişkenlerini temsil eden nesneler içerir. Bu değişken yalnızca bir olay kayıt komutunun Action
bloğu içinde doldurulur. Bu değişkenin değeri, döndüren PSEventArgs nesnesinin Get-Event
SourceArgs özelliğinde de bulunabilir.
$ConsoleFileName
Oturumda en son kullanılan konsol dosyasının (.psc1
) yolunu içerir. Bu değişken, PowerShell'i PSConsoleFile parametresiyle başlattığınızda veya ek bileşen adlarını bir konsol dosyasına aktarmak için cmdlet'ini kullandığınızda Export-Console
doldurulur.
cmdlet'ini Export-Console
parametresiz kullandığınızda, oturumda en son kullanılan konsol dosyasını otomatik olarak güncelleştirir. Güncelleştirilecek dosyayı belirlemek için bu otomatik değişkeni kullanabilirsiniz.
$EnabledExperimentalFeatures
Etkinleştirilen deneysel özelliklerin adlarının listesini içerir.
$Error
En son hataları temsil eden bir hata nesneleri dizisi içerir. En son hata, dizisindeki $Error[0]
ilk hata nesnesidir.
Bir hatanın $Error
diziye eklenmesini önlemek için ErrorAction ortak parametresini Ignore değeriyle kullanın. Daha fazla bilgi için bkz. about_CommonParameters.
$Event
İşlenen olayı temsil eden bir PSEventArgs nesnesi içerir. Bu değişken yalnızca gibi Register-ObjectEvent
bir olay kayıt komutunun bloğu içinde Action
doldurulur. Bu değişkenin değeri, cmdlet'in döndürdüğü nesneyle Get-Event
aynıdır. Bir betik bloğunda değişkeninin Event
özelliklerini ( gibi$Event.TimeGenerated
Action
) kullanabilirsiniz.
$EventArgs
İşlenmekte olan olayın EventArgs öğesinden türetilen ilk olay bağımsız değişkenini temsil eden bir nesnesi içerir. Bu değişken yalnızca bir olay kayıt komutunun Action
bloğu içinde doldurulur. Bu değişkenin değeri, döndüren PSEventArgs nesnesinin Get-Event
SourceEventArgs özelliğinde de bulunabilir.
$EventSubscriber
İşlenen olayın olay abonesini temsil eden bir PSEventSubscriber nesnesi içerir. Bu değişken yalnızca bir olay kayıt komutunun Action
bloğu içinde doldurulur. Bu değişkenin değeri, cmdlet'in döndürdüğü nesneyle Get-EventSubscriber
aynıdır.
$ExecutionContext
PowerShell konağı yürütme bağlamını temsil eden bir EngineIntrinsics nesnesi içerir. Cmdlet'ler için kullanılabilen yürütme nesnelerini bulmak için bu değişkeni kullanabilirsiniz.
$false
False içerir. dizesini kullanmak "false"
yerine komutlarda ve betiklerde False değerini göstermek için bu değişkeni kullanabilirsiniz. Dize boş olmayan bir dizeye veya sıfır olmayan bir tamsayıya dönüştürülürse True olarak yorumlanabilir.
$foreach
ForEach döngüsünün numaralandırıcısını (sonuçta elde edilen değerleri değil) içerir. $ForEach
Değişken yalnızca ForEach
döngü çalışırken bulunur; döngü tamamlandıktan sonra silinir.
Numaralandırıcılar, döngü değerlerini almak ve geçerli döngü yinelemesini değiştirmek için kullanabileceğiniz özellikler ve yöntemler içerir. Daha fazla bilgi için bkz. Numaralandırıcıları Kullanma.
$HOME
Kullanıcının giriş dizininin tam yolunu içerir. Windows'da, bu değişken Genellikle C:\Users\<UserName>
Windows ortam değişkeninin "$env:USERPROFILE"
değerini kullanır. Unix'te bu değişken ortam değişkeninin HOME
değerini kullanır.
Önemli
Windows, kullanıcı profilinin konumunu yeniden yönlendirebilir. Bu, ile $HOME
aynı değere $env:HOMEDRIVE$env:HOMEPATH
sahip olmadığı anlamına gelir.
$Host
PowerShell için geçerli konak uygulamasını temsil eden bir nesnesi içerir.
Bu değişkeni komutlarda geçerli konağı temsil etmek veya konağın veya $Host.CurrentCulture
$Host.UI.RawUI.BackGroundColor = "Red"
gibi $Host.version
özelliklerini görüntülemek veya değiştirmek için kullanabilirsiniz.
Not
içindeki $Host.PrivateData
renk ayarları tercih değişkeniyle $PSStyle
değiştirildi. Daha fazla bilgi için bkz. about_ANSI_Terminals.
$input
bir işleve geçirilen tüm girişleri numaralandıran bir numaralandırıcı içerir.
$input
Değişkeni yalnızca işlevler ve betik blokları (adlandırılmamış işlevlerdir) için kullanılabilir.
,
process
veyaend
bloğu olmayan birbegin
işlevde$input
, değişkeni işleve yönelik tüm girişlerin koleksiyonunu numaralandırır.bloğunda
begin
$input
değişken veri içermiyor.bloğunda
process
$input
değişken, işlem hattındaki geçerli nesneyi içerir.bloğunda
end
$input
değişkeni, işleve yönelik tüm girişlerin koleksiyonunu numaralandırır.Not
Aynı işlev veya betik bloğunda
process
hem bloğun hem de bloğunend
içindeki değişkeni kullanamazsınız$input
.
Bir numaralandırıcı olduğundan $input
, özelliklerinden herhangi birine erişmek artık kullanılamama neden olur $input
. Özellikleri yeniden kullanmak için başka bir değişkende $input
depolayabilirsiniz$input
.
Numaralandırıcılar, döngü değerlerini almak ve geçerli döngü yinelemesini değiştirmek için kullanabileceğiniz özellikler ve yöntemler içerir. Daha fazla bilgi için bkz. Numaralandırıcıları Kullanma.
$input
değişkeni, komut satırından çağrıldığında parametresi pwsh
tarafından -Command
belirtilen komut için de kullanılabilir. Aşağıdaki örnek, Windows Komut kabuğundan çalıştırılır.
echo Hello | pwsh -Command """$input World!"""
$IsCoreCLR
Geçerli oturumun .NET Core Çalışma Zamanı'nda (CoreCLR) çalıştırılıp çalıştırılamadığını içerir $True
. Aksi takdirde içerir $False
.
$IsLinux
Geçerli oturumun linux işletim sisteminde çalıştırılıp çalıştırılamadığını içerir $True
.
Aksi takdirde içerir $False
.
$IsMacOS
Geçerli oturumun bir MacOS işletim sisteminde çalıştırılıp çalıştırılamadığını içerir $True
.
Aksi takdirde içerir $False
.
$IsWindows
Geçerli oturumun bir Windows işletim sisteminde çalıştırılıp çalıştırılamadığını içerir $TRUE
. Aksi takdirde içerir $FALSE
.
$LASTEXITCODE
Çalıştıran son yerel programın veya PowerShell betiğinin çıkış kodunu içerir.
PowerShell betikleri için değeri $LASTEXITCODE
, betiğin nasıl çağrıldığı ve anahtar sözcüğün exit
kullanılıp kullanılmadığına bağlıdır:
Betik anahtar sözcüğünü kullandığında
exit
:$LASTEXITCODE
, anahtar sözcüğü tarafından belirtilen değereexit
ayarlanır. Daha fazla bilgi için bkz. about_Language_Keywords.Bir betik gibi doğrudan veya gibi
./Test.ps1
& ./Test.ps1
çağrı işleciyle (&
) çağrıldığında:değeri
$LASTEXITCODE
aşağıdakiler dışında değiştirilmez:- Betik, anahtar sözcüğünü
exit
kullanan başka bir betiği çağırır - Betik yerel bir komut çağırır
- Betik anahtar sözcüğünü
exit
kullanır
- Betik, anahtar sözcüğünü
Dosya parametresi kullanılarak ile
pwsh
bir betik çağrıldığında şu$LASTEXITCODE
şekilde ayarlanır:1
betik bir özel durum nedeniyle sonlandırıldıysa- Betikte
exit
kullanılıyorsa anahtar sözcüğü tarafından belirtilen değer 0
betik başarıyla tamamlandıysa
Komut parametresi kullanılarak ile
pwsh
bir betik çağrıldığında şu$LASTEXITCODE
şekilde ayarlanır:1
Betik bir özel durum nedeniyle sonlandırıldıysa veya son komutun sonucu olarak ayarlandıysa$?
$false
0
betik başarıyla tamamlandıysa ve son komutun sonucu olarak ayarlandıysa$?
$true
Dosya ve Komut parametreleri hakkında daha fazla bilgi için bkz. about_Pwsh.
$Matches
$Matches
değişkeni ve -notmatch
işleçleriyle -match
çalışır. veya -notmatch
işlecine -match
skaler giriş gönderdiğinizde ve biri eşleşme algıladığında bir Boole değeri döndürür ve otomatik değişkeni eşleşen dize değerlerinin karma tablosuyla doldurur$Matches
.
Karma $Matches
tablo, işleciyle normal ifadeler kullandığınızda yakalamalarla -match
da doldurulabilir.
İşleç -match
hakkında daha fazla bilgi için bkz. about_Comparison_Operators. Normal ifadeler hakkında daha fazla bilgi için bkz. about_Regular_Expressions.
değişkeni parametresiyle $Matches
-Regex
bir switch
deyimde de çalışır. ve işleçleri ile -match
-notmatch
aynı şekilde doldurulur. deyimi hakkında switch
daha fazla bilgi için bkz. about_Switch.
Not
Oturumda doldurulduğunda $Matches
, başka bir eşleşme tarafından üzerine yazılana kadar eşleşen değeri korur. Yeniden kullanılırsa ve eşleşme bulunmazsa -match
, olarak sıfırlanmıyordur $Matches
$null
. Daha önce eşleşen değer, başka bir eşleşme bulunana kadar içinde $Matches
tutulur.
$MyInvocation
Geçerli komut hakkında ad, parametreler, parametre değerleri gibi bilgileri ve komutun nasıl başlatıldığı, çağrıldığı veya çağrıldığı hakkında bilgiler (geçerli komutu çağıran betiğin adı gibi) içerir.
$MyInvocation
yalnızca betikler, işlev ve betik blokları için doldurulur. Geçerli komutu tanımlamak için geçerli betikte döndüren $MyInvocation
System.Management.Automation.InvocationInfo nesnesindeki bir işlevin ($MyInvocation.MyCommand.Name
) adı gibi bilgileri kullanabilirsiniz.
Bu, geçerli betiğin adını bulmak için kullanışlıdır.
PowerShell 3.0 MyInvocation
sürümünden başlayarak aşağıdaki yeni özelliklere sahiptir.
- PSScriptRoot - Geçerli komutu çağıran betiğin tam yolunu içerir. Bu özelliğin değeri yalnızca çağıran bir betik olduğunda doldurulur.
- PSCommandPath - Geçerli komutu çağıran betiğin tam yolunu ve dosya adını içerir. Bu özelliğin değeri yalnızca çağıran bir betik olduğunda doldurulur.
$PSScriptRoot
ve $PSCommandPath
otomatik değişkenlerinden farklı olarak, otomatik değişkenin PSScriptRoot ve PSCommandPath özellikleri $MyInvocation
geçerli betikle değil çağıran veya çağıran betik hakkında bilgi içerir.
$NestedPromptLevel
Geçerli istem düzeyini içerir. 0 değeri özgün istem düzeyini gösterir. İç içe bir düzey girdiğinizde değer artırılır ve bu düzeyden çıktığınızda azalmış olur.
Örneğin, yöntemini kullandığınızda $Host.EnterNestedPrompt
PowerShell iç içe bir komut istemi sunar. PowerShell hata ayıklayıcısında bir kesme noktasına ulaştığınızda PowerShell iç içe bir komut istemi de sunar.
İç içe bir istem girdiğinizde PowerShell geçerli komutu duraklatır, yürütme bağlamını kaydeder ve değişkenin $NestedPromptLevel
değerini artırır. İç içe ek komut istemleri (en fazla 128 düzey) oluşturmak veya özgün komut istemine dönmek için, komutu tamamlayın veya yazın exit
.
değişkeni, $NestedPromptLevel
istem düzeyini izlemenize yardımcı olur. Her zaman görünür olması için bu değeri içeren alternatif bir PowerShell komut istemi oluşturabilirsiniz.
$null
$null
null veya boş değer içeren bir otomatik değişkendir. Komutlarda ve betiklerde eksik veya tanımsız bir değeri göstermek için bu değişkeni kullanabilirsiniz.
PowerShell bir değere veya yer tutucuya sahip bir nesne olarak davranır $null
, böylece bir değer koleksiyonundaki boş bir değeri temsil etmek için kullanabilirsiniz $null
.
Örneğin, bir koleksiyona dahil edildiğinde $null
nesnelerden biri olarak sayılır.
$a = "one", $null, "three"
$a.count
3
değişkeni cmdlet'ine ForEach-Object
kanal oluşturursanız$null
, diğer nesneler için olduğu gibi için $null
bir değer oluşturur.
"one", $null, "three" | ForEach-Object { "Hello " + $_}
Hello one
Hello
Hello three
Sonuç olarak, parametre değeri olmamasını ifade etmek için kullanamazsınız$null
. parametresinin $null
değeri, varsayılan parametre değerini geçersiz kılar.
Ancak, PowerShell değişkeni yer tutucu olarak değerlendirdiğinden $null
, bunu aşağıdaki gibi betiklerde kullanabilirsiniz; bu, yoksayılırsa $null
işe yaramaz.
$calendar = @($null, $null, "Meeting", $null, $null, "Team Lunch", $null)
$days = "Sunday","Monday","Tuesday","Wednesday","Thursday",
"Friday","Saturday"
$currentDay = 0
foreach($day in $calendar)
{
if($day -ne $null)
{
"Appointment on $($days[$currentDay]): $day"
}
$currentDay++
}
Appointment on Tuesday: Meeting
Appointment on Friday: Team lunch
$PID
Geçerli PowerShell oturumunu barındıran işlemin işlem tanımlayıcısını (PID) içerir.
$PROFILE
Geçerli kullanıcı ve geçerli konak uygulaması için PowerShell profilinin tam yolunu içerir. Komutlarda profili temsil etmek için bu değişkeni kullanabilirsiniz. Örneğin, bir profilin oluşturulup oluşturulmadığını belirlemek için bunu bir komutta kullanabilirsiniz:
Test-Path $PROFILE
İsterseniz, profil oluşturmak için komutta da kullanabilirsiniz:
New-Item -ItemType file -Path $PROFILE -Force
Profili notepad.exeaçmak için bir komutta kullanabilirsiniz:
notepad.exe $PROFILE
$PSBoundParameters
Bir betik veya işleve geçirilen parametrelerin ve bunların geçerli değerlerinin sözlüğünü içerir. Bu değişken yalnızca betik veya işlev gibi parametrelerin bildirildiği bir kapsamda bir değere sahiptir. Parametrelerin geçerli değerlerini görüntülemek veya değiştirmek ya da parametre değerlerini başka bir betik veya işleve geçirmek için bunu kullanabilirsiniz.
Bu örnekte, Test2 işlevi test1 işlevine iletir$PSBoundParameters
. $PSBoundParameters
, Anahtar ve Değer biçiminde görüntülenir.
function Test1 {
param($a, $b)
# Display the parameters in dictionary format.
$PSBoundParameters
}
function Test2 {
param($a, $b)
# Run the Test1 function with $a and $b.
Test1 @PSBoundParameters
}
Test2 -a Power -b Shell
Key Value
--- -----
a Power
b Shell
$PSCmdlet
Çalıştırılmakta olan cmdlet'i veya gelişmiş işlevi temsil eden bir nesne içerir.
Kullanım koşullarına yanıt vermek için cmdlet veya işlev kodunuzda nesnenin özelliklerini ve yöntemlerini kullanabilirsiniz. Örneğin, ParameterSetName özelliği kullanılmakta olan parametre kümesinin adını içerir ve ShouldProcess yöntemi cmdlet'ine WhatIf ve Confirm parametrelerini dinamik olarak ekler.
Otomatik değişken hakkında $PSCmdlet
daha fazla bilgi için bkz. about_Functions_CmdletBindingAttribute ve about_Functions_Advanced.
$PSCommandPath
Çalıştırılmakta olan betiğin tam yolunu ve dosya adını içerir. Bu değişken tüm betiklerde geçerlidir.
$PSCulture
PowerShell 7'de başlayarak, $PSCulture
geçerli PowerShell çalışma alanının (oturum) kültürünü yansıtır. PowerShell çalışma alanında kültür değiştirilirse, $PSCulture
bu çalışma alanının değeri güncelleştirilir.
Kültür, sayılar, para birimi ve tarihler gibi öğelerin görüntüleme biçimini belirler ve System.Globalization.CultureInfo nesnesinde depolanır. Bilgisayarın kültürünü görüntülemek için kullanın Get-Culture
. $PSCulture
Name özelliğinin değerini içerir.
$PSDebugContext
Hata ayıklama sırasında, bu değişken hata ayıklama ortamı hakkında bilgi içerir. Aksi takdirde , null bir değer içerir. Sonuç olarak, hata ayıklayıcının denetimi olup olmadığını belirlemek için bunu kullanabilirsiniz. Doldurulduğunda, Kesme Noktaları ve InvocationInfo özelliklerine sahip bir PsDebugContext nesnesi içerir. InvocationInfo özelliği, Location özelliği de dahil olmak üzere çeşitli yararlı özelliklere sahiptir. Location özelliği, hata ayıklanan betiğin yolunu gösterir.
$PSEdition
içinde $PSVersionTable.PSEdition
aynı değeri içerir. Bu değişken modül bildirim dosyalarında kullanılabilirken $PSVersionTable
kullanılamaz.
$PSHOME
Genellikle Windows sistemlerinde PowerShell $env:windir\System32\PowerShell\v1.0
yükleme dizininin tam yolunu içerir. Bu değişkeni PowerShell dosyalarının yollarında kullanabilirsiniz. Örneğin, aşağıdaki komut kavramsal Yardım konularını sözcük değişkeni için arar:
Select-String -Pattern Variable -Path $pshome\*.txt
$PSItem
ile $_
aynı. İşlem hattı nesnesindeki geçerli nesneyi içerir. Bu değişkeni, işlem hattındaki her nesne üzerinde eylem gerçekleştiren komutlarda kullanabilirsiniz.
Daha fazla bilgi için bkz. about_PSItem.
$PSScriptRoot
Yürütülen betiğin üst dizininin tam yolunu içerir.
PowerShell 2.0'da bu değişken yalnızca betik modüllerinde (.psm1
) geçerlidir.
PowerShell 3.0'da başlayarak tüm betiklerde geçerlidir.
$PSSenderInfo
PsSession'ı başlatan kullanıcı hakkında, kullanıcı kimliği ve kaynak bilgisayarın saat dilimi dahil olmak üzere bilgileri içerir. Bu değişken yalnızca PSSessions içinde kullanılabilir.
$PSSenderInfo
değişkeni, varsayılan olarak yalnızca $PSVersionTable
kaynak oturumdan öğesini içeren applicationArguments adlı kullanıcı tarafından yapılandırılabilir bir özellik içerir. ApplicationArguments özelliğine veri eklemek için cmdlet'in ApplicationArguments parametresini New-PSSessionOption
kullanın.
$PSUICulture
İşletim sisteminde yapılandırılan kullanıcı arabirimi (UI) kültürünün adını içerir. Kullanıcı arabirimi kültürü, menüler ve iletiler gibi kullanıcı arabirimi öğeleri için hangi metin dizelerinin kullanıldığını belirler. Bu System.Globalization.CultureInfo değeridir.Current sistemin UICulture.Name özelliği. Sistemin System.Globalization.CultureInfo nesnesini almak için cmdlet'ini Get-UICulture
kullanın.
$PSVersionTable
Geçerli oturumda çalışan PowerShell sürümüyle ilgili ayrıntıları görüntüleyen salt okunur bir karma tablo içerir. Tablo aşağıdaki öğeleri içerir:
- PSVersion - PowerShell sürüm numarası
- PSEdition Bu özellik, PowerShell 4 ve altı için 'Desktop' değerinin yanı sıra tam özellikli Windows sürümlerinde PowerShell 5.1'e sahiptir. Bu özellik, PowerShell 6 ve üzeri için değerinin
Core
yanı sıra Windows Nano Server veya Windows IoT gibi azaltılmış ayak izi sürümleri üzerinde Windows PowerShell 5.1'e sahiptir. - GitCommitId - GitHub'daki kaynak dosyaların işleme kimliği,
- İşletim sistemi - PowerShell'in üzerinde çalıştığı işletim sisteminin açıklaması.
- Platform - İşletim sisteminin üzerinde çalıştığı platform. Linux ve macOS'ta değer Unix'tir. Bkz
$IsMacOs
. ve$IsLinux
. - PSCompatibleVersions - Geçerli sürümle uyumlu PowerShell sürümleri
- PSRemotingProtocolVersion - PowerShell uzaktan yönetim protokolünün sürümü.
- SerializationVersion - Serileştirme yönteminin sürümü
- WSManStackVersion - WS-Management yığınının sürüm numarası
$PWD
Geçerli PowerShell çalışma alanı için geçerli dizin konumunun tam yolunu temsil eden bir yol nesnesi içerir.
Not
PowerShell, işlem başına birden çok çalışma alanı destekler. Her çalışma alanının kendi geçerli dizini vardır. Bu, işlemin geçerli diziniyle aynı değildir: [System.Environment]::CurrentDirectory
.
$Sender
Bu olayı oluşturan nesneyi içerir. Bu değişken yalnızca bir olay kaydı komutunun Eylem bloğu içinde doldurulur. Bu değişkenin değeri, döndüren PSEventArgs nesnesinin Get-Event
Sender özelliğinde de bulunabilir.
$ShellId
Geçerli kabuğun tanımlayıcısını içerir.
$StackTrace
En son hata için bir yığın izlemesi içerir.
$switch
Bir deyiminin sonuçta elde edilen değerlerini değil numaralandırıcıyı Switch
içerir. $switch
değişkeni yalnızca Switch
deyimi çalışırken bulunur; deyimi yürütmeyi tamamladığında switch
silinir. Daha fazla bilgi için bkz. about_Switch.
Numaralandırıcılar, döngü değerlerini almak ve geçerli döngü yinelemesini değiştirmek için kullanabileceğiniz özellikler ve yöntemler içerir. Daha fazla bilgi için bkz. Numaralandırıcıları Kullanma.
$this
$this
değişkeni, sınıfın kendi örneğine başvurmak için sınıfları genişleten betik bloklarında kullanılır.
PowerShell'in Genişletilebilir Tür Sistemi (ETS), betik bloklarını kullanarak sınıflara özellik eklemenizi sağlar. Bir betik özelliğini veya betik yöntemini tanımlayan bir betik bloğunda $this
değişken, genişletilmekte olan sınıfın nesnesinin bir örneğine başvurur. Örneğin PowerShell, BaseName özelliğini FileInfo sınıfına eklemek için ETS kullanır.
PS> Get-ChildItem .\README.md | Get-Member BaseName | Format-List
TypeName : System.IO.FileInfo
Name : BaseName
MemberType : ScriptProperty
Definition : System.Object BaseName {get=if ($this.Extension.Length -gt 0)
{$this.Name.Remove($this.Name.Length - $this.Extension.Length
)}else{$this.Name};}
Daha fazla bilgi için bkz . about_Types.ps1xml.
Bir PowerShell sınıfında değişkeni, $this
sınıfın kendi örnek nesnesine başvurur ve sınıfta tanımlanan özelliklere ve yöntemlere erişim sağlar. Daha fazla bilgi için bkz. about_Classes.
değişkeni $this
, betik bloklarını olay işleyicisi için temsilci olarak alan .NET olay sınıfları tarafından da kullanılır. Bu senaryoda, $this
olayı gönderen olarak bilinen olayı oluşturan nesneyi temsil eder.
$true
True içerir. Komutlarda ve betiklerde True'yu göstermek için bu değişkeni kullanabilirsiniz.
Numaralandırıcıları Kullanma
$input
, $foreach
ve $switch
değişkenleri, içeren kod blokları tarafından işlenen değerler arasında yineleme yapmak için kullanılan tüm numaralandırıcılardır.
Numaralandırıcı, yinelemeyi ilerletmek veya sıfırlamak ya da yineleme değerlerini almak için kullanabileceğiniz özellikler ve yöntemler içerir. Numaralandırıcıları doğrudan düzenlemek en iyi yöntem olarak kabul edilmez.
Döngüler içinde akış denetimi anahtar sözcüklerinin sonu ve devamı tercih edilmelidir.
İşlem hattı girişini kabul eden işlevlerde, ValueFromPipeline veya ValueFromPipelineByPropertyName öznitelikleriyle parametreleri kullanmak en iyi yöntemdir.
Daha fazla bilgi için bkz. about_Functions_Advanced_Parameters.
Movenext
MoveNext yöntemi numaralandırıcıyı koleksiyonun sonraki öğesine ilerler. Numaralandırıcı koleksiyonun sonunu geçtiyse, False
numaralandırıcı başarılı bir şekilde gelişmişse MoveNext döndürürTrue
.
Not
MoveNext tarafından döndürülen Boole değeri çıkış akışına gönderilir.
Çıkışı typecasting to veya piping [void]
out-Null olarak gizleyebilirsiniz.
$input.MoveNext() | Out-Null
[void]$input.MoveNext()
Reset
Reset yöntemi, numaralandırıcıyı koleksiyondaki ilk öğeden önceki ilk konumuna ayarlar.
Current
Current özelliği, öğeyi numaralandırıcının geçerli konumundaki koleksiyon veya işlem hattında alır.
Current Özelliği, MoveNext çağrılana kadar aynı özelliği döndürmeye devam eder.
Örnekler
Örnek 1: $input değişkenini kullanma
Aşağıdaki örnekte değişkene $input
erişmek, işlem bloğunun bir sonraki yürütülmesine kadar değişkeni temizler. yöntemi kullanıldığında Reset değişken geçerli işlem hattı değerine sıfırlanır $input
.
function Test
{
begin
{
$i = 0
}
process
{
"Iteration: $i"
$i++
"`tInput: $input"
"`tAccess Again: $input"
$input.Reset()
"`tAfter Reset: $input"
}
}
"one","two" | Test
Iteration: 0
Input: one
Access Again:
After Reset: one
Iteration: 1
Input: two
Access Again:
After Reset: two
İşlem bloğu, siz erişmeseniz bile değişkeni otomatik olarak ilerletir $input
.
$skip = $true
function Skip
{
begin
{
$i = 0
}
process
{
"Iteration: $i"
$i++
if ($skip)
{
"`tSkipping"
$skip = $false
}
else
{
"`tInput: $input"
}
}
}
"one","two" | Skip
Iteration: 0
Skipping
Iteration: 1
Input: two
Örnek 2: İşlem bloğunun dışında $input kullanma
İşlem bloğunun $input
dışında değişken, işleve yöneltilen tüm değerleri temsil eder.
- değişkenine
$input
erişmek tüm değerleri temizler. - yöntemi koleksiyonun Reset tamamını sıfırlar.
- Current Özelliği hiçbir zaman doldurulmaz.
- Koleksiyon gelişmiş olmadığından MoveNext yöntemi false döndürür.
- MoveNext çağrısı değişkeni temizler
$input
.
- MoveNext çağrısı değişkeni temizler
Function All
{
"All Values: $input"
"Access Again: $input"
$input.Reset()
"After Reset: $input"
$input.MoveNext() | Out-Null
"After MoveNext: $input"
}
"one","two","three" | All
All Values: one two three
Access Again:
After Reset: one two three
After MoveNext:
Örnek 3: $input kullanma.Current Özellik
Current özelliğiyle, geçerli işlem hattı değerine yöntemi kullanılmadan Reset birden çok kez erişilebilir. İşlem bloğu MoveNext yöntemini otomatik olarak çağırmaz.
CurrentMoveNext'i açıkça çağırmadığınız sürece özellik hiçbir zaman doldurulmaz. özelliğine Current işlem bloğunun içinde değerini temizlemeden birden çok kez erişilebilir.
function Current
{
begin
{
$i = 0
}
process
{
"Iteration: $i"
$i++
"`tBefore MoveNext: $($input.Current)"
$input.MoveNext() | Out-Null
"`tAfter MoveNext: $($input.Current)"
"`tAccess Again: $($input.Current)"
}
}
"one","two" | Current
Iteration: 0
Before MoveNext:
After MoveNext: one
Access Again: one
Iteration: 1
Before MoveNext:
After MoveNext: two
Access Again: two
Örnek 4: $foreach değişkenini kullanma
değişkeninin $input
aksine, $foreach
değişkeni her zaman doğrudan erişildiğinde koleksiyondaki tüm öğeleri temsil eder. Current Geçerli koleksiyon öğesine erişmek için özelliğini ve Reset değerini değiştirmek için ve MoveNext yöntemlerini kullanın.
Not
Döngünün foreach
her yinelemesi otomatik olarak MoveNext yöntemini çağırır.
Aşağıdaki döngü yalnızca iki kez yürütülür. İkinci yinelemede, yineleme tamamlanmadan önce koleksiyon üçüncü öğeye taşınır. İkinci yinelemeden sonra, artık yinelenmek için başka değer yoktur ve döngü sonlandırılır.
MoveNext özelliği, koleksiyon ()$Num
aracılığıyla yinelemek için seçilen değişkeni etkilemez.
$i = 0
foreach ($num in ("one","two","three"))
{
"Iteration: $i"
$i++
"`tNum: $num"
"`tCurrent: $($foreach.Current)"
if ($foreach.Current -eq "two")
{
"Before MoveNext (Current): $($foreach.Current)"
$foreach.MoveNext() | Out-Null
"After MoveNext (Current): $($foreach.Current)"
"Num hasn't changed: $num"
}
}
Iteration: 0
Num: one
Current: one
Iteration: 1
Num: two
Current: two
Before MoveNext (Current): two
After MoveNext (Current): three
Num hasn't changed: two
yöntemi kullanıldığında Reset koleksiyondaki geçerli öğe sıfırlanır. Aşağıdaki örnek, yöntemi çağrıldığından ilk iki öğede Resetiki kez döngü yapar. İlk iki döngüden if
sonra deyimi başarısız olur ve döngü her üç öğede de normal olarak yinelenir.
Önemli
Bu, sonsuz döngüye neden olabilir.
$stopLoop = 0
foreach ($num in ("one","two", "three"))
{
("`t" * $stopLoop) + "Current: $($foreach.Current)"
if ($num -eq "two" -and $stopLoop -lt 2)
{
$foreach.Reset() | Out-Null
("`t" * $stopLoop) + "Reset Loop: $stopLoop"
$stopLoop++
}
}
Current: one
Current: two
Reset Loop: 0
Current: one
Current: two
Reset Loop: 1
Current: one
Current: two
Current: three
Örnek 5: $switch değişkenini kullanma
değişkeni, $switch
değişkeniyle tam olarak aynı kurallara $foreach
sahiptir. Aşağıdaki örnekte tüm numaralandırıcı kavramları gösterilmektedir.
Not
MoveNext yönteminden sonra deyimi olmasa break
bile NotEvaluated olayının hiçbir zaman yürütülmediğine dikkat edin.
$values = "Start", "MoveNext", "NotEvaluated", "Reset", "End"
$stopInfinite = $false
switch ($values)
{
"MoveNext" {
"`tMoveNext"
$switch.MoveNext() | Out-Null
"`tAfter MoveNext: $($switch.Current)"
}
# This case is never evaluated.
"NotEvaluated" {
"`tAfterMoveNext: $($switch.Current)"
}
"Reset" {
if (!$stopInfinite)
{
"`tReset"
$switch.Reset()
$stopInfinite = $true
}
}
default {
"Default (Current): $($switch.Current)"
}
}
Default (Current): Start
MoveNext
After MoveNext: NotEvaluated
Reset
Default (Current): Start
MoveNext
After MoveNext: NotEvaluated
Default (Current): End