Get Attributes from Powershell File

Version: 1.0

Category: Input

Extended Category: Powershell

Action Package: Standard Actions

Description

Run a powershell .ps1 file and create attributes for the result. The powershell script must receive a parameter called $outputfile and write the output to that file in UTF8 encoding. The output to the file must be one or multiple PSObjects in list format. It is possible to send additional powershell parameters to the script.

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, and the result will be added to all session objects.

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 result will be that two new session attributes will be added to the object, givenname and sn.

The script GetNamesFromUser.ps1:

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

$result=Get-ADUser -Identity $user

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

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