Get-NAVAppTenant

Gets the tenants where the specified NAV App is installed.

Syntax

Get-NAVAppTenant
   [-ServerInstance] <String>
   [-Id <Guid>]
   [-Name <String>]
   [-Publisher <String>]
   [-Version <Version>]
   [-IncludeFailed]
   [<CommonParameters>]
Get-NAVAppTenant
   [-ServerInstance] <String>
   -Path <String>
   [-IncludeFailed]
   [<CommonParameters>]

Description

Use the Get-NAVAppTenant cmdlet to get the tenants where the specified NAV App is installed. You can specify the NAV App by name, publisher, or version.

You can use the returned list of tenants to apply general changes, such as uninstalling the NAV App for all tenants that currently have it installed.

Examples

EXAMPLE 1

Get-NavAppTenant -ServerInstance DynamicsNAV90 -Name 'ProseWare SmartApp' -Version 2.3.4.500

          Id                    State
          ----                  ---------
          Tenant1               Mounted
          Tenant2               Mounted
          Tenant4               Mounted

This example gets the tenants on the DynamicsNAV90 server instance that have the version 2.3.4.500 of the Proseware SmartApp installed.

EXAMPLE 2

Get-NavAppTenant -ServerInstance DynamicsNAV90 -Name 'ProseWare SmartApp' -Version 2.3.4.500 | Uninstall-NAVApp -ServerInstance DynamicsNAV90 -Name 'Proseware SmartApp' -Version 2.3.4.500

This example gets the tenants on the DynamicsNAV90 server instance that have the version 2.3.4.500 of the Proseware SmartApp installed and then uninstalls that NAV App for each of those tenants by passing the tenants to the Uninstall-NAVApp cmdlet.

Required Parameters

-Path

Specifies the path to a NAV App package file for the NAV App that you want to see a list of tenants where it is installed.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ServerInstance

Specifies the Microsoft Dynamics NAV server instance that the NAV App is deployed to, such as DynamicsNAV.

Type:String
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False

Optional Parameters

-Id

Specifies the ID of the NAV App to be returned.

Type:Guid
Aliases:AppId
Position:Named
Default value:00000000-0000-0000-0000-000000000000
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-IncludeFailed

Indicates if failed tenants should be included in the list.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Name

Specifies the name of the NAV App that you want to see a list of tenants where it is installed.

Type:String
Aliases:AppName
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Publisher

Specifies the publisher of the NAV App that you want to see a list of tenants where it is installed.

Type:String
Aliases:AppPublisher
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Version

Specifies the version of the NAV App that you want to see a list of tenants where it is installed.

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