工作流活动

描述​

项目兼容性​

配置​

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

属性面板​

常见​

• “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。
  备注：

  如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为“True”，则系统在执行项目时不会捕获任何错误。

• “显示名称”- 活动的显示名称。

输入​

• 参数 - PowerShell 命令参数字典。可以使用特定命令 (cmdlet) 或脚本。
  • 特定命令：调用特定命令时，参数名称应与命令参数的名称相符。

• 脚本：在脚本开头，您需要指定参数的类型。（可选）您也可以强制使用参数，以强制脚本始终使用调用者设置的参数进行调用。

Param(
  [Parameter(Mandatory=$true)]
  [string]$Name,
  [int]$Age
)
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”活动。