Invoke-ProjectBuild.md

external help file	PSPublishModule-help.xml
Module Name	PSPublishModule
online version	https://github.com/EvotecIT/PSPublishModule
schema	2.0.0

Invoke-ProjectBuild

SYNOPSIS

Executes a repository-wide .NET build/release pipeline from a JSON configuration.

SYNTAX

__AllParameterSets

Invoke-ProjectBuild -ConfigPath <string> [-UpdateVersions] [-Build] [-PublishNuget] [-PublishGitHub] [-Plan] [-PlanPath <string>] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

The configuration file follows Schemas/project.build.schema.json in the PSPublishModule repository. Use it to define discovery rules, versioning, staging, NuGet publishing, and GitHub release settings.

GitHub tag/release templates support tokens: {Project}, {Version}, {PrimaryProject}, {PrimaryVersion}, {Repo}, {Repository}, {Date}, {UtcDate}, {DateTime}, {UtcDateTime}, {Timestamp}, {UtcTimestamp}. When GitHub release mode is Single and multiple project versions are present, {Version} defaults to the local date (yyyy.MM.dd) unless a primary project version is available.

EXAMPLES

EXAMPLE 1

Invoke-ProjectBuild -ConfigPath 'C:\Path'

PARAMETERS

-Build

Run build/pack step.

Type: SwitchParameter
Parameter Sets: __AllParameterSets
Aliases: None
Possible values:

Required: False
Position: named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-ConfigPath

Path to the JSON configuration file.

Type: String
Parameter Sets: __AllParameterSets
Aliases: None
Possible values:

Required: True
Position: named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-Plan

Generate a plan only (no build/publish actions).

Type: SwitchParameter
Parameter Sets: __AllParameterSets
Aliases: None
Possible values:

Required: False
Position: named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-PlanPath

Optional path to write the plan JSON file.

Type: String
Parameter Sets: __AllParameterSets
Aliases: None
Possible values:

Required: False
Position: named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-PublishGitHub

Publish artifacts to GitHub.

Type: SwitchParameter
Parameter Sets: __AllParameterSets
Aliases: None
Possible values:

Required: False
Position: named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-PublishNuget

Publish packages to NuGet.

Type: SwitchParameter
Parameter Sets: __AllParameterSets
Aliases: None
Possible values:

Required: False
Position: named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-UpdateVersions

Run version update step.

Type: SwitchParameter
Parameter Sets: __AllParameterSets
Aliases: None
Possible values:

Required: False
Position: named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

• None

OUTPUTS

• PowerForge.ProjectBuildResult

RELATED LINKS

• None