除了作为一种脚本语言外，Windows PowerShell被多种应用程序使用。这是因为Windows PowerShell引擎可以被托管在一个应用程序内部。这篇博文和下一篇博文将会处理在C#应用程序中托管Windows Powershell的多个API.
用来托管Windows Powershell最为重要的一个类型是System.Management.Automation.PowerShell类。这个类提供了用来创建命令管道和在运行空间中执行命令的方法。
添加命令（AddCommand）
让我们来看一个非常简单的例子。假设你想得到当前机器上运行的进程的一个列表。执行命令的方式如下。
步骤 1 – 创建一个 PowerShell 对象
|
1
|
PowerShell ps = [PowerShell]::Create(); |
步骤 2 – 添加你想执行的命令
|
1
|
ps.AddCommand(“Get-Process”);
|
步骤 3 –执行这些命令
|
1
|
ps.Invoke(); |
你也可以像这样一步到位执行这些步骤:
|
1
|
[PowerShell]::Create().AddCommand(“Get-Process”).Invoke();
|
添加参数（AddParameter）
上面执行单个命令的例子没有任何参数。比方说，我想得到运行在当前机器上的所有PowerShell进程。我就可以使用AddParamete方法来给命令添加参数了。
|
1
2
3
|
[PowerShell]::Create().AddCommand(“Get-Process”)
.AddParameter(“Name”, “PowerShell”)
.Invoke();
|
如果想添加更多参数，可以像这样继续调用：
|
1
2
3
4
|
[PowerShell]::Create().AddCommand(“Get-Process”)
.AddParameter(“Name”, “PowerShell”)
.AddParameter(“Id”, “12768”)
.Invoke();
|
或者，如果你有一个包含参数名和参数的词典，可以使用AddParameters ，来添加所有参数。
|
1
2
3
4
5
6
|
IDictionary parameters = new Dictionary<String, String>();parameters.Add("Name", "PowerShell");
parameters.Add("Id", "12768");
[PowerShell]::Create().AddCommand(“Get-Process”)
.AddParameters(parameters)
.Invoke()
|
添加语句（AddStatement）
现在我们已经执行了一个单独的命令和它的参数，让我们再来执行一堆命令。PowerShell API给我们提供了一个模拟批处理的方式，这样就可以在管道的末尾追加额外的语句。获取所有正在运行的进程，然后再获取所有正在运行的服务，可以这样做：
|
1
2
3
4
|
PowerShell ps = [PowerShell]::Create();ps.AddCommand(“Get-Process”).AddParameter(“Name”, “PowerShell”);
ps.AddStatement().AddCommand(“Get-Service”);
ps.Invoke(); |
添加脚本（AddScript）
AddCommand方法只能添加命令。如果我想运行一个脚本，我可以使用 AddScript 方法。假设我们有一个简单的脚本，a.ps1,可以获取机器上所有运行的PowerShell进程的的数量。
|
1
2
3
4
5
6
|
------------D:\PshTemp\a.ps1----------$a = Get-Process -Name PowerShell
$a.count
------------D:\PshTemp\a.ps1----------PowerShell ps = [PowerShell]::Create();ps.AddScript(“D:\PshTemp\a.ps1”).Invoke(); |
AddScript API也提供了一个选项来在本地作用域运行脚本。在下面的例子中，脚本会在本地作用域中来执行，因为我们将true传递给了参数useLocalScope 。
|
1
2
|
PowerShell ps = [PowerShell]::Create();ps.AddScript(@“D:\PshTemp\a.ps1”, true).Invoke(); |
处理错误，详细消息，警告和进度信息(Handling Errors, Verbose, Warning, Debug and Progress Messages)
PowerShell API也能让我们访问命令运行时产生的错误和详细信息等。你可以使用PowerShell.Streams.Error属性获取错误信息，和PowerShell.Streams.Verbose 属性获取详细信息。下面的属性也可以获取进度，调试，和警告信息。
|
1
2
3
4
|
PowerShell ps = [PowerShell]::Create() .AddCommand("Get-Process")
.AddParameter("Name", "Non-ExistentProcess");
ps.Invoke(); |
ps.Streams.Error有一个命令运行时产生的错误列表，下面的情况，我们在查询一个不存在的进程时得到了一个错误
|
1
2
3
4
5
6
|
Get-Process : Cannot find a process with the name "Non-ExistentProcess".
Verify the process name and call the cmdlet again.
+ CategoryInfo : ObjectNotFound: (Non-ExistentProcess:String) [Get-Process],
ProcessCommandException+ FullyQualifiedErrorId :NoProcessFoundForGivenName,Microsoft.PowerShell.Commands.GetProcessCommand |
PowerShell API 非常强大。它能让我们在同步/异步模式下运行命令，创建一个只能运行有限命令集的受约束的运行空间，在嵌套的管道中执行命令，等等。
在本文中的所有例子中，我们创建了一个包含了所有Windows PowerShell 内置命令的默认运行空间，这在内存消耗方面并不高效。在更多的场景中，用户可能想创建一个只包含指定命令集/语言元素的运行空间。在下一篇博文中，我们会解释如何创建一个受限制但是效率更高的运行空间。
Original Author: Indhu Sivaramakrishnan [MSFT] （Windows PowerShell Developer）
From：http://www.pstips.net/paap-windows-powershell-as-a-platform-part-1.html
http://blogs.msdn.com/b/powershell/archive/2013/10/01/paap-windows-powershell-as-a-platform-part-1.aspx