РАЗДЕЛ
about_Language_Keywords
КРАТКОЕ ОПИСАНИЕ
Описание ключевых слов языка скриптов Windows PowerShell.
ПОЛНОЕ ОПИСАНИЕ
В Windows PowerShell используются следующие ключевые слова.
Дополнительные сведения см. в соответствующих разделах справки по
отдельным ключевым словам, а также в следующей за таблицей информации.
Ключевое слово Разделы справки
------- ---------
Begin about_Functions, about_Functions_Advanced
Break about_Break, about_Trap
Catch about_Try_Catch_Finally
Continue about_Continue, about_Trap
Data about_Data_Sections
Do about_Do, about_While
Dynamicparam about_Functions_Advanced_Parameters
Else about_If
Elseif about_If
End about_Functions, about_Functions_Advanced_Methods
Exit Описывается в этом разделе.
Filter about_Functions
Finally about_Try_Catch_Finally
For about_For
Foreach about_Foreach
From Зарезервировано для использования в дальнейшем.
Function about_Functions, about_Functions_Advanced
If about_If
In about_Foreach
Param about_Functions
Process about_Functions, about_Functions_Advanced
Return about_Return
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
While about_While, about_Do
Ключевые слова языка скриптов
Begin
-----
Указывает одну из частей тела функции, как и ключевые слова
Dynamicparam, Process и End. Список инструкций из блока Begin
выполняется однократно, прежде чем какие-либо объекты принимаются с
конвейера.
Синтаксис:
function <имя> {
dynamicparam {<список_инструкций>}
begin {<список_инструкций>}
process {<список_инструкций>}
end {<список_инструкций>}
}
Break
-----
Обеспечивает выход из цикла скрипта.
Синтаксис:
while (<условие>) {
<инструкции>
...
break
...
<инструкции>
}
Catch
-----
Задает список инструкций, выполняемых при возникновении ошибки в
сопутствующем списке инструкций Try. Тип ошибки указывается в квадратных
скобках. Наличие двойных квадратных скобок означает, что тип ошибки
указывать не обязательно.
Синтаксис:
try {<список_инструкций>}
catch [[<тип_ошибки>]] {<список_инструкций>}
Continue
--------
Обеспечивает остановку цикла скрипта и возврат к условию. Если
условие выполняется, цикл скрипта запускается снова.
Синтаксис:
while (<условие>) {
<инструкции>
...
continue
...
<инструкции>
}
Data
----
При использовании в скриптах это ключевое слово определяет раздел,
отделяющий данные от логики скрипта. Также может содержать инструкции If и
некоторые ограниченные команды.
Синтаксис:
data <переменная> [-supportedCommand <имя_командлета>] {<допустимое_содержимое>}
Do
--
Используется в сочетании с ключевым словом While или Until для
создания циклов. Windows PowerShell выполняет список инструкций как
минимум один раз, в отличие от циклов с ключевым словом While.
Синтаксис:
do {<список_инструкций>} while (<условие>)
do {<список_инструкций>} until (<условие>)
Dynamicparam
------------
Указывает одну из частей тела функции, как и ключевые слова
Begin, Process и End. Динамические параметры добавляются во время
выполнения.
Синтаксис:
function <имя> {
dynamicparam {<список_инструкций>}
begin {<список_инструкций>}
process {<список_инструкций>}
end {<список_инструкций>}
}
Else
----
Используется с ключевым словом If. Задает список инструкций по
умолчанию.
Синтаксис:
if (<условие>) {<список_инструкций>}
else {<список_инструкций>}
Elseif
------
Используется с ключевыми словами If и Else. Задает
дополнительные условия. Ключевое слово Else необязательное.
Синтаксис:
if (<условие>) {<список_инструкций>}
elseif (<условие>) {<список_инструкций>}
else {<список_инструкций>}
End
---
Указывает одну из частей тела функции, как и ключевые слова
Dynamicparam, Begin и End. Список инструкций из блока End
выполняется однократно после получения всех объектов с конвейера.
Синтаксис:
function <имя> {
dynamicparam {<список_инструкций>}
begin {<список_инструкций>}
process {<список_инструкций>}
end {<список_инструкций>}
}
Exit
----
Обеспечивает выход из скрипта Windows PowerShell или из
экземпляра Windows PowerShell.
Синтаксис:
exit
Filter
------
Задает функцию, список инструкций которой выполняется по одному
разу для каждого объекта ввода. Она действует аналогично функции,
содержащей только блок Process.
Синтаксис:
filter <имя> {<список_инструкций>}
Finally
-------
Определяет список инструкций, выполняемых после инструкций,
связанных с ключевыми словами Try и Catch. Список инструкций из
блока Finally выполняется, даже если выйти из скрипта с помощью
сочетания клавиш CTRL+C или ключевого слова Exit в скрипте.
Синтаксис:
try {<список_инструкций>}
catch [<тип_ошибки>] {<список_инструкций>}
finally {<список_инструкций>}
For
---
Определяет цикл, используя условие.
Синтаксис:
for (<инициализация>; <условие>; <итерация>) {<список_инструкций>}
Foreach
-------
Определяет цикл, используя каждый элемент коллекции.
Синтаксис:
foreach (<элемент> in <коллекция>){<список_инструкций>}
From
-----
Зарезервировано для использования в дальнейшем.
Function
--------
Создает список инструкций, имеющий имя и доступный для многократного
использования. Позволяет задать имя области, к которой принадлежит
функция. Также позволяет задать один или несколько именованных
параметров с помощью ключевого слова Param. В список инструкций
функции можно включить списки инструкций Dynamicparam, Begin, Process
и End.
Синтаксис:
function [<scope:>]<name> {
param ([type]<$pname1> [, [type]<$pname2>])
dynamicparam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}
}
Также можно определить один или несколько параметров вне списка
инструкций после имени функции.
Синтаксис:
function [<scope:>]<name> [([type]<$pname1>, [[type]<$pname2>])] {
dynamicparam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}
If
--
Определяет условие.
Синтаксис:
if (<условие>) {<список_инструкций>}
In
--
Используется в инструкциях Foreach для создания цикла, в котором
используется каждый элемент коллекции.
Синтаксис:
foreach (<элемент> in <коллекция>){<список_инструкций>}
Param
-----
Определяет параметры в функции.
Синтаксис:
function [<scope:>]<name> {
param ([type]<$pname1>[, [[type]<$pname2>]])
<statement list>
}
Process
-------
Указывает часть тела функции, как и ключевые слова
Dynamicparam, Begin и End. Когда список инструкций из блока Process
получает входные данные через конвейер, этот список инструкций
выполняется по одному разу для каждого элемента из конвейера.
Если через конвейер не передано ни одного объекта, список инструкций
из блока Process не выполняется. Если команда является первой командой
в конвейере, список инструкций из блока Process выполняется один раз.
Синтаксис:
function <имя> {
dynamicparam {<список_инструкций>}
begin {<список_инструкций>}
process {<список_инструкций>}
end {<список_инструкций>}
}
Return
------
Предписывает Windows PowerShell выйти из текущей области,
например из скрипта или функции, и записывает выражение
(необязательный параметр) в выходные данные.
Синтаксис:
return [<выражение>]
Switch
------
Задает различные действия, выполняемые с элементами из
конвейера или из файла. Можно использовать любую из следующих
моделей синтаксиса.
Синтаксис 1:
switch [-regex|-wildcard|-exact][-casesensitive] ( pipeline )
{
<строка>|<число>|<переменная>|{ <выражение> } {<список_инструкций>}
<строка>|<число>|<переменная>|{ <выражение> } {<список_инструкций>}
...
default {<список_инструкций>}
}
Синтаксис 2:
switch [-regex|-wildcard|-exact][-casesensitive] -file filename
{
<строка>|<число>|<переменная>|{ <выражение> } {<список_инструкций>}
<строка>|<число>|<переменная>|{ <выражение> } {<список_инструкций>}
...
default {<список_инструкций>}
}
Throw
-----
Выдает объект как ошибку.
Синтаксис:
throw [<объект>]
Trap
----
Определяет список инструкций, выполняемый в случае ошибки. Тип
ошибки указывается в квадратных скобках. Наличие двойных
квадратных скобок означает, что тип ошибки указывать не обязательно.
Синтаксис:
trap [[<тип_ошибки>]] {<список_инструкций>}
Try
---
Определяет список инструкций, проверяемых на ошибки при
выполнении. Если возникает ошибка, Windows PowerShell продолжает
выполнение инструкции Catch или Finally. Тип ошибки указывается в
квадратных скобках. Наличие двойных квадратных скобок означает, что
тип ошибки указывать не обязательно.
Синтаксис:
try {<список_инструкций>}
catch [[<тип_ошибки>]] {<список_инструкций>}
finally {<список_инструкций>}
Until
-----
Используется в инструкциях Do для создания циклов, в которых список
инструкций выполняется не менее одного раза.
Синтаксис:
do {<список_инструкций>} until (<условие>)
While
-----
Используется в инструкциях Do для создания циклов, в которых список
инструкций выполняется не менее одного раза.
Синтаксис:
do {<список_инструкций>} while (<условие>)
СМ. ТАКЖЕ
about_escape_characters
about_special_characters
about_wildcards