Skip to content

Invoke-DotNetReleaseBuild.md

Latest commit

 

History

History
145 lines (110 loc) · 3.67 KB

Invoke-DotNetReleaseBuild.md

File metadata and controls

145 lines (110 loc) · 3.67 KB
Raw
external help file PSPublishModule-help.xml
Module Name PSPublishModule
online version https://github.com/EvotecIT/PSPublishModule
schema 2.0.0

Invoke-DotNetReleaseBuild

SYNOPSIS

Builds a .NET project in Release configuration and prepares release artefacts.

SYNTAX

__AllParameterSets

Invoke-DotNetReleaseBuild -ProjectPath <string[]> [-CertificateThumbprint <string>] [-LocalStore <CertificateStoreLocation>] [-TimeStampServer <string>] [-PackDependencies] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

The cmdlet discovers the .csproj file (when a directory is provided), reads VersionPrefix from the project, then runs dotnet build and dotnet pack in Release (by default). It produces a ZIP snapshot of the release output and returns a typed result object for each input project path.

Use -WhatIf to preview the planned outputs without running build/pack/sign operations.

EXAMPLES

EXAMPLE 1

Invoke-DotNetReleaseBuild -ProjectPath '.\MyLibrary\MyLibrary.csproj' -PackDependencies

EXAMPLE 2

Invoke-DotNetReleaseBuild -ProjectPath '.\MyLibrary\MyLibrary.csproj' -CertificateThumbprint '0123456789ABCDEF' -LocalStore CurrentUser

EXAMPLE 3

Invoke-DotNetReleaseBuild -ProjectPath '.\MyLibrary' -PackDependencies -WhatIf

EXAMPLE 4

Invoke-DotNetReleaseBuild -ProjectPath '.\ProjectA\ProjectA.csproj', '.\ProjectB\ProjectB.csproj' -PackDependencies

PARAMETERS

-CertificateThumbprint

Optional certificate thumbprint used to sign assemblies and packages. When omitted, no signing is performed.

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

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

-LocalStore

Certificate store location used when searching for the signing certificate. Default: CurrentUser.

Type: CertificateStoreLocation
Parameter Sets: __AllParameterSets
Aliases: None
Possible values: CurrentUser, LocalMachine

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

-PackDependencies

When enabled, also packs all project dependencies that have their own .csproj files.

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

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

-ProjectPath

Path to the folder containing the project (*.csproj) file (or the csproj file itself).

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

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

-TimeStampServer

Timestamp server URL used while signing. Default: http://timestamp.digicert.com.

Type: String
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.DotNetReleaseBuildResult

RELATED LINKS

  • None