Command

New-DotNetPublishConfig

Module PSPublishModule

Inputs

None

Outputs

System.String PowerForge.DotNetPublishConfigScaffoldResult

Scaffolds a starter powerforge.dotnetpublish.json configuration file.

Syntax

New-DotNetPublishConfig [-Configuration <String>] [-Force] [-Framework <String>] [-NoSchema] [-OutputPath <String>] [-PassThru] [-ProjectPath <String>] [-ProjectRoot <String>] [-Runtimes <String[]>] [-Styles <DotNetPublishStyle[]>] [-TargetName <String>] [<CommonParameters>]

Parameter set: All Parameter Sets

Description

Use this cmdlet for JSON-first onboarding of the DotNet publish engine. The generated config can be executed with Invoke-DotNetPublish -ConfigPath ....

Examples

Authored help example

Create a starter config from the current repository root

New-DotNetPublishConfig -ProjectRoot '.' -PassThru

Generate config for a selected project and overwrite existing file

New-DotNetPublishConfig -Project '.\src\App\App.csproj' -Runtimes 'win-x64','win-arm64' -Styles PortableCompat,AotSpeed -Force

Parameters

-Configuration String optional: Build configuration (default: Release).
-Force SwitchParameter optionalaliases: Overwrite: Overwrite existing config file.
-Framework String optional: Optional framework override (for example net10.0).
-NoSchema SwitchParameter optional: Omits the $schema property from generated JSON.
-OutputPath String optionalaliases: ConfigPath, Path: Output config path (default: powerforge.dotnetpublish.json).
-PassThru SwitchParameter optional: Returns detailed scaffold metadata instead of only config path.
-ProjectPath String optionalaliases: Project: Optional path to a specific project file. When omitted, the first matching .csproj is used.
-ProjectRoot String optional: Project root used to resolve relative paths.
-Runtimes String[] optional: Optional runtime identifiers override.
-Styles DotNetPublishStyle[] optional: Optional publish styles override.; Possible values: Portable, PortableCompat, PortableSize, SelfContained, FrameworkDependent, AotSpeed, AotSize
-TargetName String optional: Optional target name override. Defaults to project file name.

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.