API Reference
Command
New-ConfigurationDotNetInstaller
Creates MSI, Debian, or macOS app-bundle installer configuration for the DotNet publish DSL.
Remarks
Creates MSI, Debian, or macOS app-bundle installer configuration for the DotNet publish DSL.
Examples
Create MSI installer mapping
New-ConfigurationDotNetInstaller -Id 'service.msi' -PrepareFromTarget 'My.Service' -InstallerProjectPath 'Installer/My.Service.wixproj' -Harvest Auto
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-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 <Portable>] [-Versioning <DotNetPublishMsiVersionOptions>] [<CommonParameters>]#Parameter set:
All Parameter SetsParameters
- Authoring PowerForgeInstallerDefinition
- Optional PowerForge-owned installer authoring model used to generate a WiX SDK project.
- ClientLicense DotNetPublishMsiClientLicenseOptions
- Optional client-license injection policy.
- Debian DotNetPublishDebianOptions
- Debian package metadata used when Kind is Debian.
- Frameworks String[]
- Optional target-framework filter for installer generation.
- Harvest DotNetPublishMsiHarvestMode
- Harvest behavior for payload tree.
- Possible values:
Auto - HarvestComponentGroupId String
- Optional WiX component group id template for generated harvest fragment.
- HarvestDirectoryRefId String
- Optional WiX directory reference id for generated harvest fragment.
- HarvestExcludePatterns String[]
- Optional wildcard patterns excluded from MSI harvesting.
- HarvestPath String
- Optional harvest output path template.
- Id String
- Installer identifier.
- InstallerProjectId String
- Optional installer project catalog identifier.
- InstallerProjectPath String
- Optional path to installer project file (*.wixproj).
- Kind DotNetPublishInstallerKind
- Installer format. Defaults to MSI.
- Possible values:
Msi,Debian,MacApp - MacApp DotNetPublishMacAppOptions
- macOS app-bundle metadata used when Kind is MacApp.
- ManifestPath String
- Optional manifest path template for MSI prepare output.
- MsBuildProperties Hashtable
- Optional installer-specific MSBuild properties passed to msi.build.
- OutputName String
- Optional installer output file-name template.
- OutputPath String
- Optional installer output directory template.
- PrepareFromBundleId String
- Optional bundle identifier used as the installer payload source.
- PrepareFromTarget String
- Source publish target name used for prepare/build.
- Runtimes String[]
- Optional runtime filter for installer generation.
- Sign DotNetPublishSignOptions
- Optional MSI signing policy.
- SignOverrides DotNetPublishSignPatch
- Optional signing-profile overrides.
- SignProfile String
- Optional named signing profile.
- StagingPath String
- Optional staging path template for MSI payload.
- Styles DotNetPublishStyle[]
- Optional publish-style filter for installer generation.
- Possible values:
Portable,PortableCompat,PortableSize,SelfContained,FrameworkDependent,AotSpeed,AotSize - Versioning DotNetPublishMsiVersionOptions
- Optional MSI version policy.
Outputs
PowerForge.DotNetPublishInstaller