Get-NAVAppInfo
Gets information about an NAV 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>
[<CommonParameters>] Get-NAVAppInfo
[-Id <Guid>]
[-Name <String>]
[-Publisher <String>]
[-Version <Version>]
-Tenant <TenantId>
[-TenantSpecificProperties]
[-ServerInstance] <String>
[<CommonParameters>] Get-NAVAppInfo
-Tenant <TenantId>
[-ServerInstance] <String>
[<CommonParameters>] Get-NAVAppInfo
-Path <String>
[<CommonParameters>] Description
Use the Get-NAVAppInfo cmdlet to get information about a specific NAV App, or to get a list of NAV Apps that have been deployed. The list of deployed NAV Apps can include all NAV Apps that have been published to a Business Central Server instance, filtered by NAV App properties, or NAV Apps that are installed for a specific tenant.
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 NAV 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 NAV 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 NAV 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 NAV 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 NAV 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 NAV 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 NAV 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 NAV 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 NAV 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 NAV Apps installed in a single tenant NAV server instance.
Parameters
Specifies the ID of the NAV App to be returned.
| Type: | Guid |
| Aliases: | AppId |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Specifies the name of the NAV App to be returned.
| Type: | String |
| Aliases: | AppName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Specifies the path to a NAV App Package file that you want to return.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Specifies the publisher of the NAV App to be returned.
| Type: | String |
| Aliases: | AppPublisher |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Specifies the Business Central Server instance to which the NAV App is deployed, such as BC.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Returns the list of installed extensions published with SymbolsOnly
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Specifies the ID of the tenant that you want to get the installed NAV 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 |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Indicates to include any properties of the NAV Apps that are specific to the provided tenant
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Specifies the version of the NAV App to be returned.
| Type: | Version |
| Aliases: | AppVersion |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |