【转】PowerShell 函数（Function）

转至：http://blog.csdn.net/kk185800961/article/details/49022395

函数基本操作：

[plain] view plain copy

1. #创建函数
2. Function GetSQLService
3. {
4. Get-Service -DisplayName "*SQL*"
5. }
6. #调用函数，直接写函数名
7. GetSQLService
8. #查看函数定义
9. $Function:GetSQLService
10. #导出函数定义到文本
11. $Function:GetSQLService | Out-File E:\GetSQLService.ps1
12. #删除函数
13. del Function:GetSQLService
14. #查看内部自定义函数：
15. dir function: | ft -AutoSize

创建带参数的函数,三种方法（会覆盖同名函数）：

[plain] view plain copy

1. #创建带参数的函数,三种方法（会覆盖同名函数）
2. Function GetSQLService($ServiceName)
3. {
4. Get-Service -DisplayName "*$ServiceName*"
5. }
6. Function GetSQLService
7. {
8. param($ServiceName)
9. Get-Service -DisplayName "*$ServiceName*"
10. }
11. #有默认值的参数
12. Function GetSQLService
13. {
14. param($ServiceName='SQL')
15. Get-Service -DisplayName "*$ServiceName*"
16. }
17. #多个参数
18. Function GetSQLService
19. {
20. param($ServiceName,$KeyWord)
21. Get-Service -DisplayName "*$ServiceName*$KeyWord*" | Format-Table -AutoSize
22. }

调用函数：

1. GetSQLService
2. GetSQLService SQL
3. GetSQLService -ServiceName SQL
4. GetSQLService -KeyWord MSSQLSERVER
5. GetSQLService -ServiceName SQL -KeyWord MSSQLSERVER

万能参数，无需声明参数，直接使用内部参数：

[plain] view plain copy

1. Function GetSQLService
2. {
3. Get-Service -DisplayName "*$args*"
4. }

[plain] view plain copy

1. #这里用其他参数名，调用时函数将无法识别参数，不可这样使用。只能用$args
2. Function GetSQLService
3. {
4. Get-Service -DisplayName "*$ServiceName*"
5. }

求和函数示例：

1. #求和函数,调用函数时参数 $args 可以同时输入多个值。
2. Function Add
3. {
4. $sum=0
5. $args | foreach {$sum=$sum+$_}
6. $sum
7. }
8. Add 1 2 3 4 5 6 7 8 9 10

返回多值的函数，也可使用 return 返回，使用 return 后函数将结束返回，后面语句不会执行

1. Function Test { "Zero", "One", "Two", "Three" }
2. Function Test
3. {
4. "Zero"
5. "One"
6. "Two"
7. "Three"
8. }
9. Function Test { "Zero" "One" "Two" "Three" } #这样写错误！
10. Function Test
11. {
12. "Zero"
13. "One"
14. return "Two"
15. "Three"
16. }

输出注释，不会作为结果：

1. Function Test
2. {
3. Write-Host "此处为注释不作为结果，但同样会输出"
4. "Zero"
5. "One"
6. return "Two"
7. "Three"
8. }
9. Test
10. $Test = Test

隐藏函数内部的错误：

1. #函数内部有错误，调用时也返回错误！
2. Function Test { Stop-Process -Name "kk123456" }
3. #使用参数 $ErrorActionPreference 可隐藏错误
4. Function Test
5. {
6. $ErrorActionPreference="SilentlyContinue"
7. Stop-Process -Name "kk123456"
8. $ErrorActionPreference="Continue"
9. }

管道应用：函数内部处理上一个的结果集：

1. Function Test { $input }
2. 2,0,1,2 | Test
3. Function Test
4. {
5. Foreach ($element in $input)
6. {
7. "value: "+$element
8. }
9. }
10. 2,0,1,2 | Test

使用过滤器 Filter（特殊函数）的流模式处理管道数据，避免结果集太大占用过多内存或进程等待太久

[plain] view plain copy

1. Filter Test
2. {
3. Foreach ($element in $input)
4. {
5. "value: "+$element
6. }
7. }
8. 2,0,1,2 | Test

使用Filter时， $input 每次传递一个元素，不再是整个结果集，因此不必要了，用变量 $_ 替代

1. Filter Test{ $_.name }
2. Get-Service -DisplayName "*MSSQLSERVER*" | Test

函数在内部 process 也可以处理多结果集：

1. Function Test{
2. begin{ $i=1 }
3. process{
4. $_.name
5. $i++
6. }
7. end{}
8. }
9. Get-Service -DisplayName "*MSSQLSERVER*" | Test