Property

Details

PowerShell

Enter the command you want executed on the target computer. The syntax for the command is the same as when running commands in PowerShell.exe. Multiple commands are supported—enter one command per line.

The command is executed on the target computer in the %SystemRoot%\AdminArsenal\PDQDeployRunner\service-n\exec directory. You can also specify commands and specific paths for files at other locations.

If the command requires user interaction, set Run As (on the Options tab) to Logged On User or Deploy User (Interactive). For details about the Run As option, see Deployments Preferences.

NOTE: Write-Output is recommended over Write-Host for formatting purposes.

Note: The PowerShell step includes some basic error handling. For more detailed information on error handling, see PowerShell Error Handling.

Insert PowerShell Script

This will attach a PowerShell script (.ps1) file to your package and call that file from within the PowerShell Step. The included file will be listed in the Files field of the step.

Files

Select any additional files you wish to include with the command. This is useful for running utilities that may not be installed on all target computers or for including configuration files.

These files are copied into the %SystemRoot%\AdminArsenal\PDQDeployRunner\service-n\exec directory on the target computer.

Success Codes

The success or failure of the PowerShell step is determined by its return code. A command is considered a success if the return code is listed in the Success Code box.

For programs not native to PowerShell, PowerShell has a built-in variable called $LastExitCode that stores the last return code. This behaves similar to the %ERRORLEVEL% from a regular command line.

For native PowerShell cmdlets, no return code is given. Any native PowerShell cmdlets that encounter an error will return a PackagePowerShellErrorException for the step.

Note: The PowerShell step includes some basic error handling. For more detailed information on error handling, see PowerShell Error Handling.

Command Line

This is the command that will be executed on the target computer.