Command

New-ConfigurationTest

Module PSPublishModule

Inputs

None

Configures running Pester tests as part of the build.

Syntax

New-ConfigurationTest [-Enable] [-Force] -TestsPath <String> [<CommonParameters>]

Parameter set: All Parameter Sets

Description

Emits a test configuration segment that instructs the pipeline to run Pester tests after the module is merged/built. Use this when you want builds to fail fast on test failures.

Examples

Authored help example

Enable Pester tests during the build

New-ConfigurationTest -Enable -TestsPath 'Tests'

Runs tests from the Tests folder after the build/merge step.

Force test execution (ignore caching)

New-ConfigurationTest -Enable -TestsPath 'Tests' -Force

Useful in CI when you always want a fresh test run.

Parameters

-Enable SwitchParameter optional: Enable test execution in the build.
-Force SwitchParameter optional: Force running tests even if caching would skip them.
-TestsPath String required: Path to the folder containing Pester tests.

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.