Run Powershell File

Version: 1.0

Category: Input

Extended Category: Powershell

Action Package: Standard Actions

Description

Launch and run a PowerShell script file, without any input from the powershell execution.

Use Cases

Example 1: Run script with no parameters

This action will run a script that do not take any parameters. It will therefor only need to run once.

The powershell file path has been entered in global parameter POWERSHELL_PATH.

The script GetAllUsernames.ps1:

[CmdletBinding()]
Param(
 [Parameter(Mandatory=$True)]
 [string]$outputfile
)

$obj = Get-ADUser -Filter * -SearchBase 'OU=IM,DC=company,DC=local'

Out-File -FilePath $outputfile -Encoding UTF8 -InputObject ($obj | Format-List SamAccountName)

Example 2: Run script with parameters

This action will run a script that requires a parameter. It uses the value from a session attribute in the parameter value, so it has to run once for each session object.

The powershell file path has been entered in global parameter POWERSHELL_PATH.

The script GetUsersByLocation.ps1:

[CmdletBinding()]
  Param(
    [Parameter(Mandatory=$True)]
    [string]$location,
    [Parameter(Mandatory=$True)]
    [string]$outputfile
)

$result=Get-ADUser -LDAPFilter '(l=$location)'

$obj = New-Object PSObject -Property @{
  givenname = $result.GivenName
  sn = $result.Surname
 }

Out-File -FilePath $outputfile -Encoding UTF8 -InputObject ($obj | Format-List)