Project

PSPublishModule

PSPublishModule is an open-source PowerShell and .NET project with packages, release history, and technical documentation.

View on GitHub Releases Get package

Stars 43

Forks 13

Open issues 1

PowerShell Gallery downloads 13,876

Release v3.0.3

Language: C# Updated: 2026-04-14

API Reference

Command

New-PowerForgeReleaseConfig

Namespace PSPublishModule

Inputs

None

Outputs

System.String
PowerForge.PowerForgeReleaseConfigScaffoldResult

Scaffolds a starter unified release.json configuration file.

Remarks

Use this cmdlet to assemble a repository-level release config from the build configs the repo already has, typically Build/project.build.json and Build/powerforge.dotnetpublish.json.

Examples

Authored help example

Create a starter unified release config from the current repository root


New-PowerForgeReleaseConfig -ProjectRoot '.' -PassThru

Generate config from explicit package and DotNet publish config files


New-PowerForgeReleaseConfig -PackagesConfigPath '.\Build\project.build.json' -DotNetPublishConfigPath '.\Build\powerforge.dotnetpublish.json' -Force

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

New-PowerForgeReleaseConfig [-Configuration <Release|Debug>] [-DotNetPublishConfigPath <String>] [-Force] [-NoSchema] [-OutputPath <String>] [-PackagesConfigPath <String>] [-PassThru] [-ProjectRoot <String>] [-SkipPackages] [-SkipTools] [<CommonParameters>]

Parameter set: All Parameter Sets

Parameters

Configuration String optionalposition: namedpipeline: Falsevalues: 2: Release configuration value written into the tool section.; Possible values: Release, Debug
DotNetPublishConfigPath String optionalposition: namedpipeline: False: Optional path to an existing DotNet publish config file.
Force SwitchParameter optionalposition: namedpipeline: Falsealiases: Overwrite: Overwrite an existing config file.
NoSchema SwitchParameter optionalposition: namedpipeline: False: Omits the $schema property from generated JSON.
OutputPath String optionalposition: namedpipeline: Falsealiases: ConfigPath, Path: Output config path (default: Build\release.json).
PackagesConfigPath String optionalposition: namedpipeline: False: Optional path to an existing project-build config file.
PassThru SwitchParameter optionalposition: namedpipeline: False: Returns detailed scaffold metadata instead of only the config path.
ProjectRoot String optionalposition: namedpipeline: False: Project root used to resolve relative paths.
SkipPackages SwitchParameter optionalposition: namedpipeline: False: Skips package config discovery.
SkipTools SwitchParameter optionalposition: namedpipeline: False: Skips tool/app config discovery.

Outputs

System.String PowerForge.PowerForgeReleaseConfigScaffoldResult