Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Find the below examples for download (.json upload)run-powershell-unix.workflow.json
  • In order to directly add PowerShell script code to a JS7 shell job script the recommended approach is to use a shebang like this:

    Code Block
    languagebash
    titleExample how use 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

    Code Block
    languagebash
    titleExample how to add 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 to :
      • quote quoting the script by single quotes.
      • quote quoting code inside the script with double quotes or to use using escape characters for single quotes.
    • Consider Note that each PowerShell command has to be terminated with a semicolon.

  • An even more weird way how to add weirder way of adding PowerShell code to JS7 job scripts includes:

    Code Block
    languagebash
    titleExample how to add PowerShell script code from a multiple lines
    pwsh -NoLogo -NonInteractive -Command '& { `
      Echo "Hello"; `
      Echo "World"; `
    }'

    Explanation:

    • Consider Note the use of single quotes , double quotes and semicolons as from 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 with by the respective executing Agent:

    Code Block
    languagebash
    titleExample how to add 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 add PowerShell script code to a JS7 shell job script the recommended approach is to use a shebang replacement like this:

    Code Block
    languagebash
    titleExample how use 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 that which are easily referenced from a shell jobjobs, e.g. by using ##!include pwsh
    • The PowerShell executable pwsh.exeexe executable is available starting from with PowerShell 6.0. PowerShell releases 5.x use the executable powershell.exe that can be used accordingly with the shebang accordingly.
  • As a bad alternative the PowerShell executable can be invoked directly and can be parameterized like this:

    Code Block
    languagebash
    titleExample how to add PowerShell script code from a single line
    pwsh.exe -NoLogo -NonInteractive -Command "& { Echo ""Flight Destination: $env:FLIGHT_DESTINATION""; Echo ""Booking Code: $env:BOOKING_CODE""; }"

    Explanation:

    • Consider the quoting: when using the -Command parameter then the PowerShell script has to be specified from a string. This includes to :
      • quote quoting the script by double quotes.
      • quote code quoting code inside the script with two double quotes or to use using single quotes.
    • Consider Note that each PowerShell command has to be terminated with a semicolon.


  • Last but not least a PowerShell script can be executed from a file that has to be located with by the respective executing Agent:

    Code Block
    languagebash
    titleExample how to add PowerShell script code from a file
    pwsh.exe -NoLogo -NonInteractive -File some_powershell_script.ps1

...