Get-NAVAppInfo

Gets information about a Business Central app based on the specified package file or the specified Business Central Server instance.

Syntax

Get-NAVAppInfo
   [-Id <Guid>]
   [-Name <String>]
   [-Publisher <String>]
   [-Version <Version>]
   [-SymbolsOnly]
   [-ServerInstance] <String>
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]
Get-NAVAppInfo
   [-Id <Guid>]
   [-Name <String>]
   [-Publisher <String>]
   [-Version <Version>]
   -Tenant <TenantId>
   [-TenantSpecificProperties]
   [-ServerInstance] <String>
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]
Get-NAVAppInfo
   -Tenant <TenantId>
   [-ServerInstance] <String>
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]
Get-NAVAppInfo
   -Tenant <TenantId>
   -Path <String>
   [-ServerInstance] <String>
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]
Get-NAVAppInfo
   -Path <String>
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]

Description

Use the Get-NAVAppInfo cmdlet to get information about a specific Business Central app, or to get a list of Business Central apps that have been deployed. The list of deployed Business Central apps can include all Business Central apps that have been published to a Business Central Server instance, filtered by Business Central app properties, or Business Central apps that are published for a specific tenant.

  • If you know to the location of App package (.app file), you get information about it by providing the path to the file.

  • To get information about all Apps published to the application on a server instance, specify the server instance. If you want to filter the list to specific Apps, then use other parameters, like ID, publisher, and version.

  • To get information about all apps that are installed on a specific tenant, specify the server instance and the tenant. With a single tenant server instance, the tenant is named `default'. If you want to filter the list to specific Apps, then use other parameters, like Id, publisher, and version.

  • To get information about all apps that are installed and published on a specific tenant, specify the server instance, the tenant, and the TenantSpecificproperties.

  • To get information about symbols published to the application on a server instance, specify the server instance and the -SymbolsOnly switch.

Note: To get a list of all tenants on which a specific App is installed, you can use the Get-NAVAppTenant cmdlet.

Examples

EXAMPLE 1

Get-NAVAppInfo -ServerInstance BC

                    Id                                       Name                 Version    Publisher
                    --                                       ----                 -------    ---------
                    9a47a833-e22f-4812-ade314219c53          SmartApp Base        2.0.0.300  Proseware, Inc.
                    3c88160c-e0eb-4fe1-b4f6-011e45d74b10     Proseware SmartApp   2.3.4.500  Proseware, Inc.

This example returns information about all of the Business Central apps published on the BC server instance.

EXAMPLE 2

Get-NAVAppInfo -ServerInstance BC -Name 'Proseware SmartApp' -Version 2.3.4.500

                    Id                 : 3c88160c-e0eb-4fe1-b4f6-011e45d74b10
                    Name               : Proseware SmartApp
                    Version            : 2.3.4.500
                    Publisher          : Proseware, Inc.
                    Brief              : First Proseware App
                    Description        : First Business Central app by Proseware
                    Compatibility Id   : 2.0.0.0
                    Privacy Statement  : http://www.proseware.com/SmartApp/privacypolicy.aspx
                    EULA               : http://www.proseware.com/SmartApp/EULA.aspx
                    Help               : http://www.proseware.com/SmartApp/Support.aspx
                    Url                : http://www.proseware.com/SmartApp/
                    Logo               : SmartLogo.png
                    ScreenShots        : SmartShot1.png, SmartShot2.png, SmartShot3.png
                    Capabilities       :
                    Prerequisites      :
                    Dependencies       :

This example returns information about the Business Central app with the specified name and version on the BC server instance.

EXAMPLE 3

Get-NAVAppInfo -ServerInstance BC -Publisher 'Proseware, Inc.'

                    Id                                       Name                 Version    Publisher
                    --                                       ----                 -------    ---------
                    9a47a833-e22f-4812-ade314219c53          SmartApp Base        2.0.0.300  Proseware, Inc.
                    3c88160c-e0eb-4fe1-b4f6-011e45d74b10     Proseware SmartApp   2.3.4.500  Proseware, Inc.

This example returns information about all of the Business Central apps published on the BC server instance that are published by Proseware, Inc.

EXAMPLE 4

Get-NAVAppInfo -ServerInstance BC -Tenant 'Tenant1'

                    Id                 : 3c88160c-e0eb-4fe1-b4f6-011e45d74b10
                    Name               : Proseware SmartApp
                    Version            : 2.3.4.500
                    Publisher          : Proseware, Inc.
                    Brief              : First Proseware App
                    Description        : First Business Central app by Proseware
                    Compatibility Id   : 2.0.0.0
                    Privacy Statement  : http://www.proseware.com/SmartApp/privacypolicy.aspx
                    EULA               : http://www.proseware.com/SmartApp/EULA.aspx
                    Help               : http://www.proseware.com/SmartApp/Support.aspx
                    Url                : http://www.proseware.com/SmartApp/
                    Logo               : SmartLogo.png
                    ScreenShots        : SmartShot1.png, SmartShot2.png, SmartShot3.png
                    Capabilities       :
                    Prerequisites      :
                    Dependencies       :

This example returns information about all of the Business Central apps installed for the tenant with an ID of Tenant1 on the BC server instance.

EXAMPLE 5

Get-NAVAppInfo -Path '.\Proseware SmartApp.navx'

                    Id                 : 3c88160c-e0eb-4fe1-b4f6-011e45d74b10
                    Name               : Proseware SmartApp
                    Version            : 2.3.4.500
                    Publisher          : Proseware, Inc.
                    Brief              : First Proseware App
                    Description        : First Business Central app by Proseware
                    Compatibility Id   : 2.0.0.0
                    Privacy Statement  : http://www.proseware.com/SmartApp/privacypolicy.aspx
                    EULA               : http://www.proseware.com/SmartApp/ULA.aspx
                    Help               : http://www.proseware.com/SmartApp/Support.aspx
                    Url                : http://www.proseware.com/SmartApp/
                    Logo               : SmartLogo.png
                    ScreenShots        : SmartShot1.png, SmartShot2.png, SmartShot3.png
                    Capabilities       :
                    Prerequisites      :
                    Dependencies       :

This example returns information about the Business Central app from the package file provided.

EXAMPLE 6

Get-NAVAppInfo -ServerInstance BC -Tenant default

                    Id                 : 3c88160c-e0eb-4fe1-b4f6-011e45d74b10
                    Name               : Proseware SmartApp
                    Version            : 2.3.4.500
                    Publisher          : Proseware, Inc.
                    Brief              : First Proseware App
                    Description        : First Business Central app by Proseware
                    Compatibility Id   : 2.0.0.0
                    Privacy Statement  : http://www.proseware.com/SmartApp/privacypolicy.aspx
                    EULA               : http://www.proseware.com/SmartApp/ULA.aspx
                    Help               : http://www.proseware.com/SmartApp/Support.aspx
                    Url                : http://www.proseware.com/SmartApp/
                    Logo               : SmartLogo.png
                    ScreenShots        : SmartShot1.png, SmartShot2.png, SmartShot3.png
                    Capabilities       :
                    Prerequisites      :
                    Dependencies       :

This example returns information about all of the Business Central apps installed in a single tenant NAV server instance.

EXAMPLE 7

Get-NAVAppInfo -ServerInstance <server> -Tenant <tenantName> -TenantSpecificProperties

                    Id                     : a5d61952-f432-4ee6-8686-e8aa5d3dedc0
                    Name                   : Italian language (Switzerland)
                    Version                : 19.0.27273.0
                    Publisher              : Microsoft
                    ExtensionType          : ModernDev
                    Scope                  : Global
                    Tenant                 : 
                    Is Installed           : False
                    Extension Data Version : 
                    Needs Upgrade          : False
                    Sync State             : NotSynced
                    Is Published           : True

This example returns detailed information about the specific tenant in a single tenant NAV server instance.

Parameters

-Id

Specifies the ID of the Business Central app to be returned.

Type:Guid
Aliases:AppId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifies the name of the Business Central app to be returned.

Type:String
Aliases:AppName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Path

Specifies the path to a Business Central app Package file that you want to return.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ProgressAction

A common PowerShell parameter that determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider. Learn more.

Type:ActionPreference
Aliases:proga
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Publisher

Specifies the publisher of the Business Central app to be returned.

Type:String
Aliases:AppPublisher
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServerInstance

Specifies the Business Central Server instance to which the Business Central app is deployed, such as BC.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SymbolsOnly

Returns the list of published extensions published with SymbolsOnly

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tenant

Specifies the ID of the tenant that you want to get the published Business Central apps for, such as Tenant1. Provide a value of 'default' if the specified server instance is not configured to run multiple tenants.

Type:TenantId
Aliases:TenantId
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TenantSpecificProperties

Indicates to include any properties of the Business Central apps that are specific to the provided tenant

Type:SwitchParameter
Position:Named
Default value:False
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Version

Specifies the version of the Business Central app to be returned.

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

Inputs

System.Guid

By property name: Id

System.String

By property name: Name

System.String

By property name: Publisher

System.Version

By property name: Version

Microsoft.Dynamics.Nav.Types.TenantId

By property name: Tenant

System.String

By value and by property name: Path

System.Management.Automation.SwitchParameter

By property name: SymbolsOnly

System.Management.Automation.SwitchParameter

By property name: TenantSpecificProperties

System.String

By value and by property name: ServerInstance