API Reference
Command
Start-BenchmarkProvenanceCapture
Captures clean source state before an external benchmark writes into a fresh artifact directory.
Remarks
Captures clean source state before an external benchmark writes into a fresh artifact directory.
Examples
Reserve a BenchmarkDotNet artifact directory before measurement
$capture = Start-BenchmarkProvenanceCapture -SourceRoot . -ArtifactRoot .\Build\BenchmarkDotNet.Artifacts -Metadata @{ 'benchmark.workload.id' = 'tabular-65k-v1' } -RunMode full
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
Start-BenchmarkProvenanceCapture -ArtifactRoot <String> [-Metadata <Hashtable>] [-RunMode <String>] -SourceRoot <String> [<CommonParameters>]#Parameter set:
All Parameter SetsParameters
- ArtifactRoot String
- Fresh directory where the external benchmark will write its artifacts.
- Metadata Hashtable
- Optional workload metadata to bind before measurement. Publishable evidence requires benchmark.workload.id.
- RunMode String
- Optional for diagnostic captures; publishable evidence requires a run mode bound before measurement.
- SourceRoot String
- Git repository root whose source is being measured.
Outputs
PowerForge.BenchmarkProvenanceCaptureSession