Command

New-ConfigurationRelease

Module: PSPublishModule
Inputs: None
Outputs: PowerForge.ConfigurationReleaseSegment

Creates repo-level release coordination settings for a module and package build.

Syntax

New-ConfigurationRelease
[-BuildOrder <String[]>]
[-PrimaryProject <String>]
[-PublishOrder <String[]>]
[-ResumeIncompleteRelease]
[-StageRoot <String>]
[-SynchronizeModuleVersion]
[-Version <String>]
[-VersionSource <Module|ProjectBuild|PackageBuild|Manual>]
[<CommonParameters>]

Parameter set: All Parameter Sets

Examples

Example 1

New-ConfigurationRelease -BuildOrder @('Value')

Parameters

-BuildOrder String[] optional: Preferred build order for high-level release lanes.
-PrimaryProject String optional: Primary package/project used when the version source is a package/project build. Required by SynchronizeModuleVersion to identify the package coordinated with module history.
-PublishOrder String[] optional: Preferred publish order for destinations such as NuGet, PowerShellGallery, and GitHub.
-ResumeIncompleteRelease SwitchParameter optional: Explicitly resumes a compatible incomplete synchronized release checkpoint. Without this switch, an older checkpoint is archived and the invocation starts a fresh release.
-StageRoot String optional: Staged release root where upload-ready assets should be copied.
-SynchronizeModuleVersion SwitchParameter optional: Coordinates the module and selected primary package on one version. This is enabled automatically when VersionSource is ProjectBuild or PackageBuild and PrimaryProject is configured. The next available module version becomes a floor for the primary package; a higher numeric package version still wins. At the same numeric version, a stable X-pattern candidate does not erase the configured module prerelease; explicit prerelease versions retain normal semantic-version ordering. PrimaryProject is required, and exactly one selected lane must run before the module and use UseAsReleaseVersionSource. Package groups using AlignPackageVersions are raised together. Publish runs persist a credential-free checkpoint for optional recovery. A normal invocation archives an incomplete checkpoint and starts fresh; use ResumeIncompleteRelease to retain the exact versions and skip destinations that already completed.
-Version String optional: Explicit release version used when VersionSource is Manual.
-VersionSource ReleaseVersionSource optional: Source used to resolve the coordinated release version.; Possible values: Module, ProjectBuild, PackageBuild, Manual

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.