在 Windows PowerShell 脚本中查看函数

已完成

函数是可重用代码块。 可以使用函数在脚本中执行重复操作，而不用在脚本中多次输入相同的代码。 例如，如果你有一个可以执行多个操作的大型脚本，而不是每个操作都要输入代码将数据记录到磁盘，那么你可以使用函数将数据记录到磁盘。 然后，每次执行操作时都会调用此日志记录函数。 稍后，如果要更改该日志记录函数，只需更改一处即可。

调用函数时，可以将数据传递给它。 以与脚本相同的方式对函数使用 Param () 块。 在函数的声明之后，插入 Param () 块以及预期传递给函数的任何变量的定义。 以下示例是一个使用 Param () 块来接受计算机名称的函数：

Function Get-SecurityEvent {
   Param (
      [string]$ComputerName
   ) #end Param
   Get-EventLog -LogName Security -ComputerName -$ComputerName -Newest 10
}

若要在脚本中调用函数，请使用以下语法：

Get-SecurityEvent -ComputerName LON-DC1

在上面的示例中，-Computer 参数的值将传递给函数中的 变量。 然后，Get-EventLog 从该计算机的安全日志中查询最近 10 个事件，并将其显示在屏幕上。 如果你希望将这些事件放置在变量中并使其在脚本的其余部分可用，请使用以下语法：

$securityEvents = Get-SecurityEvent -ComputerName LON-DC1