Command

New-PowerForgeReleaseConfig

Module PSPublishModule

Inputs

None

Outputs

System.String PowerForge.PowerForgeReleaseConfigScaffoldResult

Scaffolds a starter unified release.json configuration file.

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

Description

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

Parameters

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

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.