about_Language_Keywords

  • Artykuł

Krótki opis

Opisuje słowa kluczowe w języku skryptów programu PowerShell.

Długi opis

Program PowerShell ma następujące słowa kluczowe języka. Aby uzyskać więcej informacji, zobacz temat dotyczący słowa kluczowego i informacje, które są zgodne z tabelą.

Słowo kluczowe Odwołanie
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 Zarezerwowane do użytku w przyszłości
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 Opisano w tym temacie
filter about_Functions
finally about_Try_Catch_Finally
for about_For
foreach about_ForEach
from Zarezerwowane do użytku w przyszłości
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 Zarezerwowane do użytku w przyszłości
while about_While, about_Do

Następujące słowa kluczowe są używane przez przepływy pracy programu PowerShell:

  • inlinescript
  • parallel
  • sequence
  • workflow

Przepływy pracy programu PowerShell są obsługiwane tylko w programie PowerShell 5.1. Aby uzyskać więcej informacji na temat przepływów pracy, zobacz Uruchamianie poleceń programu PowerShell w przepływie pracy.

begin

Określa jedną część treści funkcji wraz z słowami dynamicparamkluczowymi , processi end . Lista begin instrukcji jest uruchamiana jeden raz przed odebraniem wszystkich obiektów z potoku.

Składnia:

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

break

Powoduje zamknięcie pętli przez skrypt.

Składnia:

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

   break
   ...

   <statements>
}

catch

Określa listę instrukcji do uruchomienia, jeśli na liście instrukcji try towarzyszących wystąpi błąd. Typ błędu wymaga nawiasów kwadratowych. Druga para nawiasów wskazuje, że typ błędu jest opcjonalny.

Składnia:

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

class

Określa nową klasę w programie PowerShell.

Składnia:

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

continue

Powoduje, że skrypt przestaje uruchamiać pętlę i wraca do warunku. Jeśli warunek zostanie spełniony, skrypt ponownie rozpocznie pętlę.

Składnia:

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

   continue
   ...

   <statements>
}

data

W skrycie definiuje sekcję, która izoluje dane od logiki skryptu. Może również zawierać if instrukcje i niektóre ograniczone polecenia.

Składnia:

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

do

Używany z while słowem kluczowym lub until jako konstrukcją pętli. Program PowerShell uruchamia listę instrukcji co najmniej raz, w przeciwieństwie do pętli używającej polecenia while.

Składnia dla :while

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

Składnia dla :until

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

dynamicparam

Określa jedną część treści funkcji wraz z słowami beginkluczowymi , processi end . Parametry dynamiczne są dodawane w czasie wykonywania.

Składnia:

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

else

Używany ze if słowem kluczowym do określenia domyślnej listy instrukcji.

Składnia:

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

elseif

Używane z słowami kluczowymi if i else do określania dodatkowych warunków warunkowych. Słowo else kluczowe jest opcjonalne.

Składnia:

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

end

Określa jedną część treści funkcji wraz z słowami dynamicparamkluczowymi , begini end . Lista end instrukcji jest uruchamiana jeden raz po odebraniu wszystkich obiektów z potoku.

Składnia:

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

enum

enum służy do deklarowania wyliczenia; odrębny typ składający się z zestawu nazwanych etykiet nazywanych listą modułów wyliczających.

Składnia:

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

exit

Powoduje, że program PowerShell kończy działanie skryptu lub wystąpienia programu PowerShell.

Składnia:

exit
exit <exitcode>

W przypadku użycia pwsh z parametrem .ps1Plik sam plik (skrypt) powinien zawierać instrukcje obsługi błędów lub wyjątków występujących podczas działania skryptu. Należy użyć tylko instrukcji exit , aby wskazać stan po wykonaniu skryptu.

W systemie Windows dowolna liczba między [int]::MinValue i [int]::MaxValue jest dozwolona.

W systemie Unix dozwolone są tylko liczby dodatnie między [byte]::MinValue i [byte]::MaxValue . Liczba ujemna w zakresie -1 przec -255 . jest automatycznie tłumaczona na liczbę dodatnią przez dodanie wartości 256. Na przykład -2 element jest przekształcany na 254.

W programie PowerShell instrukcja exit ustawia wartość zmiennej $LASTEXITCODE . W powłoce poleceń systemu Windows (cmd.exe) instrukcja exit ustawia wartość zmiennej środowiskowej %ERRORLEVEL% .

Każdy argument, który nie jest numeryczny lub poza zakresem specyficznym dla platformy, jest tłumaczony na wartość 0.

W poniższym przykładzie użytkownik ustawia wartość zmiennej na poziomie błędu na 4 , dodając exit 4 do pliku test.ps1skryptu .

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

Po uruchomieniu pwsh.exe -File <path to a script> polecenia i zakończeniu pliku exit skryptu kod zakończenia jest ustawiony na argument liczbowy używany z poleceniem exit . Jeśli skrypt nie exit ma instrukcji, kod zakończenia jest zawsze 0 , gdy skrypt zakończy się bez błędu lub 1 gdy skrypt zakończy działanie z nieobsługiwanego wyjątku.

filter

Określa funkcję, w której lista instrukcji jest uruchamiana jeden raz dla każdego obiektu wejściowego. Ma taki sam efekt jak funkcja, która zawiera tylko process blok.

Składnia:

filter <name> {<statement list>}

finally

Definiuje listę instrukcji uruchamianą po instrukcjach skojarzonych z elementami try i catch. finally Lista instrukcji jest uruchamiana nawet w przypadku naciśnięcia klawisza CTRL+C w celu pozostawienia skryptu lub użycia exit słowa kluczowego w skry skrycie.

Składnia:

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

for

Definiuje pętlę z warunkiem.

Składnia:

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

foreach

Definiuje pętlę przy użyciu każdego elementu członkowskiego kolekcji.

Składnia:

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

from

Zarezerwowane do użytku w przyszłości.

function

Tworzy nazwaną listę instrukcji kodu wielokrotnego użytku. Zakres, do którego należy funkcja. Można również określić co najmniej jeden nazwany parametr przy użyciu słowa kluczowego param . Na liście instrukcji funkcji można uwzględnić dynamicparamlisty , begin, processi end instrukcji.

Składnia:

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

Istnieje również możliwość zdefiniowania co najmniej jednego parametru poza listą instrukcji po nazwie funkcji.

Składnia:

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

if

Definiuje warunkowe.

Składnia:

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

hidden

Ukrywa elementy członkowskie klasy przed domyślnymi wynikami Get-Member polecenia cmdlet, funkcji IntelliSense i wyników uzupełniania tabulatorów.

Składnia:

hidden [data type] $member_name

in

Używana w instrukcji foreach do tworzenia pętli, która używa każdego elementu członkowskiego kolekcji.

Składnia:

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

param

Definiuje parametry w funkcji.

Składnia:

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

process

Określa część treści funkcji wraz z słowami dynamicparamkluczowymi , begini end . process Gdy lista instrukcji odbiera dane wejściowe z potoku, process lista instrukcji jest uruchamiana jeden raz dla każdego elementu z potoku. Jeśli potok nie zawiera żadnych obiektów, process lista instrukcji nie zostanie uruchomiona. Jeśli polecenie jest pierwszym poleceniem w potoku, process lista instrukcji jest uruchamiana jeden raz.

Składnia:

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

return

Powoduje pozostawienie bieżącego zakresu przez program PowerShell, takiego jak skrypt lub funkcja, i zapisanie opcjonalnego wyrażenia w danych wyjściowych.

Składnia:

return [<expression>]

static

Określa zdefiniowaną właściwość lub metodę jest wspólną dla wszystkich wystąpień klasy, w której jest zdefiniowana.

Zobacz class przykłady użycia.

switch

Aby sprawdzić wiele warunków, użyj instrukcji switch . Instrukcja jest równoważna switch serii instrukcji if , ale jest prostsza.

Instrukcja switch zawiera listę każdego warunku i akcję opcjonalną. Jeśli warunek zostanie spełniony, wykonywana jest akcja.

Składnia 1:

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

   default {<statement list>}
}

Składnia 2:

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

   default {<statement list>}
}

throw

Zgłasza obiekt jako błąd.

Składnia:

throw [<object>]

trap

Definiuje listę instrukcji do uruchomienia w przypadku wystąpienia błędu. Typ błędu wymaga nawiasów kwadratowych. Druga para nawiasów wskazuje, że typ błędu jest opcjonalny.

Składnia:

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

try

Definiuje listę instrukcji do sprawdzenia pod kątem błędów podczas uruchamiania instrukcji. Jeśli wystąpi błąd, program PowerShell będzie nadal działać w instrukcji catch lub finally . Typ błędu wymaga nawiasów kwadratowych. Druga para nawiasów wskazuje, że typ błędu jest opcjonalny.

Składnia:

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

until

Używana w instrukcji do jako konstrukcja pętli, w której lista instrukcji jest wykonywana co najmniej raz.

Składnia:

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

using

Umożliwia wskazanie, które przestrzenie nazw są używane w sesji. Klasy i elementy członkowskie wymagają mniejszego pisania, aby je wspomnieć. Można również uwzględnić klasy z modułów.

Składnia 1:

using namespace <.Net-framework-namespace>

Składnia nr 2:

using module <module-name>

while

Instrukcja while jest konstrukcją pętli, w której warunek jest testowany przed wykonaniem instrukcji. Jeśli warunek ma wartość false, instrukcje nie są wykonywane.

Składnia instrukcji:

while (<condition>) {
   <statements>
 }

W przypadku do użycia w instrukcji jest częścią konstrukcji pętli, while w której lista instrukcji jest wykonywana co najmniej raz.

do składnia pętli:

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

Zobacz też