Get-NAVAppTenant
Get-NAVAppTenant
Gets a list of tenants where the specified Microsoft Dynamics NAV extension is installed.
Syntax
Parameter Set: Path
Get-NAVAppTenant [-ServerInstance] <String> -Path <String> [ <CommonParameters>]
Parameter Set: Properties
Get-NAVAppTenant [-ServerInstance] <String> [-Name <String> ] [-Publisher <String> ] [-Version <Version> ] [ <CommonParameters>]
Detailed Description
Use the Get-NAVAppTenant cmdlet to get the tenants where the specified extension is installed. You can specify the extension by name, publisher, or version. You can use the returned list of tenants to apply general changes, such as uninstalling the extension for all tenants that currently have it installed.
Parameters
-Name<String>
Specifies the name of the extension that you want to see a list of tenants where it is installed.
Aliases |
AppName |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Path<String>
Specifies the path to a Microsoft Dynamics NAV extension package file that contains the extension that you want to see a list of tenants where it is installed.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Publisher<String>
Specifies the publisher of the extension that you want to see a list of tenants where it is installed.
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 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 |
-Version<Version>
Specifies the version of the extension that you want to see a list of tenants where it is installed.
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 gets the tenants on the DynamicsNAV90 server instance that have version 2.3.4.500 of the Proseware SmartStuff extension installed.
PS C:\>
Get-NavAppTenant -ServerInstance DynamicsNAV90 -Name 'ProseWare SmartStuff' -Version 2.3.4.500
Id State
---- ---------
Tenant1 Mounted
Tenant2 Mounted
Tenant4 Mounted
-------------------------- EXAMPLE 2 --------------------------
Description
-----------
This example gets the tenants on the DynamicsNAV90 server instance that have version 2.3.4.500 of the Proseware SmartStuff extension installed, and then uninstalls that extension for each of those tenants by passing the tenants to the Uninstall-NAVApp cmdlet.
PS C:\>
Get-NavAppTenant -ServerInstance DynamicsNAV90 -Name 'ProseWare SmartStuff' -Version 2.3.4.500 | Uninstall-NAVApp -ServerInstance DynamicsNAV90 -Name 'Proseware SmartStuff' -Version 2.3.4.500