about_Language_Keywords

  • Cikk

Rövid leírás

A PowerShell szkriptelési nyelvének kulcsszavai.

Hosszú leírás

A PowerShell a következő nyelvi kulcsszavakat tartalmazza. További információkért tekintse meg a kulcsszóval kapcsolatos témakört és a táblázatot követő információkat.

Kulcsszó Referencia
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 Jövőbeli használatra fenntartva
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 Ebben a témakörben leírtak
filter about_Functions
finally about_Try_Catch_Finally
for about_For
foreach about_ForEach
from Jövőbeli használatra fenntartva
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 Jövőbeli használatra fenntartva
while about_While, about_Do

A PowerShell-munkafolyamatok a következő kulcsszavakat használják:

  • inlinescript
  • parallel
  • sequence
  • workflow

A PowerShell-munkafolyamatok csak a PowerShell 5.1-ben támogatottak. A munkafolyamatokkal kapcsolatos további információkért lásd : PowerShell-parancsok futtatása munkafolyamatokban.

begin

A függvény törzsének egy részét adja meg a , processés end a dynamicparamkulcsszavakkal együtt. Az begin utasításlista egy alkalommal fut, mielőtt bármilyen objektumot megkap a folyamat.

Szintaxis:

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

break

Egy szkript kilép egy ciklusból.

Szintaxis:

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

   break
   ...

   <statements>
}

catch

Megadja a futtatandó utasításlistát, ha hiba történik a kísérő try utasításlistában. Egy hibatípushoz szögletes zárójelek szükségesek. A második zárójelpár azt jelzi, hogy a hiba típusa nem kötelező.

Szintaxis:

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

class

Új osztályt ad meg a PowerShellben.

Szintaxis:

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

continue

Egy szkript leállítja a ciklus futtatását, és visszalép a feltételhez. Ha a feltétel teljesül, a szkript újra elindítja a ciklust.

Szintaxis:

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

   continue
   ...

   <statements>
}

data

Egy szkriptben definiál egy szakaszt, amely elkülöníti az adatokat a szkriptlogikától. Utasításokat és korlátozott parancsokat is tartalmazhat if .

Szintaxis:

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

do

A kulcsszóval whileuntil ciklusszerkezetként használható. A PowerShell legalább egyszer futtatja az utasításlistát, ellentétben a használt whileciklusokkal.

Szintaxis:while

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

Szintaxis:until

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

dynamicparam

A függvény törzsének egy részét adja meg a , processés end a beginkulcsszavakkal együtt. A rendszer futásidőben dinamikus paramétereket ad hozzá.

Szintaxis:

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

else

A kulcsszóval if együtt az alapértelmezett utasításlista megadására szolgál.

Szintaxis:

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

elseif

További feltételes feltételek megadására használható a if kulcsszavakkal együtt else . A else kulcsszó nem kötelező.

Szintaxis:

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

end

A függvény törzsének egy részét adja meg a , beginés end a dynamicparamkulcsszavakkal együtt. Az end utasításlista egyszer fut, miután az összes objektum megérkezett a folyamatból.

Szintaxis:

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

enum

enum enumerálás deklarálására szolgál; egy különálló típus, amely nevesített címkékből, úgynevezett enumerátorlistából áll.

Szintaxis:

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

exit

Emiatt a PowerShell kilép egy szkriptből vagy egy PowerShell-példányból.

Szintaxis:

exit
exit <exitcode>

Ha a Fájl paraméterrel használjapwsh, a .ps1 (szkript) fájlnak tartalmaznia kell a szkript futtatása során előforduló hibák és kivételek kezelésére vonatkozó utasításokat. Az utasítást csak a exit szkript végrehajtás utáni állapotának jelzésére használhatja.

Windows rendszeren bármilyen szám [int]::MinValue engedélyezett és [int]::MaxValue engedélyezett.

A Unix-on csak pozitív számok [byte]::MinValue használhatók és [byte]::MaxValue engedélyezettek. A tartomány negatív száma -1-255 automatikusan pozitív számmá lesz lefordítva 256 hozzáadásával. Például -2 át lesz alakítva a következővé 254: .

A PowerShellben az exit utasítás beállítja a $LASTEXITCODE változó értékét. A Windows Command Shellben (cmd.exe) a kilépési utasítás beállítja a %ERRORLEVEL% környezeti változó értékét.

A nem numerikus vagy a platformspecifikus tartományon kívüli argumentumok a következő értékre 0lesznek lefordítva: .

Az alábbi példában a felhasználó a hibaszintű változó értékét 4-es értékre állítja a szkriptfájlhoz test.ps1való hozzáadássalexit 4.

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

Amikor fut pwsh.exe -File <path to a script> , és a szkriptfájl egy exit paranccsal leáll, a kilépési kód a parancshoz exit használt numerikus argumentumra van állítva. Ha a szkript nem exit rendelkezik utasítással, a kilépési kód mindig 0 akkor jelenik meg, ha a szkript hiba nélkül befejeződik, vagy 1 ha a szkript nem kezelt kivételből áll le.

filter

Olyan függvényt ad meg, amelyben az utasításlista minden bemeneti objektumhoz egyszer fut. Ugyanaz a hatása, mint egy olyan függvénynek, amely csak egy blokkot process tartalmaz.

Szintaxis:

filter <name> {<statement list>}

finally

Olyan utasításlistát határoz meg, amely a következőhöz társított trycatchutasítások után fut: Az finally utasításlista akkor is lefut, ha a CTRL C billentyűkombinációt+lenyomva hagyja el a szkriptet, vagy ha a kulcsszót exit használja a szkriptben.

Szintaxis:

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

for

Egy feltétellel rendelkező hurkot határoz meg.

Szintaxis:

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

foreach

Egy hurok definiálása a gyűjtemény minden egyes tagját használva.

Szintaxis:

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

from

Jövőbeli használatra fenntartva.

function

Létrehoz egy elnevezett utasításlistát az újrahasználható kódról. Elnevheti azt a hatókört, amelyhez egy függvény tartozik. A kulcsszóval param egy vagy több elnevezett paramétert is megadhat. A függvényutasítások listájában szerepelhetnek dynamicparama , begin, processés end az utasításlisták.

Szintaxis:

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

A függvény neve után egy vagy több paramétert is megadhat az utasításlistán kívül.

Szintaxis:

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

if

Feltételes feltételt határoz meg.

Szintaxis:

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

hidden

Elrejti az osztálytagokat a parancsmag, az IntelliSense és a Get-Member lapkiegészítési eredmények alapértelmezett eredményei elől.

Szintaxis:

hidden [data type] $member_name

in

Egy utasításban foreach egy gyűjtemény minden tagját használó hurkot hoz létre.

Szintaxis:

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

param

Meghatározza a függvény paramétereit.

Szintaxis:

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

process

A függvény törzsének egy részét adja meg a , beginés end a dynamicparamkulcsszavakkal együtt. Amikor egy utasításlista bemenetet process kap a folyamatból, az process utasításlista a folyamat minden eleméhez egyszer fut. Ha a folyamat nem biztosít objektumokat, az process utasításlista nem fut. Ha a parancs a folyamat első parancsa, az process utasításlista egyszer fut.

Szintaxis:

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

return

A PowerShell elhagyja az aktuális hatókört, például egy szkriptet vagy függvényt, és a kimenetbe írja az opcionális kifejezést.

Szintaxis:

return [<expression>]

static

Meghatározza a definiált tulajdonságot vagy metódust annak az osztálynak az összes példánya esetében, amelyben definiálva van.

Lásd class a használati példákat.

switch

Több feltétel ellenőrzéséhez használjon utasítást switch . Az switch utasítás egyenértékű egy if sor utasítással, de egyszerűbb.

Az switch utasítás felsorolja az egyes feltételeket és egy választható műveletet. Ha egy feltétel beolvas, a művelet végrehajtása történik.

1. szintaxis:

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

   default {<statement list>}
}

2. szintaxis:

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

   default {<statement list>}
}

throw

Hibaként dob egy objektumot.

Szintaxis:

throw [<object>]

trap

Egy hiba esetén futtatandó utasításlistát határoz meg. Egy hibatípushoz szögletes zárójelek szükségesek. A második zárójelpár azt jelzi, hogy a hiba típusa nem kötelező.

Szintaxis:

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

try

Meghatározza a hibák ellenőrzésére szolgáló utasításlistát az utasítások futtatása során. Hiba esetén a PowerShell továbbra is fut egy vagy finally több catch utasításban. Egy hibatípushoz szögletes zárójelek szükségesek. A második zárójelpár azt jelzi, hogy a hiba típusa nem kötelező.

Szintaxis:

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

until

Az utasításban do ciklusszerkezetként használatos, ahol az utasításlista végrehajtása legalább egyszer történik.

Szintaxis:

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

using

Lehetővé teszi, hogy jelezze, mely névtereket használja a munkamenet. Írja be a neveket, az osztályokat és a tagokat, hogy kevesebb gépeléssel hivatkozzon rájuk. A modulok osztályai is felvehetők.

Névtér szintaxisa:

using namespace <.Net-namespace>

Modul szintaxisa:

using module <module-name>

Szerelvény szintaxisa:

using assembly <.NET-assembly-path>

További információ: about_Using.

while

Az while utasítás egy hurokszerkezet, amelyben a feltételt az utasítások végrehajtása előtt teszteli a rendszer. Ha a feltétel hamis, akkor az utasítások nem lesznek végrehajtva.

Utasítás szintaxisa:

while (<condition>) {
   <statements>
 }

Ha utasításban do használják, egy olyan ciklusszerkezet része, while amelyben az utasításlista végrehajtása legalább egyszer történik.

do hurok szintaxisa:

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

Lásd még