To make your extension available to users, the package must be published to a specific Microsoft Dynamics NAV Server instance. The extension can be installed for one or more tenants.

To publish or remove an extension

  1. In the Microsoft Dynamics NAV 2017 Administration Shell, use the Publish-NAVApp cmdlet. The cmdlet takes as parameters the server you want to install to and the .navx package file that contains the extension. The following example publishes the extension MyExtension to the YourDynamicsNAVServer instance.

     Copy Code
    Publish-NAVApp -ServerInstance YourDynamicsNAVServer -Path MyExtension.navx

    Publish does more than just update internal tables. It also compiles the components of the extension behind-the-scenes and builds the necessary metadata objects that are used at runtime.

    You can get an overview of the published extensions and their state using the Get-NAVAppInfo cmdlet. If no tenants have a specific extension installed, you can completely remove it using the Unpublish-NAVApp cmdlet.

  2. In the Microsoft Dynamics NAV 2017 Administration Shell, use the Unpublish-NAVApp cmdlet. The cmdlet takes as parameters the server you want to remove the extension from, and the name of the extension. The following example removes the extension MyExtension from the YourDynamicsNAVServer instance.

     Copy Code
    Unpublish-NAVApp -ServerInstance YourDynamicsNAVServer -Path MyExtension

Once an app has been published, it must be made available for any tenant that wishes to use it.

To install an extension

  • In the , use the Install-NAVApp cmdlet. The following example installs the MyExtension for Tenant1 and Tenant3. In single-tenant deployments, you either specify default as the tenant ID, or you omit the -Tenant parameter.

     Copy Code
    Install-NAVApp -ServerInstance YourDynamicsNAVServer -Name ”My Extension” -Tenant Tenant1, Tenant3

    Use Get-NAVAppInfo -Tenant command to get an overview of the extensions for that tenant, use the Get-NAVAppTenant cmdlet to get all tenants that have installed a specified extension, and uninstall an extension using the Uninstall-NAVApp cmdlet.

    Note
    When you uninstall an extension that includes tables and fields, this impacts the database schema and any data that the tables and fields contain. For more information, see Extending Microsoft Dynamics NAV Using Extension Packages.

See Also