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