New-NAVAppPackage
Creates a NAV App package file (.navx) at the specified location based on the specified manifest file and source files.
Syntax
Default (Default)
New-NAVAppPackage
[-Path] <String>
[-Manifest] <NavAppManifest>
[-SourcePath] <String[]>
[[-Logo] <String>]
[[-ScreenShots] <String[]>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use the New-NAVAppPackage cmdlet to create a .navx package file to distribute a NAV App. You can then use the package file to deploy the NAV App to a Microsoft Dynamics NAV Server instance.
Examples
Example 1
New-NavAppManifest -Name 'Proseware SmartApp' -Publisher 'Proseware, Inc.' -Version 2.3.4.500 | New-NAVAppPackage -Path 'C:\Proseware SmartApp.navx' -SourcePath 'C:\NavAppFiles'
This example creates a new NAV App package using new in-memory NAV App manifest metadata and the source files in the C:\NavAppFiles folder.
Example 2
Get-NAVAppManifest -Path '.\Manifest-Proseware SmartApp.xml' | New-NAVAppPackage -Path 'C:\Proseware SmartApp.navx' -SourcePath 'C:\NavAppFiles'
This example creates a new NAV App package using the NAV App manifest file and source files in the C:\NavAppFiles folder.
Example 3
Get-NAVAppManifest -Path '.\Manifest-Proseware SmartStuff.xml' | New-NAVAppPackage -Path 'C:\Proseware SmartStuff.navx' -SourcePath C:\NavAppFiles, 'C:\permissions.xml'
This example creates a new NAV App package using the NAV App manifest file and source files in the C:\NavAppFiles folder and an exported permission set file in the location provided.
Example 4
Get-NAVAppManifest -Path '.\Manifest-Proseware SmartStuff.xml' | New-NAVAppPackage -Path 'C:\Proseware SmartStuff.navx' -SourcePath C:\NavAppFiles, 'C:\permissions.xml' -Logo C:\SmartLogo.png -ScreenShots C:\SmartScreenShots
This example creates a new NAV App package using the NAV App manifest file and source files in the C:\NavAppFiles folder, an exported permission set file in the location provided, a logo image in the location provided, and screen shot images files in the C:\SmartScreenShots folder.
Parameters
-Confirm
Prompts you for confirmation before executing the command.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Force
Forces the command to run without asking for user confirmation to overwrite an existing package file at the given path.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Logo
Specifies the path to and image file to use as the logo when creating this Nav App package
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 4 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Manifest
Specifies the manifest object that contains the metadata that defines the NAV App package. You can pass this object from the New-NAVAppManifest or Get-NAVAppManifest cmdlets to the New-NAVAppPackage cmdlet.
Parameter properties
| Type: | NavAppManifest |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-PassThru
Returns the path of the created package file.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Path
Specifies the file name and the location where the NAV App package file (.navx) must be placed.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | OutputPath, Output |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-ScreenShots
Specifies the path(s) to the image and files, or a directory containing such, to include as product screen shots in the NAV App package. Use a comma (,) to separate multiple paths. (example: C:\NavAppImages, C:\Images\ScreenShot.jpg)
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 5 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-SourcePath
Specifies the location of the delta files and full object files, or a folder that contains the files, that you want to include in the NAV App package. Use a comma (,) to separate multiple paths as in the following example: C:\NavAppFiles, C:\Permissions\PermissionSet.xml
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 3 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-WhatIf
Describes what would happen if you executed the command without actually executing the command.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.