Unpublish-NAVApp

Module:
Microsoft.Dynamics.Nav.Apps.Management
Unpublishes a NAV App from the app catalog of the specified Business Central Server instance.

Syntax

Unpublish-NAVApp
         [-ServerInstance] <String>
         [-Name] <String>
         [[-Publisher] <String>]
         [[-Version] <Version>]
         [[-Tenant] <TenantId>]
         [<CommonParameters>]
Unpublish-NAVApp
         [-ServerInstance] <String>
         [-Path] <String>
         [[-Tenant] <TenantId>]
         [<CommonParameters>]

Description

Use the Unpublish-NAVApp cmdlet to remove a NAV App from the application database of the specified Business Central Server instance. The NAV App cannot be unpublished if it is currently installed for a tenant of the specified Business Central Server instance.

Examples

EXAMPLE 1

Unpublish-NAVApp -ServerInstance BC -Name 'Proseware SmartApp'

This example removes the NAV App with the specified name from the BC server instance's app catalog.

EXAMPLE 2

Get-NAVAppInfo -ServerInstance BC -Name 'Proseware SmartApp' -Version 2.3.4.500 | Unpublish-NAVApp

This example removes the NAV App returned from the Get-NAVAppInfo cmdlet from the BC server instance's app catalog.

EXAMPLE 3

Unpublish-NAVApp -ServerInstance BC -Path '.\Proseware SmartApp.app'

This example removes the NAV App at the provided path from the BC server instance's app catalog.

Parameters

-Name

Specifies the name of the NAV App to be unpublished.

The results must return only a single NAV App to successfully unpublished.

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

Specifies the path to a NAV App Package file that you want to unpublish.

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

Specifies the publisher of the NAV App to be unpublished.

The results must return only a single NAV App to successfully unpublish.

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

Specifies the Business Central Server instance that the NAV App will be unpublished from, such as DynamicsNAV90.

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

Specifies the tenant to unpublish the package from if it was published into the tenant scope.

Type:TenantId
Aliases:TenantId
Position:246944
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Version

Specifies the version of the NAV App to be unpublished.

The results must return only a single NAV App to successfully unpublish.

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