o_jazyku_klíčová_slova

Krátký popis

Popisuje klíčová slova ve skriptovacím jazyce PowerShellu.

Dlouhý popis

PowerShell má následující klíčová slova jazyka. Další informace najdete v tématu věnovaném klíčovému slovu a informacím, které následuje za tabulkou.

Klíčové slovo	Odkaz
begin	about_Functions, about_Functions_Advanced
break	about_Break, about_Trap
catch	about_Try_Catch_Finally
class	about_Classes
clean	o_Funkcích, o_Funkcích_Rozšířené_Metody
continue	about_Continue, about_Trap
data	o_datových_sekcích
define	Vyhrazeno pro budoucí použití
do	about_Do, about_While
dynamicparam	about_Functions_Advanced_Parameters
else	about_If
elseif	about_If
end	o_Funkcích, o_Funkcích_Rozšířené_Metody
enum	about_Enum
exit	popsané v tomto tématu
filter	o_funkcích
finally	about_Try_Catch_Finally
for	about_For
foreach	about_Foreach
from	Vyhrazeno pro budoucí použití
function	about_Functions, about_Functions_Advanced
hidden	about_Hidden
if	about_If
in	about_Foreach
param	o_funkcích
process	about_Functions, about_Functions_Advanced
return	o_Návratu
static	about_Classes
switch	about_Switch
throw	o_Throw, o_Funkce_Pokročilé_Metody
trap	about_Trap, about_Break, about_Try_Catch_Finally
try	about_Try_Catch_Finally
until	o_Do
using	o_Použití, o_Třídách
var	Vyhrazeno pro budoucí použití
while	about_While, about_Do

Pracovní postupy PowerShellu používají následující klíčová slova:

• inlinescript
• parallel
• sequence
• workflow

Pracovní postupy PowerShellu se podporují jenom v PowerShellu 5.1. Další informace o pracovních postupech naleznete v tématu Spouštění příkazů PowerShellu v pracovním postupu.

begin

Určuje jednu část těla funkce spolu s klíčovými slovy dynamicparam, processa end. Seznam příkazů begin se spustí jednou, než se z kanálu přijme jakýkoli objekt.

Syntax:

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

break

Způsobí, že skript ukončí smyčku.

Syntax:

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

   break
   ...

   <statements>
}

catch

Určuje seznam příkazů, který se má spustit, pokud dojde k chybě v doprovodném seznamu příkazů try. Typ chyby vyžaduje hranaté závorky. Druhá dvojice závorek označuje, že typ chyby je volitelný.

Syntax:

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

class

Určuje novou třídu v PowerShellu.

Syntax:

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

clean

Klíčové slovo clean bylo přidáno v PowerShellu 7.3. Klíčové slovo definuje blok kódu, který se zaručeně spustí po blocích begin, process a end funkce. Na rozdíl od end bloku se blok clean vždy spustí, i když dojde k ukončovací chybě v jednom z ostatních bloků.

continue

Způsobí, že skript přestane spouštět smyčku a vrátí se k podmínce. Pokud je podmínka splněna, skript znovu spustí smyčku.

Syntax:

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

   continue
   ...

   <statements>
}

data

Ve skriptu definuje oddíl, který izoluje data od logiky skriptu. Může také zahrnovat příkazy if a některé omezené příkazy.

Syntax:

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

do

Používá se s klíčovým slovem while nebo until jako konstrukce smyčky. PowerShell spustí seznam příkazů alespoň jednou, na rozdíl od cyklu s podmínkou, který používá while.

Syntaxe pro while:

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

Syntaxe pro until:

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

dynamicparam

Určuje jednu část těla funkce spolu s klíčovými slovy begin, processa end. Dynamické parametry se přidávají za běhu.

Syntax:

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

else

Používá se s klíčovým slovem if k určení výchozího seznamu příkazů.

Syntax:

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

elseif

Používá se s klíčovými slovy if a else k určení dalších podmíněných výrazů. Klíčové slovo else je volitelné.

Syntax:

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

end

Určuje jednu část těla funkce spolu s klíčovými slovy dynamicparam, begina end. Seznam příkazů end se spustí jednou poté, co byly všechny objekty přijaty z potrubí.

Syntax:

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

enum

enum slouží k deklaraci výčtu; jedinečný typ, který se skládá ze sady pojmenovaných popisků označovaných jako seznam enumerátoru.

Syntax:

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

exit

Způsobí, že PowerShell ukončí skript nebo instanci PowerShellu.

Syntax:

exit
exit <exitcode>

Pokud použijete pwsh s parametrem File, měl by samotný soubor .ps1 (skript) obsahovat pokyny pro zpracování chyb nebo výjimek, ke kterým dochází při spuštění skriptu. Příkaz exit byste měli použít pouze k označení stavu po spuštění skriptu.

Ve Windows je povolené libovolné číslo mezi [int]::MinValue a [int]::MaxValue.

V unixu jsou povolena pouze kladná čísla mezi [byte]::MinValue a [byte]::MaxValue. Záporné číslo v rozsahu -1 až -255 se automaticky přeloží na kladné číslo přidáním čísla 256. Například -2 se transformuje na 254.

V PowerShellu nastaví příkaz exit hodnotu proměnné $LASTEXITCODE. V prostředí Windows Command Shell (cmd.exe) nastaví příkaz exit hodnotu proměnné prostředí %ERRORLEVEL%.

Jakýkoli argument, který není číselný nebo mimo rozsah specifický pro platformu, se přeloží na hodnotu 0.

V následujícím příkladu uživatel nastaví hodnotu proměnné na úrovni chyby na 4 přidáním exit 4 do souboru skriptu test.ps1.

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

Když spustíte pwsh.exe -File <path to a script> a soubor skriptu se ukončí příkazem exit, ukončovací kód se nastaví na číselný argument použitý s příkazem exit. Pokud skript nemá prohlášení exit, ukončovací kód je vždy 0, když skript dokončí bez chyby, nebo 1, když se skript ukončí v důsledku neošetřené výjimky.

filter

Určuje funkci, ve které se seznam příkazů spouští jednou pro každý vstupní objekt. Má stejný účinek jako funkce, která obsahuje pouze blok process.

Syntax:

filter <name> {<statement list>}

finally

Definuje seznam příkazů, který se spouští po příkazech přidružených k try a catch. Seznam příkazů finally se spustí i v případě, že stisknete klávesu CTRL+C opustíte skript nebo použijete klíčové slovo exit ve skriptu.

Syntax:

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

for

Definuje smyčku s podmínkou.

Syntax:

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

foreach

Definuje smyčku pro každý prvek kolekce.

Syntax:

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

from

Vyhrazeno pro budoucí použití.

function

Vytvoří pojmenovaný seznam příkazů opakovaně použitelného kódu. Můžete pojmenovat obor, ke kterému funkce patří. Pomocí klíčového slova param můžete také zadat jeden nebo více pojmenovaných parametrů. V seznamu příkazů funkce můžete zahrnout seznamy příkazů dynamicparam, begin, processa end.

Syntax:

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

Máte také možnost definovat jeden nebo více parametrů mimo seznam příkazů za názvem funkce.

Syntax:

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

if

Definuje podmínku.

Syntax:

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

hidden

Skryje členy třídy z výchozích výsledků Get-Member rutiny, IntelliSense a výsledků dokončování tabulátoru.

Syntax:

hidden [data type] $member_name

in

Používá se v příkazu foreach k vytvoření smyčky, která používá každého člena kolekce.

Syntax:

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

param

Definuje parametry ve funkci.

Syntax:

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

process

Určuje část těla funkce spolu s klíčovými slovy dynamicparam, begina end. Když seznam příkazů process obdrží vstup z kanálu, spustí se seznam příkazů process jednou pro každý prvek z kanálu. Pokud potrubí neobsahuje žádné objekty, seznam příkazů process se nespustí. Pokud je příkaz prvním příkazem v potrubí, příkazový seznam process se spustí jednou.

Syntax:

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

return

Způsobí, že PowerShell ponechá aktuální obor, například skript nebo funkci, a zapíše volitelný výraz do výstupu.

Syntax:

return [<expression>]

static

Určuje vlastnost nebo metodu definovanou je společná pro všechny instance třídy, ve které je definována.

Příklady použití najdete v class.

switch

Pokud chcete zkontrolovat více podmínek, použijte příkaz switch. Příkaz switch je ekvivalentní řadě příkazů if, ale je jednodušší.

Příkaz switch uvádí jednotlivé podmínky a volitelnou akci. Pokud podmínka nastane, akce se provede.

Syntaxe 1:

switch [-Regex|-Wildcard|-Exact][-CaseSensitive] ( <value> )
{
   <string>|<number>|<variable>|{ <expression> } {<statement list>}
   <string>|<number>|<variable>|{ <expression> } {<statement list>}
   ...

   default {<statement list>}
}

Syntaxe 2:

switch [-Regex|-Wildcard|-Exact][-CaseSensitive] -File <filename>
{
   <string>|<number>|<variable>|{ <expression> } {<statement list>}
   <string>|<number>|<variable>|{ <expression> } {<statement list>}
   ...

   default {<statement list>}
}

throw

Vyhazuje objekt jako chybu.

Syntax:

throw [<object>]

trap

Definuje seznam příkazů, který se má spustit, pokud dojde k chybě. Typ chyby vyžaduje hranaté závorky. Druhá dvojice závorek označuje, že typ chyby je volitelný.

Syntax:

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

try

Definuje seznam příkazů, u kterých se mají kontrolovat chyby při spuštění příkazů. Pokud v PowerShellu dojde k chybě, pokračuje v příkazu catch nebo finally. Typ chyby vyžaduje hranaté závorky. Druhá dvojice závorek označuje, že typ chyby je volitelný.

Syntax:

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

until

Používá se v příkazu do jako konstruktor smyčky, kde se seznam příkazů spouští alespoň jednou.

Syntax:

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

using

Umožňuje určit, které obory názvů se v relaci používají. Názvy, třídy a členy typu vyžadují, aby se na ně odkazovaly méně. Můžete také zahrnout třídy z modulů.

Syntaxe oboru názvů:

using namespace <.NET-namespace>

Syntaxe modulu:

using module <module-name>

Syntaxe sestavení:

using assembly <.NET-assembly-path>

Pro více informací viz about_Using.

while

Příkaz while je smyčková konstrukce, ve které se podmínka testuje před provedením příkazů. Pokud je podmínka nepravdivá, příkazy se nespustí.

Syntaxe příkazu:

while (<condition>) {
   <statements>
 }

Při použití v příkazu do je while součástí smyčky, ve které je seznam příkazů spuštěn alespoň jednou.

Syntaxe smyčky do:

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

Viz také

• o_speciálních_znacích
• o_zástupných_znacích