关于语言关键词

简短描述

描述 PowerShell 脚本语言中的关键字。

详细描述

PowerShell 具有以下语言关键字。有关详细信息，请参阅关键字的 about 主题以及表后面的信息。

about_Functions、about_Functions_Advanced

about_Break、about_Trap

about_Try_Catch_Finally

关于课程

about_Functions、about_Functions_Advanced_Methods

about_Continue、about_Trap

about_Data_Sections

保留供将来使用

about_Do、about_While

about_Functions_Advanced_Parameters

关于_如果

关于_如果

about_Functions、about_Functions_Advanced_Methods

about_Enum

本主题中描述

about_函数

about_Try_Catch_Finally

关于_For

about_ForEach

保留供将来使用

about_Functions、about_Functions_Advanced

about_隐藏

关于_如果

about_ForEach

about_函数

about_Functions、about_Functions_Advanced

关于返回

关于课程

about_Switch

about_Throw、about_Functions_Advanced_Methods

about_Trap、about_Break、about_Try_Catch_Finally

about_Try_Catch_Finally

关于_Do

about_Using、about_Classes

保留供将来使用

about_While、about_Do

PowerShell 工作流使用以下关键字：

inlinescript

parallel

sequence

workflow

仅 PowerShell 5.1 支持 PowerShell 工作流。有关工作流的更多信息，请参阅在工作流中运行 PowerShell 命令。

开始

指定函数主体的一部分，以及 dynamicparam、process 和 end 关键字。 begin 语句列表在从管道接收任何对象之前运行一次。

语法：

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

中断

导致脚本退出循环。

语法：

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

   break
   ...

   <statements>
}

抓住

指定在随附的 try 语句列表中发生错误时要运行的语句列表。错误类型需要括号。第二对括号表示错误类型是可选的。

语法：

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

类

在 PowerShell 中指定一个新类。

语法：

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

干净

PowerShell 7.3 中添加了 clean 关键字。该关键字定义了保证在函数的 begin、process 和 end 块之后运行的代码块。与 end 块不同，clean 块始终会执行，即使其他块之一出现终止错误也是如此。

继续

使脚本停止运行循环并返回到条件。如果满足条件，脚本将再次开始循环。

语法：

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

   continue
   ...

   <statements>
}

数据

在脚本中，定义将数据与脚本逻辑隔离的部分。还可以包含 if 语句和一些有限的命令。

语法：

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

做

与 while 或 until 关键字一起用作循环结构。 PowerShell 至少运行一次语句列表，这与使用 while 的循环不同。

while 的语法：

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

until 的语法：

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

动态参数

指定函数主体的一部分，以及 begin、process 和 end 关键字。动态参数在运行时添加。

语法：

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

其他

与 if 关键字一起使用来指定默认语句列表。

语法：

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

其他

与 if 和 else 关键字一起使用来指定其他条件。 else 关键字是可选的。

语法：

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

结束

指定函数主体的一部分，以及 dynamicparam、begin 和 end 关键字。 end 语句列表在从管道接收到所有对象后运行一次。

语法：

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

枚举

enum 用于声明枚举；一种独特的类型，由一组称为枚举器列表的命名标签组成。

语法：

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

退出

导致 PowerShell 退出脚本或 PowerShell 实例。

语法：

exit
exit <exitcode>

当您将 pwsh 与 File 参数一起使用时，.ps1（脚本）文件本身应包含用于处理在脚本正在运行。您应该仅使用 exit 语句来指示脚本的执行后状态。

在 Windows 上，允许 [int]::MinValue 和 [int]::MaxValue 之间的任何数字。

在 Unix 上，只允许 [byte]::MinValue 和 [byte]::MaxValue 之间的正数。 -1 到 -255 范围内的负数会通过添加 256 自动转换为正数。例如，-2 为转换为 254。

在 PowerShell 中，exit 语句设置 $LASTEXITCODE 变量的值。在 Windows 命令外壳 (cmd.exe) 中，exit 语句设置 %ERRORLEVEL% 环境变量的值。

任何非数字或超出平台特定范围的参数都会转换为 0 值。

在以下示例中，用户通过将 exit 4 添加到脚本文件 test.ps1 来将错误级别变量值设置为 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

当您运行 pwsh.exe -File