Publish-NAVApp

Publish-NAVApp

Publishes a Microsoft Dynamics NAV extension to the app catalog of the specified Microsoft Dynamics NAV Server instance.

Syntax

Parameter Set: Default
Publish-NAVApp [-ServerInstance] <String> [-Path] <String> [[-PassThru]] [[-LogPath] <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

Use the Publish-NAVApp cmdlet to publish an extension from a package file (.navx) to the app catalog of the specified Microsoft Dynamics NAV Server instance. When the extension has been published, you can install it for individual tenants.

Parameters

-LogPath<String>

Specifies the path where you want to save the log file for any potential publication errors. If the file exists, any errors are added to the log file.

Aliases

none

Required?

false

Position?

41

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PassThru

Returns an object for the published extension. The object contains the properties of the extension, such as name, publisher, and version.

Aliases

none

Required?

false

Position?

22

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Path<String>

Specifies the path to an extension package file that you want to publish to the Microsoft Dynamics NAV Server instance.

Aliases

none

Required?

true

Position?

21

Default Value

none

Accept Pipeline Input?

true(ByValue,ByPropertyName)

Accept Wildcard Characters?

false

-ServerInstance<String>

Specifies the Microsoft Dynamics NAV Server instance that you want to publish the extension to, such as DynamicsNAV90.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true(ByValue,ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

-------------------------- EXAMPLE 1 --------------------------

Description

-----------

This example publishes the Microsoft Dynamics NAV extension from the Proseware SmartStuff.navx package to the DynamicsNAV90 server instance.

PS C:\> Publish-NAVApp -ServerInstance DynamicsNAV90 -Path '.\Proseware SmartStuff.navx'

-------------------------- EXAMPLE 2 --------------------------

Description

-----------

This example publishes the extension from the Proseware SmartStuff.navx package to the DynamicsNAV90 server instance and then returns an object that represents the extension.

PS C:\> Publish-NAVApp -ServerInstance DynamicsNAV90 -Path '.\Proseware SmartStuff.navx' -PassThru

          Name                  Publisher              Version                   ServerInstance
          ----                  ---------              -------                   --------------
          Proseware SmartStuff  Proseware, Inc.        2.3.4.500                 nav_server_instance

-------------------------- EXAMPLE 3 --------------------------

Description

-----------

This example will attempt to publish an extension from the Proseware BrokenStuff.navx package to the DynamicsNAV90 server instance. In this example, the extension cannot be published for some reason. The -LogPath parameter specifies the path to a file that lists errors. If the file exists, errors are added to the file.

PS C:\> Publish-NAVApp -ServerInstance DynamicsNAV90 -Path '.\Proseware BrokenStuff.navx' -LogPath c:\temp\myerror.log

Extending Microsoft Dynamics NAV Using Extension Packages