关于脚本块

简短描述

定义什么是脚本块并解释如何在 PowerShell 编程语言中使用脚本块。

详细描述

在 PowerShell 编程语言中，脚本块是可用作单个单元的语句或表达式的集合。语句集合可以括在大括号 ({}) 中、定义为函数或保存在脚本文件中。脚本块可以返回值并接受参数和参数。

从语法上来说，脚本块是大括号中的语句列表，如以下语法所示：

{<statement list>}

脚本块以单个对象或数组的形式返回脚本块中所有命令的输出。

您还可以使用 return 关键字指定返回值。 return 关键字不会影响或抑制从脚本块返回的其他输出。但是，return 关键字会在该行退出脚本块。欲了解更多信息，请参阅about_Return。

与函数一样，脚本块可以包含参数。使用 Param 关键字分配命名参数，如以下语法所示：

{
    Param([type]$Parameter1 [,[type]$Parameter2])
    <statement list>
}

笔记

在脚本块中，与函数不同，您不能在大括号之外指定参数。

与函数一样，脚本块可以包含 dynamicparam、begin、process 和 end 关键字。有关更多信息，请参阅 about_Functions 和 about_Functions_Advanced。

使用脚本块

脚本块是 Microsoft .NET Framework 类型 System.Management.Automation.ScriptBlock 的实例。命令可以具有脚本块参数值。例如，Invoke-Command cmdlet 具有一个采用脚本块值的 ScriptBlock 参数，如下例所示：

Invoke-Command -ScriptBlock { Get-Process }

Handles  NPM(K)    PM(K)     WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----     ----- -----   ------     -- -----------
999          28    39100     45020   262    15.88   1844 communicator
721          28    32696     36536   222    20.84   4028 explorer
...

Invoke-Command 还可以执行具有参数块的脚本块。使用ArgumentList参数按位置分配参数。

Invoke-Command -ScriptBlock { param($p1, $p2)
"p1: $p1"
"p2: $p2"
} -ArgumentList "First", "Second"

p1: First
p2: Second

前面示例中的脚本块使用 param 关键字创建参数 $p1 和 $p2。字符串“First”绑定到第一个参数 ($p1)，“Second”绑定到 ($p2)。

有关 ArgumentList 行为的更多信息，请参阅 about_Splatting。

您可以使用变量来存储和执行脚本块。下面的示例将脚本块存储在变量中并将其传递给 Invoke-Command。

$a = { Get-Service BITS }
Invoke-Command -ScriptBlock $a

Status   Name               DisplayName
------   ----               -----------
Running  BITS               Background Intelligent Transfer Ser...

调用运算符是执行存储在变量中的脚本块的另一种方法。与 Invoke-Command 类似，调用运算符在子作用域中执行脚本块。调用运算符可以让您更轻松地在脚本块中使用参数。

$a ={ param($p1, $p2)
"p1: $p1"
"p2: $p2"
}
&$a -p2 "First" -p1 "Second"

p1: Second
p2: First

您可以使用赋值将脚本块的输出存储在变量中。

PS>  $a = { 1 + 1}
PS>  $b = &$a
PS>  $b
2

PS>  $a = { 1 + 1}
PS>  $b = Invoke-Command $a
PS>  $b
2

有关调用运算符的更多信息，请参阅 about_Operators。

使用带参数的延迟绑定脚本块

接受管道输入的类型化参数允许在参数上使用延迟绑定脚本块。您可以使用延迟绑定脚本块作为简写，在执行管道 cmdlet 之前为其定义参数。

在延迟绑定脚本块中，您可以使用管道变量 $_ 引用管道传入的对象。

# Both examples rename config.log to old_config.log
# Without delay-binding
dir config.log | ForEach-Object -Process {
  Rename-Item -Path $_ -NewName "old_$($_.Name)"
}
# With delay-binding
dir config.log | Rename-Item -NewName { "old_$($_.Name)" }

在更复杂的 cmdlet 中，延迟绑定脚本块允许重用一个管道传入对象来填充其他参数。

关于延迟绑定脚本块作为参数的注意事项：

• 您必须显式指定与延迟绑定脚本块一起使用的任何参数名称。

• 该参数不得为无类型参数，并且参数的类型不能为 [scriptblock] 或 [object]。

• 如果您使用延迟绑定脚本块而不提供管道输入，则会收到错误。

  Rename-Item -NewName {$_.Name + ".old"}
  

  Rename-Item : Cannot evaluate parameter 'NewName' because its argument is
  specified as a script block and there is no input. A script block cannot
  be evaluated without input.
  At line:1 char:23
  +  Rename-Item -NewName {$_.Name + ".old"}
  +                       ~~~~~~~~~~~~~~~~~~
      + CategoryInfo          : MetadataError: (:) [Rename-Item],
        ParameterBindingException
      + FullyQualifiedErrorId : ScriptBlockArgumentNoInput,
        Microsoft.PowerShell.Commands.RenameItemCommand
  

参见

• about_函数
• about_功能_高级
• about_Operators