调用 PowerShell

UiPath.Core.Activities.InvokePowerShell

描述

“调用 Power Shell”活动使用指定的输入参数执行 PowerShell 命令或脚本。

备注：限制 PowerShell 访问的防病毒策略可能会阻止使用 PowerShell 相关活动。例如，在迈克菲端点安全中启用规则 ID 6151 时，您不能使用调用工作流文件和调用 Power Shell。

项目兼容性

Windows - 旧版 | Windows

配置

• 命令文本 - 要执行的 PowerShell 命令。此值可以是 cmdlet 的名称，也可以是 PowerShell 脚本的文本。

属性面板

常见

• “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。
  注意：如果 Try Catch 异常处理中包含该活动且出错时继续属性的值为 True，则系统在执行项目时不会捕获任何错误。
• “显示名称”- 活动的显示名称。

输入

• 参数 - PowerShell 命令参数字典。可以使用特定命令 (cmdlet) 或脚本。
  • 特定命令：调用特定命令时，参数名称应与命令参数的名称相符。
    例如，如果您使用 Get-Command -Module CimCmdlets 作为输入，则输入值必须为 Get-Command，并且应将参数命名为 Module，并将值设置为 "CimCmdlets"。
  • 脚本：在脚本开头，您需要指定参数的类型。（可选）您也可以强制使用参数，以强制脚本始终使用调用者设置的参数进行调用。
    例如，以下脚本支持使用两个参数， 其中一个参数类型为字符串，另一个参数类型为整数：

    Param(
       [Parameter(Mandatory=$true)]
       [string]$Name,
       [int]$Age
    )

    然后，通过在参数名称前面添加 $，即可在脚本中引用这些参数。

• 输入 - PSObject 的集合，系统会将其传递给用于执行命令的管道编写器。可以是另一个“调用 PowerShell”活动的输出。您可以使用 $input 在脚本中引用管道输入。
  注意：此变量由 PowerShell 隐式创建。定义名为 input 的变量或参数可能会生成错误或导致冲突。建议为管道保留 input 一词。

其他

• 执行模式 - 选择要用于执行所提供命令或脚本的 PowerShell 版本。这仅适用于 Windows 项目，Windows 旧版项目目标 Windows PowerShell 5.1（32 位）版本。

  可用的选项如下：

  • PowerShell 7.2（64 位） - 使用基于 .NET6 的 PowerShell Core Shell。在此版本中，PowerShell 托管在 .NET 6 Runtime 中。使用的任何数据都可以通过该活动直接访问，并且可以导入到工作流中。
  • PowerShell 5.1（64 位） - 使用 64 位 Windows PowerShell 可执行文件。在此版本中，PowerShell 与 Windows 捆绑在一起，默认情况下位于 C:\Windows\System32\WindowsPowerShell\v1.0\ 中。在此执行模式下，PowerShell 使用预装的 Shell 在计算机本地远程运行。.NET Remoting 引入了在不同 .NET 运行时之间序列化和反序列化信息的需求，因此无法重建的对象包含在 PSObject 或 PSCustomObject 中。
  • PowerShell 5.1（32 位）- 使用 32 位 Windows PowerShell 可执行文件。在此版本中，PowerShell 与 Windows 捆绑在一起，默认情况下位于 C:\Windows\SysWOW64\WindowsPowerShell\v1.0\。在此执行模式下，PowerShell 使用预装的 Shell 在计算机本地远程运行。 .NET Remoting 引入了在不同 .NET 运行时之间序列化和反序列化信息的需求，因为无法重建的此类对象包含在 PSObject 或 PSCustomObject 中。PSObject 和 PSCustomObjects 保存有关原始对象整体结构的信息，可用于手动重建对象。
• 是脚本 - 指定命令文本是脚本还是直接命令。管道、变量和参数可与单个命令或脚本一起使用。
• PowerShell 变量 - 命名对象字典，表示在“调用 PowerShell”活动的当前会话中使用的变量。PowerShell 命令或脚本可以从 In 和 In/Out 变量中检索信息，并可以设置 Out 变量。要在脚本中引用变量，请使用变量标识符字符 $ 来表示其后的文本是变量名称。示例：$firstVariable。
  注意：变量名称不区分大小写。
• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。
• 类型参数 - 设置输出变量的类型。

输出

• 输出 - 执行命令后返回的“类型参数”对象的集合。可用于传送多个“调用 PowerShell”活动。