API Reference
Command
Invoke-ProjectRelease
Executes a PowerShell-authored project release object through the unified PowerForge release engine.
Remarks
Executes a PowerShell-authored project release object through the unified PowerForge release engine.
Examples
EXAMPLE 1
Invoke-ProjectRelease -Project 'Value'
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-ProjectRelease [-ChecksumsPath <String>] [-ExitCode] [-Frameworks <String[]>] [-InstallerProperty <String[]>] [-KeepSymbols] [-ManifestJsonPath <String>] [-OutputRoot <String>] [-Plan] -Project <ConfigurationProject> [-PublishToolGitHub] [-Runtimes <String[]>] [-Sign] [-SignCsp <String>] [-SignDescription <String>] [-SignKeyContainer <String>] [-SignOnFailure <Nullable`1>] [-SignOnMissingTool <Nullable`1>] [-SignProfile <String>] [-SignSubjectName <String>] [-SignThumbprint <String>] [-SignTimestampUrl <String>] [-SignToolPath <String>] [-SignUrl <String>] [-SkipBuild] [-SkipReleaseChecksums] [-SkipRestore] [-SkipToolOutput <Tool|Portable|Installer|Store>] [-SkipWorkspaceValidation] [-StageRoot <String>] [-Styles <Portable>] [-Target <String[]>] [-ToolOutput <Tool|Portable|Installer|Store>] [-Validate] [-WorkspaceConfigPath <String>] [-WorkspaceDisableFeature <String[]>] [-WorkspaceEnableFeature <String[]>] [-WorkspaceProfile <String>] [<CommonParameters>]
#
Parameter set:
All Parameter SetsParameters
- ChecksumsPath String
- Optional release checksums output path override.
- ExitCode SwitchParameter
- Sets host exit code: 0 on success, 1 on failure.
- Frameworks String[]
- Optional framework filter.
- InstallerProperty String[]
- Optional installer MSBuild property overrides in Name=Value form.
- KeepSymbols SwitchParameter
- Keeps symbol files for tool/app artefacts.
- ManifestJsonPath String
- Optional release manifest output path override.
- OutputRoot String
- Optional output root override for tool/app assets.
- Plan SwitchParameter
- Builds the release plan without executing steps.
- Project ConfigurationProject
- PowerShell-authored project/release object.
- PublishToolGitHub SwitchParameter
- Enables tool/app GitHub release publishing for this run.
- Runtimes String[]
- Optional runtime filter.
- Sign SwitchParameter
- Enables signing for tool/app outputs when supported by the project object.
- SignCsp String
- Optional signing CSP override.
- SignDescription String
- Optional signing description override.
- SignKeyContainer String
- Optional signing key container override.
- SignOnFailure Nullable`1
- Optional policy when signing fails.
- SignOnMissingTool Nullable`1
- Optional policy when the configured signing tool is missing.
- SignProfile String
- Optional signing profile override.
- SignSubjectName String
- Optional signing certificate subject name override.
- SignThumbprint String
- Optional signing thumbprint override.
- SignTimestampUrl String
- Optional signing timestamp URL override.
- SignToolPath String
- Optional signing tool path override.
- SignUrl String
- Optional signing URL override.
- SkipBuild SwitchParameter
- Disables build operations for the tool/app publish flow.
- SkipReleaseChecksums SwitchParameter
- Skips top-level release checksums generation.
- SkipRestore SwitchParameter
- Disables restore operations for the tool/app publish flow.
- SkipToolOutput String[]
- Optional tool/app output exclusion.
- Possible values:
Tool,Portable,Installer,Store - SkipWorkspaceValidation SwitchParameter
- Skips workspace validation defined by the project object.
- StageRoot String
- Optional staged release root override.
- Styles DotNetPublishStyle[]
- Optional publish style filter.
- Possible values:
Portable,PortableCompat,PortableSize,FrameworkDependent,AotSpeed,AotSize - Target String[]
- Optional target-name filter.
- ToolOutput String[]
- Optional tool/app output selection.
- Possible values:
Tool,Portable,Installer,Store - Validate SwitchParameter
- Validates configuration through plan-only execution.
- WorkspaceConfigPath String
- Optional workspace validation config override.
- WorkspaceDisableFeature String[]
- Optional workspace feature disable list override.
- WorkspaceEnableFeature String[]
- Optional workspace feature enable list override.
- WorkspaceProfile String
- Optional workspace validation profile override.
Outputs
PowerForge.PowerForgeReleaseResult