Command

New-ConfigurationReleaseProtection

Module: PSPublishModule
Inputs: None
Outputs: PowerForge.ConfigurationReleaseProtectionSegment

Creates opt-in source-state and provenance protections for module releases.

Syntax

New-ConfigurationReleaseProtection
[-GenerateProvenance]
[-RequireCleanSource]
[-RequireSourceUnchanged]
[<CommonParameters>]

Parameter set: All Parameter Sets

Description

All protections are disabled unless explicitly selected. Generating provenance also requires a clean source snapshot and protects it from changes through packaging.

Examples

Require clean, unchanged release inputs without embedding provenance

New-ConfigurationReleaseProtection -RequireSourceUnchanged

Generate signed release provenance

New-ConfigurationReleaseProtection -GenerateProvenance

Parameters

-GenerateProvenance SwitchParameter optional: Embeds signed source provenance in eligible signed GitHub module artefacts and implies both source checks.
-RequireCleanSource SwitchParameter optional: Requires a clean Git source snapshot when the release pipeline is planned.
-RequireSourceUnchanged SwitchParameter optional: Requires release inputs to remain unchanged after planning and implies a clean source snapshot.

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.