Command

New-ConfigurationExternalAsset

Module: PSPublishModule
Inputs: None
Outputs: PowerForge.ConfigurationExternalAssetSegment

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

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

Description

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

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')

Parameters

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

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.