Run PowerShell Script

Run PowerShell Script executes a .ps1 script through a Command Runner policy. The script path must resolve under that runner's Allowed Paths.

It is the PowerShell counterpart to Run Bash Script, with one additional setting: Use -Command (instead of -File) changes how the script is handed to PowerShell.

The activity has four tabs: Configuration, Arguments, Environment, and Output.

Configuration

Field	Required	Description
Name	Optional	Name of the component.
Description	Optional	Description of the component.
Command Runner	Optional	The Command Runner policy resource that gates this execution.
Script Path	Optional	Path to the .ps1 script; must resolve under the runner's Allowed Paths.
Use -Command (instead of -File)	Optional	When enabled the script is passed via -Command rather than -File. Defaults to cleared.
Working Directory	Optional	Must be under the runner's Allowed Paths. Defaults to the first Allowed Paths entry.
Standard Input	Optional	Text written to the process stdin, which is then closed.

Script Path, Working Directory, and Standard Input each support mapped and vault-backed values.

Arguments

Field	Required	Description
Arguments	Optional	Arguments passed after the script path, each a discrete array element.

Environment

Field	Required	Description
Environment Overrides	Optional	Per-run environment variables applied on top of the runner's environment.

Values are mapping and vault capable.

Output

The activity returns a scriptOutput object.

Field	Data Type	Description
exitCode	Integer	Process exit code.
stdout	String	Captured standard output.
stderr	String	Captured standard error.
durationMs	Integer	Run duration in milliseconds.
timedOut	Boolean	Whether the run exceeded Max Runtime (seconds) on the Command Runner.
truncated	Boolean	Whether output exceeded Max Output Bytes (per stream) and was cut short.