about_Break
简短说明
描述该 break 语句，该语句提供了退出当前控制块的方法。
长说明
break 语句提供了退出当前控制块的方法。
在控制块之后的下一个语句中继续执行。 该语句支持标签。 标签是分配给脚本中的语句的名称。
在循环中使用 break
当 foreach、for、do 或 while 等循环中出现 break 语句时，PowerShell会立即退出循环。
break 语句可以包含一个允许退出嵌入式循环的标签。 标签可以指定脚本中的任何循环关键字，例如 foreach、for 或 while。
以下示例显示如何使用 break 语句退出 for 语句：
for($i=1; $i -le 10; $i++) {
Write-Host $i
break
}
在此示例中，break 语句在 $i 变量等于 1 时退出 for 循环。 即使 for 语句在 $i 大于 10 之前计算结果为 True，PowerShell 也会在第一次运行 for 循环时到达中断语句。
更常见的情况是在必须满足内部条件的循环中使用 break 语句。 请考虑以下示例 foreach 语句：
$i=0
$varB = 10,20,30,40
foreach ($val in $varB) {
if ($val -eq 30) {
break
}
$i++
}
Write-Host "30 was found in array index $i"
在此示例中，foreach 语句循环访问 $varB 数组。 前两次循环运行时，if 语句的计算结果为 False，变量 $i 递增 1。 第三次运行循环， $i 等于 2，$val 变量等于 30。 此时，break 语句将运行，foreach 循环将退出。
在循环中使用带标签的 break
break 语句可以包含标签。 如果将 break 关键字与标签一起使用，PowerShell 将退出标记循环，而不是退出当前循环。
标签是一个冒号，后跟指定的名称。 标签必须是语句中的第一个标记，并且后面必须跟循环关键字，例如 while。
break 将执行移出标记循环。 在嵌入式循环中，这与 break 关键字单独使用时的结果不同。 此示例有一个 while 语句和一个 for 语句：
:myLabel while (<condition 1>) {
for ($item in $items) {
if (<condition 2>) {
break myLabel
}
$item = $x # A statement inside the For-loop
}
}
$a = $c # A statement after the labeled While-loop
如果条件 2 的计算结果为 True，则脚本的执行将跳到标记循环之后的语句。 在本示例中，执行再次以语句 $a = $c 开头。
可以嵌套许多标记的循环，如以下示例所示。
:red while (<condition1>) {
:yellow while (<condition2>) {
while (<condition3>) {
if ($a) {break}
if ($b) {break red}
if ($c) {break yellow}
}
Write-Host "After innermost loop"
}
Write-Host "After yellow loop"
}
Write-Host "After red loop"
如果 $b 变量的计算结果为 True，则脚本的执行将在标记为“red”的循环后恢复。 如果 $c 变量的计算结果为 True，则脚本控件的执行将在标记为“yellow”的循环后恢复。
如果 $a 变量的计算结果为 True，则在最内层循环之后恢复执行。 不需要标签。
PowerShell 不限制标签可以恢复执行的程度。 标签甚至可以跨脚本和函数调用边界传递控件。
在 switch 语句中使用 break
在 switch 构造中，break 会导致 PowerShell 退出 switch 代码块。
break 关键字用于保留 switch 构造。 例如，以下 switch 语句使用 break 语句来测试最具体的条件：
$var = "word2"
switch -regex ($var) {
"word2" {
Write-Host "Exact" $_
break
}
"word.*" {
Write-Host "Match on the prefix" $_
break
}
"w.*" {
Write-Host "Match on at least the first letter" $_
break
}
default {
Write-Host "No match" $_
break
}
}
在此示例中，将创建 $var 变量并将其初始化为字符串值 word2。 switch 语句使用 Regex 类将变量值与术语 word2 匹配。 由于变量值和 switch 语句中的第一个测试匹配，因此 switch 语句中的第一个代码块将运行。
当 PowerShell 到达第一个 break 语句时，switch 语句将退出。 如果从示例中删除了四个 break 语句，则所有四个条件都满足。 此示例使用 break 语句在满足最具体的条件时显示结果。
在 trap 语句中使用 break
如果 trap 语句正文中执行的最终语句是 break，则错误对象将被抑制并重新引发异常。
以下示例创建使用 trap 语句捕获的 DivideByZeroException 异常。
function test {
trap [DivideByZeroException] {
Write-Host 'divide by zero trapped'
break
}
$i = 3
'Before loop'
while ($true) {
"1 / $i = " + (1 / $i--)
}
'After loop'
}
test
请注意，执行在异常处停止。 永远不会到达 After loop 循环。
trap 执行后，将重新引发异常。
Before loop
1 / 3 = 0.333333333333333
1 / 2 = 0.5
1 / 1 = 1
divide by zero trapped
ParentContainsErrorRecordException:
Line |
10 | "1 / $i = " + (1 / $i--)
| ~~~~~~~~~~~~~~~~~~~~~~~~
| Attempted to divide by zero.
请勿在循环、switch 或 trap 之外使用 break
当在直接支持它的构造（循环、switch、trap）之外使用 break 时，PowerShell 会在调用堆栈中查找封闭构造。 如果找不到封闭的构造，当前运行空间将被悄悄终止。
这意味着，如果函数和脚本无意中在支持它的封闭结构之外使用了 break，则可能会无意中终止其调用方。
在管道 break 内使用 break（例如 ForEach-Object 脚本块）不仅会退出管道，还可能终止整个运行空间。
