Usage

Download the plugin and extract the .zip file. A tutorial is available in the form of an example process in the imports/process/PowerShell+Example.json file. To see the tutorial content, import the example process.

Step palette

To access this plugin in the palette, click Scripting > PowerShell.

Steps

The following process steps are available in the Powshell plugin.

• Run PowerShell Script

Run PowerShell Script

Runs a PowerShell script. This step allows for bidirectional passing of script variables and HCL Launch properties.

Troubleshooting

Errors and solutions

ERROR

FullyQualifiedErrorId : MethodInvocationNotSupportedInConstrainedLanguage

SOLUTION

This issue is caused by a new policy update to the Windows defender application control (WDAC) Windows GPO. It resulted in PowerShell on the agent servers to run in ConstrainedLanguage mode, causing the error. To enable full language support, refer to the following link: https://stackoverflow.com/questions/57032747/how-to-change-powershell-mode-to-fulllanguage-mode-from-constrained-mode

ERROR

PowerShell script execution failed. Error Message: Windows PowerShell is in Non-Interactive mode. Read and Prompt functionality is not available.

SOLUTION

When scripts are run in non-interactive mode, Stop-Process requires the -Force option to make it non-interactive even if -Confirm:$false is set. Change the line of your script to: Stop-Process -Name $process -Force

For additional assistance on this issue, refer to the following links:

• https://stackoverflow.com/questions/16580723/powershell-in-noninteractive-mode
• https://help.octopus.com/t/deploy-windows-powershell-is-in-noninteractive-mode/1313

ERROR

PowerShell exits with exit code 1 rather than returning $LASTEXITCODE when last process exit code is >0.

SOLUTION

This is a bug in MS PowerShell and a PS v7.0.0 error. Details and workarounds are found at the following links:

• https://github.com/PowerShell/PowerShell/issues/11461
• https://stackoverflow.com/questions/50200325/returning-an-exit-code-from-a-powershell-script

ERROR

System.Management.Automation.ExitException: System error.

SOLUTION

This is a PS script error. Solutions are found at the following link: https://stackoverflow.com/questions/42481761/system-management-automation-exitexception-system-error-in-powershell-studio

ERROR

System error" from invoke command: System.Management.Automation.StopUpstreamCommandsException

SOLUTION

This is a MS PowerShell error and caused because Script is wrapped in the Invoke-Command. This is a PS v6.1.3 error and resolved in a later version. This issue was resolved in #10840 and released as the version 7.0.0 and previewed at the following link: https://github.com/PowerShell/PowerShell/pull/10840.

Details and workarounds are found at the following links:

• https://github.com/PowerShell/PowerShell/issues/9185.
• https://stackoverflow.com/questions/58582692/why-system-error-stopupstreamcommandsexception-is-raised-only-from-inside-invok.

Questions and Answers

Why does the plugin step succeed when the PowerShell script exits with a -128 error status?

The plug-in is configured by default to accept a -128 status as success. By default, PowerShell exits with a 0 error status even if the script fails, so using 0 results in false positives. If the -128 status overlaps with a custom error status that is used in your script, change the error status in the hidden properties.

How can I pass the -file parameter?

Use one of the following options:

• Insert PowerShell -non-interactive -Additional_Parameters_Here
• Use the Shell plugin to interact with the command line.

How can I run the script in a multi-threaded apartment model?

Perform the following:

• Navigate to the hidden properties.
• Add -MTA to one of the argument properties.

Why is script output not displayed in the HCL Launch log?

The HCL Launch log stores all PowerShell output. You may need to change the PowerShell output preferences. To learn more, refer to the Microsoft documentation here: https://technet.microsoft.com/en-us/library/hh847796.aspx.