New-ConfigurationExternalAsset

Namespace PSPublishModule

Inputs

None

Outputs

PowerForge.ConfigurationExternalAssetSegment

Adds an external asset bundle that is prepared before module staging.

Remarks

External asset bundles are for files that should be carried inside a module package but are not authored as normal source files, such as offline installers, tooling archives, generated payloads, or mirrored third-party packages. PowerForge downloads or copies the declared files before staging, computes SHA256 values, and writes a manifest alongside the bundle.

Examples

Authored help example

Prepare an offline payload before staging


New-ConfigurationExternalAsset -Name VendorTool -OutputPath 'Artefacts\VendorTool' -Files @(New-ConfigurationExternalAssetFile -Runtime win-x64 -FileName tool.zip -Uri 'https://example.test/tool.zip')

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

New-ConfigurationExternalAsset [-Disabled] -Files <ExternalAssetFileConfiguration[]> [-License <String>] [-ManifestPath <String>] -Name <String> -OutputPath <String> [-SkipDownload] [-Source <String>] [-Version <String>] [<CommonParameters>]

Parameter set: All Parameter Sets

Parameters

Disabled SwitchParameter optionalposition: namedpipeline: False: When set, disables the bundle while keeping it in configuration.
Files ExternalAssetFileConfiguration[] requiredposition: namedpipeline: False: Files that make up the external asset bundle.
License String optionalposition: namedpipeline: False: Optional license expression or label written to the generated manifest.
ManifestPath String optionalposition: namedpipeline: False: Optional manifest path. Relative paths resolve from the project root; when omitted, manifest.json is written under OutputPath.
Name String requiredposition: namedpipeline: False: Friendly bundle name written to the generated manifest.
OutputPath String requiredposition: namedpipeline: False: Output directory for the downloaded or copied files. Relative paths resolve from the project root.
SkipDownload SwitchParameter optionalposition: namedpipeline: False: When set, existing files are used and missing files fail the build instead of downloading or copying sources.
Source String optionalposition: namedpipeline: False: Optional source URI or project URL written to the generated manifest.
Version String optionalposition: namedpipeline: False: Optional bundle version written to the generated manifest.

Outputs

PowerForge.ConfigurationExternalAssetSegment