Introduction

PowerShell® is a frequently used scripting language available for Linux, MacOS, Windows and other platforms.
JS7 offers the JS7 - PowerShell Module for simplified access to the JS7 - REST Web Service API
This article explains how to syntactically include PowerShell® scripts with JS7 job scripts

Unix

Find the below examples for download (.json upload): run-powershell-unix.workflow.json
In order to directly run PowerShell® script code from a JS7 shell job script the recommended approach is to use a shebang like this:
Example how run PowerShell® script code with a shebang
```
#!/usr/bin/env pwsh
 
Write-Output "Hello"
Write-Output "world"
```
As a bad alternative the PowerShell® executable can be invoked directly and can be parameterized like this
Example how to run PowerShell® script code from a single line
```
pwsh -NoLogo -NonInteractive -Command '& { Echo "Hello"; Echo "World"; }'
```
Explanation:
- Consider the quoting: when using the -Command parameter then the PowerShell® script has to be specified from a string. This includes:
  - quoting the script by single quotes.
  - quoting code inside the script with double quotes or using escape characters for single quotes.
- Note that each PowerShell® command has to be terminated with a semicolon.
An even weirder way of running PowerShell® code from JS7 job scripts includes:
Example how to run PowerShell® script code from a number of lines
```
pwsh -NoLogo -NonInteractive -Command '& { `
  Echo "Hello"; `
  Echo "World"; `
}'
```
Explanation:
- Note the use of single quotes, double quotes and semicolons as in the previous example.
- In addition each line of script code has to be terminated with a backtick for line continuation.

Last but not least a PowerShell® script can be executed from a file that has to be located by the executing Agent:
Example how to run PowerShell® script code from a file
```
pwsh -NoLogo -NonInteractive -File some_powershell_script.ps1
```

Find the below examples for download (.json upload): run-powershell-windows.workflow.json
In order to directly run PowerShell® script code from a JS7 shell job script the recommended approach is to use a shebang replacement like this:
Example how run PowerShell® script code with a shebang replacement
```
@@findstr/v "^@@f.*&" "%~f0"|pwsh.exe -&goto:eof

Write-Output "Hello" 
Write-Output "world" 
```
Explanation:
- Credits for the shebang replacement to How to run a PowerShell script within a Windows batch file
- If you consider this shebang replacement somewhat cryptic then add it to JS7 - Script Includes which are easily referenced from shell jobs, e.g. by using ##!include pwsh
- The PowerShell® pwsh.exe executable is available starting with PowerShell 6.0. PowerShell releases 5.x use the executable powershell.exe that can be used with the shebang accordingly.

Last but not least a PowerShell® script can be executed from a file that has to be located by the executing Agent:
Example how to run PowerShell® script code from a file
```
pwsh.exe -NoLogo -NonInteractive -File some_powershell_script.ps1
```