API Reference
Command
Invoke-ValidationCommand
Runs a bounded validation process and returns its captured output.
Remarks
Use this for product-specific probes that must inspect structured process output. PowerForge owns timeout, cancellation, argument quoting, and expected-exit checks.
Examples
Read product diagnostics as JSON
$result = Invoke-ValidationCommand -Command @{ FileName = './tool.exe'; Arguments = @('diagnostics', '--json'); OutputJsonKind = 'Object' }; $result.StdOut | ConvertFrom-Json
Common Parameters
This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.
For more information, see about_CommonParameters.
Syntax
Invoke-ValidationCommand -Command <ReleaseCommandValidation> [-ProjectRoot <String>] [-Variables <Hashtable>] [<CommonParameters>]#Parameter set:
All Parameter SetsParameters
- Command ReleaseCommandValidation
- Executable, arguments, timeout, environment, and output expectations.
- ProjectRoot String
- Root for relative paths. Defaults to the current PowerShell filesystem location.
- Variables Hashtable
- Named substitutions for command arguments, environment, and paths.
Outputs
PowerForge.ProcessRunResult