Command

New-ConfigurationDotNetInstaller

Module PSPublishModule

Inputs

None

Outputs

PowerForge.DotNetPublishInstaller

Creates MSI, Debian, or macOS app-bundle installer configuration for the DotNet publish DSL.

Syntax

New-ConfigurationDotNetInstaller [-Authoring <PowerForgeInstallerDefinition>] [-ClientLicense <DotNetPublishMsiClientLicenseOptions>] [-Debian <DotNetPublishDebianOptions>] [-Frameworks <String[]>] [-Harvest <Auto>] [-HarvestComponentGroupId <String>] [-HarvestDirectoryRefId <String>] [-HarvestExcludePatterns <String[]>] [-HarvestPath <String>] -Id <String> [-InstallerProjectId <String>] [-InstallerProjectPath <String>] [-Kind <Msi|Debian|MacApp>] [-MacApp <DotNetPublishMacAppOptions>] [-ManifestPath <String>] [-MsBuildProperties <Hashtable>] [-OutputName <String>] [-OutputPath <String>] [-PrepareFromBundleId <String>] -PrepareFromTarget <String> [-Runtimes <String[]>] [-Sign <DotNetPublishSignOptions>] [-SignOverrides <DotNetPublishSignPatch>] [-SignProfile <String>] [-StagingPath <String>] [-Styles <DotNetPublishStyle[]>] [-Versioning <DotNetPublishMsiVersionOptions>] [<CommonParameters>]

Parameter set: All Parameter Sets

Examples

Authored help example

Create MSI installer mapping

New-ConfigurationDotNetInstaller -Id 'service.msi' -PrepareFromTarget 'My.Service' -InstallerProjectPath 'Installer/My.Service.wixproj' -Harvest Auto

Parameters

-Authoring PowerForgeInstallerDefinition optional: Optional PowerForge-owned installer authoring model used to generate a WiX SDK project.
-ClientLicense DotNetPublishMsiClientLicenseOptions optional: Optional client-license injection policy.
-Debian DotNetPublishDebianOptions optional: Debian package metadata used when Kind is Debian.
-Frameworks String[] optional: Optional target-framework filter for installer generation.
-Harvest DotNetPublishMsiHarvestMode optional: Harvest behavior for payload tree.; Possible values: Auto
-HarvestComponentGroupId String optional: Optional WiX component group id template for generated harvest fragment.
-HarvestDirectoryRefId String optional: Optional WiX directory reference id for generated harvest fragment.
-HarvestExcludePatterns String[] optional: Optional wildcard patterns excluded from MSI harvesting.
-HarvestPath String optional: Optional harvest output path template.
-Id String required: Installer identifier.
-InstallerProjectId String optional: Optional installer project catalog identifier.
-InstallerProjectPath String optional: Optional path to installer project file (*.wixproj).
-Kind DotNetPublishInstallerKind optional: Installer format. Defaults to MSI.; Possible values: Msi, Debian, MacApp
-MacApp DotNetPublishMacAppOptions optional: macOS app-bundle metadata used when Kind is MacApp.
-ManifestPath String optional: Optional manifest path template for MSI prepare output.
-MsBuildProperties Hashtable optional: Optional installer-specific MSBuild properties passed to msi.build.
-OutputName String optional: Optional installer output file-name template.
-OutputPath String optional: Optional installer output directory template.
-PrepareFromBundleId String optional: Optional bundle identifier used as the installer payload source.
-PrepareFromTarget String required: Source publish target name used for prepare/build.
-Runtimes String[] optional: Optional runtime filter for installer generation.
-Sign DotNetPublishSignOptions optional: Optional MSI signing policy.
-SignOverrides DotNetPublishSignPatch optional: Optional signing-profile overrides.
-SignProfile String optional: Optional named signing profile.
-StagingPath String optional: Optional staging path template for MSI payload.
-Styles DotNetPublishStyle[] optional: Optional publish-style filter for installer generation.; Possible values: Portable, PortableCompat, PortableSize, SelfContained, FrameworkDependent, AotSpeed, AotSize
-Versioning DotNetPublishMsiVersionOptions optional: Optional MSI version policy.

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.