API Reference
Invoke-PowerForgePluginPack
Packs plugin-related NuGet packages from a reusable PowerForge plugin catalog configuration.
Remarks
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
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
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
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>]
#
All Parameter SetsParameters
- ApiKey String
- API key used with Push.
- ConfigPath String
- 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 configuration override.
- Possible values:
Release,Debug - ExitCode SwitchParameter
- Sets host exit code: 0 on success, 1 on failure.
- Group String[]
- Optional package group filter. When omitted, all catalog entries are selected.
- IncludeSymbols SwitchParameter
- Includes symbol packages in the pack output.
- NoBuild SwitchParameter
- Skips the build step when running dotnet pack.
- OutputRoot String
- Optional output root override for packed NuGet packages.
- PackageVersion String
- Optional package version override.
- Plan SwitchParameter
- Builds and emits the resolved package plan without executing dotnet pack.
- ProjectRoot String
- Optional project root override for resolving plugin project paths.
- Push SwitchParameter
- Pushes packages after a successful pack run.
- Source String
- Package source URL or name used with Push.
- VersionSuffix String
- Optional package version suffix override.
Outputs
System.Object