Command

Invoke-PowerForgePluginPack

Module PSPublishModule

Inputs

None

Packs plugin-related NuGet packages from a reusable PowerForge plugin catalog configuration.

Syntax

Invoke-PowerForgePluginPack [-ApiKey <String>] [-ConfigPath <String>] [-Configuration <Release|Debug>] [-ExitCode] [-Group <String[]>] [-IncludeSymbols] [-NoBuild] [-OutputRoot <String>] [-PackageVersion <String>] [-Plan] [-ProjectRoot <String>] [-Push] [-Source <String>] [-VersionSuffix <String>] [<CommonParameters>]

Parameter set: All Parameter Sets

Description

This cmdlet is the PowerShell entry point for the same generic plugin package workflow used by powerforge plugin pack. It selects package groups from the shared catalog, runs dotnet pack, and can optionally push only the packages produced by the current run.

Examples

Authored help example

Plan package output without running dotnet pack

Invoke-PowerForgePluginPack -Plan

Pack and push public plugin packages

Invoke-PowerForgePluginPack -ConfigPath '.\Build\powerforge.plugins.json' -Group pack-public -Push -Source https://api.nuget.org/v3/index.json -ApiKey $env:NUGET_API_KEY -ExitCode

Parameters

-ApiKey String optional: API key used with Push.
-ConfigPath String optional: Path to the plugin catalog configuration file. When omitted, the cmdlet searches the current directory and its parents for standard PowerForge plugin config names.
-Configuration String optional: Optional configuration override.; Possible values: Release, Debug
-ExitCode SwitchParameter optional: Sets host exit code: 0 on success, 1 on failure.
-Group String[] optionalaliases: Groups: Optional package group filter. When omitted, all catalog entries are selected.
-IncludeSymbols SwitchParameter optional: Includes symbol packages in the pack output.
-NoBuild SwitchParameter optional: Skips the build step when running dotnet pack.
-OutputRoot String optional: Optional output root override for packed NuGet packages.
-PackageVersion String optional: Optional package version override.
-Plan SwitchParameter optional: Builds and emits the resolved package plan without executing dotnet pack.
-ProjectRoot String optional: Optional project root override for resolving plugin project paths.
-Push SwitchParameter optional: Pushes packages after a successful pack run.
-Source String optional: Package source URL or name used with Push.
-VersionSuffix String optional: Optional package version suffix override.

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.