API Reference
Command
Invoke-ReleaseValidation
Validates final artifacts and runs isolated product smoke tests without publishing.
Remarks
Configuration can come from JSON, a typed object, or a settings block using New-ConfigurationReleaseValidation.
Examples
Validate a local package set
Invoke-ReleaseValidation -ConfigPath './Build/validation.json' -Variables @{ PackageRoot = './Artifacts/packages' }
Export a command contract as JSON
Invoke-ReleaseValidation -JsonOnly -Settings { New-ConfigurationReleaseValidation -Commands @{ Name = 'CLI help'; FileName = 'example'; Arguments = @('--help') } }
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-ReleaseValidation -ConfigPath <String> [-JsonOnly] [-JsonPath <String>] [-ProjectRoot <String>] [-Variables <Hashtable>] [-Version <String>] [<CommonParameters>]#Parameter set:
ConfigParameters
- ConfigPath String
- Path to a release-validation JSON file.
- JsonOnly SwitchParameter
- Return JSON without executing validation.
- JsonPath String
- Optional configuration export path. Relative paths use the current PowerShell directory.
- ProjectRoot String
- Optional project-root override.
- Variables Hashtable
- Named path and value substitutions used by the configuration.
- Version String
- Expected artifact version; otherwise inferred from the package or module.
Outputs
PowerForge.ReleaseValidationReport, System.String
Invoke-ReleaseValidation -Configuration <ReleaseValidationSpec> [-JsonOnly] [-JsonPath <String>] [-ProjectRoot <String>] [-Variables <Hashtable>] [-Version <String>] [<CommonParameters>]#Parameter set:
ConfigurationParameters
- Configuration ReleaseValidationSpec
- Typed validation configuration.
- JsonOnly SwitchParameter
- Return JSON without executing validation.
- JsonPath String
- Optional configuration export path. Relative paths use the current PowerShell directory.
- ProjectRoot String
- Optional project-root override.
- Variables Hashtable
- Named path and value substitutions used by the configuration.
- Version String
- Expected artifact version; otherwise inferred from the package or module.
Outputs
PowerForge.ReleaseValidationReport, System.String
Invoke-ReleaseValidation [-JsonOnly] [-JsonPath <String>] [-ProjectRoot <String>] -Settings <ScriptBlock> [-Variables <Hashtable>] [-Version <String>] [<CommonParameters>]#Parameter set:
SettingsParameters
- JsonOnly SwitchParameter
- Return JSON without executing validation.
- JsonPath String
- Optional configuration export path. Relative paths use the current PowerShell directory.
- ProjectRoot String
- Optional project-root override.
- Settings ScriptBlock
- Block that emits one New-ConfigurationReleaseValidation object.
- Variables Hashtable
- Named path and value substitutions used by the configuration.
- Version String
- Expected artifact version; otherwise inferred from the package or module.
Outputs
PowerForge.ReleaseValidationReport, System.String