Activities
...
The PS Script activity parameters can be provided by manual inserted values or via IN arguments or variables:
Parameters:
- Command (text box editor type) (type: string):
- the PowerShell inline script. This parameter takes precedence over the Script Code parameter. Without $using, a $a workflow variable (variable defined via workflow, visible in the Variables area) is not visible in the script. $Using imports the variable and its current value (e.g. {$a = $using:a+1; $a})
- the Command editor has a syntax highlighting toggle, for displaying the lines according to the chosen language. In the example below, PowerShell was used:
the user can also use an external editor of his/her choice via the button to the left of the edit field (
). The external editor is by default Windows notepad, but it can be changed in the Designer Settings.
- Include Administrator Scripts (combobox editor type) (type: string): this parameter specifies whether to include the execution of the scripts assigned to the task in Administrator. The task selected from Administrator will be executed first and added to the result of the powershell script.
- Parameters collection (collection editor type) (type: string): the parameters you want to send with the request. e.g. Name: -ArgumentList and Value:arg1.
- Password Name (text box editor type) (type: string): the name for the password variable used in the script. This is used in case of scripts that are using password variables, in order for a plain text password display to be avoided.
- Password (password box editor type) (type: string): the value for the password that will be used in the script (encrypted).
- Password Binding (text box editor type) (type: string): bind to a variable containing the encrypted password for the script.
- Script Code (text box editor type) (type: string): the Powershell script code to be executed. For example: "mkdir 'C:\FlowsterSolutions'" (this command creates a folder with the specified path).
- Script File (text box editor type) (type: string): the Powershell script file. This parameter takes precedence over the Command and the Script Code parameter.
- Script Parameters (text box editor type) (type: string): the parameters that will be passed to the PowerShell code stored in a PowerShell script file. For multiple parameters, separate the values with comma ( , ). This parameter will take effect only when a script file is selected for execution.
As mentioned above, the values for all the required parameters can be provided by IN arguments or variables. Below is an example of predefined arguments, ready to be used by the PS Script activity:
Parameters Remoting:
- Remote Machine (text box editor type): the name of the machine for the remote connection
- Remote Password (password box editor type) (type: string): the value for the user password that will be used in the script (encrypted).
- Remote Password Binding (text box editor type) (type: string): bind to a variable containing the encrypted password for the PS machine host.
- Remote User (text box editor type): the user name for the remote connection. The user name can be added with domain ( mydomain\username) or without it.
The Read Only Output variable are the possible output values that the activity will provide:
...