Start Process

Starts a system process or application with arguments.

Behaviour

Risk: High · Idempotent: No · Safe to retry: No · Recovery: Not replayed after a crash

Package System activities VeloPhex.System.Activities 0.7.1-rc.12 · Supported (Core profile) · type id velophex.system.startProcess

Properties#

Input#

File Name#

FileName · String · Required · Default: Not specified in package metadata

Path to executable or command to run.

Arguments#

Arguments · String · Optional · Default: Not specified in package metadata

Command-line arguments to pass.

Working Directory#

WorkingDirectory · String · Optional · Default: Not specified in package metadata

Working directory for the process.

Wait For Exit#

WaitForExit · Boolean · Optional · Default: False

Blocks execution until process terminates.

Timeout (ms)#

TimeoutMS · Int32? · Optional · Default: Not specified in package metadata

With Wait For Exit, how many milliseconds to wait before the step fails; the process keeps running. Empty: wait until it exits.

Output#

Exit Code#

ExitCode · Int32? · Output

Process exit code if WaitForExit was true.

Process ID#

ProcessId · Int32? · Output

The started process's ID.

Retry and risk#

This activity is not marked safe to retry: if it fails partway, check whether its work already happened before running it again. If a run is interrupted and the outcome of a step is unknown, the step is never retried automatically (what to do). How activities declare this: characteristics, retries and risk.

Every activity also has the engine's common properties: Timeout and Continue On Error.

Related activities#

• Invoke Method
• Invoke PowerShell

Generated from VeloPhex.System.Activities 0.7.1-rc.12. Category: Invoke. Keywords: process, start, run, launch, open, execute, application.

Properties

Input

Output

Retry and risk

Related activities