Get-NAVAppInfo
Get-NAVAppInfo
Gets information about a Microsoft Dynamics NAV extension based on the specified package file or the specified Microsoft Dynamics NAV Server instance.
Syntax
Parameter Set: Path
Get-NAVAppInfo -Path <String> [ <CommonParameters>]
Parameter Set: Properties
Get-NAVAppInfo [-ServerInstance] <String> [-CompatibilityId <Version> ] [-Id <Guid> ] [-Name <String> ] [-Publisher <String> ] [-Version <Version> ] [ <CommonParameters>]
Parameter Set: Tenant
Get-NAVAppInfo [-ServerInstance] <String> -Tenant <String> [ <CommonParameters>]
Detailed Description
Use the Get-NAVAppInfo cmdlet to get information about a specific Microsoft Dynamics NAV extension, or to get a list of extensions that have been deployed. The list of deployed extensions can include all extensions that have been published to a Microsoft Dynamics NAV Server instance, filtered by properties, or extension that are installed for a specific tenant.
Parameters
-CompatibilityId<Version>
Specifies the compatibility ID of the extension. The compatibility ID is a version string in the format of Major.Minor.Build.Revision, with a default value of 1.0.0.0 if not provided. The value is used to indicate whether there are compatibility related code changes between different versions of the extension.
Aliases |
AppCompatibilityId |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Id<Guid>
Specifies the ID of the extension.
Aliases |
AppId |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies the name of the extension.
Aliases |
AppName |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Path<String>
Specifies the path to an extension package file.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue, ByPropertyName) |
Accept Wildcard Characters? |
false |
-Publisher<String>
Specifies the publisher of the extension.
Aliases |
AppPublisher |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ServerInstance<String>
Specifies the Microsoft Dynamics NAV Server instance that the extension is deployed to, such as DynamicsNAV90.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue, ByPropertyName) |
Accept Wildcard Characters? |
false |
-Tenant<String>
Specifies the ID of the tenant that you want to get the installed extensions for, such as Tenant1. If the specified server instance is not multitenant, st this parameter to default, or do not set the parameter.
Aliases |
TenantId |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Version<Version>
Specifies the version of the extension.
Aliases |
AppVersion |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
-------------------------- EXAMPLE 1 --------------------------
Description
-----------
This example returns information about all Microsoft Dynamics NAV extensions that are published to the DynamicsNAV90 server instance.
PS C:\>
Get-NAVAppInfo -ServerInstance DynamicsNAV90
Id Name Version Publisher
-- ---- ------- ---------
9a47a833-e22f-4812-ade314219c53 SmartStuff Base 2.0.0.300 Proseware, Inc.
3c88160c-e0eb-4fe1-b4f6-011e45d74b10 Proseware SmartStuff 2.3.4.500 Proseware, Inc.
-------------------------- EXAMPLE 2 --------------------------
Description
-----------
This example returns information about the extension with the specified name and version on the DynamicsNAV90 server instance.
PS C:\>
Get-NAVAppInfo -ServerInstance DynamicsNAV90 -Name 'Proseware SmartStuff' -Version 2.3.4.500
Id : 3c88160c-e0eb-4fe1-b4f6-011e45d74b10
Name : Proseware SmartStuff
Version : 2.3.4.500
Publisher : Proseware, Inc.
Description : First Extension by Proseware
Compatibility Id : 2.0.0.0
Capabilities :
Prerequisites :
Dependencies :
-------------------------- EXAMPLE 3 --------------------------
Description
-----------
This example returns information about all Microsoft Dynamics NAV extensions that are published to the DynamicsNAV90 server instance by Proseware, Inc.
PS C:\>
Get-NAVAppInfo -ServerInstance DynamicsNAV90 -Publisher 'Proseware, Inc.'
Id Name Version Publisher
-- ---- ------- ---------
9a47a833-e22f-4812-ade314219c53 SmartStuff Base 2.0.0.300 Proseware, Inc.
3c88160c-e0eb-4fe1-b4f6-011e45d74b10 Proseware SmartStuff 2.3.4.500 Proseware, Inc.
-------------------------- EXAMPLE 4 --------------------------
Description
-----------
This example returns information about all Microsoft Dynamics NAV extensions that are installed for the tenant with the ID Tenant1 on the DynamicsNAV90 server instance.
PS C:\>
Get-NAVAppInfo -ServerInstance DynamicsNAV90 -Tenant 'Tenant1'
Id : 3c88160c-e0eb-4fe1-b4f6-011e45d74b10
Name : Proseware SmartStuff
Version : 2.3.4.500
Publisher : Proseware, Inc.
Description : First Extension by Proseware
Compatibility Id : 2.0.0.0
Capabilities :
Prerequisites :
Dependencies :
-------------------------- EXAMPLE 5 --------------------------
Description
-----------
This example returns information about the Microsoft Dynamics NAV extension that is contained in the specified package file.
PS C:\>
Get-NAVAppInfo -Path '.\Proseware SmartStuff.navx'
Id : 3c88160c-e0eb-4fe1-b4f6-011e45d74b10
Name : Proseware SmartStuff
Version : 2.3.4.500
Publisher : Proseware, Inc.
Description : First Extension by Proseware
Compatibility Id : 2.0.0.0
Capabilities :
Prerequisites :
Dependencies :
-------------------------- EXAMPLE 6 --------------------------
Description
-----------
This example returns information about all Microsoft Dynamics NAV extensions that are installed on a non-multitenant Microsoft Dynamics NAV Server instance.
PS C:\>
Get-NAVAppInfo -ServerInstance DynamicsNAV90 -Tenant default
Id : 3c88160c-e0eb-4fe1-b4f6-011e45d74b10
Name : Proseware SmartStuff
Version : 2.3.4.500
Publisher : Proseware, Inc.
Description : First Extension by Proseware
Compatibility Id : 2.0.0.0
Capabilities :
Prerequisites :
Dependencies :