PowerShell 函数

PowerShell 中函数是一系列 PowerShell 语句的组合。当你经过函数的名称调用函数时，函数中的语句会被顺序的执行，就像在命令行中执行它们同样。

从 hello world 开始

function Say-HelloWorld 
{
    Write-Host "hello world!"
}

定义函数必须使用 function 关键字，而且为函数提供一个名称。而后用花括号把 PowerShell 语句括起来。
调用函数的方式也很简单，好比上面的函数连参数都没有定义，直接写函数名称就能够了：

> Say-HelloWorld

函数的命名规则

PowerShell 中命令的命名是很是有特点的，都是 "动词 - 名词" 的模式。MS 也建议咱们以一样的模式来命名自定义的函数，以保证代码的可读性。
好比咱们定义的函数 Say-HelloWorld 就遵循这样的规则。再举个例子，好比你要定义一个把日志信息写到文件中的函数，那可能就要命名为 Write-Log 之类的名称了。

MS 甚至对经常使用的名称给出了具体的规范，有兴趣的同窗能够去读读：Approved Verbs for Windows PowerShell Commands。

位置参数 $args

在 shell 世界中位置参数(Position Patameters)是广泛存在的。其实就是在函数或脚本中咱们能够经过默认存在的变量 $args 来引用传递给函数或脚本的参数。$args 变量是一个数组，因此咱们须要经过索引语法来引用具体的参数，如 $args[0]，$args[1] …

咱们在下面的函数中引用位置参数：

function Say-Hello
{
    Write-Host("Hello {0} {1}!" -f $args[0], $args[1])
}

> Say-Hello "Nick" "Li"

命名参数

除了使用位置参数，咱们还能够在声明函数时指定命名参数。使用命名的参数还能够为参数指定默认值。

function Say-Hello($name, $count=3)
{
    for(;$count -gt 0;$count--)
    {
        Write-Host("Hello {0}!" -f $name)
    }   
}

> Say-Hello "Nick" 2

做为 C# 程序员笔者比较喜欢把参数写在小括号里面，可是在 PowerShell 中更常见的参数声明方式为使用 Param 关键字：

function Say-Hello
{
    Param
    (
        $name,
        $count=3
    )

    for(;$count -gt 0;$count--)
    {
        Write-Host("Hello {0}!" -f $name)
    }   
}

这两种声明函数参数的方式是彻底等价的，因此你能够选择本身喜欢的方式。

在调用函数时，咱们还能够经过指定参数名称的方式为函数传参：

> Say-Hello -name "Jack" -count 5

从 Pipeline 输入函数参数

PowerShell 中的函数能够很轻松的支持从 Pipeline 输入参数，下面是一个简单的 demo：

function Say-Hello
{
    Param
    (
        [parameter(Mandatory=$true, ValueFromPipeline=$true)]
        $name
    )
    process
    {
        Write-Host("Hello {0}!" -f $name)
    }
}

在上面的函数声明中咱们把函数的主体放入了 process 程序块。在 process 块中的语句会根据 Pipeline 中对象的个数执行屡次。也就是说，若是咱们经过 Pipeline 为函数传递 3 个参数，那么 process 块中的代码就会执行 3 次。
[parameter(Mandatory=$true, ValueFromPipeline=$true)] 说明能够经过 Pipeline 传递参数 name。试一下经过 Pipeline 传参：

> "Jack","Nick","Alice" | Say-Hello

注意，此时还能够经过 Say-Hello "Nick" 的方式调用函数，咱们只是在基本功能的基础上添加了对 Pipeline 的支持。

做用域

函数只存在于建立它的上下文中(scope)，好比定义函数的脚本。若是想要在一个脚本中引用在另一个脚本中定义的函数，须要使用 source(.) 命令。在当前的脚本 A 中使用 source 命令并指定另一个脚本 B 做为参数，会把 B 中定义的函数、别名和变量引入到脚本 A 的上下文中(scope)。
好比笔者在 Write-Log.ps1 文件中定义了函数 Write-Log，在另一个脚本中使用 Write-Log 的方法为：
# 此处能够写绝对路径也能够写相对路径

. "./Write-Log.ps1"
Write-Log -Message 'It's a test message'

函数自身会建立一个上下文(scope)，在函数中定义的变量在函数外部是不可见的。
可是在函数内部却能够访问在函数外部定义的变量，好比下面的 demo：

$world = "Hello world!"
function Say-Hello 
{
    Write-Host($world)
}

> Say-Hello