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

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.