Applies to:

  • Winshuttle Foundation

Execute Powershell Plug-in

The Execute Powershell plug-in allows you to invoke a Powershell command or script within a workflow.

Usage example

Powershell can be used to perform a variety of complex tasks. For example, you might use Powershell to make specific changes to a SharePoint list, such as changing list permissions, adding or removing columns, or a sequence of commands contained within a single script.

Value Pair

Description

arguments

The arguments to pass to the command.

command

The path to the server and the name of the Powershell script to run.

For example: \\server-name\folder-name\command-name.ps1

outputcolumn

The SharePoint column into which the output will be placed.

When you save and route a form using the Execute Powershell Plug-in, an entry is made in the SVService that will run the next time svservice.exe runs. (See Winshuttle Workflow SVService types for more information about SVService.)

Important: If you use the form element property Run Embedded Plug-in with the Execute Powershell Plug-in it does the same thing, i.e. creates an entry for SVService that will run the next time SVService runs.

Tip: Only plug-ins that do not need SVService to run will run immediately.

Winshuttle recommends

  • Use the Execute Powershell Plug-in with the Workflow Plug-in node
  • Do not use the Execute Powershell Plug-in with embedded buttons.