PowerShell inside BatchController

Requirements and restrictions to run PowerShell scripts inside the Batchcontroller:

• PowerShell version:
  The PowerShell version on the system where the BatchController is running must be at least PowerShell version 7.6.1, recommended is the newest 7.6.* version.
  Within PowerShell the version is displayed by running:
  

  $PSVersionTable

• Execution Policy:
  The execution policy need to be set to RemoteSigned with the scope of LocalMachine
  This can be achieved by running the following command in PowerShell with Administrators rights:
  

  set-executionpolicy remotesigned -Scope LocalMachine

• For more information about execution policies, see execution policy on the Microsoft website.
  
• MyInvocation:
  

  Usage of "$MyInvocation" inside the scripts and Avanade script libraries must be removed, as not all properties are filled because of limits from Microsoft automation.

  For example when you have the following code:

  $ScriptPath = (Split-Path $MyInvocation.MyCommand.Path)
  .$ScriptPath"\AmtSettings.ps1"

  It must be changed to:

  .".\AmtSettings.ps1"

  The script has the folder it is located in, set as current folder by default.

  Getting the script name is typically coded as follows:

  $Base = Get-Item $myInvocation.ScriptName | select BaseName
  return $Base.BaseName

  Which can be changed to:

  $AmtScriptName = "$env:AMTJOBNAME"
  if (-not ([String]::IsNullOrEmpty($AmtScriptName))) {
  return $AmtScriptName
  }

• When run inside the Batchcontroller, the environment variable "AMTJOBNAME" is set to the active script.

• Exit statement:
  

  Any "Exit" statement must also set a PowerShell variable "$Global:AmtExitCode" for the Batchcontroller to read it correctly:

  Change from:

  Exit $ExitCode

  To:

  $Global:AmtExitCode = $ExitCode
  Exit $ExitCode