Get-NavAppRuntimePackage

Get a NAV App runtime package

Syntax

Get-NavAppRuntimePackage
   [-Id <String>]
   [-Name <String>]
   [-Publisher <String>]
   [-Version <Version>]
   [-ShowMyCode <Boolean>]
   -Path <String>
   [-Tenant <TenantId>]
   [-ServerInstance] <String>
   [-Force]
   [<CommonParameters>]

Description

Use the Get-NAVAppRuntimePackage cmdlet to get a NAV App runtime package.

Examples

EXAMPLE 1

Get-NAVAppRuntimePackage -ServerInstance BC -Name 'Proseware SmartApp' -Version 2.3.4.500 -Path 'Prosware SmartApp_2.3.4.500_runtime.app'

This example gets the NAV App runtime package with the provided name and version.

Parameters

-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Id

Specifies the ID of the NAV App to be returned.

Type:String
Aliases:AppId
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Name

Specifies the name of the NAV App to be returned.

Type:String
Aliases:AppName
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Path

Specifies the path where the binary extension will be written to.

Type:String
Aliases:ExtensionPath
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Publisher

Specifies the publisher of the NAV App to be returned.

Type:String
Aliases:AppPublisher
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ServerInstance

Specifies the name of a Business Central Server instance, for example, BC or myinstance. You can specify either the full name of an instance, such as MicrosoftDynamicsNavServer$myinstance or the short name such as myinstance.

Type:String
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
-ShowMyCode

Overwrites the ShowMyCode value in the manifest.

This parameter is available only in Business Central April 2019 and later versions.

Type:Boolean
Aliases:AppShowMyCode
Position:Named
Default value:False
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Tenant

Specifies the ID of a specific tenant that you want to act on, such as Tenant1.

Type:TenantId
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Version

Specifies the exact version of the NAV App to be returned.

Type:Version
Aliases:AppVersion
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Inputs

System.String

By property name: Id

System.String

By property name: Name

System.String

By property name: Publisher

System.Version

By property name: Version

System.String

By property name: Version

System.String

Notes

You generate runtime packages for distribution of extensions that do not contain AL code, but only the final artifacts used by the server at runtime. Runtime packages allow you to protect the intellectual property represented by your AL source code. The extension in a runtime package can be installed on servers that do not have a developer license. The license is checked on the server where the runtime package is generated.