使用 InvokePowerShell 活动
本主题适用于 Windows Workflow Foundation 4。
InvokePowerShell 示例演示如何使用 InvokePowerShell 活动调用 Windows PowerShell 命令。
演示
Windows PowerShell 命令的简单创新。
从 Windows PowerShell 输出管道检索值，并将这些值存储在工作流变量中。
将数据作为执行命令的输入管道传入 Windows PowerShell 中。
.gif "Dd797586.Important(zh-cn,VS.100).gif") 注意： |
|---|
您的计算机上可能已安装这些示例。在继续操作之前，请先检查以下（默认）目录：
<安装驱动器>:\WF_WCF_Samples
如果此目录不存在，请转到 .NET Framework 4 的 Windows Communication Foundation (WCF) 和 Windows Workflow Foundation (WF) 示例（可能为英文网页），下载所有 Windows Communication Foundation (WCF) 和 WF 示例。此示例位于以下目录：
<安装驱动器>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\PowerShell
|
讨论
此示例包含以下三个项目。
| 项目名称 | 说明 | 主要文件 |
|---|---|---|
CodedClient |
使用 PowerShell 活动的示例客户端应用程序。 |
|
DesignerClient |
一个自定义活动集，其中包含 |
|
PowerShell |
|
活动文件
设计器文件：
|
首先讨论客户端项目，因为在了解 PowerShell 活动的用法之后再了解它的内部功能会更容易一些。
使用此示例
以下各节说明如何使用此示例中的三个项目。
使用 CodedClient 项目
示例客户端以编程方式创建一个顺序活动，其中包含几个使用 InvokePowerShell 活动的不同的方法的示例。第一次调用将启动“记事本”。
new InvokePowerShell()
{
CommandText = "notepad"
},
第二次调用将获取本地计算机上正在运行的进程的列表。
new InvokePowerShell<Process>()
{
CommandText = "Get-Process",
Output = processes1,
},
Output 是用于存储命令输出的变量。
下一次调用将演示如何对 PowerShell 调用的每个单独输出运行后续处理步骤。InitializationAction 将设置为输出每个进程的字符串表示形式的函数。InvokePowerShell<string> 活动将在 Output 变量中返回这些字符串的集合。
后续的 InvokePowerShell 调用演示如何将数据传入到活动中以及如何显示输出和错误。
使用 DesignerClient 项目
DesignerClient 项目由一组自定义活动组成，生成的所有这些活动几乎都包含 InvokePowerShell 活动。大多数活动都调用非泛型版本的 InvokePowerShell 活动，并且不期待返回值。其他活动使用泛型版本的 InvokePowerShell 活动，并使用 InitializationAction 参数对结果进行后续处理。
使用 PowerShell 项目
活动的主要操作是在 ExecutePowerShell 类中进行的。由于执行 PowerShell 命令时将不会阻止主要工作流线程，因此通过从 AsyncCodeActivity 类继承可将活动创建为异步活动。
工作流运行时调用 BeginExecute 方法以开始运行活动。首先，它通过调用 PowerShell API 来创建 PowerShell 管道。
runspace = RunspaceFactory.CreateRunspace();
runspace.Open();
pipeline = runspace.CreatePipeline();
然后，它创建一个 PowerShell 命令并在此命令中填入参数和变量。
Command cmd = new Command(this.CommandText, this.IsScript);
// loop over parameters and run: cmd.Parameters.Add(...)
// loop over variables and run: runspace.SessionStateProxy.SetVariable(...)
pipeline.Commands.Add(cmd);
此时，已传入的输入也将发送到此管道。最后，此管道将包装在 PipelineInvokerAsyncResult 对象中，并会返回此管道。PipelineInvokerAsyncResult 对象注册侦听器并调用此管道。
pipeline.InvokeAsync();
在完成执行后，输出和错误将存储在同一个 PipelineInvokerAsyncResult 对象中，并会通过调用最初传递到 BeginExecute 的回调方法将控制交还给工作流运行时。
在方法的执行过程结束时，工作流运行时会调用活动的 EndExecute 方法。
InvokePowerShell 类包装 ExecutePowerShellCommand 类并创建活动的两个版本，即泛型版本和非泛型版本。非泛型版本直接返回 PowerShell 执行的输出，而泛型版本会将各个结果转换为泛型类型。
将泛型版本的活动作为一个顺序工作流实现，这将调用 ExecutePowerShellCommand 并对其结果进行后续处理。对于结果集合中的每个元素，后续处理步骤将调用 InitializationAction（如果已设置的话）。否则，它将执行一个简单的强制转换。
new ForEach<PSObject>
{
Values = psObjects,
Body = new ActivityAction<PSObject>
{
Argument = psObject,
Handler = new Sequence
{
Activities =
{
new If
{
Condition = // Is InitializationAction set?
Then = new InvokeFunc<PSObject, TResult>
{
Argument = psObject,
Result = outputObject,
Func = this.InitializationAction
},
Else = new Assign<TResult>
{
To = outputObject,
Value = new InArgument<TResult>(ctx => (TResult) psObject.Get(ctx).BaseObject),
}
},
new AddToCollection<TResult>
{
Collection = outputObjects,
Item = outputObject
},
}
}
}
},
已为两个 InvokePowerShell 活动（泛型和非泛型）创建了设计器。InvokePowerShellDesigner.xaml 及其关联的 .cs 文件定义非泛型版本的 工作流设计器 活动在 InvokePowerShell 中时的外观。在 InvokePowerShellDesigner.xaml 中，将使用 DockPanel 表示图形界面。
<DockPanel x:Uid="DockPanel_1" LastChildFill="True">
<TextBlock x:Uid="TextBlock_1" Text="CommandText" />
<TextBox x:Uid="TextBox_1" Text="{Binding Path=ModelItem.CommandText, Mode=TwoWay}"
TextWrapping="WrapWithOverflow" AcceptsReturn="True" MinLines="4" MaxLines="4"
Background="{x:Null}" Margin="3" />
</DockPanel>
请注意，文本框的 Text 属性是一个双向绑定，它可确保活动的 CommandText 属性的值与设计器中输入的值相等。
GenericInvokePowerShellDesigner.xaml 及其关联的 .cs 文件定义了泛型 InvokePowerShell 活动的图形界面。设计器会稍微复杂一些，因为它允许用户设置 InitializationAction。关键在于使用 WorkflowItemPresenter 以允许将子活动拖放到 InvokePowerShell 设计器图面上。
<sap:WorkflowItemPresenter x:Uid="sap:WorkflowItemPresenter_1" Margin="0,10,0,10"
HintText="Drop Activities Here"
AllowedItemType="{x:Type sa:Activity}"
Item="{Binding Path=ModelItem.InitializationAction.Handler, Mode=TwoWay}"
Grid.Row="1" Grid.Column="1" />
设计器自定义并不仅限于用于定义活动在设计画布上的外观的 .xaml 文件。还可以自定义用于显示活动参数的对话框。这些参数和 PowerShell 变量将影响 PowerShell 命令的行为。活动会将它们作为 Dictionary 类型公开。ArgumentDictionaryEditor.cs、PropertyEditorResources.xaml 和 PropertyEditorResources.cs 定义可供您用来编辑这些类型的对话框。
设置、生成和运行示例
必须安装 Windows PowerShell 才能运行此示例。可以从以下位置安装 Windows PowerShell：Windows PowerShell。
运行 CodedClient
使用 Visual Studio 2010 打开 PowerShell.sln。
右击该解决方案并生成它。
右击**“CodedClient”项目，然后选择“设为启动项目”**。
按 Ctrl+F5 运行应用程序。
运行 DesignerClient
使用 Visual Studio 2010 打开 PowerShell.sln。
右击该解决方案并生成它。
右击**“DesignerClient”项目，然后选择“设为启动项目”**。
按 Ctrl+F5 运行应用程序。
已知问题
如果从另一个项目引用
InvokePowerShell活动程序集或项目时导致出现生成错误，则可能需要手动将<SpecificVersion>True</SpecificVersion>元素添加到该新项目的 .csproj 文件中引用InvokePowerShell的行下方。如果未安装 Windows PowerShell，则一旦将
InvokePowerShell活动添加到工作流，Visual Studio 中就会显示以下错误消息：工作流设计器在您的文档中遇到了问题。未能加载文件或程序集“System.Management.Automation”... 或它的某一个依赖项。系统找不到指定的文件。在 Windows PowerShell 2.0 中，以编程方式调用
$input.MoveNext()失败，并且使用$input.MoveNext()的脚本会产生意外的错误和结果。若要解决此问题，请考虑在循环访问数组时使用 PowerShell 谓词foreach而不是调用MoveNext()。
| 注意： |
|---|
您的计算机上可能已安装这些示例。在继续操作之前，请先检查以下（默认）目录。
<安装驱动器>:\WF_WCF_Samples
如果此目录不存在，请转到 .NET Framework 4 的 Windows Communication Foundation (WCF) 和 Windows Workflow Foundation (WF) 示例（可能为英文网页），下载所有 Windows Communication Foundation (WCF) 和 WF 示例。此示例位于以下目录。
<安装驱动器>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\PowerShell
|