about_Language_Keywords

  • Makale

Kısa açıklama

PowerShell betik dilindeki anahtar sözcükleri açıklar.

Uzun açıklama

PowerShell'de aşağıdaki dil anahtar sözcükleri bulunur. Daha fazla bilgi için anahtar sözcüğün hakkında konusuna ve tabloyu izleyen bilgilere bakın.

Anahtar sözcük Başvuru
begin about_Functions, about_Functions_Advanced
break about_Break, about_Trap
catch about_Try_Catch_Finally
class about_Classes
continue about_Continue, about_Trap
data about_Data_Sections
define Gelecekte kullanılmak üzere ayrılmıştır
do about_Do, about_While
dynamicparam about_Functions_Advanced_Parameters
else about_If
elseif about_If
end about_Functions, about_Functions_Advanced_Methods
enum about_Enum
exit Bu konu başlığında açıklanmıştır
filter about_Functions
finally about_Try_Catch_Finally
for about_For
foreach about_ForEach
from Gelecekte kullanılmak üzere ayrılmıştır
function about_Functions, about_Functions_Advanced
hidden about_Hidden
if about_If
in about_ForEach
param about_Functions
process about_Functions, about_Functions_Advanced
return about_Return
static about_Classes
switch about_Switch
throw about_Throw, about_Functions_Advanced_Methods
trap about_Trap, about_Break, about_Try_Catch_Finally
try about_Try_Catch_Finally
until about_Do
using about_Using, about_Classes
var Gelecekte kullanılmak üzere ayrılmıştır
while about_While, about_Do

Aşağıdaki anahtar sözcükler PowerShell iş akışları tarafından kullanılır:

  • inlinescript
  • parallel
  • sequence
  • workflow

PowerShell iş akışları yalnızca PowerShell 5.1'de desteklenir. İş akışları hakkında daha fazla bilgi için bkz . İş Akışında PowerShell Komutlarını Çalıştırma.

begin

bir işlevin gövdesinin bir bölümünü, ile birlikte dynamicparam, processve end anahtar sözcüklerini belirtir. deyim begin listesi, işlem hattından herhangi bir nesne alınmadan önce bir kez çalışır.

Söz dizimi:

function <name> {
    dynamicparam {<statement list>}
    begin {<statement list>}
    process {<statement list>}
    end {<statement list>}
}

break

Bir betiğin döngüden çıkmasına neden olur.

Söz dizimi:

while (<condition>) {
   <statements>
   ...

   break
   ...

   <statements>
}

catch

Eşlik try eden deyim listesinde bir hata oluşursa çalıştırılacak bir deyim listesi belirtir. Hata türü için köşeli ayraç gerekir. İkinci köşeli ayraç çifti, hata türünün isteğe bağlı olduğunu gösterir.

Söz dizimi:

try {<statement list>}
catch [[<error type>]] {<statement list>}

class

PowerShell'de yeni bir sınıf belirtir.

Söz dizimi:

class <class-name> {
    [[hidden] [static] <property-definition> ...]
    [<class-name>([argument-list>]) {<constructor-statement-list>} ...]
    [[hidden] [static] <method-definition> ...]
}

continue

Bir betiğin döngü çalıştırmayı durdurmasına ve koşula geri dönmesine neden olur. Koşul karşılanırsa betik döngüye yeniden başlar.

Söz dizimi:

while (<condition>) {
   <statements>
   ...

   continue
   ...

   <statements>
}

data

Betikte, verileri betik mantığından yalıtan bir bölüm tanımlar. Deyimleri ve bazı sınırlı komutları da içerebilir if .

Söz dizimi:

data <variable> [-supportedCommand <cmdlet-name>] {<permitted content>}

do

Döngü yapısı olarak veya until anahtar sözcüğüyle birlikte while kullanılır. PowerShell, kullanan whilebir döngüden farklı olarak deyim listesini en az bir kez çalıştırır.

için whilesöz dizimi:

do {<statement list>} while (<condition>)

için untilsöz dizimi:

do {<statement list>} until (<condition>)

dynamicparam

bir işlevin gövdesinin bir bölümünü, ile birlikte begin, processve end anahtar sözcüklerini belirtir. Dinamik parametreler çalışma zamanında eklenir.

Söz dizimi:

function <name> {
   dynamicparam {<statement list>}
   begin {<statement list>}
   process {<statement list>}
   end {<statement list>}
}

else

Varsayılan deyim listesini belirtmek için anahtar sözcüğüyle birlikte if kullanılır.

Söz dizimi:

if (<condition>) {<statement list>}
else {<statement list>}

elseif

Ek koşulluları belirtmek için ve else anahtar sözcükleriyle birlikte if kullanılır. anahtar else sözcüğü isteğe bağlıdır.

Söz dizimi:

if (<condition>) {<statement list>}
elseif (<condition>) {<statement list>}
else {<statement list>}

end

bir işlevin gövdesinin bir bölümünü, ile birlikte dynamicparam, beginve end anahtar sözcüklerini belirtir. deyim end listesi, tüm nesneler işlem hattından alındıktan sonra bir kez çalışır.

Söz dizimi:

function <name> {
   dynamicparam {<statement list>}
   begin {<statement list>}
   process {<statement list>}
   end {<statement list>}
}

enum

enum bir sabit listesi bildirmek için kullanılır; numaralandırıcı listesi olarak adlandırılan adlandırılmış etiketler kümesinden oluşan ayrı bir tür.

Söz dizimi:

enum <enum-name> {
    <label> [= <int-value>]
    ...
}

exit

PowerShell'in bir betik veya PowerShell örneğinden çıkmasına neden olur.

Söz dizimi:

exit
exit <exitcode>

Dosya parametresiyle kullandığınızdapwsh, (betik) dosyasının .ps1 kendisi betik çalışırken oluşan hataları veya özel durumları işlemeye yönelik yönergeler içermelidir. deyimini exit yalnızca betiğin yürütme sonrası durumunu belirtmek için kullanmanız gerekir.

Windows'ta ve arasında [int]::MinValue[int]::MaxValue herhangi bir sayıya izin verilir.

Unix'te, ve [byte]::MaxValue arasında [byte]::MinValue yalnızca pozitif sayılara izin verilir. ile -255 aralığındaki -1 negatif bir sayı, 256 eklenerek otomatik olarak pozitif bir sayıya çevrilir. Örneğin, -2 olarak 254dönüştürülür.

PowerShell'de exit deyimi değişkeninin $LASTEXITCODE değerini ayarlar. Windows Komut Kabuğu'nda (cmd.exe ), exit deyimi ortam değişkeninin %ERRORLEVEL% değerini ayarlar.

Sayısal olmayan veya platforma özgü aralığın dışında olan tüm bağımsız değişkenler değerine çevrilir 0.

Aşağıdaki örnekte kullanıcı, betik dosyasına test.ps1ekleyerek exit 4 hata düzeyi değişken değerini 4 olarak ayarlar.

C:\scripts\test>type test.ps1
1
2
3
exit 4

C:\scripts\test>pwsh -file ./test.ps1
1
2
3

C:\scripts\test>echo %ERRORLEVEL%
4

Çalıştırdığınızda pwsh.exe -File <path to a script> ve betik dosyası bir exit komutla sonlandırıldığında, çıkış kodu komutuyla kullanılan sayısal bağımsız değişkene exit ayarlanır. Betiğin deyimi yoksa exit , çıkış kodu her zaman 0 betik hatasız tamamlandığında veya 1 betik işlenmeyen bir özel durumdan sonlandırıldığında olur.

filter

Her giriş nesnesi için deyim listesinin bir kez çalıştırıldığı bir işlev belirtir. Yalnızca process bir blok içeren bir işlevle aynı etkiye sahiptir.

Söz dizimi:

filter <name> {<statement list>}

finally

ve catchile try ilişkilendirilmiş deyimlerden sonra çalışan bir deyim listesi tanımlar. Bir finally betik bırakmak için CTRL+C tuşuna bassanız veya betikte anahtar sözcüğünü exit kullanıyor olsanız bile bir deyim listesi çalışır.

Söz dizimi:

try {<statement list>}
catch [<error type>] {<statement list>}
finally {<statement list>}

for

Bir koşula sahip bir döngü tanımlar.

Söz dizimi:

for (<initialize>; <condition>; <iterate>) { <statement list> }

foreach

Bir koleksiyonun her üyesini kullanarak bir döngü tanımlar.

Söz dizimi:

foreach (<item> in <collection>) { <statement list> }

from

Daha sonraki kullanımlar için ayrılmıştır.

function

Yeniden kullanılabilir kodun adlandırılmış bir deyim listesini oluşturur. Bir işlevin ait olduğu kapsamı adlandırabilirsiniz. Anahtar sözcüğünü kullanarak param bir veya daha fazla adlandırılmış parametre de belirtebilirsiniz. İşlev deyimi listesinde , , beginprocessve end deyim listelerini ekleyebilirsinizdynamicparam.

Söz dizimi:

function [<scope:>]<name> {
   param ([type]<$pname1> [, [type]<$pname2>])
   dynamicparam {<statement list>}
   begin {<statement list>}
   process {<statement list>}
   end {<statement list>}
}

İşlev adından sonra deyim listesinin dışında bir veya daha fazla parametre tanımlama seçeneğiniz de vardır.

Söz dizimi:

function [<scope:>]<name> [([type]<$pname1>, [[type]<$pname2>])] {
   dynamicparam {<statement list>}
   begin {<statement list>}
   process {<statement list>}
   end {<statement list>}
}

if

Bir koşullu tanımlar.

Söz dizimi:

if (<condition>) {<statement list>}

hidden

Sınıf üyelerini cmdlet, IntelliSense ve sekme tamamlama sonuçlarının Get-Member varsayılan sonuçlarından gizler.

Söz dizimi:

hidden [data type] $member_name

in

Bir foreach koleksiyonun her üyesini kullanan bir döngü oluşturmak için deyiminde kullanılır.

Söz dizimi:

foreach (<item> in <collection>){<statement list>}

param

İşlevdeki parametreleri tanımlar.

Söz dizimi:

function [<scope:>]<name> {
   param ([type]<$pname1>[, [[type]<$pname2>]])
   <statement list>
}

process

, ve end anahtar sözcükleriyle birlikte bir işlevin gövdesinin dynamicparambeginbir bölümünü belirtir. Bir process deyim listesi işlem hattından giriş aldığında, process deyim listesi işlem hattındaki her öğe için bir kez çalışır. İşlem hattı hiçbir nesne sağlamazsa, process deyim listesi çalışmaz. komut işlem hattındaki ilk komutsa, process deyim listesi bir kez çalışır.

Söz dizimi:

function <name> {
   dynamicparam {<statement list>}
   begin {<statement list>}
   process {<statement list>}
   end {<statement list>}
}

return

PowerShell'in betik veya işlev gibi geçerli kapsamı bırakmasına neden olur ve isteğe bağlı ifadeyi çıkışa yazar.

Söz dizimi:

return [<expression>]

static

Tanımlanan özelliğin veya yöntemin, tanımlandığı sınıfın tüm örnekleri için ortak olduğunu belirtir.

Kullanım örnekleri için bkz class .

switch

Birden çok koşulu denetlemek için deyimini switch kullanın. deyimi switch bir dizi if deyimle eşdeğerdir, ancak daha basittir.

deyimi her switch koşulu ve isteğe bağlı eylemi listeler. Bir koşul elde edilirse, eylem gerçekleştirilir.

Söz dizimi 1:

switch [-regex|-wildcard|-exact][-casesensitive] ( <value> )
{
   <string>|<number>|<variable>|{ <expression> } {<statement list>}
   <string>|<number>|<variable>|{ <expression> } {<statement list>}
   ...

   default {<statement list>}
}

Söz dizimi 2:

switch [-regex|-wildcard|-exact][-casesensitive] -file <filename>
{
   <string>|<number>|<variable>|{ <expression> } {<statement list>}
   <string>|<number>|<variable>|{ <expression> } {<statement list>}
   ...

   default {<statement list>}
}

throw

Bir nesneyi hata olarak atar.

Söz dizimi:

throw [<object>]

trap

Hatayla karşılaşılırsa çalıştırılacak bir deyim listesi tanımlar. Hata türü için köşeli ayraç gerekir. İkinci köşeli ayraç çifti, hata türünün isteğe bağlı olduğunu gösterir.

Söz dizimi:

trap [[<error type>]] {<statement list>}

try

Deyimler çalışırken hatalar için denetlenecek bir deyim listesi tanımlar. Hata oluşursa, PowerShell bir catch veya finally deyiminde çalışmaya devam eder. Hata türü için köşeli ayraç gerekir. İkinci köşeli ayraç çifti, hata türünün isteğe bağlı olduğunu gösterir.

Söz dizimi:

try {<statement list>}
catch [[<error type>]] {<statement list>}
finally {<statement list>}

until

Deyim listesinin en az bir kez yürütüldüğü döngü yapısı olarak deyiminde do kullanılır.

Söz dizimi:

do {<statement list>} until (<condition>)

using

Oturumda hangi ad alanlarının kullanıldığını belirtmenizi sağlar. Tür adları, sınıflar ve üyelere başvurmak için daha az yazmanız gerekir. Ayrıca modüllerden sınıflar da ekleyebilirsiniz.

Ad alanı söz dizimi:

using namespace <.Net-namespace>

Modül söz dizimi:

using module <module-name>

Derleme söz dizimi:

using assembly <.NET-assembly-path>

Daha fazla bilgi için bkz . about_Using.

while

deyimi while , deyimleri yürütülmeden önce koşulun test edildiği bir döngü yapısıdır. Koşul false ise deyimleri yürütülmemektedir.

Deyim söz dizimi:

while (<condition>) {
   <statements>
 }

Deyiminde do kullanıldığında, while deyim listesinin en az bir kez yürütüldüğü döngü oluşturma yapısının bir parçasıdır.

do döngü Sözdizimi:

do {<statement list>} while (<condition>)

Ayrıca bkz.